mirror of
https://github.com/dong-nz/cv.git
synced 2026-11-23 00:20:40 +07:00
ui spec
This commit is contained in:
1 parent
519d48ddae
commit
0273f555de
16 files changed
+4232
No files matched your search
@@ -0,0 +1,157 @@
|
||||
# UI Spec — Project Detail Page
|
||||
|
||||
## Overview
|
||||
|
||||
Trang chi tiết từng featured project. Tuân theo storytelling template.
|
||||
|
||||
---
|
||||
|
||||
## Structure
|
||||
|
||||
```
|
||||
ProjectDetailPage
|
||||
├── PageHeader
|
||||
│ ├── Breadcrumb (Projects → Project title)
|
||||
│ ├── Title (H1)
|
||||
│ ├── Meta
|
||||
│ │ ├── Category badge
|
||||
│ │ ├── Role
|
||||
│ │ └── Technologies (tags)
|
||||
│ └── Links (GitHub, Demo — optional)
|
||||
├── StoryBlock (×9 sections)
|
||||
│ ├── 01 — Context
|
||||
│ ├── 02 — Problem
|
||||
│ ├── 03 — Constraints
|
||||
│ ├── 04 — Solution
|
||||
│ ├── 05 — Architecture
|
||||
│ │ └── ArchitectureDiagram (SVG/interactive)
|
||||
│ ├── 06 — Implementation
|
||||
│ ├── 07 — Challenges
|
||||
│ ├── 08 — Result
|
||||
│ │ └── Metrics (highlight boxes)
|
||||
│ └── 09 — Lessons Learned
|
||||
└── Navigation
|
||||
├── Previous project
|
||||
└── Next project
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Content Model
|
||||
|
||||
```ts
|
||||
interface ProjectDetail {
|
||||
id: string;
|
||||
title: string;
|
||||
summary: string;
|
||||
category: ProjectCategory;
|
||||
role: string;
|
||||
technologies: string[];
|
||||
githubUrl?: string;
|
||||
demoUrl?: string;
|
||||
|
||||
sections: ProjectSection[];
|
||||
}
|
||||
|
||||
interface ProjectSection {
|
||||
id: string;
|
||||
number: number; // 01–09
|
||||
title: string;
|
||||
content: string; // markdown or HTML
|
||||
type: 'text' | 'diagram' | 'metrics' | 'code';
|
||||
images?: string[];
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Layout
|
||||
|
||||
### Desktop
|
||||
|
||||
- Single column, max-width 800px
|
||||
- Page header: centered, large title
|
||||
- Story blocks: sequential, each separated by divider
|
||||
- Architecture diagram: full-width within content area
|
||||
- Metrics: grid of highlight boxes
|
||||
- Previous/Next nav: row at bottom
|
||||
|
||||
### Mobile
|
||||
|
||||
- Single column
|
||||
- Page header: stacked, smaller title
|
||||
- Diagram: scrollable horizontally hoặc fit-width
|
||||
- Metrics: stack vertically
|
||||
- Previous/Next: stacked buttons
|
||||
|
||||
---
|
||||
|
||||
## Typography
|
||||
|
||||
| Element | Size | Weight |
|
||||
|---|---|---|
|
||||
| Page title (H1) | 40px / 32px mobile | 600 |
|
||||
| Section number | 14px | 400 |
|
||||
| Section title (H3) | 24px | 500 |
|
||||
| Section content | 16px | 400 |
|
||||
| Meta info | 14px | 400 |
|
||||
| Tech tag | 12px | 400 |
|
||||
| Metric | 16px | 600 |
|
||||
|
||||
---
|
||||
|
||||
## Architecture Diagram
|
||||
|
||||
| Variant | Style |
|
||||
|---|---|
|
||||
| Static SVG | Rendered SVG, zoom/pan if needed |
|
||||
| Interactive (future) | Clickable nodes, zoom, pan, tooltips |
|
||||
|
||||
---
|
||||
|
||||
## Metrics
|
||||
|
||||
- Accent background, white text
|
||||
- Grid layout (2 columns desktop, 1 column mobile)
|
||||
- Each metric: number (large) + label (small)
|
||||
|
||||
---
|
||||
|
||||
## Accessibility
|
||||
|
||||
- H1 page title, H3 section titles
|
||||
- Semantic `<article>` cho project
|
||||
- Breadcrumb: `aria-label="Breadcrumb"`
|
||||
- Diagram: `alt` text, `aria-label`
|
||||
- Links: `aria-label` với URL description
|
||||
- Focus visible trên tất cả elements
|
||||
- Content: semantic headings hierarchy
|
||||
|
||||
---
|
||||
|
||||
## Animation
|
||||
|
||||
- Story blocks fade-in khi scroll
|
||||
- Diagram: fade-in
|
||||
- Metrics: counter animation (optional, subtle)
|
||||
|
||||
---
|
||||
|
||||
## State
|
||||
|
||||
| State | Description |
|
||||
|---|---|
|
||||
| Default | Normal render |
|
||||
| Loading | Skeleton for content |
|
||||
| Error | 404 or not-found state |
|
||||
| Reduced motion | Disable animations |
|
||||
|
||||
---
|
||||
|
||||
## Constraints
|
||||
|
||||
- Data-driven từ `projects.ts`
|
||||
- Sections có thể partial (không phải project có đủ 9 sections)
|
||||
- Missing images → graceful degradation
|
||||
- Missing URLs → hide link buttons
|
||||
- Diagram: static fallback if interactive unavailable
|
||||
Reference in new issue
Block a user