Documentdossier: kerngegevens, AI-voorstellen en PDF met tussenpagina’s #2443

New issue

Closed

opened 2026-10-15 16:21:54 +00:00 by brenno · 0 comments

brenno commented

2026-10-15 16:21:54 +00:00

Owner

Doel

Maak het documentdossier bruikbaar als verzorgd, deelbaar document: kerngegevens per bijlage op het overzicht, optionele AI-hulp, en één PDF met desgewenst een tussenpagina vóór iedere bijlage. Ook een presentatiebijlage loopt als documentinhoud mee.

Ontwerp voor het dossierformaat

Houd dossier.json op versie 2. DossierEntry.title bestaat al; voeg optioneel description (korte omschrijving), documentDate (ISO YYYY-MM-DD) en author (opsteller) toe. Oude v1/v2-dossiers blijven leesbaar en worden bij opslaan bijgewerkt; onbekende sleutels blijven behouden.
De velden zijn redactionele gegevens in het dossier. Ze wijzigen het bronbestand en diens opgeslagen SHA-256 niet. Een ontbrekende of onzekere datum/opsteller blijft leeg; de bestandswijzigingsdatum geldt niet als documentdatum.
overzicht.md blijft afgeleid en leesbaar zonder OciDeck. Neem de kerngegevens daarin op. Werk FILE_FORMAT.md, de Nederlandse variant, USER_GUIDE en SOURCE_MAP bij.

Gebruikersreis

Op elke documentkaart: titel, korte omschrijving, datum en opsteller bekijken en direct bewerken. Lege gegevens tonen een uitnodiging om ze aan te vullen. Toetsenbord, schermlezer, smal scherm en lange vertalingen werken.
Alleen wanneer AI is ingeschakeld en geconfigureerd: knop Gegevens voorstellen. OciDeck leest de gekozen bron veilig, begrenst de tekst en gebruikt de bestaande AI-toestemming en privacyprojectie voor uitgaand verkeer. Voorstel per veld tonen, met bron/onzekerheid waar mogelijk; gebruiker kiest wat wordt overgenomen. Geen automatische overschrijving; ontbrekende gegevens blijven leeg.
Exporteren als PDF op het dossieroverzicht. Keuze Tussenpagina vóór elk document staat standaard aan en kan uit. De PDF bevat een omslag, inhoudsopgave en de volledige inhoud van iedere .md-bijlage in dossiervolgorde. Een tussenpagina toont nummer, titel, korte omschrijving, datum, opsteller en SHA-256, zonder lege veldlabels. Presentaties worden als documentinhoud gezet.
Controleer vóór export alle bronpaden en hashes. Bij ontbrekende, onveilige of gewijzigde bronnen stopt de export met een duidelijke verwijzing naar het betreffende document en een herstelactie; er ontstaat geen misleidend compleet dossier. Gebruik de bestaande privacy- en PDF-exportketen. Schrijf pas na een geslaagde volledige export het doelbestand.

Acceptatie

V1/v2-compatibiliteit en behoud van onbekende velden getest; optionele velden kunnen worden gezet en gewist.
AI-voorstellen zijn uitgeschakeld wanneer AI uitstaat, verlopen via bestaande toestemming/projectie en worden pas na menselijke keuze opgeslagen.
PDF met en zonder tussenpagina's bevat de juiste volgorde en documentinhoud; ontbrekende/gewijzigde bron maakt geen half PDF-bestand.
App-reis, visuele controle, vertalingen en make check-full slagen.

## Doel Maak het documentdossier bruikbaar als verzorgd, deelbaar document: kerngegevens per bijlage op het overzicht, optionele AI-hulp, en één PDF met desgewenst een tussenpagina vóór iedere bijlage. Ook een presentatiebijlage loopt als documentinhoud mee. ## Ontwerp voor het dossierformaat - Houd `dossier.json` op versie 2. `DossierEntry.title` bestaat al; voeg optioneel `description` (korte omschrijving), `documentDate` (ISO `YYYY-MM-DD`) en `author` (opsteller) toe. Oude v1/v2-dossiers blijven leesbaar en worden bij opslaan bijgewerkt; onbekende sleutels blijven behouden. - De velden zijn redactionele gegevens in het dossier. Ze wijzigen het bronbestand en diens opgeslagen SHA-256 niet. Een ontbrekende of onzekere datum/opsteller blijft leeg; de bestandswijzigingsdatum geldt niet als documentdatum. - `overzicht.md` blijft afgeleid en leesbaar zonder OciDeck. Neem de kerngegevens daarin op. Werk `FILE_FORMAT.md`, de Nederlandse variant, USER_GUIDE en SOURCE_MAP bij. ## Gebruikersreis 1. Op elke documentkaart: titel, korte omschrijving, datum en opsteller bekijken en direct bewerken. Lege gegevens tonen een uitnodiging om ze aan te vullen. Toetsenbord, schermlezer, smal scherm en lange vertalingen werken. 2. Alleen wanneer AI is ingeschakeld en geconfigureerd: knop **Gegevens voorstellen**. OciDeck leest de gekozen bron veilig, begrenst de tekst en gebruikt de bestaande AI-toestemming en privacyprojectie voor uitgaand verkeer. Voorstel per veld tonen, met bron/onzekerheid waar mogelijk; gebruiker kiest wat wordt overgenomen. Geen automatische overschrijving; ontbrekende gegevens blijven leeg. 3. **Exporteren als PDF** op het dossieroverzicht. Keuze **Tussenpagina vóór elk document** staat standaard aan en kan uit. De PDF bevat een omslag, inhoudsopgave en de volledige inhoud van iedere `.md`-bijlage in dossiervolgorde. Een tussenpagina toont nummer, titel, korte omschrijving, datum, opsteller en SHA-256, zonder lege veldlabels. Presentaties worden als documentinhoud gezet. 4. Controleer vóór export alle bronpaden en hashes. Bij ontbrekende, onveilige of gewijzigde bronnen stopt de export met een duidelijke verwijzing naar het betreffende document en een herstelactie; er ontstaat geen misleidend compleet dossier. Gebruik de bestaande privacy- en PDF-exportketen. Schrijf pas na een geslaagde volledige export het doelbestand. ## Acceptatie - V1/v2-compatibiliteit en behoud van onbekende velden getest; optionele velden kunnen worden gezet en gewist. - AI-voorstellen zijn uitgeschakeld wanneer AI uitstaat, verlopen via bestaande toestemming/projectie en worden pas na menselijke keuze opgeslagen. - PDF met en zonder tussenpagina's bevat de juiste volgorde en documentinhoud; ontbrekende/gewijzigde bron maakt geen half PDF-bestand. - App-reis, visuele controle, vertalingen en `make check-full` slagen.

brenno referenced this issue from a pull request that will close it,

2026-10-15 17:30:50 +00:00

Documentdossier: kerngegevens, AI-voorstellen en verzorgde PDF #2445

brenno closed this issue

2026-10-15 17:31:32 +00:00