docs(career): record workspace evidence

2026-08-09 19:02:34 +02:00
parent 268b3a07de
commit c201832603
8 changed files with 105 additions and 28 deletions
@@ -0,0 +1,49 @@
+# CAREER-001 Career Workspace redesign
+
+Updated: 2026-08-09
+
+Status: `IMPLEMENTED — NOT VERIFIED`. State-focused component tests, the full frontend suite and the production build pass. Browser and production checks remain.
+
+## Revalidated execution path
+
+- `/career` renders `CareerWorkspacePage`, which delegates the master-profile state to `CareerProfilePage`.
+- `CareerProfilePage` loads `/career/profile`, `/auth/me`, `/profile-cv/runs` and version history. Active durable operations are polled; pending-review diffs are loaded separately.
+- CV import/rebuild/improve/reprocess create durable processing runs. Extracted changes are not written into the career profile until the user selects **Apply changes**; **Discard** remains available.
+- The previous wrapper presented a duplicate page heading, a large explanatory alert and one CV Builder action. Recent CV documents, first-run guidance, missing information and resumable import states were not visible at workspace level.
+- General documents live at `/career/builder`; job-specific selection/attachment lives in a saved job workspace. CV variants already carry optional `jobApplicationId` ownership metadata.
+
+## Implemented contract
+
+- The workspace starts with one `h1`, a short next-step prompt and an explicit CV Builder action. The requested long explanatory paragraph was removed.
+- Four responsive action cards lead to career-profile editing, CV import/review, general CV creation and the saved-job path for job-specific CVs.
+- Completeness and up to three missing areas are visible before the editor. The former duplicate completeness panel is hidden on this route while version restore remains available.
+- Durable import state is summarized as import, processing, review or failure and links to the existing run history/actions.
+- First-run, profile-load error, recent-CV loading/error/empty and returning-user states are explicit. Recent CVs are sorted by update time and show job-specific context.
+- Anchor targets use scroll margins; action navigation is native keyboard-focusable links. The grid collapses at small widths.
+- Existing profile persistence, extraction diff, low-confidence selection, Apply/Discard approval and version restore behavior are unchanged.
+
+## Verification
+
+- Focused Career Workspace and Career Profile: 2 suites, 16/16 tests.
+- State coverage includes first-run, returning/incomplete profile, recent general/job-specific CVs, queued processing, pending review, failure, loading and load error.
+- Existing pending-review test proves changes are applied only after the explicit accept request.
+- Full frontend: 49/49 suites, 178/178 tests.
+- Production frontend build and TypeScript: pass.
+- `git diff --check`: pass apart from repository line-ending notices.
+
+## Remaining gates
+
+- Browser tooling was finalized earlier in this session, so CAREER-001 was not inspected in a running browser. Required 375/768/1440, Light/Dark, keyboard/focus, Norwegian and rendered error/processing checks remain.
+- Synthetic-account production smoke and deployed route/anchor behavior remain unavailable without production access.
+- The saved-job path explains where a job-specific CV is managed; the deeper CV Builder/application interaction redesign remains CAREER-002/JOBS-001 scope.
+
+## Evidence
+
+- Evidence index: `docs/audits/evidence/career-001/README.md`
+- Commands/results: `docs/audits/verification-log.md` V-117–V-119
+- Focused tests: `job-tracker-ui/src/career-workspace-page.test.tsx`, `job-tracker-ui/src/profile-page.test.tsx`
+- Implementation commit: `268b3a0`
+
+## Rollback
+
+Revert `268b3a0`. No schema, dependency, configuration, provider or stored profile/CV data changes are involved.