Drawn from .timeline-marker::after rather than from the entry or the header, because the current-role entry pads its own content box while the marker is pinned to the spine: left 10px, top 3px, width 24px on the 36px gutter (16px on the 28px mobile gutter) — the same x 12 to x 36 arithmetic .timeline-tldr::after already uses. The link carries the node's own ink: --border-strong for an ordinary ring and the gap node, --accent for the two ends of the timeline (the first node and the TLDR diamond, whose link already exists), and it follows the ring through the hover transition. The current-role link stops at the panel's accent edge (x 28 desktop, x 24 mobile). Spec: spec-ui-experience.md, new §Node → Title Link.
23 KiB
UI Spec — Experience Section
Overview
Timeline hiển thị kinh nghiệm làm việc: role, company, duration/location và responsibilities. Achievements không còn render trong SPA (2026-10-16) — dữ liệu vẫn được scripts/generate-resume.ts dùng cho resume PDF.
Structure
ExperienceSection
├── SectionHeading ("Experience")
└── ExperienceTimeline (.timeline)
├── ExperienceEntry (×N, newest-first) — entry có `variant` nhận thêm class `.timeline-entry-${variant}` (`current` / `gap`)
│ ├── TimelineMarker (.timeline-marker)
│ ├── TimelineHeader (.timeline-header)
│ │ ├── Title (.timeline-title)
│ │ ├── Company (.timeline-company)
│ │ └── Meta (.timeline-meta)
│ │ ├── Duration (.timeline-duration)
│ │ └── Location (.timeline-location)
│ └── Responsibilities (.timeline-responsibilities → li)
└── TldrNode (.timeline-tldr) — node chốt, luôn render sau entry cuối
├── Diamond marker (.timeline-tldr-marker)
├── Chip (.timeline-tldr-chip)
└── Text (.timeline-tldr-text)
FeaturedAchievement và ExpandableDetails không còn trong markup SPA — xem §Featured Achievement. Node TLDR là node cuối của timeline — xem §TLDR Terminal Node. Entry mới nhất là một status, không phải vai trò đã qua — xem §Current Status Node.
Content Model
interface ExperienceEntry {
id: string;
title: string;
titleEn?: string;
company: string;
duration: string; // e.g. "Jan 2020 – Aug 2026"
location?: string;
responsibilities: string[];
responsibilitiesEn?: string[];
achievements?: FeaturedAchievement[]; // không còn trong data; resume vẫn render nếu có
variant?: 'current' | 'gap'; // 'current' = node đang sống, 'gap' = nghỉ giữa hai vai trò
}
interface FeaturedAchievement {
id: string;
title: string;
context: string;
technicalWork: string[];
impact: string;
metrics?: string[];
technologies: string[];
featured: boolean;
}
Text của node TLDR không nằm trong experience.ts: nó là dẫn xuất của cả timeline chứ không phải một sự kiện, nên ở src/i18n/strings.ts — experience.tldr (nhãn chip) và experience.tldrText (câu tóm tắt).
Layout
Desktop
- Spine vẽ theo từng node (
.timeline-entry::before,left: -31px,bottom: -32pxbắc qua margin 32px) — không còn một đường liên tục trên.timeline, nên nó kết thúc đúng tại diamond của node TLDR thay vì chạy dài xuống dưới - Gutter 36px (
padding-left); marker 12px có tâm (x=6) nằm đúng trên tâm spine (5 + 1) - Entry rhythm: 32px padding-bottom + 32px margin-bottom + 1px divider; node
gapbỏ divider - Bullet responsibilities: dot 5px (ring
--accent, nhân--accent-soft), đặt tại0.66emđể thẳng hàng x-height của dòng đầu
Mobile
- ≤768px: spine và marker được giữ (trước đây bị ẩn) — gutter giảm còn 28px, marker
left: -28px - Entry rhythm giảm còn 24px
Timeline Marker
| Variant | Style |
|---|---|
Current node (variant: 'current') |
12px, --accent fill + --accent ring + pulse timeline-status-pulse (spread 0 → 10px --accent-glow) |
Gap node (variant: 'gap') |
10px, --border-strong ring, --bg-primary fill — nhỏ hơn một bậc, không accent |
| Other entries | 12px, --border-strong ring, --bg-primary fill |
| Hover | Ring chuyển sang --accent |
Node → Title Link (2026-10-20)
Mọi node của entry được nối vào title của nó bằng một hairline 1px nằm ngang — cùng treatment node TLDR dành cho diamond của nó (§TLDR Terminal Node: .timeline-tldr::after, 1px accent 24px từ diamond vào border panel). Link mang đúng màu của node mà nó thuộc về, không có màu riêng: accent chỉ ở hai đầu timeline (node đầu và diamond TLDR); các node ở giữa giữ --border-strong y hệt ring của chúng. Chủ sở hữu chốt hình ảnh này ngày 2026-10-20.
| Variant | Rule | Hình học / màu (gutter 36 desktop / 28 mobile) |
|---|---|---|
| Entry thường | .timeline-marker::after — left: 10px; top: 3px; width: 24px; height: 1px, background: var(--border-strong), transition: background var(--transition-normal) |
marker 12px border-box tại x 0–12, y 6–18; border 2px làm padding box bắt đầu ở (2, 8) → line bắt đầu tại mép ngoài vòng (x 12), nằm trên trục tâm vòng (y 11), kết thúc tại x 36 = mép nội dung, đúng chỗ title bắt đầu. Desktop 24px ≡ left:-24px + width:24px của link TLDR. Màu = màu ring của chính node |
Node đầu (:first-child) |
.timeline-entry:first-child .timeline-marker::after { background: var(--accent) } |
một trong hai đầu accent: cùng màu với marker fill + halo --accent-soft của node đầu |
Current node (variant: 'current') |
.timeline-entry-current .timeline-marker::after { width: 16px; background: var(--accent) } (mobile 12px) |
dừng đúng tại border accent trái của panel — x 28 desktop, x 24 mobile — không có ink tràn vào trong panel. Node đầu của data hiện tại chính là node current, nên hai rule cho cùng một màu |
| Gap node | left: 8px; width: 25px (mobile 17px) — không khai báo màu |
vòng 10px span x 1–11, padding box từ x 3 → line đi từ mép ngoài vòng; base value đã sẵn là --border-strong của spine nét đứt, ring nhỏ và title italic |
| Hover | .timeline-entry:hover .timeline-marker::after { background: var(--accent) } |
link sang accent cùng lúc ring sang accent (rule hover của marker đã có từ trước); không có cảnh node sáng mà link vẫn xám |
| Node cuối (TLDR) | giữ nguyên .timeline-tldr::after — 1px accent 24px (mobile 16px) |
đầu accent còn lại; rule mới chỉ nhắm .timeline-marker, không đụng .timeline-tldr-marker |
| ≤768px | .timeline-marker::after { width: 16px } |
line x 12 → 28, đúng 16px mà link TLDR dùng ở breakpoint này |
Vẽ từ marker, không từ entry hay .timeline-header: entry current tự pad top 16px (mobile 14px) nên toạ độ của header dịch theo padding, còn marker neo cố định trên spine. Pseudo của marker paint sau vòng (panel của node current ở z-index: -1) nên khớp nối liền một màu — cùng cách .timeline-tldr::after paint đè diamond. Node TLDR giữ link riêng: rule này chỉ nhắm .timeline-marker, không đụng .timeline-tldr-marker.
Current Status Node
Entry có variant: 'current' trong experience.ts: node "bây giờ". Nó dùng cùng họ panel với node TLDR — flat surface, hairline border, radius, whisper shadow — và khác đúng hai chỗ: cạnh trái accent và marker pulse.
| Phần | Style |
|---|---|
| Marker | fill --accent, border --accent, animation: timeline-status-pulse 2.4s ease-out infinite (spread 0 → 10px --accent-glow, cùng idiom .greeting-dot của hero). Mobile đổi animation-name sang timeline-status-pulse-sm (spread 0 → 6px) |
| Panel | Entry có padding thật 16px 18px 20px (desktop) / 14px 16px 18px (mobile) và bỏ divider riêng (border-bottom: none); .timeline-entry-current::after inset -10px -10px -10px -8px (desktop) / -8px -8px -8px -4px (mobile), --bg-surface, 1px solid --border + border-left: 2px solid --accent, radius --radius-lg, shadow inset 0 1px 0 --inset-highlight, 0 8px 20px -18px --shadow, z-index: -1 |
| Stacking | isolation: isolate trên entry — panel nằm sau text, bullet và đoạn spine của chính entry nhưng trước background của section |
| Trigger | variant?: 'current' | 'gap' trong ExperienceEntry, class ghép timeline-entry-${variant} trong JSX — không hard-code exp.id |
Không có va chạm marker–panel và không có chữ sát viền:
| Gutter | Border trái panel | Vòng pulse ngoài cùng | Chữ bắt đầu | Hở pulse | Hở chữ | |
|---|---|---|---|---|---|---|
| Desktop | 36 | 36 − 8 = 28–30 | marker 0–12 + spread 10 = 22 | 36 + 18 = 54 | 6px | 24px |
| Mobile | 28 | 28 − 4 = 24–26 | marker 0–12 + spread 6 = 18 | 28 + 16 = 44 | 6px | 18px |
Spine ở x 5–7 nằm ngoài panel. prefers-reduced-motion toàn cục (index.css:275) flatten pulse về static, marker vẫn giữ halo của rule :first-child.
Gap Node (Career Break)
Entry có variant: 'gap' — khoảng nghỉ giữa hai vai trò. Mục tiêu hình ảnh: đọc ra là một khoảng trống, không phải một công việc.
| Phần | Style |
|---|---|
| Spine | .timeline-entry-gap::before đổi sang repeating-linear-gradient — gạch 4px, hở 5px, màu --border-strong; chạy suốt chiều cao node rồi bắc qua margin 32px sang node kế tiếp |
| Marker | 10px ring --border-strong, nhân --bg-primary; left: -35px desktop (tâm = 36 − 35 + 5 = 6, vẫn đúng trên spine), -27px mobile (28 − 27 + 5 = 6) |
| Divider | bỏ (border-bottom: none) — đường gạch nối thẳng sang node kế |
| Title | --text-muted + font-style: italic |
| Company | --text-muted |
Không có accent, không có bed, không có pulse: node gap nhỏ hơn và mờ hơn mọi node việc. :first-child fill vẫn tồn tại trong CSS nhưng .timeline-entry-gap .timeline-marker đứng sau trong nguồn và có cùng specificity → gap thắng nếu một ngày node gap là node đầu.
TLDR Terminal Node
Node cuối, luôn có, không đến từ experiences: toàn bộ timeline được gói lại trong một câu.
Intent: tĩnh và lặng. Không gradient, không viền accent đậm, không quầng mạnh. Accent chỉ nằm ở ba chỗ: diamond trên spine, link hairline và chip.
| Phần | Style |
|---|---|
| Marker | 12px square rotate(45deg) → diamond ruột rỗng: border 2px --accent, nhân --bg-primary (che luôn đoạn stub spine đi sau), halo 0 0 0 3px --accent-soft; tâm vẫn nằm đúng trên spine (x=6) |
| Stub | .timeline-tldr::before 2px × 22px nối đoạn spine cuối xuống tâm diamond |
| Link | .timeline-tldr::after 1px accent ngang 24px, từ diamond vào border panel; vẽ đè lên diamond nên khớp nối liền một màu |
| Panel | --bg-surface phẳng (không gradient), border 1px --border, radius --radius-lg, inset 0 1px 0 --inset-highlight + 0 8px 20px -18px --shadow |
| Chip | mono 12px, letter-spacing: 2px, uppercase, --accent, không nền, không khung — cùng giọng với .section-tag |
| Text | var(--text-lede) 20px / 1.55; không khai báo màu → kế thừa p toàn cục (--text-secondary), giống mọi lede khác trong site |
Cột text: 636px (homepage: .page-body 680 − gutter 36 − padding 2×24) → ~74 ký tự/dòng; 668px trên /experience (752 − 36 − 48) → ~78 ký tự/dòng. Cả hai trong band 45–80.
Featured Achievement
| Scope | Status |
|---|---|
SPA (/experience + homepage Experience) |
Removed 2026-10-16. .achievement, .achievement-title, .achievement-context, .achievement-impact, .achievement-metrics, .achievement-techs deleted from src/App.css. |
| Resume PDF | Unchanged — scripts/generate-resume.ts:100-115 and public/resume-template.html:127-181 still render achievements. |
| Data / types | achievements in src/data/experience.ts and FeaturedAchievement in src/types/index.ts kept: the resume generator consumes them. |
.achievement-metric |
Kept — still used by Projects.tsx:75 and ProjectDetailPage.tsx:47. |
Typography
| Element | Size | Weight |
|---|---|---|
| Section heading (H2) | clamp(24px, 4vw, 40px) |
600 |
| Role title | 20px | 600 |
| Company | 16px | 400 |
| Duration / Location | 14px (chrome) | 400 |
| Responsibility | var(--text-meta) 15px / var(--leading-body) 1.65 |
400 |
Achievement title 18px and metric 14px/600 no longer appear on this section; .achievement-metric is chrome on the projects pages.
Accessibility
- H2 section; entry titles hiện render bằng
div, chưa phảih3 - Semantic
<time>cho duration aria-labelcho timeline- Metrics: semantic highlight, không chỉ màu
- Keyboard navigate giữa entries
Animation
- Mỗi entry reveal độc lập:
initial {opacity: 0, y: 24}→whileInView {opacity: 1, y: 0},viewport {once: true, amount: 0.2},duration 0.45s,ease easeOut,delay i * 0.08 staggerChildrentrên section bị bỏ: nó cộng hưởng vớidelay: i * 0.15của từng child, khiến entry ở giữa trang xuất hiện muộn không cần thiết- Hover không còn transform nào.
scale: 1.02làm text re-raster hoá trong lúc animation chạy;y: -4cũng bị bỏ — spine là::beforecủa chính entry, nâng entry sẽ nâng cả đoạn spine và làm lệch khớp nối. Phản hồi hover chuyển hết sang CSS: marker ring →--accent, divider →--border-strong - Spine không "draw" khi scroll: mỗi node tự vẽ đoạn của mình; node TLDR kết thúc chuỗi bằng stub 22px dừng đúng tại tâm diamond
- Reduced motion:
main.tsxđặtmotion.config.reducedMotion = 'user', cùng@media (prefers-reduced-motion: reduce)trongsrc/index.css
State
| State | Description |
|---|---|
| Default | Marker ring --border-strong, divider --border |
| Hover | Marker ring → --accent, divider → --border-strong (không còn transform) |
| Scroll reveal | Fade-in + slide-up, một lần (once: true) |
| Reduced motion | Animation tắt theo user preference |
| Current status node | Marker pulse 2.4s + bed --accent-soft với border-left accent |
Constraints
- Data-driven từ
experience.ts - Entries có thể 0 → render empty state
achievementsđã bị xoá khỏiexperience.ts; field vẫn optional trong type, vàscripts/generate-resume.ts:100vẫn render nó nếu có (optional chaining → resume PDF hiện không còn phần achievement)- Không hard-code entry count
Implementation record (2026-10-16)
- Achievements removed from
src/pages/ExperiencePage.tsxandsrc/components/sections/Experience.tsx; the.achievement*rules that lost their only consumers were deleted..achievement-metricstays (projects pages). - Timeline restyled: spine vẽ theo node (
.timeline-entry::before), marker/spine centres aligned exactly (36px gutter desktop, 28px mobile), 32px / 24px entry rhythm, filled current-role marker with--accent-softhalo, hover states on marker and divider,.timeline-metasingle row (duration · location), 5px accent bullets at0.66em. - Motion: per-entry
whileInViewreveal; mọi hover transform đã bỏ (spine là::beforecủa entry, lift làm lệch khớp nối). - TLDR terminal node: text tại
src/i18n/strings.ts:42-46—tldr=TL;DRcho cả hai ngôn ngữ,tldrText= "15 years of experience, more than 5 companies along the way. Too long to tell." / "15 năm kinh nghiệm, hơn 5 công ty đã đi qua. Quá dài để kể hết."; markup tạisrc/pages/ExperiencePage.tsx:39-43vàsrc/components/sections/Experience.tsx:56-60; CSS tạisrc/App.css(.timeline-tldr,::before,::after,-marker,-chip,-text). - Current status node:
current?: booleanthêm vàoExperienceEntry(src/types/index.ts:50); entryopen-to-worktạisrc/data/experience.ts:4-21("Nov 2026 – Present",current: true); class ghép tạisrc/pages/ExperiencePage.tsx:17vàsrc/components/sections/Experience.tsx:30; CSS.timeline-entry-current+@keyframes timeline-status-pulsetrongsrc/App.css. experience.tsgiờ có 4 entry (open-to-work, Lazada 01/2020–08/2026, Nexts 06/2019–12/2019, SAP 2017–12/2019), newest-first ✓. Ba entry cũ trùng nhauid: "senior-swe"→ trùng React key; đã đổi thànhlazada-senior-swe,nexts-founder,sap-senior-swe, và sửaNexts Limted→Nexts Limited.- Bốn điểm dữ liệu chủ sở hữu cần tự xác nhận — tôi không tự sửa vì không có nguồn trong repo: (1)
sap-senior-swecóresponsibilitiesEn5 bullet copy nguyên từ entry Lazada (IoT-DWS 16 sortations, Scrum Level L3) trong khi bản VI chỉ 2 bullet, nên switch ngôn ngữ đổi cả nội dung lẫn độ dài; (2)nexts-founder: VI 1 bullet chung chung, EN 1 bullet cụ thể về autonomous vehicles — cũng lệch nhau; (3) TLDR nói 15 năm / hơn 5 công ty còn dữ liệu là 2017→2026 (~9–10 năm) với 3 nhà tuyển dụng + 1 công ty tự lập; (4)open-to-workghi "Nov 2026 – Present" trong khi hôm nay là 2026-10-16, và Lazada kết thúc 08/2026 → còn trống 09–10/2026. - Verified:
tsc -bexit 0;vite buildgreen. Built CSS contains.timeline-entry:before{…bottom:-32px;left:-31px}(mobilebottom:-24px;left:-23px),.timeline-entry:first-child:before{top:12px},.timeline-entry:last-child:before{bottom:0}, the whole.timeline-tldrset (:beforestub,:afterlink,-markerdiamond,-chip,-text) and no global.timeline:before. oxlint 11 errors / 9 warnings — identical to before this change; the HEAD baseline was 15/9 and the four that disappeared wereuseField-in-callback findings removed together with the achievements markup. - Still open from this spec (intent not implemented): semantic
<time>for duration,aria-labelon the timeline, entry titles ash3(they render asdiv), spine draw-on-scroll, keyboard navigation between entries. - Gap node
relax-gap("Nghỉ ngơi" / "Relax",Aug 2026 – Oct 2026,Career break) tạisrc/data/experience.ts:20-35, chèn đúng giữaopen-to-work(Nov 2026 – Present) vàlazada-senior-swe(Jan 2020 – Aug 2026) → hết khoảng trống 09–10/2026 đã nêu ở mục trên.current?: booleanđược thay bằngvariant?: 'current' \| 'gap'(src/types/index.ts:50), class ghép trong JSX; CSS.timeline-entry-gap+::beforedashed + marker 10px trongsrc/App.css. Đã sửa thêmdurationcủa Lazada:"Jan 2020 – Aug 2026"(hai khoảng trắng) → một khoảng trắng. - Resume PDF có render node gap (dòng "Relax — Career break" trong
dist/resume.pdf). Đó là quyết định của chủ sở hữu: nếu muốn timeline SPA có nghỉ còn resume thì không, chỉ cần đổirenderExperience(experiences)thànhrenderExperience(experiences.filter(e => e.variant !== 'gap'))tạiscripts/generate-resume.ts:159. - Verified lần cuối (sau khi thêm gap node):
tsc -bexit 0;vite buildxanh. Built CSS có.timeline-entry-gap:before{background:repeating-linear-gradient(to bottom,var(--border-strong) 0px,var(--border-strong) 4px,transparent 4px,transparent 9px)},.timeline-entry-gap{border-bottom:none},.timeline-entry-gap .timeline-marker{width:10px;height:10px;left:-35px}+ bản mobileleft:-27px, và title/company muted vớifont-style:italic. oxlint vẫn 11 errors / 9 warnings.pnpm build:resume-allchạy thành công; text củadist/resume.pdfvàdist/resume-vi.pdfkhông chứa chuỗiundefined. - Va chạm hình ảnh do chủ sở hữu báo cáo: border trái của bed chồng lên vòng pulse của marker. Trước đây desktop
left: -14px→ border tại x 22, đúng bằng peak pulse (marker 12px + spread 10px); mobile còn tệ hơn — border tại x 14, nằm trong vùng marker 0–12 cộng halo 4px (tới 16). Nay desktopleft: -10px, mobileleft: -2px→ border nằm tại x 26–28 ở cả hai breakpoint, hở 4px so với pulse. Built CSS xác nhận:.timeline-entry-current:after{…inset:-12px -14px 20px -10px}và bản mobileleft:-2px. - Báo cáo của chủ sở hữu: trên mobile, chữ của node đầu sát mép trái của decoration (gutter 28 nên border accent ở 26–28 chạm đúng chỗ chữ bắt đầu). Cách sửa: node
currentgiờ được trang trí cùng họ với node TLDR — panel--bg-surface+1px solid --border+ radius--radius-lg+ whisper shadow, cạnh trái vẫn là accent 2px — và entry có padding thật (desktop16px 18px 20px, mobile14px 16px 18px) nên chữ nằm trong panel (24px desktop / 18px mobile tính từ border). Divider riêng của node bị bỏ; border của panel đóng khung. Pulse mobile giảm spread 10 → 6px (timeline-status-pulse-sm) để vòng pulse dừng ở x 18, panel border ở 24–26. Built CSS:.timeline-entry-current{…padding:16px 18px 20px;border-bottom:none}+:after{…inset:-10px -10px -10px -8px}và hai override mobilepadding:14px 16px 18px,inset:-8px -8px -8px -4px. - Owner follow-up 2026-10-20 — node → title link: thêm
.timeline-marker::after(hairline 1px từ node vào mép text) cùng 4 rule override (currentdesktop/mobile,gapdesktop/mobile) trongsrc/App.css— xem §Node → Title Link. Không đổi markup, không thêm class, không thêm token màu. Quyết định của chủ sở hữu (2026-10-20): gap giữ hairline muted--border-strong; node current dừng tại mép accent của panel. Verified:tsc -bexit 0;vite buildxanh (out dir tạmdist-verify, đã xoá); built CSS phát hành đúng.timeline-marker:after{content:"";…width:24px},.timeline-entry-current .timeline-marker:after{width:16px},.timeline-entry-gap .timeline-marker:after{background:var(--border-strong);width:25px;left:8px}và ba bản ≤768px16px / 12px / 17px. oxlint exit 0, 4 dòng warning — tất cả có sẵn từ trước, ởFooter.tsx,useLanguage.tsx,useTheme.tsx,Typewriter.tsx, không file nào bị sửa. Chủ sở hữu xem trên trình thật: TODO. - Owner follow-up 2026-10-20 (lần 2) — link mang đúng màu của node: chủ sở hữu chốt chỉ node đầu và node cuối của timeline mang accent; các node ở giữa dùng đúng màu của node.
src/App.css: base.timeline-marker::after→background: var(--border-strong)+transition: background var(--transition-normal); accent giờ đến từ.timeline-entry:first-child .timeline-marker::after(node đầu, cùng màu marker fill + halo--accent-softcủa nó) và từ node TLDR, nơi.timeline-tldr::afterkhông bị đụng tới;.timeline-entry-currentgiữbackground: var(--accent)(node đầu của data hiện tại chính là nodecurrent); rule gap bỏ khai báo màu vì base đã sẵn là--border-strongcủa ring / spine nét đứt / title italic của nó; thêm.timeline-entry:hover .timeline-marker::afterđể link sang accent cùng lúc ring sang accent. Tổng: 5 rule desktop + 3 override ≤768px. Verified:vite buildexit 0 (out dir tạmdist-verify, đã xoá),tsc -bexit 0, oxlint exit 0 / 4 warning cũ. Built CSS đúng thứ tự cascade: basebackground:var(--border-strong),.timeline-entry-current .timeline-marker:after{background:var(--accent);width:16px},.timeline-entry-gap .timeline-marker:after{width:25px;left:8px},.timeline-entry:first-child .timeline-marker:after{background:var(--accent)},.timeline-entry:hover .timeline-marker:after{background:var(--accent)}, rồi ba override ≤768px16px / 12px / 17px;.timeline-tldr:after{…background:var(--accent)…}không đổi. Chủ sở hữu xem trên trình thật: TODO.