D3 — Statuskaarten in mensentaal, met altijd een volgende stap #2039

Closed
opened 2026-09-09 20:47:13 +00:00 by brenno · 1 comment
Owner

Onderdeel van het bouwplan voor bewijs bij badges. Het ontwerp staat in de
OciServe-repo: docs/EVIDENCE.md (model, zekerheidsniveaus, bewaren) en
docs/adr/0015-evidence-assurance-and-retention.md (de productbesluiten).
OciDeck is in deze keten de kant van de cursist.

Waarom dit bestaat

Voor sommige badges moet je bewijs aanleveren: een EHBO- of BHV-diploma, een
medische verklaring, een taalvaardigheidsverklaring, een gedragsverklaring, of
een diploma van iets anders. Een beoordelaar stelt vast of het klopt, en pas
daarna wordt de badge toegekend.

Vandaag kan de cursist in OciDeck niets van dit alles: hij ziet zijn badges
niet en hij kan niets aanleveren. De eLearning-module heeft drie bestemmingen —
Mijn cursussen, Voortgang, Gegevens — en bewijs komt er als vierde bij.

Wat dit toevoegt. De kaart die een cursist per bewijsstuk leest, in taal
die hij begrijpt.

Vijf toestanden en hun zinnen:

  • In behandeling sinds 3 september. Meestal binnen twee werkdagen.
  • Geaccepteerd. Geldig tot 3 mei 2028 — we waarschuwen je 60 dagen van
    tevoren.
  • De datum op de achterkant ontbreekt. Voeg een foto van de achterkant toe.
  • Dit certificaat telt ook mee voor Ploegleider.
  • Wordt verzonden zodra je online bent.

Een afwijzing zonder volgende stap is een bug, geen tekst. Behandel het zo:
elke negatieve uitkomst zegt wat de cursist nu kan doen. De beoordelaar levert
een reden aan; als die niet actiegericht is, is dat een fout in het
beoordeelscherm en niet iets wat OciDeck moet verbloemen.

Hergebruik zichtbaar maken. Eén BHV-certificaat kan drie badges bedienen.
Dat is niet alleen efficiënt, het maakt ook duidelijk waaróm iets is gevraagd.

Het onderscheid tussen "opgegeven" en "vastgesteld" hoort zichtbaar te
blijven
tot een beoordelaar ernaar heeft gekeken: wat de cursist zelf intikte
is nog niet gecontroleerd.

Te doen

  1. Statuskaart per bewijsstuk met de vijf toestanden hierboven.
  2. Elke negatieve uitkomst eindigt met een concrete volgende stap.
  3. Hergebruik tonen: bij welke andere badges telt dit stuk mee.
  4. Opgegeven waarden als zodanig markeren tot ze zijn vastgesteld.
  5. De waarschuwtermijn uit de soort tonen bij een geaccepteerd stuk.

Bestanden (voorstel)

lib/widgets/dialogs/ociserve_evidence.dart

Klaar wanneer

  • Geen enkele statuskaart eindigt zonder dat duidelijk is wat er nu
    gebeurt of moet.
  • De datums zijn in de taal van de gebruiker opgemaakt, niet als ISO-string.

Afhankelijkheden

Wacht op D1. Verrijkt door brenno/OciServe#521 (herinneringen).

Vaste verplichtingen in deze repo

  • Geen zichtbare tekst buiten l10n.d('...'). Elke nieuwe string betekent
    32 vertalingen via make add-l10n SPEC=...; make l10n-check bewaakt de
    pariteit.
  • Elk nieuw bestand in lib/ krijgt een regel in docs/SOURCE_MAP.md en
    moet in minstens één test voorkomen, anders valt make check.
  • Bestanden blijven onder 1000 regels; splits met part in plaats van te
    groeien.
  • Een nieuw topniveauscherm gaat door de overflow-stresstest (200% tekstschaal).
  • make check groen vóór de merge.
  • Werk in een branch, nooit direct op main.
> Onderdeel van het bouwplan voor bewijs bij badges. Het ontwerp staat in de > OciServe-repo: `docs/EVIDENCE.md` (model, zekerheidsniveaus, bewaren) en > `docs/adr/0015-evidence-assurance-and-retention.md` (de productbesluiten). > OciDeck is in deze keten de kant van de cursist. ## Waarom dit bestaat Voor sommige badges moet je bewijs aanleveren: een EHBO- of BHV-diploma, een medische verklaring, een taalvaardigheidsverklaring, een gedragsverklaring, of een diploma van iets anders. Een beoordelaar stelt vast of het klopt, en pas daarna wordt de badge toegekend. Vandaag kan de cursist in OciDeck **niets** van dit alles: hij ziet zijn badges niet en hij kan niets aanleveren. De eLearning-module heeft drie bestemmingen — Mijn cursussen, Voortgang, Gegevens — en bewijs komt er als vierde bij. **Wat dit toevoegt.** De kaart die een cursist per bewijsstuk leest, in taal die hij begrijpt. **Vijf toestanden en hun zinnen:** - *In behandeling sinds 3 september. Meestal binnen twee werkdagen.* - *Geaccepteerd. Geldig tot 3 mei 2028 — we waarschuwen je 60 dagen van tevoren.* - *De datum op de achterkant ontbreekt. Voeg een foto van de achterkant toe.* - *Dit certificaat telt ook mee voor Ploegleider.* - *Wordt verzonden zodra je online bent.* **Een afwijzing zonder volgende stap is een bug, geen tekst.** Behandel het zo: elke negatieve uitkomst zegt wat de cursist nu kan doen. De beoordelaar levert een reden aan; als die niet actiegericht is, is dat een fout in het beoordeelscherm en niet iets wat OciDeck moet verbloemen. **Hergebruik zichtbaar maken.** Eén BHV-certificaat kan drie badges bedienen. Dat is niet alleen efficiënt, het maakt ook duidelijk waaróm iets is gevraagd. **Het onderscheid tussen "opgegeven" en "vastgesteld" hoort zichtbaar te blijven** tot een beoordelaar ernaar heeft gekeken: wat de cursist zelf intikte is nog niet gecontroleerd. ## Te doen 1. Statuskaart per bewijsstuk met de vijf toestanden hierboven. 2. Elke negatieve uitkomst eindigt met een concrete volgende stap. 3. Hergebruik tonen: bij welke andere badges telt dit stuk mee. 4. Opgegeven waarden als zodanig markeren tot ze zijn vastgesteld. 5. De waarschuwtermijn uit de soort tonen bij een geaccepteerd stuk. ## Bestanden (voorstel) ``` lib/widgets/dialogs/ociserve_evidence.dart ``` ## Klaar wanneer - Geen enkele statuskaart eindigt zonder dat duidelijk is wat er nu gebeurt of moet. - De datums zijn in de taal van de gebruiker opgemaakt, niet als ISO-string. ## Afhankelijkheden Wacht op D1. Verrijkt door brenno/OciServe#521 (herinneringen). ## Vaste verplichtingen in deze repo - **Geen zichtbare tekst buiten `l10n.d('...')`.** Elke nieuwe string betekent 32 vertalingen via `make add-l10n SPEC=...`; `make l10n-check` bewaakt de pariteit. - **Elk nieuw bestand in `lib/` krijgt een regel in `docs/SOURCE_MAP.md`** en moet in minstens één test voorkomen, anders valt `make check`. - Bestanden blijven onder 1000 regels; splits met `part` in plaats van te groeien. - Een nieuw topniveauscherm gaat door de overflow-stresstest (200% tekstschaal). - `make check` groen vóór de merge. - Werk in een branch, nooit direct op `main`.
Author
Owner

Reeds geimplementeerd op main in commit cef5ac2a1 (PR gemerged). Tests in ociserve_evidence_test.dart en ociserve_evidence_ui_test.dart dekken het bewijs. Gesloten omdat het werk al geland was.

Reeds geimplementeerd op main in commit cef5ac2a1 (PR gemerged). Tests in ociserve_evidence_test.dart en ociserve_evidence_ui_test.dart dekken het bewijs. Gesloten omdat het werk al geland was.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
LibreKAT/Ocideck#2039
No description provided.