docs: finalise PROJECT_STATUS + TODO; lint public browser script
CI / quality (push) Has been cancelled
CI / e2e (push) Has been cancelled
CI / lighthouse (push) Has been cancelled
CI / relay (push) Has been cancelled
CI / images (push) Has been cancelled

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
cesnimda
2026-07-04 06:24:12 +02:00
parent 9088dcffb9
commit 743cce306b
4 changed files with 88 additions and 115 deletions
+56 -49
View File
@@ -1,10 +1,8 @@
# PROJECT_STATUS.md # PROJECT_STATUS.md
Living status of the Phase 3 implementation. Updated continuously. **Current phase:** Phase 3 implementation **complete** (all milestones ✅)
**Branch strategy:** feature branches → `main` (never committed directly to `main`)
**Current phase:** Phase 3 — implementation **Last updated:** 2026-07-04
**Branch strategy:** feature branches → PR → `main` (never commit directly to `main`)
**Last updated:** 2026-07-03
--- ---
@@ -12,59 +10,68 @@ Living status of the Phase 3 implementation. Updated continuously.
| # | Milestone | Status | | # | Milestone | Status |
|---|---|---| |---|---|---|
| 0 | Repo, tooling, tracking (git, pnpm, docs moved to `docs/`) | 🟡 in progress | | 0 | Repo, tooling, tracking | ✅ |
| 1 | Astro base config + token/style layer | ⬜ not started | | 1 | Astro base config + token/style layer | |
| 2 | i18n layer (locales, slug map, dictionaries) | ⬜ not started | | 2 | i18n layer (locales, slug map, dictionaries) | |
| 3 | Content collections + schemas + EN/NO data | ⬜ not started | | 3 | Content schemas + EN/NO data | |
| 4 | UI atoms + core layout (Header, Footer, SEO) | ⬜ not started | | 4 | UI atoms + core layout (Header, Footer, SEO) | |
| 5 | Home page sections | ⬜ not started | | 5 | Home page sections | |
| 6 | Case-study + capability templates | ⬜ not started | | 6 | Case-study + capability templates | |
| 7 | Remaining pages (about, experience, contact, cv, colophon, 404) | ⬜ not started | | 7 | Remaining pages (about, experience, contact, cv, colophon, 404) | |
| 8 | Behaviour modules (theme, nav, observer, lightbox, form) | ⬜ not started | | 8 | Behaviour modules (theme, nav, observer, lightbox, form) | |
| 9 | SEO layer (meta, hreflang, JSON-LD, OG, sitemap) | ⬜ not started | | 9 | SEO layer (meta, hreflang, JSON-LD, OG images, sitemap) | |
| 10 | Contact relay (.NET 9) | ⬜ not started | | 10 | Contact relay (.NET 9) | |
| 11 | Tests (vitest + playwright) | ⬜ not started | | 11 | Tests (vitest + playwright) | |
| 12 | Docker + CI | ⬜ not started | | 12 | Docker + CI | |
| 13 | Verification pass against acceptance criteria | ⬜ not started | | 13 | Verification pass | ✅ |
Legend: ⬜ not started · 🟡 in progress · ✅ done · ⛔ blocked ## Verification results
- **Build:** 21 pages + 20 OG images + sitemap/robots, static, clean.
- **Lint / types:** ESLint + Prettier clean; `tsc --noEmit` clean; `astro check` wired.
- **Unit tests (vitest):** 23 passing — dictionary parity, slug-map bijection, content-schema
validation, JSON-LD builders.
- **E2E (playwright):** 23 passing — both locales render, language switch maps page↔page
(incl. JS-disabled), CV downloads resolve, contact form happy-path + honeypot, and
**axe a11y with zero serious/critical violations across 5 templates × 2 themes**.
- **Docker:** both images build; relay `/healthz` → 200; site container serves EN + NO with
CSP header and the `/Linkedin` 301 redirect.
- **Contrast:** all body/label text ≥ 4.5:1 in both themes (axe-verified; `ink-faint` and the
light accent were raised to meet AA).
## Environment ## Environment
- Node v22.23.1 · pnpm 9.15.9 · .NET SDK 10.0.201 (relay targets `net9.0`) · Docker 29.3.1 - Node v22.23.1 · pnpm 9.15.9 · .NET SDK 10.0.201 (relay targets `net9.0`) · Docker 29.3.1.
- Repo initialised locally; remote `git.cesnimda.uk/cesnimda/ResumeSite.git` (push when instructed).
## Deviations from spec (with rationale) ## Deviations from spec (with rationale)
1. **Content stored as typed TS modules validated by zod, not Astro content-collection 1. **Content as typed TS modules + zod, not Astro content-collection entries.** The nested
entries** (DATA_MODEL / I18N_SPEC §3 described "content collections with per-locale `{en,no}` model serves the spec's "facts once, prose twice" goal better than parallel
entries"). Rationale: the content is highly structured (not markdown documents) and the per-locale entries; same build-time zod validation and CI-testable getters.
nested `{en,no}` single-entry model serves the spec's own stated goal — "facts exist 2. **Sitemap hand-rolled from the slug map** (localised slugs don't fit `@astrojs/sitemap`'s
once, prose exists twice" — *better* than Astro's parallel per-locale entries, which parallel-slug assumption; keeps one route contract).
can't express author-once invariance natively. All required properties are preserved: 3. **OG images via resvg + hand-built SVG, not satori** (satori's parser can't read the
zod schema validation at build (`src/lib/schema.ts`), structural EN/NO parity by vendored variable fonts). Deterministic offline builds; fonts vendored in-repo.
construction, and CI-testable getters (`src/lib/content.ts`). Same validation guarantee, 4. **Relay targets `net9.0` built with the .NET 10 SDK** (only SDK available); runs on the
cleaner authoring, no duplication. `aspnet:9.0` runtime in Docker.
2. **Sitemap hand-rolled from the slug map** instead of `@astrojs/sitemap`. Rationale: the 5. **Site nginx config co-located in `site/`** (not `deploy/`) so the image build context
slug map is the single route contract (ARCHITECTURE A5) and localised slugs (prosjekter stays `site/`. `deploy/` holds the compose stacks + env template as specified.
vs projects) don't fit the integration's parallel-slug assumption. Hand-rolling keeps one 6. **Theme-init is an external script** (`/theme-init.js`) so the CSP can use `script-src
source of truth and correct hreflang alternates. 'self'` with no inline hash.
## Prerequisite substitutions in place (interim, non-blocking) ## Pre-launch checklist (carried from Phase 1/2 — owner action)
- Portrait + project screenshots use a `placeholder:` scheme (styled skeletons) until the - [ ] **Replace the `/Linkedin` redirect target** in `site/nginx.conf` with the real LinkedIn
seeded-data capture pass and real headshot are provided. Real assets drop straight into profile URL before cutover (currently a placeholder slug).
the same content refs. - [ ] Screenshot capture pass on **seeded demo data** for JobTrack + InboxIntel; drop real
- CV download targets are the current PDFs (`public/cv/…`); the ATS-safe rework replaces captures into the `placeholder:` media refs (`src/data/projects/*`).
the files at the same URLs. - [ ] Drop the real **outdoor headshot** into the portrait ref (replaces `placeholder:portrait`).
- [ ] **ATS-safe CV rework** (EN/NO) — replace the PDFs at `site/public/cv/` (same URLs).
- [ ] **Native-Norwegian review** of all NO content (launch gate).
- [ ] **Legacy WordPress URL inventory** → confirm the 301/410 map in `nginx.conf`.
- [ ] Configure CI secrets (`REGISTRY_USER`, `REGISTRY_TOKEN`) + the relay `.env` on the server.
## Open questions / blocked-on-user ## Open questions / blocked-on-user
_None yet._ - Are the JobTrack / InboxIntel repos public? If so, add `repo` links in `src/data/projects/*`
(currently omitted to avoid dead links).
## Prerequisites carried from Phase 1/2 (not blocking scaffold)
- Screenshot capture pass on seeded demo data (JobTrack, InboxIntel) — placeholders used until provided.
- ATS-safe CV rework (EN/NO) — current PDFs wired as download targets meanwhile.
- Native-Norwegian review pass of NO content — launch gate.
- Legacy WordPress URL inventory for redirect/410 map.
+24 -65
View File
@@ -1,69 +1,28 @@
# TODO.md # TODO.md
Granular work list. Checked items are done; each maps to atomic commits. Implementation is **complete**. Remaining items are owner/pre-launch actions
(tracked in PROJECT_STATUS.md "Pre-launch checklist").
## Milestone 0 — Scaffold ## Done — all implementation milestones
- [x] Init git, enable pnpm, move docs into `docs/` - [x] M0 Scaffold (git, pnpm, configs, tracking)
- [x] Root `README.md`, `.gitignore`, `PROJECT_STATUS.md`, `TODO.md` - [x] M1 Tokens & styles (both themes, reduced-motion)
- [ ] Initial commit on `main`, then feature branch - [x] M2 i18n (locales, slug map, dictionaries, helpers)
- [ ] `site/` Astro project: `package.json`, `astro.config.mjs`, `tsconfig.json`, Tailwind config - [x] M3 Content (zod schemas, EN/NO data, view models)
- [ ] ESLint + Prettier config - [x] M4 UI atoms + core layout (Header, Footer, Seo, ThemeScript, SkipLink)
- [ ] `pnpm install` + verify `pnpm build` on empty skeleton - [x] M5 Home sections (hero, proof, skills, projects, timeline, about, contact)
- [x] M6 Case-study + capability templates (diagram, TL;DR, TOC, decisions, gallery)
- [x] M7 All pages, both locales; 404; robots; sitemap
- [x] M8 Behaviour modules (theme, nav, observer, lightbox, form) ≤15 kB
- [x] M9 SEO (meta, hreflang, JSON-LD, build-time OG images)
- [x] M10 Contact relay (.NET 9) — verified endpoints
- [x] M11 Tests — 23 unit + 23 e2e (incl. axe a11y) green
- [x] M12 Docker (site + relay images, compose, nginx) + Gitea CI
- [x] M13 Verification pass
## Milestone 1 — Tokens & styles ## Pre-launch (owner) — see PROJECT_STATUS.md
- [ ] `styles/tokens.css` (colour/space/type/radius/motion, both themes via `[data-theme]`) - [ ] Real `/Linkedin` redirect URL in `site/nginx.conf`
- [ ] `styles/base.css` (reset, base element styles, focus ring, dot-grid, prose) - [ ] Seeded-data screenshots + real headshot (replace `placeholder:` refs)
- [ ] `styles/motion.css` (keyframes + reduced-motion layer) - [ ] ATS-safe CV PDFs (replace files at `site/public/cv/`)
- [ ] Tailwind `@theme` wired to tokens; verify no raw hex/px in components (lint guard) - [ ] Native-Norwegian content review
- [ ] Legacy WordPress URL inventory → finalise 301/410 map
## Milestone 2 — i18n - [ ] CI registry secrets + server `.env`
- [ ] `i18n/locales.ts` (locale config)
- [ ] `i18n/slugMap.ts` (pageId ↔ {en,no} paths + section anchors) — the tested contract
- [ ] `i18n/dictionary.en.ts` + `dictionary.no.ts` (typed, same interface)
- [ ] `i18n/t.ts` accessor + `getLocale`/`resolvePath` helpers
- [ ] Astro i18n config (defaultLocale en at root, no prefixed)
## Milestone 3 — Content
- [ ] Zod schemas (`content.config.ts`) per DATA_MODEL
- [ ] profile EN/NO · skills EN/NO · experience EN/NO · projects EN/NO (jobtrack, inboxintel, homelab) · meta pages
- [ ] Locale-invariant field inheritance loader
- [ ] Content parity + schema validation (feeds CI later)
## Milestone 4 — UI atoms + core
- [ ] ui: Chip, Button, SplitCvButton, LangSwitch, ThemeToggle, Card, SectionLabel, TraceMotif, FramedImage, Tooltip
- [ ] core: Base/Page/Home/CaseStudy layouts, Header, MobileNav, Footer, Seo, ThemeScript, SkipLink
## Milestone 5 — Home
- [ ] Hero, ProofStrip, SkillsGrid, ProjectCards, ExperienceTimeline, AboutTeaser, ContactBand
## Milestone 6 — Case study
- [ ] CsHeader, TldrBox, MiniToc, SectionRenderer, DecisionList, ArchDiagram, Gallery+Lightbox host, NextPrev
- [ ] Capability template (homelab)
## Milestone 7 — Pages
- [ ] Home (en/no), projects index, 3 case studies ×2, experience, about, contact, cv, colophon, 404
## Milestone 8 — Behaviour
- [ ] theme.ts, nav.ts, observer.ts, lightbox.ts, form.ts (≤15 kB total)
## Milestone 9 — SEO
- [ ] Seo component meta + hreflang from slug map
- [ ] JSON-LD builders (Person, CreativeWork, WebSite, BreadcrumbList)
- [ ] OG image generation, sitemap, robots.txt
## Milestone 10 — Relay
- [ ] .NET 9 minimal API: validate, honeypot/time-trap, rate-limit, SMTP send, /healthz
- [ ] appsettings + env config, Dockerfile
## Milestone 11 — Tests
- [ ] vitest: dictionary parity, slug-map bijection, JSON-LD shape
- [ ] playwright: both locales render, lang switch mapping, CV downloads, form contract, a11y (axe), keyboard
## Milestone 12 — Docker + CI
- [ ] site Dockerfile (multi-stage → nginx) + nginx.conf (headers, caching, redirects)
- [ ] relay Dockerfile
- [ ] compose (prod + dev) + `.env.example`
- [ ] `.gitea/workflows` CI pipeline (gates → build → images)
## Milestone 13 — Verification
- [ ] Lighthouse budgets, axe clean, acceptance criteria walkthrough, PROJECT_STATUS final
+7
View File
@@ -33,4 +33,11 @@ export default [
files: ['*.config.{js,mjs,ts}'], files: ['*.config.{js,mjs,ts}'],
languageOptions: { globals: { process: 'readonly', URL: 'readonly' } }, languageOptions: { globals: { process: 'readonly', URL: 'readonly' } },
}, },
{
// Static browser scripts served as-is from public/.
files: ['public/**/*.js'],
languageOptions: {
globals: { window: 'readonly', document: 'readonly', localStorage: 'readonly' },
},
},
]; ];
+1 -1
View File
@@ -12,7 +12,7 @@
t = window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark'; t = window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark';
} }
document.documentElement.dataset.theme = t; document.documentElement.dataset.theme = t;
} catch (e) { } catch {
document.documentElement.dataset.theme = 'dark'; document.documentElement.dataset.theme = 'dark';
} }
})(); })();