feat: establish workspace web design language

2026-09-17 01:31:54 +09:00
parent c8eb767d63
commit ab6450b9fe
39 changed files with 3626 additions and 614 deletions
@@ -55,3 +55,48 @@ the Vite dev server proxy plus the Rust backend command above.
 deno task check
 deno task build
 ```
+
+## Design and architecture authority
+
+- [`../../docs/development/ui-ux/design-language.md`](../../docs/development/ui-ux/design-language.md): visual and interaction language.
+- [`../../docs/development/ui-ux/product-ux.md`](../../docs/development/ui-ux/product-ux.md): resource and navigation IA.
+- [`../../docs/development/ui-ux/application-architecture.md`](../../docs/development/ui-ux/application-architecture.md): shell and nested override architecture.
+- [`../../docs/development/ui-ux/visual-review.md`](../../docs/development/ui-ux/visual-review.md): implementer-owned visual validation.
+
+This README owns frontend implementation guidance and concrete source paths. It does not redefine product or visual rules from those documents.
+
+## CSS ownership
+
+`src/app.css` is the global foundation and owns only:
+
+- font imports;
+- cascade layer order;
+- semantic tokens and light/dark theme;
+- reset and base element typography;
+- global focus and text-selection behavior.
+
+It must not own page layout, feature class selectors, table or definition-list layout, button variants, status presentation, helper spacing, or anchor color. Navigation, inline links, and action links own their color in the relevant component stylesheet.
+
+Feature styles are owned by their implementation area:
+
+- `src/lib/workspace/styles/workspace-pages.css`: Workspace main-content primitives.
+- `src/lib/workspace/styles/tickets.css`: Ticket surfaces.
+- `src/lib/workspace/styles/workers.css`: Worker surfaces.
+- `src/lib/workspace/styles/settings.css`: Settings, Account, and form surfaces.
+- `src/lib/workspace/styles/workspace-catalog.css`: Workspace catalog.
+- `src/lib/workspace/sidebar/sidebar.css`: Sidebar components.
+- Svelte-local styles: behavior-specific presentation that is not reused outside that component.
+
+Use semantic tokens from `app.css`. Do not introduce component-local color, spacing, font, or z-index systems.
+
+## Source map
+
+- `src/routes/+layout.svelte`: root application shell and override contexts.
+- `src/routes/w/[workspaceId]/+layout.svelte`: Workspace Header and Sidebar registration.
+- `src/routes/w/[workspaceId]/settings/+layout.svelte`: Settings Sidebar registration.
+- `src/lib/workspace/header/`: Header frame, context, and overrides.
+- `src/lib/workspace/sidebar/`: Sidebar frame, scoped content, contexts, and override stack.
+- `src/lib/workspace/ui/`: generic presentation components such as `Tooltip`, `Bevel`, and `BevelLine`.
+- `src/routes/design-lab/workspace-web-ux/`: static Design Language showroom.
+
+When one of these paths changes, update this source map in the same change. Stable architecture and UX authority remain in `docs/`; this map follows the current implementation.