diff --git a/docs/design/spec-v2.md b/docs/design/spec-v2.md index d0465e4..81e4989 100644 --- a/docs/design/spec-v2.md +++ b/docs/design/spec-v2.md @@ -17,11 +17,13 @@ | `specs/v2/spec-v2-router-v8.md` | React Router v7 → v8 | ✅ Done | ## Overview -v2 bao gồm 6 tính năng, mỗi tính năng có spec riêng trong `specs/`: +v2 bao gồm 7 tính năng, mỗi tính năng có spec riêng trong `specs/`: | File | Feature | Priority | Est. | Status | |------|---------|----------|------|--------| -| `specs/v2/spec-v2-resume.md` | Resume download | P1 | ~15 min | ✅ Done | +| `specs/v2/spec-v2-resume.md` | Resume download (UI) | P1 | ~15 min | ✅ Done | +| `specs/v2/pdf-resume/spec-v2-resume-playwright.md` | Resume PDF (Playwright) | P1 | ~4 hours | | +| `specs/v2/pdf-resume/spec-v2-resume-puppeteer.md` | Resume PDF (Puppeteer) | P1 | ~4 hours | | | `specs/v2/spec-v2-hero-carousel.md` | Hero visual carousel | P1 | ~1 hour | | | `specs/v2/spec-v2-seo.md` | SEO (metadata, OG, sitemap) | P1 | ~1 hour | | | `specs/v2/spec-v2-blog.md` | Blog (MDX, articles, syntax highlight) | P1 | ~4 hours | | @@ -29,7 +31,7 @@ v2 bao gồm 6 tính năng, mỗi tính năng có spec riêng trong `specs/`: | `specs/v2/spec-v2-testing.md` | Testing (Vitest + E2E) | P5 | ~3 hours | | | `specs/v2/spec-v2-cicd.md` | CI/CD (GitHub Actions) | P5 | ~1 hour | | -**Implementation order:** ~~Resume~~ → Hero Carousel → SEO → Blog → Analytics → Testing → CI/CD +**Implementation order:** ~~Resume~~ → ~~Resume PDF (choose one)~~ → Hero Carousel → SEO → Blog → Analytics → Testing → CI/CD --- @@ -40,7 +42,6 @@ v2 bao gồm 6 tính năng, mỗi tính năng có spec riêng trong `specs/`: - Interactive diagrams / simulations (Phase 5+) - Search functionality (Phase 5+) - Contact form with backend (Phase 5+) -- Resume PDF generation (user uploads manually) --- diff --git a/docs/design/specs/v2/pdf-resume/spec-v2-resume-playwright.md b/docs/design/specs/v2/pdf-resume/spec-v2-resume-playwright.md new file mode 100644 index 0000000..d1c45e9 --- /dev/null +++ b/docs/design/specs/v2/pdf-resume/spec-v2-resume-playwright.md @@ -0,0 +1,988 @@ +# Specification — v2 Resume PDF (Playwright) + +> **Document:** `spec-v2-resume-playwright.md` +> **Version:** 0.4.1 + +--- + +## Requirement + +- Generate `resume.pdf` (A4, multi-page, embedded fonts) during build +- Deployed at `/resume.pdf` (root of `/dist`) +- Download button in Hero CTA and Contact section (already implemented in `spec-v2-resume.md`) +- PDF content: Header (with profile photo), Experience, Skills, Projects (all) + +--- + +## Phases + +### Phase 1: Local Generation (Dev Testing) + +Mục tiêu: Developer có thể generate PDF locally để test layout, content, pagination trước khi push lên CI. + +**Scope**: + +- Tạo `scripts/generate-resume.ts` + `public/resume-template.html` + fonts +- Install `playwright`, `tsx` as `devDependency` +- Manual command: `pnpm tsx scripts/generate-resume.ts` → `dist/resume.pdf` +- **KHÔNG** thêm vào `pnpm build` script +- **KHÔNG** Gitea workflow changes + +**Workflow**: + +``` +git checkout -b feature/resume-pdf +# implement Phase 1 +pnpm tsx scripts/generate-resume.ts # test locally +# verify PDF, iterate +git push && PR +``` + +### Phase 2: Gitea Workflow Integration + +Mục tiêu: PDF tự generate trong CI, deploy cùng site. + +**Scope**: + +- Split `deploy.yml` thành 3 jobs (build / generate-resume / deploy) +- CI cache cho Playwright browser +- Thêm `tsx scripts/generate-resume.ts` vào build pipeline +- Artifact management cho PDF + +**Workflow**: + +``` +git checkout master # sau khi Phase 1 merged +# implement Phase 2 +# push → CI tự generate + deploy PDF +``` + +--- + +## PDF Structure + +### Page 1: Header + Start of Experience + +``` +┌──────────────────────────────────────────┐ +│ [Photo] Dong Nguyen │ +│ Senior Software Engineer │ +│ your.email@example.com │ +│ github.com/... │ +│ linkedin.com/... │ +├──────────────────────────────────────────┤ +│ EXPERIENCE │ +│ │ +│ Senior Software Engineer │ +│ Current Company | 2021 – Present │ +│ Ho Chi Minh City, Vietnam │ +│ │ +│ • System ownership và architecture... │ +│ • Developed IoT-DWS integration... │ +│ • Led system maintenance... │ +│ • Applied Computer Vision... │ +│ • Scrum Master responsibilities... │ +│ │ +│ IoT-DWS Integration System │ +│ Context: Tiếp nhận và nhanh chóng... │ +│ Technical: HTTP integration, HMAC... │ +│ Impact: Giải pháp DWS integration... │ +│ Metrics: 16 sortations deployed │ +│ Tech: Java, HTTP, HMAC, RocketMQ, DWS │ +└──────────────────────────────────────────┘ +``` + +### Page 2+: Remaining Content + +- AWB Detection (if fits with IoT-DWS, else new page) +- System Maintenance (if fits, else new page) +- Skills section (always starts on new page) +- Projects section (each project starts on new page) + +### Section Break Rules + +- **Experience** section starts on a new page (after header) +- **Skills** section starts on a new page +- **Each Project** starts on a new page +- Experience achievements may flow across pages naturally if space permits + +--- + +## Technology + +### Library + +``` +playwright@^1.64.0 # Playwright (Chromium) +tsx@^4.19.0 # TypeScript executor (handles .ts imports in Node) +``` + +- `playwright` full install (includes browser binary ~100MB) +- `tsx` — lightweight TS executor for Node (no install overhead) +- Installed as `devDependency` +- Browser downloaded once, cached in `node_modules/.cache/playwright` + +### Build Machine + +- Gitea runner: `ubuntu-latest` — cần `npx playwright install-deps chromium` cho system dependencies +- Local dev: `npx playwright install chromium` (one-time) +### Font Embedding + +- Font: **Inter** (self-hosted WOFF2) — clean, professional, good Vietnamese support +- Embed via `@font-face` with **base64-encoded WOFF2 inline in HTML** (not relative paths — file:// URLs fail in Playwright PDF) +- Fallback: `system-ui, -apple-system, sans-serif` + +--- + +## File Structure + +``` +scripts/ + generate-resume.ts # Main build script (TS, executed via tsx) +public/ + resume-template.html # HTML template (with {{placeholders}}) + fonts/ + Inter-Regular.woff2 + Inter-Medium.woff2 + Inter-SemiBold.woff2 + Inter-Bold.woff2 + profile-photo.webp +``` + +--- + +## Implementation + +### 1. Font Setup + +Download Inter fonts (4 weights: Regular, Medium, SemiBold, Bold) from Google Fonts. +Place in `public/fonts/` directory. Script reads each file, base64-encodes it, and injects `@font-face` CSS inline into the HTML template. + +**Commit font files into repo** (~50KB total). Do NOT add to `.gitignore`. + +``` +public/fonts/ + Inter-Regular.woff2 + Inter-Medium.woff2 + Inter-SemiBold.woff2 + Inter-Bold.woff2 +``` + +Script generates this CSS at build time: + +```css +@font-face { + font-family: 'Inter'; + font-style: normal; + font-weight: 400; + font-display: swap; + src: url('data:font/woff2;base64,{{FONT_REGULAR_BASE64}}') format('woff2'); +} +@font-face { + font-family: 'Inter'; + font-style: normal; + font-weight: 500; + font-display: swap; + src: url('data:font/woff2;base64,{{FONT_MEDIUM_BASE64}}') format('woff2'); +} +@font-face { + font-family: 'Inter'; + font-style: normal; + font-weight: 600; + font-display: swap; + src: url('data:font/woff2;base64,{{FONT_SEMIBOLD_BASE64}}') format('woff2'); +} +@font-face { + font-family: 'Inter'; + font-style: normal; + font-weight: 700; + font-display: swap; + src: url('data:font/woff2;base64,{{FONT_BOLD_BASE64}}') format('woff2'); +} +``` + +### 2. HTML Template + +`public/resume-template.html` — static template with `{{placeholder}}` tokens: + +```html + + + + + Resume - Dong Nguyen + + + + +
+ Dong Nguyen +
+

{{NAME}}

+
{{TITLE}}
+
+ {{EMAIL}}
+ {{GITHUB}}
+ {{LINKEDIN}} +
+
+
+ + +
+
Experience
+ {{EXPERIENCE}} +
+ + +
+
Skills
+
+ {{SKILLS}} +
+
+ + +
+
Projects
+ {{PROJECTS}} +
+ + +``` + +### 3. Build Script + +`scripts/generate-resume.ts` — executed via `tsx`: + +```typescript +import { chromium } from 'playwright'; +import { readFileSync, existsSync } from 'node:fs'; +import { join, resolve } from 'node:path'; + +const ROOT = resolve(import.meta.dirname, '..'); + +// --- Validate required files --- +const requiredFiles = [ + 'public/profile-photo.webp', + 'public/fonts/Inter-Regular.woff2', + 'public/fonts/Inter-Medium.woff2', + 'public/fonts/Inter-SemiBold.woff2', + 'public/fonts/Inter-Bold.woff2', + 'public/resume-template.html', +]; + +for (const file of requiredFiles) { + if (!existsSync(join(ROOT, file))) { + console.error(`❌ Missing required file: ${file}`); + process.exit(1); + } +} + +// --- Load data (tsx handles .ts imports natively) --- +const { profile } = await import(join(ROOT, 'src/data/profile.ts')); +const { experiences } = await import(join(ROOT, 'src/data/experience.ts')); +const { skillGroups } = await import(join(ROOT, 'src/data/skills.ts')); +const { projects } = await import(join(ROOT, 'src/data/projects.ts')); + + +// --- Read template --- +const template = readFileSync(join(ROOT, 'public/resume-template.html'), 'utf-8'); + +// --- Read and base64-encode assets --- +const photoBase64 = readFileSync(join(ROOT, 'public/profile-photo.webp')).toString('base64'); + +const fonts: Record = {}; +for (const [name, weight] of [ + ['REGULAR', 'Inter-Regular.woff2'], + ['MEDIUM', 'Inter-Medium.woff2'], + ['SEMIBOLD', 'Inter-SemiBold.woff2'], + ['BOLD', 'Inter-Bold.woff2'], +] as const) { + fonts[name] = readFileSync(join(ROOT, 'public/fonts', weight)).toString('base64'); +} + +// --- Generate font-face CSS --- +const fontFaces = Object.entries(fonts).map(([key, b64]) => { + const weightMap: Record = { REGULAR: 400, MEDIUM: 500, SEMIBOLD: 600, BOLD: 700 }; + return `@font-face { + font-family: 'Inter'; + font-style: normal; + font-weight: ${weightMap[key]}; + font-display: swap; + src: url('data:font/woff2;base64,${b64}') format('woff2'); +}`; +}).join('\n'); + +// --- Render HTML helpers --- +function renderExperience(exps: Awaited): string { + return exps.map(exp => ` +
+
+ ${exp.title} + ${exp.duration} +
+
${exp.company}
+ ${exp.location ? `
${exp.location}
` : ''} +
    + ${exp.responsibilities.map(r => `
  • ${r}
  • `).join('')} +
+ ${exp.achievements?.map(ach => ` +
+
${ach.title}
+
${ach.context}
+ ${ach.technicalWork?.length ? ` +
    + ${ach.technicalWork.map(t => `
  • ${t}
  • `).join('')} +
+ ` : ''} +
+ ${ach.technologies.map(t => `${t}`).join('')} +
+ ${ach.impact ? `
${ach.impact}
` : ''} + ${ach.metrics?.length ? `
${ach.metrics.join(', ')}
` : ''} +
+ `).join('')} +
+ `).join(''); +} + +function renderSkills(groups: Awaited): string { + return groups.map(group => ` +
+
${group.title}
+
${group.skills.join(' · ')}
+
+ `).join(''); +} + +function renderProjects(projs: Awaited): string { + return projs.map(project => ` +
+
${project.title}
+
${project.role}
+
${project.summary}
+
+ ${project.technologies.map(t => `${t}`).join('')} +
+ ${project.metrics?.length ? `
${project.metrics.join(', ')}
` : ''} +
+ `).join(''); +} + +// --- Assemble HTML --- +const html = template + .replace('{{NAME}}', profile.name) + .replace('{{TITLE}}', profile.title) + .replace('{{EMAIL}}', profile.email) + .replace('{{GITHUB}}', profile.githubUrl.replace('https://', 'github.com/')) + .replace('{{LINKEDIN}}', profile.linkedinUrl.replace('https://', 'linkedin.com/in/')) + .replace('{{PHOTO_BASE64}}', photoBase64) + .replace('{{FONT_FACES}}', fontFaces) + .replace('{{EXPERIENCE}}', renderExperience(experiences)) + .replace('{{SKILLS}}', renderSkills(skillGroups)) + .replace('{{PROJECTS}}', renderProjects(projects)); + +// --- Generate PDF --- +const browser = await chromium.launch(); +const page = await browser.newPage(); +await page.setContent(html); // No waitUntil needed — all resources inline + +const outputPath = join(ROOT, 'dist/resume.pdf'); +await page.pdf({ + path: outputPath, + format: 'A4', + printBackground: true, + // margin inherited from @page CSS + +await browser.close(); +console.log(`resume.pdf generated at ${outputPath}`); +``` + +### 4. package.json + +**Phase 1** (local dev only): + +```json +{ + "scripts": { + "build": "tsc -b && vite build" + }, + "devDependencies": { + "playwright": "^1.64.0", + "tsx": "^4.19.0" + } +} +``` + +Build script **không** chạy PDF generation. Developer chạy manual: + +```bash +pnpm tsx scripts/generate-resume.ts +``` + +**Phase 2** (CI integration): + +```json +{ + "scripts": { + "build": "tsc -b && vite build && tsx scripts/generate-resume.ts" + } +} +``` + +### Data Detection + +`src/data/resume.ts` — controls whether download button is visible in UI: + +```ts +// src/data/resume.ts +export const resumeAvailable = true // set false when PDF not yet deployed +``` + +**Phase 1 (dev):** Hardcoded boolean. Developer sets `false` locally until PDF is ready, +sets `true` after deployment to verify the button appears. + +**Phase 2 (CI):** After CI generates and deploys `dist/resume.pdf`, the button +will show because `/resume.pdf` exists on the server. + +> ⚠️ Do NOT use `existsSync` — this file is bundled by Vite for the browser. +> Node.js `fs` APIs are unavailable in browser runtime. + +--- + +## Acceptance Criteria + +### Phase 1 + +- [ ] `pnpm tsx scripts/generate-resume.ts` produces `dist/resume.pdf` +- [ ] PDF is A4 size, multi-page with correct pagination +- [ ] Header contains profile photo (circular crop), name, title, contact info +- [ ] Experience section includes all companies, roles, responsibilities, achievements (with technicalWork bullets) +- [ ] Skills section includes all skill groups +- [ ] All projects included (not just featured) +- [ ] Sections do not split across pages (achievements, projects, skill groups use `page-break-inside: avoid`) +- [ ] Experience section starts on a new page after header +- [ ] Skills section starts on a new page +- [ ] Each project starts on a new page +- [ ] Fonts are embedded (Inter, 4 weights, base64 inline) +- [ ] PDF is readable and well-formatted (no overflow, text not cut off) +- [ ] Works locally on Windows dev machine +- [ ] `pnpm build` still works (no PDF in build output) +- [ ] Script exits with error if required files are missing + +### Phase 2 + +- [ ] `pnpm build` produces `dist/resume.pdf` (auto-generated) +- [ ] Works in Gitea CI (`ubuntu-latest`) +- [ ] CI cache reduces Playwright install to 0s after first run +- [ ] Download button shows in Hero and Contact sections +- [ ] PDF deployed to `/resume.pdf` (root of `/dist`) + +--- + +## Tradeoffs + +### Phase 1 + +| Aspect | Detail | +|--------|--------| +| Install overhead | ~110MB (playwright + tsx) | +| Manual command | `pnpm tsx scripts/generate-resume.ts` | +| Build time | Not in `pnpm build` — developer controlled | +| CSS control | Full CSS (same as website) | +| Font embedding | Base64 in HTML, increases HTML size ~50KB | +| Photo | Inline base64 (avoids file:// URL issues) | +| Platform | Works on Windows local, Ubuntu CI | + +### Phase 2 + +| Aspect | Detail | +|--------|--------| +| CI build time | +5-10s (download once cached, render ~2s) | +| CI first run | +60s (download Playwright browser) | +| CI subsequent | +5-10s (cache hit) | +| Workflow complexity | 3 jobs (build / generate-resume / deploy) | +| Failure isolation | PDF error does not block site deploy | + +--- + +## Future Enhancements + +### Phase 2+: Gitea Workflow +**Current** (`deploy.yml` — Phase 1): + +```yaml +name: Deploy Static Site + +on: + push: + branches: [master] + +jobs: + build and deploy: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v7 + - uses: pnpm/setup@v3 + with: + cache: true + version: ^12.0.0 + runtime: node@24 + - run: pnpm build + - name: rsync deployments + uses: burnett01/rsync-deployments@v9 + with: + debug: true + switches: -avzr --delete + path: dist/ + remote_path: /opt/stacks/dong-site/dist/ + remote_host: ${{ secrets.DEPLOY_HOST }} + remote_port: ${{ secrets.DEPLOY_SSH_PORT }} + remote_user: ${{ secrets.DEPLOY_USER }} + remote_key: ${{ secrets.DEPLOY_SSH_PRIVATE_KEY }} +``` + +**Phase 2** (3 jobs split): + +```yaml +name: Deploy Static Site + +on: + push: + branches: [master] + +jobs: + build: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v7 + - uses: pnpm/setup@v3 + with: + cache: true + version: ^12.0.0 + runtime: node@24 + - run: pnpm build # tsc -b && vite build (không có PDF) + - uses: actions/upload-artifact@v4 + with: + name: static-site + path: dist/ + retention-days: 5 + + generate-resume: + runs-on: ubuntu-latest + needs: build + steps: + - uses: actions/checkout@v7 + - uses: pnpm/setup@v3 + with: + cache: true + version: ^12.0.0 + runtime: node@24 + + # Cache Playwright browser — download 1 lần, reuse các lần sau + - name: Cache Playwright browser + uses: actions/cache@v4 + with: + path: ~/.cache/ms-playwright + key: playwright-${{ runner.os }}-${{ hashFiles('pnpm-lock.yaml') }} + restore-keys: | + playwright-${{ runner.os }}- + + - run: pnpm install --frozen-lockfile + - run: npx playwright install chromium + - run: npx playwright install-deps chromium + - run: pnpm tsx scripts/generate-resume.ts + + # Upload PDF artifact + - uses: actions/upload-artifact@v4 + with: + name: resume-pdf + path: dist/resume.pdf + retention-days: 30 + + deploy: + runs-on: ubuntu-latest + needs: [build, generate-resume] + steps: + - uses: actions/download-artifact@v4 + with: + name: static-site + path: dist/ + + - uses: actions/download-artifact@v4 + with: + name: resume-pdf + path: dist/ + + - name: rsync deployments + uses: burnett01/rsync-deployments@v9 + with: + debug: true + switches: -avzr --delete + path: dist/ + remote_path: /opt/stacks/dong-site/dist/ + remote_host: ${{ secrets.DEPLOY_HOST }} + remote_port: ${{ secrets.DEPLOY_SSH_PORT }} + remote_user: ${{ secrets.DEPLOY_USER }} + remote_key: ${{ secrets.DEPLOY_SSH_PRIVATE_KEY }} +``` + +**Job dependency graph**: + +``` +build ──────────────┐ + ├──→ deploy +generate-resume ────┘ +``` + +**Key decisions**: + +- `generate-resume` depends on `build` (chỉ cần checkout, không cần artifact) +- `deploy` depends on cả 2 jobs — đảm bảo cả site + PDF sẵn sàng +- Artifact retention: site 5 ngày, PDF 30 ngày +- Cache key dựa trên `pnpm-lock.yaml` — invalidate khi dependency thay đổi +- `npx playwright install chromium` — install vào `~/.cache/ms-playwright` (khác với `node_modules/.cache`) +- `dist/` từ artifact overwrite lẫn nhau — `resume.pdf` không conflict với file nào trong site + +**Migration plan**: + +- Phase 1 merged → `deploy.yml` unchanged +- Phase 2: replace `deploy.yml` với 3-job version +- Update `package.json` scripts thêm `tsx scripts/generate-resume.ts` +- First CI run: +60s (download browser), subsequent: +5-10s (cache hit) +- Monitor: check `dist/` trên server có `resume.pdf` sau deploy + + +### PDF Metadata + +Đặt metadata trong `page.pdf()` options: + +```typescript +await page.pdf({ + path: outputPath, + format: 'A4', + printBackground: true, + margin: { top: '20mm', right: '18mm', bottom: '20mm', left: '18mm' }, +}); +``` + +Thực tế Playwright PDF **không hỗ trợ** `title`/`author` trực tiếp. Alternative: +- Inject `` tags trong HTML (chỉ hiển thị trong browser print dialog) +- Dùng `pdf-lib` sau khi generate để set metadata (thêm dependency) + +**Recommendation**: Bỏ qua metadata — resume PDF không cần metadata chuyên nghiệp. + +### Version Stamping + +Thêm footer "Last updated: YYYY-MM-DD" vào mỗi trang PDF. + +**Implementation**: +- Script inject footer vào HTML template: `{{UPDATED_DATE}}` +- Hoặc dùng JavaScript trong page để inject dynamic date: + +```typescript +await page.evaluate((date: string) => { + const footer = document.createElement('div'); + footer.className = 'pdf-footer'; + footer.textContent = `Last updated: ${date}`; + document.body.appendChild(footer); +}, new Date().toISOString().slice(0, 10)); +``` + +**CSS**: +```css +.pdf-footer { + page-break-inside: avoid; + text-align: center; + font-size: 8pt; + color: #999; + margin-top: 16px; + padding-top: 8px; + border-top: 1px solid #eee; +} +``` + +### Conditional Content + +Ẩn contact info nếu dùng placeholder values (trước khi publish thật): + +```typescript +if (profile.email === 'your.email@example.com') { + console.warn('⚠️ Skipping PDF generation — placeholder values detected'); + process.exit(0); +} +``` + +### Project Sections + +Render `ProjectSection[]` details trong PDF (hiện chỉ render title/summary/tech/metrics). + +Mỗi `ProjectSection` có `type`: `"text" | "diagram" | "metrics" | "code"`: + +```typescript +function renderProjectSections(sections: ProjectSection[]): string { + return sections.map(s => { + switch (s.type) { + case 'text': + return `
${s.content}
`; + case 'diagram': + return `
${s.content}
`; + case 'metrics': + return `
${s.content}
`; + case 'code': + return `
${s.content}
`; + } + }).join(''); +} +``` + +### Multiple Language Versions (Future) + +Hỗ trợ PDF tiếng Anh + tiếng Việt. Hiện tại chỉ English. + +**Approach**: +- Duplicate template: `resume-template-en.html`, `resume-template-vi.html` +- Script chạy 2 lần, output `resume-en.pdf`, `resume-vi.pdf` +- Data modules xuất cả 2 ngôn ngữ: `profile.nameEn`, `profile.nameVi` diff --git a/docs/design/specs/v2/pdf-resume/spec-v2-resume-puppeteer.md b/docs/design/specs/v2/pdf-resume/spec-v2-resume-puppeteer.md new file mode 100644 index 0000000..f9f1878 --- /dev/null +++ b/docs/design/specs/v2/pdf-resume/spec-v2-resume-puppeteer.md @@ -0,0 +1,626 @@ +# Specification — v2 Resume PDF (Puppeteer) + +> **Document:** `spec-v2-resume-puppeteer.md` +> **Version:** 0.1.0 +> **Parent:** `spec-v2-resume.md` +> **Priority:** P1 +> **Estimate:** ~4 hours + +--- + +## Requirement + +- Generate `resume.pdf` (A4, multi-page, embedded fonts) during build +- Deployed at `/resume.pdf` (root of `/dist`) +- Download button in Hero CTA and Contact section (already implemented in `spec-v2-resume.md`) +- PDF content: Header (with profile photo), Experience, Skills, Projects (all) + +--- + +## PDF Structure + +### Page 1: Header + Start of Experience + +``` +┌──────────────────────────────────────────┐ +│ [Photo] Dong Nguyen │ +│ Senior Software Engineer │ +│ your.email@example.com │ +│ github.com/... │ +│ linkedin.com/... │ +├──────────────────────────────────────────┤ +│ EXPERIENCE │ +│ │ +│ Senior Software Engineer │ +│ Current Company | 2021 – Present │ +│ Ho Chi Minh City, Vietnam │ +│ │ +│ • System ownership và architecture... │ +│ • Developed IoT-DWS integration... │ +│ • Led system maintenance... │ +│ • Applied Computer Vision... │ +│ • Scrum Master responsibilities... │ +│ │ +│ IoT-DWS Integration System │ +│ Context: Tiếp nhận và nhanh chóng... │ +│ Technical: HTTP integration, HMAC... │ +│ Impact: Giải pháp DWS integration... │ +│ Metrics: 16 sortations deployed │ +│ Tech: Java, HTTP, HMAC, RocketMQ, DWS │ +└──────────────────────────────────────────┘ +``` + +### Page 2+: Remaining Content + +- AWB Detection (if fits with IoT-DWS, else new page) +- System Maintenance (if fits, else new page) +- Skills section (always starts on new page) +- Projects section (each project starts on new page) + +### Section Break Rules + +- **Experience** section starts on a new page (after header) +- **Skills** section starts on a new page +- **Each Project** starts on a new page +- Experience achievements may flow across pages naturally if space permits + +--- + +## Technology + +### Library + +``` +puppeteer@^25.13.0 # Puppeteer (bundled Chromium) +``` + +- `puppeteer` full package (includes Chromium ~100MB) +- Installed as `devDependency` +- Chromium downloaded once, cached in `~/.cache/puppeteer` + +### Build Machine + +- Gitea runner: `ubuntu-latest` +- Puppeteer auto-installs Chromium on first run, cached in CI + +### Font Embedding + +- Font: **Inter** (Google Fonts) — clean, professional, good Vietnamese support +- Embed via `@font-face` with base64-encoded WOFF2 in HTML template +- Fallback: `system-ui, -apple-system, sans-serif` + +--- + +## File Structure + + +``` +scripts/ + generate-resume.mjs # Main build script +public/ + resume-template.html # HTML template (with {{placeholders}}) + resume.css # PDF-specific CSS styles + fonts/ + Inter-Regular.woff2 + Inter-Medium.woff2 + Inter-SemiBold.woff2 + Inter-Bold.woff2 +src/ + data/ + resume.ts # Export: resumeAvailable = true +``` + +--- + +## Implementation + +### 1. Font Setup + +Download Inter fonts (4 weights: Regular, Medium, SemiBold, Bold) from Google Fonts. +Place WOFF2 files in `public/fonts/` directory. +CSS `@font-face` rules use relative `url()` paths to serve fonts directly. + +```css +@font-face { + font-family: 'Inter'; + font-style: normal; + font-weight: 400; + font-display: swap; + src: url('./fonts/Inter-Regular.woff2') format('woff2'); +} +@font-face { + font-family: 'Inter'; + font-style: normal; + font-weight: 500; + font-display: swap; + src: url('./fonts/Inter-Medium.woff2') format('woff2'); +} +@font-face { + font-family: 'Inter'; + font-style: normal; + font-weight: 600; + font-display: swap; + src: url('./fonts/Inter-SemiBold.woff2') format('woff2'); +} +@font-face { + font-family: 'Inter'; + font-style: normal; + font-weight: 700; + font-display: swap; + src: url('./fonts/Inter-Bold.woff2') format('woff2'); +} +``` + +### 2. CSS File + +`public/resume.css` — all PDF-specific styles. Referenced from HTML via ``. + +```css +/* Page layout */ +@page { + size: A4; + margin: 20mm 18mm 20mm 18mm; +} + +/* Reset */ +*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; } + +body { + font-family: 'Inter', system-ui, -apple-system, sans-serif; + font-size: 10pt; + line-height: 1.5; + color: #1a1a1a; +} + +/* Header — avoid break inside */ +.header { + display: flex; + align-items: center; + gap: 16px; + padding-bottom: 12px; + border-bottom: 2px solid #1a1a1a; + margin-bottom: 16px; + page-break-inside: avoid; +} + +.header-photo { + width: 72px; + height: 72px; + border-radius: 50%; + object-fit: cover; + flex-shrink: 0; +} + +.header-info h1 { + font-size: 18pt; + font-weight: 700; + color: #1a1a1a; +} + +.header-info .title { + font-size: 11pt; + font-weight: 500; + color: #4a4a4a; + margin-bottom: 4px; +} + +.header-info .contact { + font-size: 9pt; + color: #666; + line-height: 1.6; +} + +/* Section page breaks use explicit .page-break class */ +.page-break { page-break-before: always; } + +.section-title { + font-size: 12pt; + font-weight: 700; + text-transform: uppercase; + letter-spacing: 0.5pt; + color: #1a1a1a; + padding-bottom: 4px; + border-bottom: 1px solid #ccc; + margin-bottom: 10px; +} + +/* Experience — avoid break inside */ +.exp-entry { + margin-bottom: 12px; + page-break-inside: avoid; +} + +.exp-header { + display: flex; + justify-content: space-between; + align-items: baseline; + margin-bottom: 2px; +} + +.exp-title { + font-weight: 600; + font-size: 11pt; + color: #1a1a1a; +} + +.exp-duration { + font-size: 9pt; + color: #666; + white-space: nowrap; +} + +.exp-company { + font-size: 10pt; + color: #4a4a4a; + margin-bottom: 2px; +} + +.exp-location { + font-size: 9pt; + color: #888; + margin-bottom: 4px; +} + +.exp-responsibilities { + list-style: disc; + padding-left: 16px; + margin-bottom: 6px; +} + +.exp-responsibilities li { + font-size: 9.5pt; + margin-bottom: 2px; +} + +/* Achievement — avoid break inside */ +.achievement { + margin-left: 12px; + margin-bottom: 8px; + page-break-inside: avoid; +} + +.achievement-title { + font-weight: 600; + font-size: 10pt; + color: #1a1a1a; + margin-bottom: 2px; +} + +.achievement-context { + font-size: 9pt; + color: #4a4a4a; + margin-bottom: 2px; + font-style: italic; +} + +.achievement-tech { + font-size: 8.5pt; + color: #666; +} + +.achievement-tech span { + display: inline-block; + background: #f0f0f0; + padding: 0 4px; + border-radius: 2px; + margin-right: 4px; +} + +.achievement-metrics { + font-size: 9pt; + color: #4a4a4a; + margin-top: 2px; +} + +/* Skills */ +.skills-grid { + display: grid; + grid-template-columns: 1fr 1fr; + gap: 8px 24px; +} + +.skill-group-title { + font-weight: 600; + font-size: 10pt; + color: #1a1a1a; + margin-bottom: 2px; +} + +.skill-list { + font-size: 9pt; + color: #4a4a4a; + line-height: 1.5; +} + +/* Skill group — avoid break inside */ +.skill-group { page-break-inside: avoid; } + +/* Projects — avoid break inside */ +.project { + margin-bottom: 12px; + page-break-inside: avoid; +} + +.project-title { + font-weight: 600; + font-size: 11pt; + color: #1a1a1a; +} + +.project-role { + font-size: 9pt; + color: #666; + margin-bottom: 2px; +} + +.project-summary { + font-size: 9.5pt; + color: #4a4a4a; + margin-bottom: 4px; +} + +.project-tech { + font-size: 8.5pt; + color: #666; +} + +.project-tech span { + display: inline-block; + background: #f0f0f0; + padding: 0 4px; + border-radius: 2px; + margin-right: 4px; +} + +.project-metrics { + font-size: 9pt; + color: #4a4a4a; + margin-top: 2px; +} +``` + +### 3. HTML Template + +`public/resume-template.html` — static template with `{{placeholder}}` tokens. +References external `resume.css` and uses explicit `.page-break` classes for pagination. + +```html + + + + + Resume - Dong Nguyen + + + + +
+ Dong Nguyen +
+

{{NAME}}

+
{{TITLE}}
+
+ {{EMAIL}}
+ {{GITHUB}}
+ {{LINKEDIN}} +
+
+
+ + +
+
Experience
+ {{EXPERIENCE}} +
+ + +
+
Skills
+
+ {{SKILLS}} +
+
+ + +
+
Projects
+ {{PROJECTS}} +
+ + +``` + +### 3. Build Script + +`scripts/generate-resume.mjs`: + +```javascript +import puppeteer from 'puppeteer'; +import { readFileSync, writeFileSync } from 'node:fs'; +import { fileURLToPath } from 'node:url'; +import { dirname, join } from 'node:path'; + +const __dirname = dirname(fileURLToPath(import.meta.url)); +const ROOT = join(__dirname, '..'); + +// Import data modules (ESM) +const { profile } = await import(join(ROOT, 'src/data/profile.ts')); +const { experiences } = await import(join(ROOT, 'src/data/experience.ts')); +const { skillGroups } = await import(join(ROOT, 'src/data/skills.ts')); +const { projects } = await import(join(ROOT, 'src/data/projects.ts')); + +// Read template +const template = readFileSync(join(ROOT, 'public/resume-template.html'), 'utf-8'); + +// Read and encode photo +const photoPath = join(ROOT, 'public/profile-photo.webp'); +const photoBase64 = readFileSync(photoPath).toString('base64'); + +// Render HTML +const html = template + .replace('{{NAME}}', profile.name) + .replace('{{TITLE}}', profile.title) + .replace('{{EMAIL}}', profile.email) + .replace('{{GITHUB}}', profile.githubUrl.replace('https://', 'github.com/')) + .replace('{{LINKEDIN}}', profile.linkedinUrl.replace('https://', 'linkedin.com/in/')) + .replace('{{PHOTO_BASE64}}', photoBase64) + .replace('{{EXPERIENCE}}', renderExperience(experiences)) + .replace('{{SKILLS}}', renderSkills(skillGroups)) + .replace('{{PROJECTS}}', renderProjects(projects)); + +// Generate PDF +const browser = await puppeteer.launch({ + headless: 'new', + args: ['--no-sandbox', '--disable-setuid-sandbox'], +}); +const page = await browser.newPage(); +await page.setContent(html, { waitUntil: 'networkidle' }); + +await page.pdf({ + path: join(ROOT, 'dist/resume.pdf'), + format: 'A4', + printBackground: true, + margin: { top: '20mm', right: '18mm', bottom: '20mm', left: '18mm' }, +}); + +await browser.close(); +console.log('resume.pdf generated at dist/resume.pdf'); +``` + +### 4. HTML Render Helpers + +Helper functions in `scripts/resume-html.ts`: + +```typescript +// Renders experience section HTML string +function renderExperience(experiences: ExperienceEntry[]): string { + return experiences.map(exp => ` +
+
+ ${exp.title} + ${exp.duration} +
+
${exp.company}
+ ${exp.location ? `
${exp.location}
` : ''} +
    + ${exp.responsibilities.map(r => `
  • ${r}
  • `).join('')} +
+ ${exp.achievements?.map(ach => ` +
+
${ach.title}
+
${ach.context}
+
+ ${ach.technologies.map(t => `${t}`).join('')} +
+ ${ach.impact ? `
${ach.impact}
` : ''} + ${ach.metrics?.length ? `
${ach.metrics.join(', ')}
` : ''} +
+ `).join('')} +
+ `).join(''); +} + +// Renders skills section HTML string +function renderSkills(skillGroups: SkillGroup[]): string { + return skillGroups.map(group => ` +
+
${group.title}
+
${group.skills.join(' · ')}
+
+ `).join(''); +} + +// Renders projects section HTML string +function renderProjects(projects: ProjectDetail[]): string { + return projects.map(project => ` +
+
${project.title}
+
${project.role}
+
${project.summary}
+
+ ${project.technologies.map(t => `${t}`).join('')} +
+ ${project.metrics?.length ? `
${project.metrics.join(', ')}
` : ''} +
+ `).join(''); +} +``` + +### 5. Data Detection + +Update `src/data/resume.ts`: + +```typescript +export const resumeAvailable = true; +``` + +### 6. package.json + +```json +{ + "scripts": { + "build": "tsc -b && vite build && node scripts/generate-resume.mjs" + }, + "devDependencies": { + "puppeteer": "^24.0.0" + } +} +``` + +--- + +## Acceptance Criteria + +- [ ] `pnpm build` produces `dist/resume.pdf` +- [ ] PDF is A4 size, multi-page with correct pagination +- [ ] Header contains profile photo (circular crop), name, title, contact info +- [ ] Experience section includes all companies, roles, responsibilities, achievements +- [ ] Skills section includes all skill groups +- [ ] All projects included (not just featured) +- [ ] Sections do not split across pages (achievements, projects, skill groups use `page-break-inside: avoid`) +- [ ] Fonts are embedded (Inter, 4 weights) +- [ ] PDF is readable and well-formatted (no overflow, text not cut off) +- [ ] Works in Gitea CI (`ubuntu-latest`) +- [ ] Works locally on Windows dev machine +- [ ] Download button shows in Hero and Contact sections + +--- + +## Tradeoffs + +| Aspect | Detail | +|--------|--------| +| Bundle size | ~100MB (Puppeteer + Chromium) | +| Build time | +10-20s (download once cached, render ~2s) | +| CSS control | Full CSS (same as website) | +| Font embedding | Base64 in HTML, increases HTML size ~50KB | +| Photo | Inline base64 (avoids file:// URL issues) | +| Platform | Works on Ubuntu CI, Windows local | + +--- + +## Puppeteer vs Playwright Comparison + +| Aspect | Puppeteer | Playwright | +|--------|-----------|------------| +| Package | `puppeteer` | `playwright` | +| Size | ~100MB | ~100MB | +| API | `puppeteer.launch()` | `chromium.launch()` | +| PDF API | `page.pdf()` | `page.pdf()` | +| CSS support | Full (Chromium) | Full (Chromium) | +| CI support | Excellent | Excellent | +| Community | Larger, more examples | Growing rapidly | +| TypeScript | Built-in types | Built-in types | +| Headless flags | `--no-sandbox` needed for CI | `--no-sandbox` via config | + +Both produce identical PDF output (same Chromium engine). Choice is preference. + +--- + +## Future Enhancements + +1. **Gitea workflow**: Move script execution into `deploy.yml` for cleaner separation +2. **CI caching**: Cache Puppeteer Chromium in Gitea workflow +3. **PDF metadata**: Set PDF title, author, creator +4. **Version stamping**: Add "Last updated: YYYY-MM-DD" to footer +5. **Conditional content**: Hide contact info if placeholder values detected diff --git a/package.json b/package.json index c458609..5113629 100644 --- a/package.json +++ b/package.json @@ -21,6 +21,8 @@ "@types/react-dom": "^19.2.7", "@vitejs/plugin-react": "^6.1.1", "oxlint": "^1.81.0", + "playwright": "^1.64.0", + "tsx": "^4.23.15", "typescript": "~6.0.2", "vite": "^8.3.0" } diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml index 78ec43e..e62aad2 100644 --- a/pnpm-lock.yaml +++ b/pnpm-lock.yaml @@ -190,19 +190,181 @@ importers: version: 19.3.0(@types/react@19.3.0) '@vitejs/plugin-react': specifier: ^6.1.1 - version: 6.1.1(vite@8.3.2(@types/node@24.19.1)) + version: 6.1.1(vite@8.3.2(@types/node@24.19.1)(esbuild@0.28.2)(tsx@4.23.15)) oxlint: specifier: ^1.81.0 version: 1.86.0 + playwright: + specifier: ^1.64.0 + version: 1.64.0 + tsx: + specifier: ^4.23.15 + version: 4.23.15 typescript: specifier: ~6.0.2 version: 6.0.3 vite: specifier: ^8.3.0 - version: 8.3.2(@types/node@24.19.1) + version: 8.3.2(@types/node@24.19.1)(esbuild@0.28.2)(tsx@4.23.15) packages: + '@esbuild/aix-ppc64@0.28.2': + resolution: {integrity: sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==} + engines: {node: '>=18'} + cpu: [ppc64] + os: [aix] + + '@esbuild/android-arm64@0.28.2': + resolution: {integrity: sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==} + engines: {node: '>=18'} + cpu: [arm64] + os: [android] + + '@esbuild/android-arm@0.28.2': + resolution: {integrity: sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==} + engines: {node: '>=18'} + cpu: [arm] + os: [android] + + '@esbuild/android-x64@0.28.2': + resolution: {integrity: sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==} + engines: {node: '>=18'} + cpu: [x64] + os: [android] + + '@esbuild/darwin-arm64@0.28.2': + resolution: {integrity: sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==} + engines: {node: '>=18'} + cpu: [arm64] + os: [darwin] + + '@esbuild/darwin-x64@0.28.2': + resolution: {integrity: sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==} + engines: {node: '>=18'} + cpu: [x64] + os: [darwin] + + '@esbuild/freebsd-arm64@0.28.2': + resolution: {integrity: sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==} + engines: {node: '>=18'} + cpu: [arm64] + os: [freebsd] + + '@esbuild/freebsd-x64@0.28.2': + resolution: {integrity: sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==} + engines: {node: '>=18'} + cpu: [x64] + os: [freebsd] + + '@esbuild/linux-arm64@0.28.2': + resolution: {integrity: sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==} + engines: {node: '>=18'} + cpu: [arm64] + os: [linux] + + '@esbuild/linux-arm@0.28.2': + resolution: {integrity: sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==} + engines: {node: '>=18'} + cpu: [arm] + os: [linux] + + '@esbuild/linux-ia32@0.28.2': + resolution: {integrity: sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==} + engines: {node: '>=18'} + cpu: [ia32] + os: [linux] + + '@esbuild/linux-loong64@0.28.2': + resolution: {integrity: sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==} + engines: {node: '>=18'} + cpu: [loong64] + os: [linux] + + '@esbuild/linux-mips64el@0.28.2': + resolution: {integrity: sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==} + engines: {node: '>=18'} + cpu: [mips64el] + os: [linux] + + '@esbuild/linux-ppc64@0.28.2': + resolution: {integrity: sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==} + engines: {node: '>=18'} + cpu: [ppc64] + os: [linux] + + '@esbuild/linux-riscv64@0.28.2': + resolution: {integrity: sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==} + engines: {node: '>=18'} + cpu: [riscv64] + os: [linux] + + '@esbuild/linux-s390x@0.28.2': + resolution: {integrity: sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==} + engines: {node: '>=18'} + cpu: [s390x] + os: [linux] + + '@esbuild/linux-x64@0.28.2': + resolution: {integrity: sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==} + engines: {node: '>=18'} + cpu: [x64] + os: [linux] + + '@esbuild/netbsd-arm64@0.28.2': + resolution: {integrity: sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==} + engines: {node: '>=18'} + cpu: [arm64] + os: [netbsd] + + '@esbuild/netbsd-x64@0.28.2': + resolution: {integrity: sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==} + engines: {node: '>=18'} + cpu: [x64] + os: [netbsd] + + '@esbuild/openbsd-arm64@0.28.2': + resolution: {integrity: sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==} + engines: {node: '>=18'} + cpu: [arm64] + os: [openbsd] + + '@esbuild/openbsd-x64@0.28.2': + resolution: {integrity: sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==} + engines: {node: '>=18'} + cpu: [x64] + os: [openbsd] + + '@esbuild/openharmony-arm64@0.28.2': + resolution: {integrity: sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==} + engines: {node: '>=18'} + cpu: [arm64] + os: [openharmony] + + '@esbuild/sunos-x64@0.28.2': + resolution: {integrity: sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==} + engines: {node: '>=18'} + cpu: [x64] + os: [sunos] + + '@esbuild/win32-arm64@0.28.2': + resolution: {integrity: sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==} + engines: {node: '>=18'} + cpu: [arm64] + os: [win32] + + '@esbuild/win32-ia32@0.28.2': + resolution: {integrity: sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==} + engines: {node: '>=18'} + cpu: [ia32] + os: [win32] + + '@esbuild/win32-x64@0.28.2': + resolution: {integrity: sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==} + engines: {node: '>=18'} + cpu: [x64] + os: [win32] + '@oxc-project/types@0.152.0': resolution: {integrity: sha512-oM/5rLBm2tPkg0iBgkH/FOeR3PCDpY19GTgAZjMFM8h9WI9VW7cLgzp6nwtarYKmovavIQZ+Fe/RKX/8C8O/Rw==} @@ -467,6 +629,11 @@ packages: resolution: {integrity: sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==} engines: {node: '>=8'} + esbuild@0.28.2: + resolution: {integrity: sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==} + engines: {node: '>=18'} + hasBin: true + fdir@6.5.0: resolution: {integrity: sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==} engines: {node: '>=12.0.0'} @@ -608,6 +775,16 @@ packages: resolution: {integrity: sha512-qcJu88Q2IWqJsDD529JKMdwGm/dvInW4HvQnRwiH9JtihJvzGOscDtHE3x1pBKeUOTysQ8kVmLnJ2kJu7yhcGA==} engines: {node: '>=12'} + playwright-core@1.64.0: + resolution: {integrity: sha512-T9r+MZkTECl2+oUcZ26YgZzTrYidTsIhYYkJix+6iDOymOb1FB2RLLSOxRGnZGv5DStt+aduIVbt+E8WygXYpg==} + engines: {node: '>=20'} + hasBin: true + + playwright@1.64.0: + resolution: {integrity: sha512-kVzTnYFYEyQ9RGzBjNCd2+yEqWmVbxl3AHPynv3qQ6JTjv4a+kwRcnqQwIpuP3NnrnIrE/Q6wWAIAvMfIE2/Yg==} + engines: {node: '>=20'} + hasBin: true + postcss@8.5.28: resolution: {integrity: sha512-RRuzqDtt5Y9h3quz5hWhK+TPnsmVs6WwSU6LkJMeY4HstUEDuYTG8UJSdawMRzmzAtV+KEoG8N3Qg2qLy5vM/A==} engines: {node: ^10 || ^12 || >=14} @@ -650,6 +827,11 @@ packages: tslib@2.8.1: resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==} + tsx@4.23.15: + resolution: {integrity: sha512-Yiex1Ovn8z2xPpOWckIiysV1SSyRMY9BkLF++q0yKiDxCqRhosKfMg3janKkiLBwZ5c/YryloKwGZcrEmtwxKw==} + engines: {node: '>=18.0.0'} + hasBin: true + typescript@6.0.3: resolution: {integrity: sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw==} engines: {node: '>=14.17'} @@ -703,6 +885,84 @@ packages: snapshots: + '@esbuild/aix-ppc64@0.28.2': + optional: true + + '@esbuild/android-arm64@0.28.2': + optional: true + + '@esbuild/android-arm@0.28.2': + optional: true + + '@esbuild/android-x64@0.28.2': + optional: true + + '@esbuild/darwin-arm64@0.28.2': + optional: true + + '@esbuild/darwin-x64@0.28.2': + optional: true + + '@esbuild/freebsd-arm64@0.28.2': + optional: true + + '@esbuild/freebsd-x64@0.28.2': + optional: true + + '@esbuild/linux-arm64@0.28.2': + optional: true + + '@esbuild/linux-arm@0.28.2': + optional: true + + '@esbuild/linux-ia32@0.28.2': + optional: true + + '@esbuild/linux-loong64@0.28.2': + optional: true + + '@esbuild/linux-mips64el@0.28.2': + optional: true + + '@esbuild/linux-ppc64@0.28.2': + optional: true + + '@esbuild/linux-riscv64@0.28.2': + optional: true + + '@esbuild/linux-s390x@0.28.2': + optional: true + + '@esbuild/linux-x64@0.28.2': + optional: true + + '@esbuild/netbsd-arm64@0.28.2': + optional: true + + '@esbuild/netbsd-x64@0.28.2': + optional: true + + '@esbuild/openbsd-arm64@0.28.2': + optional: true + + '@esbuild/openbsd-x64@0.28.2': + optional: true + + '@esbuild/openharmony-arm64@0.28.2': + optional: true + + '@esbuild/sunos-x64@0.28.2': + optional: true + + '@esbuild/win32-arm64@0.28.2': + optional: true + + '@esbuild/win32-ia32@0.28.2': + optional: true + + '@esbuild/win32-x64@0.28.2': + optional: true + '@oxc-project/types@0.152.0': {} '@oxlint/binding-android-arm-eabi@1.86.0': @@ -823,10 +1083,10 @@ snapshots: dependencies: csstype: 3.2.3 - '@vitejs/plugin-react@6.1.1(vite@8.3.2(@types/node@24.19.1))': + '@vitejs/plugin-react@6.1.1(vite@8.3.2(@types/node@24.19.1)(esbuild@0.28.2)(tsx@4.23.15))': dependencies: '@rolldown/pluginutils': 1.0.1 - vite: 8.3.2(@types/node@24.19.1) + vite: 8.3.2(@types/node@24.19.1)(esbuild@0.28.2)(tsx@4.23.15) cookie-es@3.1.1: {} @@ -834,6 +1094,35 @@ snapshots: detect-libc@2.1.2: {} + esbuild@0.28.2: + optionalDependencies: + '@esbuild/aix-ppc64': 0.28.2 + '@esbuild/android-arm': 0.28.2 + '@esbuild/android-arm64': 0.28.2 + '@esbuild/android-x64': 0.28.2 + '@esbuild/darwin-arm64': 0.28.2 + '@esbuild/darwin-x64': 0.28.2 + '@esbuild/freebsd-arm64': 0.28.2 + '@esbuild/freebsd-x64': 0.28.2 + '@esbuild/linux-arm': 0.28.2 + '@esbuild/linux-arm64': 0.28.2 + '@esbuild/linux-ia32': 0.28.2 + '@esbuild/linux-loong64': 0.28.2 + '@esbuild/linux-mips64el': 0.28.2 + '@esbuild/linux-ppc64': 0.28.2 + '@esbuild/linux-riscv64': 0.28.2 + '@esbuild/linux-s390x': 0.28.2 + '@esbuild/linux-x64': 0.28.2 + '@esbuild/netbsd-arm64': 0.28.2 + '@esbuild/netbsd-x64': 0.28.2 + '@esbuild/openbsd-arm64': 0.28.2 + '@esbuild/openbsd-x64': 0.28.2 + '@esbuild/openharmony-arm64': 0.28.2 + '@esbuild/sunos-x64': 0.28.2 + '@esbuild/win32-arm64': 0.28.2 + '@esbuild/win32-ia32': 0.28.2 + '@esbuild/win32-x64': 0.28.2 + fdir@6.5.0(picomatch@4.0.7): optionalDependencies: picomatch: 4.0.7 @@ -941,6 +1230,12 @@ snapshots: picomatch@4.0.7: {} + playwright-core@1.64.0: {} + + playwright@1.64.0: + dependencies: + playwright-core: 1.64.0 + postcss@8.5.28: dependencies: nanoid: 3.3.19 @@ -994,11 +1289,17 @@ snapshots: tslib@2.8.1: {} + tsx@4.23.15: + dependencies: + esbuild: 0.28.2 + optionalDependencies: + fsevents: 2.3.3 + typescript@6.0.3: {} undici-types@7.24.6: {} - vite@8.3.2(@types/node@24.19.1): + vite@8.3.2(@types/node@24.19.1)(esbuild@0.28.2)(tsx@4.23.15): dependencies: lightningcss: 1.33.0 picomatch: 4.0.7 @@ -1007,4 +1308,6 @@ snapshots: tinyglobby: 0.2.17 optionalDependencies: '@types/node': 24.19.1 + esbuild: 0.28.2 fsevents: 2.3.3 + tsx: 4.23.15 diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml new file mode 100644 index 0000000..5ed0b5a --- /dev/null +++ b/pnpm-workspace.yaml @@ -0,0 +1,2 @@ +allowBuilds: + esbuild: true diff --git a/public/fonts/Inter-Bold.woff2 b/public/fonts/Inter-Bold.woff2 new file mode 100644 index 0000000..775f757 Binary files /dev/null and b/public/fonts/Inter-Bold.woff2 differ diff --git a/public/fonts/Inter-Medium.woff2 b/public/fonts/Inter-Medium.woff2 new file mode 100644 index 0000000..21db794 Binary files /dev/null and b/public/fonts/Inter-Medium.woff2 differ diff --git a/public/fonts/Inter-Regular.woff2 b/public/fonts/Inter-Regular.woff2 new file mode 100644 index 0000000..891fc5c Binary files /dev/null and b/public/fonts/Inter-Regular.woff2 differ diff --git a/public/fonts/Inter-SemiBold.woff2 b/public/fonts/Inter-SemiBold.woff2 new file mode 100644 index 0000000..da1c039 Binary files /dev/null and b/public/fonts/Inter-SemiBold.woff2 differ diff --git a/public/resume-template.html b/public/resume-template.html new file mode 100644 index 0000000..7352d1a --- /dev/null +++ b/public/resume-template.html @@ -0,0 +1,284 @@ + + + + + Resume - Dong Nguyen + + + + +
+ Dong Nguyen +
+

{{NAME}}

+
{{TITLE}}
+
+ {{EMAIL}}
+ {{GITHUB}}
+ {{LINKEDIN}} +
+
+
+ + +
+
Experience
+ {{EXPERIENCE}} +
+ + +
+
Skills
+
+ {{SKILLS}} +
+
+ + +
+
Projects
+ {{PROJECTS}} +
+ + diff --git a/scripts/generate-resume.ts b/scripts/generate-resume.ts new file mode 100644 index 0000000..6830cc7 --- /dev/null +++ b/scripts/generate-resume.ts @@ -0,0 +1,138 @@ +import { chromium } from 'playwright'; +import { readFileSync, existsSync } from 'node:fs'; +import { join, resolve } from 'node:path'; +import { profile } from '../src/data/profile.js'; +import { experiences } from '../src/data/experience.js'; +import { skillGroups } from '../src/data/skills.js'; +import { projects } from '../src/data/projects.js'; +const ROOT = resolve(import.meta.dirname, '..'); + +// --- Validate required files --- +const requiredFiles = [ + 'public/profile-photo.webp', + 'public/fonts/Inter-Regular.woff2', + 'public/fonts/Inter-Medium.woff2', + 'public/fonts/Inter-SemiBold.woff2', + 'public/fonts/Inter-Bold.woff2', + 'public/resume-template.html', +]; + +for (const file of requiredFiles) { + if (!existsSync(join(ROOT, file))) { + console.error(`❌ Missing required file: ${file}`); + process.exit(1); + } +} + +// --- Read template --- +const template = readFileSync(join(ROOT, 'public/resume-template.html'), 'utf-8'); + +// --- Read and base64-encode assets --- +const photoBase64 = readFileSync(join(ROOT, 'public/profile-photo.webp')).toString('base64'); + +const fonts: Record = {}; +for (const [name, weight] of [ + ['REGULAR', 'Inter-Regular.woff2'], + ['MEDIUM', 'Inter-Medium.woff2'], + ['SEMIBOLD', 'Inter-SemiBold.woff2'], + ['BOLD', 'Inter-Bold.woff2'], +] as const) { + fonts[name] = readFileSync(join(ROOT, 'public/fonts', weight)).toString('base64'); +} + +// --- Generate font-face CSS --- +const fontFaces = Object.entries(fonts).map(([key, b64]) => { + const weightMap: Record = { REGULAR: 400, MEDIUM: 500, SEMIBOLD: 600, BOLD: 700 }; + return `@font-face { + font-family: 'Inter'; + font-style: normal; + font-weight: ${weightMap[key]}; + font-display: swap; + src: url('data:font/woff2;base64,${b64}') format('woff2'); +}`; +}).join('\n'); + +// --- Render HTML helpers --- +function renderExperience(exps: typeof experiences): string { + return exps.map(exp => ` +
+
+ ${exp.title} + ${exp.duration} +
+
${exp.company}
+ ${exp.location ? `
${exp.location}
` : ''} +
    + ${exp.responsibilities.map(r => `
  • ${r}
  • `).join('')} +
+ ${exp.achievements?.map(ach => ` +
+
${ach.title}
+
${ach.context}
+ ${ach.technicalWork?.length ? ` +
    + ${ach.technicalWork.map(t => `
  • ${t}
  • `).join('')} +
+ ` : ''} +
+ ${ach.technologies.map(t => `${t}`).join('')} +
+ ${ach.impact ? `
${ach.impact}
` : ''} + ${ach.metrics?.length ? `
${ach.metrics.join(', ')}
` : ''} +
+ `).join('')} +
+ `).join(''); +} + +function renderSkills(groups: typeof skillGroups): string { + return groups.map(group => ` +
+
${group.title}
+
${group.skills.join(' · ')}
+
+ `).join(''); +} + +function renderProjects(projs: typeof projects): string { + return projs.map(project => ` +
+
${project.title}
+
${project.role}
+
${project.summary}
+
+ ${project.technologies.map(t => `${t}`).join('')} +
+ ${project.metrics?.length ? `
${project.metrics.join(', ')}
` : ''} +
+ `).join(''); +} + +// --- Assemble HTML --- +const html = template + .replace('{{NAME}}', profile.name) + .replace('{{TITLE}}', profile.title) + .replace('{{EMAIL}}', profile.email) + .replace('{{GITHUB}}', profile.githubUrl.replace('https://', 'github.com/')) + .replace('{{LINKEDIN}}', profile.linkedinUrl.replace('https://', 'linkedin.com/in/')) + .replace('{{PHOTO_BASE64}}', photoBase64) + .replace('{{FONT_FACES}}', fontFaces) + .replace('{{EXPERIENCE}}', renderExperience(experiences)) + .replace('{{SKILLS}}', renderSkills(skillGroups)) + .replace('{{PROJECTS}}', renderProjects(projects)); + +// --- Generate PDF --- +const browser = await chromium.launch(); +const page = await browser.newPage(); +await page.setContent(html); // No waitUntil needed — all resources inline + +const outputPath = join(ROOT, 'dist/resume.pdf'); +await page.pdf({ + path: outputPath, + format: 'A4', + printBackground: true, + // margin inherited from @page CSS +}); + +await browser.close(); +console.log(`resume.pdf generated at ${outputPath}`);