5.1 KiB
Codebase index
Reviewed 10 November 2026 against the current source. This is a vanilla JavaScript static portfolio with hash routing, Dutch/English text, and no runtime dependencies. The source contains nine projects, twenty-four source/evidence items (twelve with provisional exam mappings) and eight process definitions.
| File | Responsibility |
|---|---|
README.md, AGENTS.md |
Setup, publication workflow and contributor instructions |
package.json |
Node >=22 requirement and five npm commands; no dependencies |
content/projects/*.json |
Editable projects, each with its evidence items; display order uses number |
content/settings.json |
Profile links, pinned source revision, eight process definitions |
content.js |
Generated browser module; do not edit directly |
app.js |
DOM rendering, translations, navigation, evidence filtering and printing |
styles.css |
Desktop/mobile layouts, project diagrams, accessibility and print styles |
index.html, favicon.svg |
Document shell, metadata and icon |
scripts/content.mjs |
Validate content, generate module, scaffold a project |
scripts/serve.mjs |
Loopback-only static preview; compiles content when requested |
scripts/build.mjs |
Validate/generate content, copy five public assets to dist/ |
tests/ |
Content integrity, editing, settings injection, publication and preview security regression checks |
Dockerfile, .dockerignore |
Allowlisted build context; test/build in Node, then copy public assets into Nginx |
compose.yaml, .env.example |
Host binding, port, restart policy, read-only runtime, temporary storage and log rotation |
docker/nginx.conf |
Domain-root public-file allowlist, response headers and /healthz |
.gitignore |
Excludes dist/, node_modules/, logs and .env |
docs/content-editing.md |
Field reference, editing workflow and validation limits |
docs/docker-hosting.md |
Guest deployment, separate proxy topology, updates and operations |
docs/repository-review.md |
Public account inventory, selected source revisions and review limits |
docs/verification.md |
Dated current checks, historical results and remaining verification limits |
docs/preview.png, docs/mobile-preview.png |
Historical visual references; not generated or refreshed by the build |
Rendering and dependencies
content/ → scripts/content.mjs → content.js → app.js → main
Routes: #home, #work, #project/<id>, #evidence, #evidence/<code>, #about. Empty hash opens home. Unknown page/project routes render an in-page 404; an unknown evidence code falls back to all processes. Language is English only for ?lang=en, otherwise Dutch. Switching language updates the query without losing the route.
header and footer render shared navigation. home and work render project lists; detail renders a dossier. processRow derives evidence counts and links from every project's evidence array. Removing evidence automatically removes its process-index entries.
The compiler reads JSON files directly inside content/projects/, sorts by number using numeric-aware comparison, validates project fields and emits exports. The first project is featured and the homepage count is derived from the array; an empty portfolio is supported. The preview generates content in memory on request. Content, test and build commands regenerate the tracked module on disk.
Project IDs are stable route identifiers. Evidence paths default to profile.school at the pinned revision. An optional project repository overrides the base, commit and forge; source(path, directory, project) constructs GitHub or Gitea URLs. An optional bilingual setting describes school year or personal-project context. Text pairs are [Dutch, English]. The existing design uses exactly three diagram nodes. Personal contribution and reflection copy is still shared placeholder text in app.js.
tests/content.test.mjs checks translations, mappings, pinned URL construction and the currently missing collaboration evidence. tests/editor.test.mjs checks compilation, empty collections, invalid inputs and homepage rendering with the featured project or all projects removed. Its DOM stub does not test real layout or browser interactions.
The print button opens all currently rendered process details and invokes browser printing; a filtered view prints only that process. The skip link focuses the main region without changing the route. Route changes focus main and scroll to the top. Responsive, reduced-motion and print rules live in styles.css.
Exposure boundary
Editing happens in local JSON files. The preview server has no write endpoint and binds to 127.0.0.1; it serves only / and the five public assets. Production ships five static files, with no editor, login, database or application backend. Docker uses an Nginx server process on port 8080 and adds /healthz. All content included in a build is public: only put publishable material in these files. Publish dist/, not the repository root. The build validates content and stages five assets before replacing dist/, removing stale files; it rejects redirected output/staging directories.