obsidian-vault/Infra-Network/SPEC-PAYMENTS-MAP-WEEK-PRINT.md

SPEC — Payments MAP WEEK / A4 landscape

Date: 2026-09-09
Status: implemented on VM500 (/mapa)
Language: English UI and print output

Scope

• Navigation and page title: Payments MAP WEEK.
• Filters: Week, Week Range, Month, Year and Date Range.
• ISO Week Range accepts start year/week and end year/week.
• The same compact range controls also appear in the Residents in period header.
• Rev. 2026-09-19 (006.2026): All cash payments redesigned (Hash / Ticket / Txn / Rent·Other·Total); Residents in period = behaviour only (weekly due / cash done / 6 prior weeks). Details: SPEC-SESSION-2026-09-19.md.

Print contract

• Print landscape prints a dedicated A4 landscape document, not the screen layout.
• The action is available twice: in the page toolbar and, with a printer icon, in the Residents in period control bar next to the status filters.
• Excluded: page toolbar, KPI cards, donut charts, collection bridge, search/filter controls and the secondary payments section.
• Included: SA/Granby header, selected date range, active roster filter and the complete Residents table.
• Fixed-width column layout uses the full printable width without horizontal clipping.
• Table header repeats on every printed page; resident rows do not split across pages.
• Printed columns: sequence, status, room, SAGE, resident, weekly due, cash done, behaviour and six prior-week status columns (W−1…W−6). The on-screen Residents in period table does not include a “Payments this period” detail column — that belongs only to All cash payments in this period.
• Colours are preserved with print-color-adjust: exact on the print container and all descendants.

Status colours in print

• Status and prior-week cells print solid badges with inline colours: green #047857 (PAID), amber #b45309 (PART), red #b91c1c (UNPAID), slate #64748b (FUTURE).
• Resident rows print on white. Status colour lives only in the badges, keeping the sheet clean when most residents are in arrears.
• The print header shows a PAID / PART / UNPAID legend.

On-screen: All cash payments in this period

• Professional header with Period button (period_headline + date range).
• Columns: Date, Resident, Room, Hash, Invoice / Ticket, Txn, Time (rent only; ancillary shows —), Account, Rent €, Other €, Total €.
• One line per transaction; non-rent amounts in Other €; footer = period totals.
• Txn prefixes and hash rules: SPEC-TRANSACTION-IDS.md.

Reliability

• Gateway 502/503/504 responses are converted to a short English message; raw Cloudflare HTML is never displayed.
• Payment Map retries transient gateway/network failures up to three times.