Files
cv/docs/design/specs/ui/spec-ui-project-detail.md
dong.nguyen d827bf9b23 feat: resume download, router v7/v8 migrations, spec restructure
- Add resume download button in Hero CTA and Contact section
- Migrate react-router v6→v7 and v7→v8
- Restructure specs: UI specs to specs/ui/, v2 specs to specs/v2/
- Add profile-photo assets (jpg + webp)
- Update AGENTS.md, spec-v2.md index
2026-10-06 14:14:01 +07:00

3.3 KiB
Raw Permalink Blame History

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

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