Rapport: gedeelde rapportageperiode (#120) en gegroepeerde belasting per week/maand (#119)

[Nozzit]

What and why

Issues #119 en #120 raken exact dezelfde rapportlaag (rapportopties, optieblok, specbouwer en de twee resource-engines) en de opmerking bij #119 vraagt zelf om het gedeelde periodecontrol uit #120 — daarom samen in één PR.

Rapportageperiode (#120). Eén ReportingPeriod-model (src/engine/reports/reportingPeriod.ts) voor de vier venstergebonden tabelrapporten: look-ahead, voortgang, resourcebelasting en resourcetoewijzingen. Presets volgende / afgelopen 1, 2, 4, 6, 8, 12 weken en maand worden bij elke berekening tegen de statusdatum (anders vandaag) opgelost, zodat een gewijzigde statusdatum het venster mee verschuift; daarnaast Hele project en Aangepast (twee eigen datums). Het gedeelde ReportingPeriodField toont bij een preset de berekende datums alleen-lezen in de datumnotatie van de app; bij Aangepast worden het bewerkbare datumvelden (typen of kalenderkiezer), een omgekeerd, leeg of onvolledig bereik wordt rood gemarkeerd en niet toegepast, en terug naar een preset laat de eigen datums vallen. Per rapport een eigen onthouden keuze. Defaults volgen het issue: look-ahead volgende maand, voortgang afgelopen maand, belasting en toewijzingen hele project. Bestaande gebruikers merken daar niets van: hun opgeslagen "N weken"-getal migreert naar de kleinste dekkende preset (3 ⇒ 4 weken, 0 toewijzingsweken ⇒ hele project). Een venster dat helemaal in het verleden ligt is een terugblik en sleept de actuele achterstand niet mee.

Voortgangsrapport. "Voltooid" telt binnen de periode; "start in de komende periode" kijkt vanaf de statusdatum vooruit tot het periode-einde. Bij een afgelopen …-preset wordt even ver vooruitgekeken als de periode terugkijkt (de oude 2-wekenoptie blijft zo byte-identiek); een aangepaste of projectperiode die helemaal in het verleden ligt laat die sectie leeg. Dit staat niet letterlijk in het issue; het is mijn invulling om de vooruitkijksectie zinvol te houden bij een afgesloten rapportageperiode. De samenvatting toont beide grenzen.

Resourcebelasting (#119). Gegroepeerd per resource in dezelfde stijl als het toewijzingenrapport (naam en type alleen op de eerste rij van de groep, DOM én PDF); nieuwe optie Aggregatie per kalenderweek of kalendermaand (maandbucket toegevoegd aan computeHistogramReport, ook via de MCP-tool planner_get_resource_histogram); volgt de rapportageperiode (elke week/maand die de periode raakt, als geheel — dus altijd hetzelfde getal als het histogram). Beide resourcerapporten tellen "Resources" nu hetzelfde (wat in de tabel staat) en delen dezelfde periode-ondertitel. Titel is nu "Resourcebelasting" i.p.v. "… per week". Het maandlabel is in elke taal Gregoriaans met Latijnse cijfers (src/utils/monthLabel.ts).

Bewust niet gedaan: de presetlijst is in alle vier de rapporten identiek (ook afgelopen … bij look-ahead), precies zoals het issue "the same control can be reused across reports with different defaults" beschrijft; filteren per rapport is een mogelijke vervolgstap. Bekende beperking (gedocumenteerd in de gids): bij een PDF-paginaovergang midden in een resourcegroep wordt de resourcenaam niet herhaald — dat gold al voor het toewijzingenrapport.

Reviewhistorie. Drie hyperkritische reviewrondes op deze branch. Ronde 1 (verwerkt in 7f61ed8): datumvelden waren in de standaardlayout 18 px breed, leeg veld stil genegeerd, defaults weken af van het issue, resourcerapporten telden en ondertitelden verschillend, MCP-tool kende geen maand. Ronde 2 (verwerkt in a737b98): de layoutfix kapte lange labels af (Turks), presetdatums stonden in de browserlocale i.p.v. de app-notatie, buckets telde niet mee met het filter, de spiegelregel liep bij een 2020-periode een jaar vooruit, en de belastingsalinea in de twaalf vertaalde gidsen was nog week-only — de commitboodschap van df449f3 beweerde ten onrechte het tegendeel; dat is in a737b98 rechtgezet. Ronde 3 (verwerkt in 89f27d6): het maandlabel liep in het Perzisch op de Solar-Hijri-kalender (jaar 1405 naast 2026), de keuzelijsten voor periode/aggregatie (en de bestaande voor papier/oriëntatie) kapten bij de standaardkolombreedte af, een venster in het verleden sleepte de actuele achterstand mee, plus gids- en commentaarcorrecties.

Fixes #119
Fixes #120

How it was verified

• npm run verify green — alle onderdelen los gedraaid: typecheck, lint, planning (191 rapportchecks, incl. cases voor periode-resolutie, maandklem 31 jan → 28 feb, maandbucket, maandlabel in tien talen, spiegelregel incl. het 2020-geval, terugblik zonder achterstand, gefilterde tellingen en instellingenmigratie), library, mcp (incl. maandbucket via de tool), dev-server, verify:examples/docs/i18n/release-highlights-json/store-boundaries/gantt-boundaries/cycles. CI op de eerdere commits was volledig groen.
• Browsertests: table-reports.spec.ts uitgebreid (presetkeuze met alleen-lezen datums in app-notatie, label-, waarde- én keuzelijstbreedte gemeten op scroll- vs. clientbreedte, invoerbreedte bij Aangepast, omgekeerd én leeg bereik gemeld en niet toegepast) plus een flow voor de belasting (groepering, week ⇒ maand met Gregoriaans jaartal, periode). Lokaal gedraaid in Chromium; de container levert een andere Chromium-build dan Playwright 1.62 pint, dus via een niet-gecommitte config met executablePath.

Does this touch

• Project data — n.v.t.: rapportopties zijn app-voorkeuren (ops-reportSettings), geen IFC-data.
• Scheduling logic — alleen bucketing in computeHistogramReport (maand erbij, week/dag ongewijzigd); cases in tests/planning/check-reports.ts en tests/mcp/cases-read.ts.
• User-visible text — via t(...), alle veertien report.json-locales gevuld (verify:i18n groen).
• @tauri-apps/* — n.v.t.

Documentation

• public/docs/{nl,en}/gids-rapporten-printen.md: nieuwe sectie Rapportageperiode, bijgewerkte secties look-ahead, voortgang, resourcebelasting en -toewijzingen.
• Overige twaalf talen: sectie Rapportageperiode toegevoegd en de secties look-ahead, voortgang, resourcebelasting (kop, week-of-maand, optienaam, PDF-beperking) en -toewijzingen herschreven naar dezelfde inhoud als nl/en.
• CLAUDE.md: rapportenparagraaf noemt het gedeelde periodemodel.

🤖 Generated with Claude Code

https://claude.ai/code/session_01JoVB3BSFPZoKLvL6NmWRKy