feat: widgets - yuki documents-per-calendar-year customer widget + inactive-relations-with-yuki-dossier kpi

Samenvatting

Twee nieuwe Yuki-functies. Op het klant-dashboard zie je per relatie het aantal documenten per archiefmap per kalenderjaar, en in de datacontroles spoor je relaties op die bij jullie op inactief staan maar nog een actief dossier in Yuki hebben.

Beschrijving

Voor kantoren met een Yuki-koppeling ontbrak tot nu een overzicht van het documentvolume per klant, en een controle op dossiers die in Yuki nog actief zijn terwijl de relatie bij jullie al op inactief staat (en dus mogelijk onnodig kosten meebrengen).

Aantal documenten per kalenderjaar (klant-dashboard): per relatie toont Finibase het aantal documenten per archiefmap, opgesplitst per kalenderjaar (huidig jaar plus de drie voorgaande), met doorklik en export zoals de andere widgets.

Inactieve relaties met een Yuki-dossier (datacontroles): een controle die relaties toont die bij jullie op inactief staan maar nog gekoppeld zijn aan een actief Yuki-dossier, zodat je die kan opvolgen (bijvoorbeeld om licentiekosten te besparen), net zoals de bestaande Silverfin-variant.

Internal notes

Bouwt op de data- en integratielaag die in FIN-471 is opgeleverd (data nu volledig, geschikt voor 5000+ administraties). De twee widgets waren in FIN-471 bewust uitgesteld.

Opgeleverd in FIN-471:

• Documenttellingen per (administratie, map, jaar) over een venster van 4 kalenderjaren (huidig jaar tot op heden + 3 voorgaande volledige jaren).
• Yuki naar AdminPulse matching via matchRelationToYukiAdministration (nr. boekhouding naar internalCustomerCode, fallback ondernemingsnummer).
• is_active op administraties weerspiegelt Yuki's <Active>-vlag.
• Schaalbaar gemaakt voor 5000+ administraties (watermark-prune, SQL-aggregatie).

Scope 1 — klantwidget "Aantal documenten per kalenderjaar" (customer dashboard, per relatie):

• Toont documenttellingen per archiefmap, opgesplitst per kalenderjaar.
• providers: ["YUKI", "ADMINPULSE"] (controleer dat de YUKI-provider-enum bestaat / migratie toegepast is).
• Relatie naar Yuki-administratie via de bestaande matcher; tellingen uit document_folder_counts.
• Drill-down en export volgens de standaard widgetconventies (zie de Silverfin transaction-counts widget als referentie).

Scope 2 — datakwaliteit-KPI "Inactieve relaties met een Yuki dossier":

• Spiegel van de bestaande Silverfin "Inactieve relaties met een Silverfin dossier"-KPI.
• Telt relaties met isDeleted = true die matchen met een actief Yuki-dossier (isActive = true).
• Filter administraties op actief vóór buildYukiMatchLookups (de matcher is bewust agnostisch t.o.v. de active-vlag; zie de JSDoc).

Schaalbaarheid / opvolging:

• Voeg een (administration_id, year) index toe op document_folder_counts zodra de widget-queryvorm vaststaat (nu bewust niet gedaan: de composite unique dekt de per-administratie reads al).
• Overweeg paginatie op de settings-/widget-reads als kantoren met duizenden administraties de volledige lijst te zwaar vinden.

Referenties:

• Data/integratie: FIN-471 (commits 6a531b9e, 86d15f01).
• Matcher: src/features/dashboards-content/data-quality/shared/yuki/utils/match-yuki-adminpulse-administrations.ts.
• Silverfin-referentie: kpi-inactive-relations (data-quality) + de customer transaction-counts widget.
• Documentatie: docs/yuki-integration.md.