docs: RentCharge 006.2026 — SPEC-SESSION-2026-09-19.md

Infra-Network/SPEC-SESSION-2026-09-19.md

@@ -0,0 +1,67 @@
+# SPEC — Session 2026-09-19 (Rently / RentCharge)
+
+**Status:** implemented · **Operador:** Roger  
+**Ambientes:** prod + test (VM500)  
+**Versão:** **006.2026**
+
+---
+
+## Alterações do dia
+
+### 1. Week Payments Maps (`/mapa`)
+
+**All cash payments in this period** (única secção com Hash / Ticket / Txn):
+- Colunas: Date, Resident, Room, **Hash**, **Invoice / Ticket**, **Txn**, **Time** (só Rent), Account, **Rent €**, **Other €**, **Total €**
+- Cabeçalho profissional + botão **Period** (`period_headline`)
+- Ancillary cash incluído nesta tabela; rodapé com totais
+- Fontes Hash/Txn alinhadas às outras colunas
+
+**Residents in period** (comportamento — **não** alterar para detalhe de txn):
+- Removida coluna “Payments this period”
+- Cabeçalhos: **weekly due** · **cash done**
+- Prior lookback: **6 semanas** (W−1…W−6)
+
+### 2. Public Txn IDs — `SPEC-TRANSACTION-IDS.md`
+
+| Tipo | Formato |
+|------|---------|
+| Rent manual | `NNNNNN-M` · Ref `02_XXXXXX` |
+| Cash ancillary | **`000000-AA`** (9 chars): `000084-ME`, `000010-EL`, `000001-KC`, `DN`, `LY` |
+| Credit sale / settlement | `CR-…` / `CT-…` (canal) |
+| Import | Mantém ids do ficheiro |
+
+- Hash ROI/EOD: `payment_txn_hash` / `payments.txn_hash` no post de renda
+- Migração histórica: `CS-…` → prefixo conta → **padded** `000000-AA`
+- EOD gravados **descongelados** e regenerados (totais iguais; content hash atualizado)
+- Backups: `backend/data/arrears_pre_*_20260919_*.db` (+ test)
+
+### 3. Nomes de tabelas (fora ROI)
+- Ficha residente: **Payment history**
+- People hub tab: **Recent cash payments**
+- Payables: **Remittance by account**
+
+### 4. Invoice / Ticket — flag Required
+- Componente partilhado `TicketInvoiceField`
+- Verde **Required** por defeito (desmarcável → Optional) em **todos** os tabs do QuickPost (+ Add payment em dashboard, people, residents, mapa, receivables)
+- Campo pisca a vermelho se Required e vazio no Post
+- Também no **Edit payment** da ficha do residente
+- Evita assumir Receipt No (SA) como ticket
+
+### 5. People hub — Search pulse
+- Com **All Residents** selecionado, o campo Search pisca (verde) para o operador localizar a pesquisa
+
+### 6. Specs / docs
+- Novo: `SPEC-TRANSACTION-IDS.md`, `SPEC-SESSION-2026-09-18.md`, este ficheiro, `releases/006.2026.md`
+- Atualizados: `SPEC-PAYMENTS-MAP-WEEK-PRINT.md`, `SPEC-ACCOUNT-RECEIVABLES.md`, `VERSION.md`
+
+## Ficheiros principais
+- `backend/app/services/ledger.py`, `payment_map.py`, `eod_report.py`, `weekly_charges.py`, `main.py`
+- `frontend/src/app/mapa/page.tsx`, `people/page.tsx`, `payables/page.tsx`, `residents/[id]/page.tsx`
+- `frontend/src/components/QuickPostModal.tsx`, `TicketInvoiceField.tsx`, `residents/ResidentSearchToolbar.tsx`
+- `frontend/src/app/globals.css`, `lib/api.ts`
+- `docs/SPEC-TRANSACTION-IDS.md`, `docs/VERSION.md`
+
+## Deploy
+- `npm run build` prod + test (`NEXT_PUBLIC_APP_ENV=test` no test)
+- `systemctl restart` `rentcharge-{backend,frontend}` + `rentcharge-test-*`
+- Specs → Forgejo `myvexx/rently` + Obsidian CT130 via `scripts/sync_obsidian.py`