docs(cv): track builder integrity progress
This commit is contained in:
@@ -47,5 +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` |
|
||||
|
||||
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.
|
||||
|
||||
@@ -0,0 +1,53 @@
|
||||
# CAREER-002 CV Builder redesign
|
||||
|
||||
Updated: 2026-08-09
|
||||
|
||||
Status: `IN PROGRESS`. The save-integrity increment is implemented and locally verified; interaction, browser and production gates remain.
|
||||
|
||||
## Revalidated capability matrix
|
||||
|
||||
| Requirement | Existing implementation | Current status |
|
||||
|---|---|---|
|
||||
| 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 |
|
||||
| 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 |
|
||||
| Versions/public/PDF | Existing history/restore, public toggle/link and PDF export | Preserved; regression/production gates remain |
|
||||
|
||||
## Save-integrity increment
|
||||
|
||||
- Latest settings/name are retained independently of render closures.
|
||||
- Monotonic save revisions prevent an older overlapping request from changing a newer edit to `Saved` or `Save failed`.
|
||||
- Blank names show inline validation and are not sent as misleading no-op renames.
|
||||
- Unsaved and failed states expose **Save now**; failed saves retry the latest settings.
|
||||
- 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.
|
||||
|
||||
## Verification to date
|
||||
|
||||
- Focused Builder list/helper/deep-link/save/navigation: 3 suites, 15/15 tests.
|
||||
- Full frontend: 49/49 suites, 181/181 tests.
|
||||
- Production build/TypeScript and `git diff --check`: pass.
|
||||
- Implementation commit: `b58cc19`.
|
||||
|
||||
## 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
|
||||
|
||||
- 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.
|
||||
Reference in New Issue
Block a user