docs(cv): complete builder implementation evidence
CI and Deploy / test (pull_request) Failing after 1m36s
CI and Deploy / deploy (pull_request) Has been skipped

This commit is contained in:
cesnimda
2026-08-09 21:08:28 +02:00
parent 20433491db
commit efacc3a06b
8 changed files with 69 additions and 39 deletions
@@ -47,6 +47,6 @@ This is the rolling action-level evidence index. `PASS (automated/runtime)` is n
| Theme state | Light/Dark/System precedence, login/logout scope, refresh/navigation and two-tab synchronization | PASS (state/provider/bootstrap tests) | PASS/PARTIAL — anonymous local browser at 375/768/1440 | NOT RUN | `ux-002-deterministic-theme-state.md` |
| Job match terms | bilingual/noisy/short/technology-heavy/filler extraction and honest labels | PASS (seven fixtures + component tests) | NOT RUN | NOT RUN | `qa-001-job-term-quality.md` |
| Career Workspace | first/returning/incomplete/loading/import processing/review/failure and recent CV actions | PASS (components; approval gate regression) | NOT RUN | NOT RUN | `career-001-career-workspace.md` |
| CV Builder | blank-name validation, unsaved/saving/failed/saved states, latest-data retry and navigation warning | PASS (components) | NOT RUN | NOT RUN | `career-002-cv-builder.md` |
| CV Builder | edit/collapse/add/delete/reorder/hide, save states/latest-data retry, navigation warning and preview failure/retry | PASS (components) | NOT RUN | NOT RUN | `career-002-cv-builder.md` |
Remaining product actions are `NOT STARTED` in the master plan and will be added as their work packages enter verification. The in-app browser is available for local UI checks; configured/real-provider and production access are not documented/configured.
+18 -13
View File
@@ -2,7 +2,7 @@
Updated: 2026-08-09
Status: `IN PROGRESS`. The save-integrity increment is implemented and locally verified; interaction, browser and production gates remain.
Status: `IMPLEMENTED — NOT VERIFIED`. Repository interactions and automated/build gates are complete; browser, external research and production gates remain.
## Revalidated capability matrix
@@ -11,13 +11,13 @@ Status: `IN PROGRESS`. The save-integrity increment is implemented and locally v
| Ordered section list | Default plus persisted section order | Implemented; browser pending |
| Expand/collapse | Entry-based sections use explicit collapse controls | Implemented; deeper tests pending |
| Inline editing | Section title and per-entry title/subtitle/bullets overrides | Implemented; validation depth pending |
| Add entries | Custom section uses line-based items; master entries remain profile-owned | Partial; interaction redesign pending |
| Delete entries/sections | Custom section removal existed without confirmation | Gap remains |
| Reorder sections/entries | Native drag plus visible up/down keyboard buttons | Implemented; persistence tests pending |
| Visibility | Section and entry hide/show controls | Implemented; persistence tests pending |
| Add entries | Explicit custom-section entries; master entries remain profile-owned | Implemented; browser pending |
| Delete entries/sections | Confirmed deletion for populated custom entries/sections; profile entries hide instead of mutating the profile | Implemented; browser pending |
| Reorder sections/entries | Native drag plus named up/down keyboard buttons | Implemented and persistence-tested |
| Visibility | Named section/entry/custom-section hide/show controls | Implemented and persistence-tested |
| Save feedback | Unsaved/Saving/Saved/failed badge existed | Hardened in `b58cc19` |
| Navigation safety | Debounced/failed state could be abandoned silently | Hardened in `b58cc19` |
| Preview | Debounced live server render beside editor; below editor on narrow layout | Implemented; responsive/browser review pending |
| Preview | Debounced live server render beside editor; visible failure/retry; below editor on narrow layout | Implemented; responsive/browser review pending |
| Versions/public/PDF | Existing history/restore, public toggle/link and PDF export | Preserved; regression/production gates remain |
## Save-integrity increment
@@ -29,25 +29,30 @@ Status: `IN PROGRESS`. The save-integrity increment is implemented and locally v
- Data-router navigation is blocked until the user explicitly confirms discarding pending/failed changes. Reload/tab close uses the browser's before-unload warning.
- The debounce timer is cleared on intentional unmount. Existing version creation and API payloads are unchanged.
## Interaction and error increments
- Custom sections retain the existing `string[]` storage model but expose entries individually: add, multiline edit, inline empty validation, arrow reorder and confirmation before destructive deletion.
- Custom sections can be reordered and hidden without changing the Career Profile. Deleting an original profile-backed entry is intentionally not offered; variant-specific hide/override preserves source-of-truth ownership.
- Profile-backed section and entry controls include the affected section/entry name. Expand controls expose `aria-expanded`.
- Preview failure no longer silently preserves stale output without explanation; an error state and in-context retry are available.
## Verification to date
- Focused Builder list/helper/deep-link/save/navigation: 3 suites, 15/15 tests.
- Full frontend: 49/49 suites, 181/181 tests.
- Focused Builder list/helper/deep-link/save/navigation: 3 suites, 17/17 tests; editor deep-link/interaction 9/9.
- Full frontend: 49/49 suites, 184/184 tests.
- Production build/TypeScript and `git diff --check`: pass.
- Implementation commit: `b58cc19`.
- Implementation commits: `b58cc19`, `a5b74e0`, `2043349`.
## Research limitation
The programme asks for authenticated FlowCV browser research. Browser tooling was finalized earlier in this session and no authorized FlowCV session was inspected. Existing repository research documents were read as prior context, but this is not reported as fresh browser evidence. Implementation continues from confirmed JobTracker gaps.
## Remaining CAREER-002 work
## Remaining verification
- Replace line-based custom entries with clear add/edit/reorder/delete behavior and confirmation where destructive.
- Add focused collapse, edit, add, delete, reorder, hide/show, autosave persistence, preview error and version regression tests.
- Decide and verify narrow-screen editor/preview navigation from rendered behavior.
- Run 375/768/1440, Light/Dark, keyboard/focus, empty/error and production synthetic-variant checks.
- Recheck DOCX status honestly: the current architecture documents it as an extension point, while PDF/public rendering are implemented.
## Rollback
Revert `b58cc19`. No schema, dependency, configuration, CV data rewrite or version migration is involved.
Revert `2043349`, `a5b74e0` and `b58cc19` in reverse order. No schema, dependency, configuration, CV data rewrite or version migration is involved.