cesnimda
3.4 KiB
3.4 KiB
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
SavedorSave 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.