docs: add spec_v1.md (v1 completion record) and move all specs to docs/design/

This commit is contained in:
dong.nguyen committed 2026-10-06 12:24:55 +07:00
1 parent 59951a7224
commit e922ce64b8
18 files changed
+628

No files matched your search

+91
View File
@@ -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