Files
jobtrackingapp/docs/redesign/phase-6/p6-00/SURFACES.md
T

6.4 KiB
Raw Blame History

Surface and shared-pattern coverage

Current-source audit at 9d6d29d. Native/visual references below belong to the retained Phase 5 / historical P6 audit. They establish prior finite observations; this table does not claim fresh execution or human acceptance.

Requested surface Current owner / established scope Review and migration boundary
Application shell AppShell, App, QuickCommandDialog, NotificationsPopover; P5-01/02 Grouped IA, exact active route, rail/mobile, skip/main/route focus, menu/command keyboard architecture retained. Investigate settled child names; full notification centre remains Phase 7.
Dashboard DashboardView, dashboard resource owner; P5-06 Personal snapshot/attention/reports, proven status links, exact current data and text chart values; shared PageSection/states. No Phase 8 drag/resize.
Jobs workspace / Table Jobs workspace in App, jobsQuery, JobTable; P5-03/04b Shared filter/query/sort/page/saved search/create refresh and Table/Board parity; opt-in density and phone action parity retained. Literal company fallback is a bounded localisation defect.
Kanban Board KanbanBoard; P5-04a/04b Semantic status groups, exact/custom outcomes, keyboard/no-drag alternative, error/Retry/Back retained. Full-result O(N) measurement required; no silent limit.
Job details ApplicationWorkspacePage, existing application children; P5-08a/b Seven sections, source context, current documents versus frozen package, timeline, tasks and interview retained. Deep child visual migrations must not change accepted package/data guards.
Analytics AnalyticsPage + DashboardView reporting; P5-07 Existing eight report families, URL period and exact data/link text already migrated. Remaining advanced/other Analytics work belongs Phase 7; no fabricated metrics.
Career Profile CareerProfilePage, career children Canonical facts/import low-confidence review/evidence/history exist. Avatar/heading corrections are current barriers; complete visual migration stays Phase 7.
CV library CvBuilderPage, gallery/thumbnails Create/copy/delete/share/export functions retained. Complete library migration stays Phase 7, distinguish it from already migrated studio template controls.
CV Builder CvBuilderEditor, CvCustomizeTab, existing revision/preview owner; P5-09–12/14 Scope/save/retry/conflict, source/reset overrides, content reorder, template settings, panes and preview are migrated. Explicit section heading correction only; keep native renderer/pagination, app density separate from paper.
Documents Job Attachments, ApplicationAssets/package owners and related routes Job-scoped navigation/presentation already migrated, frozen native package ordinary P2-D01 passes. Full cross-resource hub remains Phase 7; no second editor/database.
Settings SettingsView, Rules/AI/privacy/usage/backup/capture/cards; P4-04 and P5 repairs PageSection typography/layout exists; tab association and failed-language feedback are bounded corrections. Rules draft/save/discard contract retained; remaining account/security/full migration stays Phase 7.
Administration AdminUsersPage/AdminAuditPage/AdminSystemPage Roles and operational domain actions retained. Semantic headings can be corrected without moving controls or running probe/model actions. Broad admin migration stays Phase 7.
Authentication / onboarding Login/Forgot/Reset/Verify and provider controls Existing validation/remember-me/provider/2FA/verification semantics preserved. Login main/H1 correct current barrier. Visual onboarding/auth migration stays Phase 7.
Dialogs / forms MUI dialog/menu primitives; Add/Edit/Company/Crop, confirm/prompt Existing focus/return/dirty confirm infrastructure reused. Company failed save must be discoverable inside modal. Remaining forms are not globally restyled.
AI entry points AiSectionAssistant, CvBuilderEditor existing tools, job match/letter/answers/interview, profile import Ready/busy/error/retry, current/proposed and deliberate review/domain-specific mutation owners retained. P5-13 qualification/review migration withheld; no automated model runs.

Shared primitive review

Pattern Current decision and bounded evidence
Colour / surfaces / borders theme semantic light/dark roles, paired alerts, inverse nav and approved primary pair; fix default Avatar exception at two consumers. Public marketing variation remains intentional.
Typography / heading hierarchy Archivo/system stack; pageTitle/sectionTitle/pageDescription already defined. Visual variants and DOM heading level are separate; explicit semantic levels fix confirmed skips without altering approved typography.
Spacing / widths / density Existing page/card/section CSS tokens and reading/data/editor widths; Comfortable/Compact table/card tokens preserve desktop32/phone44 targets. Never apply app density to CV paper.
Actions / icons / status MUI icons/controls, one contained primary, outlined/text secondary, explicit destructive confirmation, translated names and pipeline status owners; no duplicate framework.
Inputs / forms Persistent MUI labels/help/error linkage and existing domain validation/save/dirty owners. Standardisation may not change data-saving semantics.
Tables / cards / menus / overlays Existing data density, active nav, dialog/menu elevation and focus overrides; full-row keyboard/click semantics retained. No fashion-driven replacement.
Loading / empty / request error ViewStateNotice/useViewResource and domain MUI state primitives already differentiate fresh loading, refresh failures and true empty data. Reuse existing retry and status infrastructure.
Save feedback / notifications Existing toast/Alert and confirm/prompt infrastructure; modal error and suppressed language persistence are the confirmed discoverability exceptions.
Preview / motion / responsiveness Native white physical document stays distinct from app dark surfaces; reduced-motion global override already exists. Canvas scrolling and chrome overflow are evaluated separately.

Relevant prior visual evidence: Phase 4 p4-06 loaded foundations/density/Settings captures; Phase 5 p5-04b Table/Board, p5-08b Job workspace, p5-09–12 studio and p5-15 final native manifest. Exact fresh screenshot/state and automated counts are supplied by the parent's current execution evidence, never inferred from file presence.