mirror of
https://github.com/dong-nz/cv.git
synced 2026-11-22 16:10:40 +07:00
157 lines
3.3 KiB
Markdown
157 lines
3.3 KiB
Markdown
# 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
|