mirror of
https://github.com/dong-nz/cv.git
synced 2026-11-22 16:10:40 +07:00
New spec-v3-review-fixes.md carries the findings, the per-bundle implementation detail, the affected-file list, the out-of-scope table including the declined resume.pdf bundle with its measured 200 text/html probe, the gate numbers and the commit record. spec-v2-seo.md acceptance is now honest: robots, sitemap, JSON-LD and canonical are done, per-route title/description/OG remain open because the SPA serves one head for every route. spec-v2.md statuses no longer contradict shipped work. AGENTS.md drops both barrels, documents the pure field() helper, the canonical origin module, the sitemap build step and the lazy/default-export gotcha.
2.3 KiB
2.3 KiB
Specification — v2 Features
Document:
spec-v2.mdVersion: 0.1.0 Status: Draft — awaiting review Branch:dev_v2Parent branch:dev(v0.0.1)
Prerequisites (Completed)
| File | Feature | Status |
|---|---|---|
specs/v2/spec-v2-router.md |
React Router v6 → v7 | ✅ Done |
specs/v2/spec-v2-router-v8.md |
React Router v7 → v8 | ✅ Done |
Overview
v2 bao gồm 7 tính năng, mỗi tính năng có spec riêng trong specs/:
| File | Feature | Priority | Est. | Status |
|---|---|---|---|---|
specs/v2/spec-v2-resume.md |
Resume download (UI) | P1 | ~15 min | ✅ Done |
specs/v2/pdf-resume/spec-v2-resume-playwright.md |
Resume PDF (Playwright) | P1 | ~4 hours | ✅ Chosen and shipped — pnpm build:resume / build:resume-all, CI generate-resume job. Serving the PDF from the site is open: specs/v3/spec-v3-review-fixes.md §4, bundle C (declined) |
specs/v2/pdf-resume/spec-v2-resume-puppeteer.md |
Resume PDF (Puppeteer) | P1 | ~4 hours | |
specs/v2/spec-v2-hero-carousel.md |
Hero visual carousel | P1 | ~1 hour | ❌ Spec file was never written; the feature was not built |
specs/v2/spec-v2-seo.md |
SEO (metadata, OG, sitemap) | P1 | ~1 hour | 🟡 Partial — head, JSON-LD, robots.txt, build-time sitemap.xml shipped via specs/v3/spec-v3-review-fixes.md Bundle D; per-route metadata open |
specs/v2/spec-v2-blog.md |
Blog (MDX, articles, syntax highlight) | P1 | ~4 hours | |
specs/v2/spec-v2-analytics.md |
Analytics (Plausible) | P2 | ~30 min | |
specs/v2/spec-v2-testing.md |
Testing (Vitest + E2E) | P5 | ~3 hours | |
specs/v2/spec-v2-cicd.md |
CI/CD (GitHub Actions) | P5 | ~1 hour |
Implementation order: Resume → Resume PDF (choose one) → Hero Carousel → SEO → Blog → Analytics → Testing → CI/CD
Out of Scope (v2)
- CMS integration (Phase 5+)
- Multi-language / i18n — shipped in v3 instead of Phase 5 (
specs/v3/spec-v3-i18n.md): chrome strings insrc/i18n/strings.ts, bilingual data throughsrc/i18n/field.ts, EN/VI resume output - Interactive diagrams / simulations (Phase 5+)
- Search functionality (Phase 5+)
- Contact form with backend (Phase 5+)
Approval
- All requirements reviewed and confirmed
- Implementation order agreed
- Ready to start coding