This commit is contained in:
Jens
@@ -0,0 +1,46 @@
|
||||
# Professionalisering baseline
|
||||
|
||||
- Datum: 2026-07-29
|
||||
- Branch: `main`
|
||||
- Versie: 0.3.12
|
||||
- Opdracht: volledige autonome professionalisering van VacatureRadar
|
||||
|
||||
## Architectuur
|
||||
|
||||
VacatureRadar is een Django 5.2 server-rendered modulaire monoliet op Python 3.13. PostgreSQL is de productiedatabase; Redis ondersteunt cache, gedeelde rate limiting en Celery. Een afzonderlijke worker en scheduler verwerken bronruns, lifecycle en notificaties. Externe bronnen lopen via policy-, robots-, TLS- en SSRF-validatie en adapters leveren genormaliseerde extractieresultaten zonder databasewrites.
|
||||
|
||||
De frontend bestaat uit Django-templates, lokale CSS en beperkte lokale JavaScript. Er is geen clientframework of externe runtimeasset. Authenticatie ondersteunt lokale accounts, een optionele Entra-boundary en een server-side alleen-lezen gastdemo.
|
||||
|
||||
## Baselinevalidatie
|
||||
|
||||
`./scripts/codex_verify.sh` start schoon: Ruff, Django system check en migratiecheck slagen. De bestaande suite bevat 298 tests. In de laatst volledig afgeronde gate slaagden 296 tests en werden twee browsercases overgeslagen omdat Playwright lokaal niet geïnstalleerd was; branch-aware dekking bedroeg 83,44%.
|
||||
|
||||
CI voert lint, tests, secret scanning, dependency scanning, een productie-imagebuild en containerscan uit. De browserdependency wordt wel gesynchroniseerd, maar Chromium wordt nog niet geïnstalleerd en de E2E-test staat omgevingsafhankelijke skips toe.
|
||||
|
||||
## Werkende onderdelen
|
||||
|
||||
- Negen functionele hoofdschermen, login en wachtwoordherstel.
|
||||
- Deterministische relevantie, scoring, dedupe en lifecycle vóór optionele AI.
|
||||
- Read-only gastdemo met server-side mutatiebescherming.
|
||||
- Bronbeleid, sanitization, SSRF-, TLS- en redirectbescherming.
|
||||
- Docker-, Unraid-, reverse-proxy-, health-, back-up- en restorevoorzieningen.
|
||||
- Dark/light theme, toetsenbordfocus, reduced-motionbasis en mobiele hoofdnavigatie.
|
||||
|
||||
## Belangrijkste risico's bij start
|
||||
|
||||
1. De premium CSS overschrijft het gecentreerde layoutcontract met links verankerde content. Op 3440 px blijft ongeveer 900 px ongebruikte ruimte rechts.
|
||||
2. De gastbanner begint mobiel boven de vaste topbar en is daardoor gedeeltelijk onzichtbaar.
|
||||
3. Verplichte browser- en accessibilitytests kunnen stilzwijgend skippen.
|
||||
4. De vacatureverkenner rendert een zeer lange resultaatpagina; selectie- en scrollcontext zijn beperkt.
|
||||
5. Bronnen en automatisering tonen veel operationele controls en informatie tegelijk.
|
||||
6. Kritieke dekking is relatief laag in auth, Entra, core views en task orchestration.
|
||||
7. Enkele modules zijn groter dan de repositoryrichtlijn en combineren meerdere verantwoordelijkheden.
|
||||
8. Live TLS-, reverse-proxy-, worker-, scheduler-, back-up- en restoreacceptatie blijft doelomgevingafhankelijk.
|
||||
|
||||
## Eerste uitvoeringsvolgorde
|
||||
|
||||
1. Responsive layout en gastbanner.
|
||||
2. Niet-skipbare browser-/accessibilitymatrix.
|
||||
3. Dagelijkse kernflows en taakgerichte schermcomposities.
|
||||
4. Kritieke tests, observability, container/security en herstelvalidatie.
|
||||
5. Integrale eindacceptatie en live restpunten.
|
||||
@@ -0,0 +1,18 @@
|
||||
# Finale acceptance 0.3.13
|
||||
|
||||
Status: lokaal geaccepteerd; live externe acties blijven afzonderlijk geregistreerd.
|
||||
|
||||
## Bewijs
|
||||
|
||||
- `./scripts/codex_verify.sh`: geslaagd.
|
||||
- Tests: 312 geslaagd, 0 mislukt, 0 overgeslagen, 1 niet-blokkerende waarschuwing.
|
||||
- Branch-aware coverage: 84,16%.
|
||||
- Playwright: zes viewports van 390×844 tot 3440×1200, volledige kernreis, reduced motion, focus, console/page errors en documentoverflow geslaagd.
|
||||
- Benchmarkkwaliteitsrun: 12/12 parservelden, dedupeprecision 1,0, recall 1,0 en rankingchurn 0,0.
|
||||
- Django system check en migratiecheck: schoon.
|
||||
- Repository-, YAML-, ledger- en dependencyconsistentie: schoon; `pip check` meldt geen gebroken dependencies.
|
||||
- Docker/compose-runtime: niet uitgevoerd omdat de lokale omgeving geen Dockerbinary bevat. Composebestanden blijven regressiegedekt en CI bouwt, scant en produceert een CycloneDX-SBOM.
|
||||
|
||||
## Uitkomst
|
||||
|
||||
Er bestaan geen bekende lokale P0- of P1-blokkers. Live TLS/proxy, productie-restore en optionele externe identity/mailintegraties worden uitsluitend overgenomen uit `USER_INPUT_REQUIRED.md`; lokale validatie wordt niet als live bewijs gepresenteerd.
|
||||
@@ -0,0 +1,26 @@
|
||||
# Performanceaudit 2026-07-29
|
||||
|
||||
## Baseline
|
||||
|
||||
- Lokale quickbenchmark: 250 invoeritems op Windows 11, Python 3.13, 16 CPU-threads.
|
||||
- Import: p50 348,879 ms; p95 825,107 ms; totaal 125.982,74 ms.
|
||||
- Dashboardlijst: p95 1.128,986 ms in de synthetische benchmark.
|
||||
- Detail: p95 101,754 ms.
|
||||
- Rescore: 53,284 ms voor de overgebleven unieke job in deze quickrun.
|
||||
- Piekgeheugen: 105,588 MB.
|
||||
- Frontend: lokale CSS en JavaScript, zonder framework of externe runtimeassets.
|
||||
|
||||
De eerste run ontdekte een echte benchmarkfout: de generieke HTML-fixture leverde slechts vier van zes verwachte velden. De adapter en fixture ondersteunen nu ook gelabelde publicatiedatum en dienstverband. De herhaalde kwaliteitsrun behaalt 12/12 parservelden, dedupeprecision 1,0, recall 1,0 en nul rankingchurn.
|
||||
|
||||
## Wijzigingen
|
||||
|
||||
- Vacaturepaginering verlaagd van 30 naar 20 kaarten per pagina.
|
||||
- Ultrawideframe gecentreerd zonder extra clientcode.
|
||||
- Mobiele pipeline gebruikt een verticale grid en veroorzaakt geen horizontale documentoverflow.
|
||||
- Runtimeheartbeat gebruikt de bestaande cache en voegt geen netwerkprobe aan paginarendering toe.
|
||||
|
||||
## Resterende risico's
|
||||
|
||||
- De synthetische quickimport overschrijdt de historische NFR-007-p95-doelwaarde; profiling van het volledige 25.000-itempad blijft zinvol vóór opschaling.
|
||||
- De quickbenchmark meldt meer dan 7.900 databasequeries voor 250 importpogingen. Correctheid en idempotentie zijn goed, maar bulkimport is de eerstvolgende optimalisatiekandidaat.
|
||||
- Queuediepte is met de generieke Django-cachebackend niet betrouwbaar meetbaar en wordt daarom eerlijk als onbekend getoond.
|
||||
@@ -0,0 +1,15 @@
|
||||
# Professionaliseringstraceability
|
||||
|
||||
| Roadmaponderdeel | Implementatie | Bewijs | Status |
|
||||
|---|---|---|---|
|
||||
| Responsive frame | `premium.css`, `layout.css` | zes Playwrightviewports, overflowassertie | implemented and verified |
|
||||
| Mobiele gastbanner | `base.html`, `components.css` | integratietest en mobiele E2E | implemented and verified |
|
||||
| Sticky/mobiele pipeline | `responsive.css`, `premium.css` | mobiele kernreis | implemented and verified |
|
||||
| Verplichte browsergate | CI, E2E-suite | Chromiuminstallatie, console/page-errorchecks | implemented and verified |
|
||||
| Vacatureflow | `JobListView`, `jobs/list.html` | view- en E2E-tests | implemented and verified |
|
||||
| Zoekscope en recente termen | `base.html`, `app.js` | lokale, begrensde browseropslag | implemented and verified |
|
||||
| Democontrols | read-only middleware en responsive CSS | auth- en E2E-tests | implemented and verified |
|
||||
| Runtimeobservability | `apps/core/tasks.py`, automationservice | runtime-observabilitytests | implemented and verified |
|
||||
| Parser/performance | generic HTML-adapter en benchmarkfixture | benchmark 12/12, precision/recall 1,0 | implemented and verified |
|
||||
| Container/security | bestaande Docker/CI-hardening | compose-, config-, security- en containerscans | implemented, live verification pending |
|
||||
| Live TLS/restore/identity | scripts en runbooks | `USER_INPUT_REQUIRED.md` | externally blocked, implementation complete |
|
||||
Reference in New Issue
Block a user