VacatureRadar/CODEX_START_HERE.md

Codex start hier

Dit bestand is de enige handmatige ingang die nodig is om VacatureRadar verder af te bouwen.

Missie

Lever een betrouwbare persoonlijke vacature-assistent die na eenmalige configuratie zelfstandig toegestane bronnen controleert, vacatures verwerkt, de beste matches uitlegbaar toont en sollicitaties helpt opvolgen. De gebruiker beoordeelt alleen de kleine relevante selectie en verstuurt iedere sollicitatie zelf.

Direct uitvoeren

1. Lees AGENTS.md.
2. Lees docs/ai/PROJECT_STATE.md.
3. Valideer de huidige basis met ./scripts/codex_verify.sh.
4. Lees docs/ai/BACKLOG.yaml machineleesbaar.
5. Kies de eerste taak met status: ready waarvan alle dependencies done zijn.
6. Voer die taak volledig uit volgens de acceptatiecriteria en docs/quality/DEFINITION_OF_DONE.md.
7. Werk tests, documentatie, traceability en taakstatus in dezelfde wijziging bij.
8. Herhaal zonder om bevestiging te vragen tot geen uitvoerbare ready taak meer bestaat.
9. Draai de volledige verificatie en schrijf de eindstatus naar docs/ai/PROJECT_STATE.md.

Niet onderbreken voor beslissingen

Alle kernbeslissingen zijn vastgelegd:

• single-user-first, maar modellen blijven user-scoped;
• België-first en Nederlandstalige UI;
• Django server-rendered modulaire monoliet;
• PostgreSQL + Redis/Celery in productie, SQLite voor lokale tests;
• publieke werkgeverspagina's en toegestane publieke ATS-pagina's eerst;
• platformmails in plaats van rechtstreekse scraping van denylistplatformen;
• strikt bronbeleid: onbekend betekent review, niet automatisch crawlen;
• deterministische regels vóór optionele AI;
• AI mag classificeren/samenvatten, nooit verwijderen, verzenden of solliciteren;
• geen automatische sollicitaties;
• één dagelijkse digest, uitzonderingsmeldingen alleen voor duidelijke sterke matches;
• privacy- en bewaarbeperking als standaard;
• geen nieuwe frontendstack tenzij een ADR bewijst dat Django templates niet voldoen.

Gebruik bij een ontbrekend detail de veiligste, eenvoudigste omkeerbare implementatie die met deze keuzes strookt. Noteer de aanname in een ADR of in het taakresultaat; stel geen vraag.

Externe blokkades

Een taak mag alleen blocked-external worden wanneer de resterende stap uitsluitend afhankelijk is van iets buiten de repository, zoals:

• een mailboxaccount of app-password;
• een productiedomein en TLS-configuratie;
• een gekozen live geocodingdataset/provider;
• juridische/voorwaardenreview van een specifieke bron;
• containerregistrycredentials.

Maak vóór blokkering altijd af:

• de interface en configuratievelden;
• fixtures/mocks;
• unit- en integratietests;
• foutafhandeling;
• operationele documentatie;
• een exact invul- of verificatiechecklistje.

Ga daarna direct door naar de volgende taak. Geen externe blokkade mag de implementatie van onafhankelijke taken stoppen.

Startprompt

Een kant-en-klare prompt staat in docs/ai/SESSION_BOOTSTRAP_PROMPT.md.