mirror of
https://github.com/dong-nz/cv.git
synced 2026-11-22 16:10:40 +07:00
docs: add spec_v1.md (v1 completion record) and move all specs to docs/design/
This commit is contained in:
1 parent
59951a7224
commit
e922ce64b8
18 files changed
+628
No files matched your search
@@ -0,0 +1,91 @@
|
||||
# UI Spec — Projects List Page (/projects)
|
||||
|
||||
## Overview
|
||||
|
||||
Trang danh sách tất cả projects, với filter theo category.
|
||||
|
||||
---
|
||||
|
||||
## Structure
|
||||
|
||||
```
|
||||
ProjectsListPage
|
||||
├── PageHeader
|
||||
│ └── Title (H1)
|
||||
├── FilterBar
|
||||
│ └── CategoryFilter (pills)
|
||||
│ ├── All
|
||||
│ ├── Software Engineering
|
||||
│ ├── Logistics
|
||||
│ ├── AI / ML
|
||||
│ ├── Computer Vision
|
||||
│ ├── Architecture
|
||||
│ └── Experiment
|
||||
└── ProjectGrid (×N)
|
||||
└── ProjectCard (same as homepage card)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Layout
|
||||
|
||||
### Desktop
|
||||
|
||||
- Page header: centered, H1
|
||||
- Filter bar: row of pills, centered
|
||||
- Grid: 2 columns
|
||||
- Active filter: accent background
|
||||
|
||||
### Mobile
|
||||
|
||||
- Page header: stacked
|
||||
- Filter bar: horizontal scroll pills
|
||||
- Grid: 1 column
|
||||
- Active filter: accent fill
|
||||
|
||||
---
|
||||
|
||||
## FilterBar
|
||||
|
||||
| Variant | Style |
|
||||
|---|---|
|
||||
| Default | Transparent bg, muted border, muted text |
|
||||
| Active | Accent bg, white text |
|
||||
| Hover | Accent border |
|
||||
|
||||
---
|
||||
|
||||
## Typography
|
||||
|
||||
| Element | Size | Weight |
|
||||
|---|---|---|
|
||||
| Page title (H1) | 40px / 32px mobile | 600 |
|
||||
| Filter pill | 14px | 500 |
|
||||
|
||||
---
|
||||
|
||||
## Accessibility
|
||||
|
||||
- H1 page title
|
||||
- Filter pills: `role="listbox"`, active item `aria-selected="true"`
|
||||
- Keyboard navigate filters (arrow keys)
|
||||
- Project cards: `<article>` semantic
|
||||
|
||||
---
|
||||
|
||||
## State
|
||||
|
||||
| State | Description |
|
||||
|---|---|
|
||||
| Default (All) | Show all projects |
|
||||
| Filtered | Show only selected category |
|
||||
| Empty | No projects in category → show message |
|
||||
|
||||
---
|
||||
|
||||
## Constraints
|
||||
|
||||
- Data-driven từ `projects.ts`
|
||||
- Filter state trong URL query param (`?category=ai-ml`)
|
||||
- URL state shareable
|
||||
- ProjectCard reuse từ homepage component
|
||||
Reference in new issue
Block a user