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

38 lines
6.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.