refactor(i18n): split content into structure JSON and per-language dictionaries

Phase 1 of spec-v4-live-edit: data/i18n foundation, no visible feature.

- src/data/{profile,skills,experience,projects}.json: language-neutral
  structure documents with thin typed loaders; all prose moved to
  src/i18n/locales/{vi,en}/content.json; chrome strings to ui.json
- src/i18n/: dict-types, cross-document validator (runs at module load and
  via pnpm validate:content), loader joining structure+text once (UI/CONTENT),
  I18nProvider/useI18n mounted in App under LanguageProvider
- all 22 consumers read joined records via useI18n(); field.ts and
  strings.ts deleted; *En field pairs removed from the domain types
- hero tagline renders as plain-text segments (D9); philosophy quotes as
  paragraph arrays; footer display name now localizes per language (D6)
- resume generator consumes UI/CONTENT; generated resume HTML verified
  byte-identical (EN+VI) before/after the migration
- AGENTS.md and v3/v3-i18n + v4 specs updated; deploy.yml concurrency group
This commit is contained in:
dong.nguyen committed 2026-10-22 07:29:06 +07:00
1 parent f5687cce1c
commit e6b4d83084
50 files changed
+2215 -961

No files matched your search

+34
View File
@@ -0,0 +1,34 @@
[
{
"id": "open-to-work",
"company": "Open to new opportunities",
"duration": "Nov 2026 – Present",
"variant": "current"
},
{
"id": "relax-gap",
"company": "Career break",
"duration": "Aug 2026 – Oct 2026",
"variant": "gap"
},
{
"id": "lazada-senior-swe",
"company": "Lazada Tech Hub Vietnam",
"duration": "Jan 2020 – Aug 2026",
"location": "Ho Chi Minh City, Vietnam",
"logo": "lazada"
},
{
"id": "nexts-founder",
"company": "Nexts Limited Company",
"duration": "06/2019 – 12/2019",
"location": "Ho Chi Minh City, Vietnam"
},
{
"id": "sap-senior-swe",
"company": "SAP Lab Vietnam",
"duration": "2017 – 12/2019",
"location": "Ho Chi Minh City, Vietnam",
"logo": "sap"
}
]
+7 -84
View File
@@ -1,85 +1,8 @@
import type { ExperienceEntry } from "@/types";
// Typed loader for the experience structure document (spec-v4 D2) — see the
// note in profile.ts. Titles and responsibilities are localized text in the
// content dictionaries; company, duration, location, variant, and logo are
// language-neutral structure.
import experienceJson from './experience.json';
import type { ExperienceStructure } from '../i18n/dict-types';
export const experiences: ExperienceEntry[] = [
{
id: "open-to-work",
variant: "current",
title: "Đang tìm nơi làm việc mới",
titleEn: "Seeking a New Place",
company: "Open to new opportunities",
duration: "Nov 2026 – Present",
responsibilities: [
"Sẵn sàng cho vai trò Senior Engineer: system architecture, integration platform, full-stack delivery",
],
responsibilitiesEn: [
"Open to Senior Engineer roles: system architecture, integration platforms, full-stack delivery",
],
},
{
id: "relax-gap",
variant: "gap",
title: "Nghỉ ngơi",
titleEn: "Relax",
company: "Career break",
duration: "Aug 2026 – Oct 2026",
responsibilities: [
"Nghỉ có chủ đích giữa hai vai trò — lấy lại nhịp trước khi nhận hệ thống tiếp theo",
"Tự thử nghiệm theo nhịp riêng: local LLM với llama.cpp, đọc về Computer Vision",
],
responsibilitiesEn: [
"Intentional break between roles — recovering the rhythm before the next system",
],
},
{
id: "lazada-senior-swe",
title: "Senior Software Engineer",
titleEn: "Senior Software Engineer",
company: "Lazada Tech Hub Vietnam",
logo: "lazada",
duration: "Jan 2020 – Aug 2026",
location: "Ho Chi Minh City, Vietnam",
responsibilities: [
"System ownership và architecture design cho logistics integration systems",
"Developed IoT-DWS integration solution deployed across 16 sortations",
"Led system maintenance and modernization for production environments",
"Applied Computer Vision and ML to solve real-world operational problems",
"Scrum Master responsibilities — team achieved Scrum Level L3",
],
responsibilitiesEn: [
"System ownership and architecture design for logistics integration systems",
"Developed IoT-DWS integration solution deployed across 16 sortations",
"Led system maintenance and modernization for production environments",
"Applied Computer Vision and ML to solve real-world operational problems",
"Scrum Master responsibilities — team achieved Scrum Level L3",
],
},
{
id: "nexts-founder",
title: "Người sáng lập",
titleEn: "CTO & Founder",
company: "Nexts Limited Company",
duration: "06/2019 – 12/2019",
location: "Ho Chi Minh City, Vietnam",
responsibilities: [
"Phát triển giải pháp cho xe tự hành, thu thập dữ liệu thời gian thực từ cảm biến và hệ thống onboard: LiDAR, camera, GPS, CAN bus.",
],
responsibilitiesEn: [
"Developed a solution for autonomous vehicles to collect real-time data from onboard sensors and systems, including LiDAR, cameras, GPS, and CAN bus.",
],
},
{
id: "sap-senior-swe",
title: "Senior Software Engineer",
titleEn: "Senior Software Engineer",
logo: "sap",
company: "SAP Lab Vietnam",
duration: "2017 – 12/2019",
location: "Ho Chi Minh City, Vietnam",
responsibilities: [
"Team leader quản lý sản phẩm B1 Integration",
],
responsibilitiesEn: [
"Team leader managing the B1 Integration product",
],
}
];
export const experiences = experienceJson as ExperienceStructure[];
+69
View File
@@ -0,0 +1,69 @@
{
"firstName": "Dong",
"lastName": "Nguyen",
"email": "nguyendong_bkdn@yahoo.com",
"githubUrl": "https://github.com/dong-nz",
"linkedinUrl": "https://www.linkedin.com/in/dong-nz",
"githubHandle": "dong-nz",
"linkedinHandle": "dong-nz",
"telegramUrl": "https://t.me/dongdn",
"telegramHandle": "dongdn",
"currentInterests": [
"AI in logistics",
"Digital twins",
"Simulation",
"LLM",
"Computer Vision",
"High-performance systems"
],
"roles": [
"System Architect",
"Full-Stack Developer",
"System Engineer",
"AI/ML Application Engineer"
],
"philosophy": [
{
"id": "build-for-the-real-problem",
"keywords": [
"Problem-first",
"Business value",
"Measurement"
]
},
{
"id": "think-in-systems",
"keywords": [
"Architecture",
"Integration",
"Scalability",
"Reliability"
]
},
{
"id": "measure-impact",
"keywords": [
"Performance",
"Reliability",
"Cost",
"Efficiency"
]
},
{
"id": "keep-learning",
"keywords": [
"AI/ML",
"Computer Vision",
"LLM",
"Distributed systems"
]
},
{
"id": "business-domain-knowledge-is-a-key-of-success",
"keywords": [
"Biz knowledge",
"Business value"
]
}
]
}
+10 -83
View File
@@ -1,84 +1,11 @@
import type {Profile} from "@/types";
// Typed loader for the profile structure document (spec-v4 D2). Localized text
// lives in src/i18n/locales and is joined in src/i18n/index.ts; this module
// exports the language-neutral structure under today's name, for the i18n
// loader and for scripts/generate-sitemap.ts.
// JSON imports widen string literals to `string`, so id membership is guarded
// by the text dictionaries (tsc) and by src/i18n/validate.ts (cross-document
// coverage) — the cast still fails on gross shape errors.
import profileJson from './profile.json';
import type { ProfileStructure } from '../i18n/dict-types';
export const profile: Profile = {
firstName: "Dong",
lastName: "Nguyen",
name: "Nguyễn Đông",
nameEn: "Dong Nguyen",
title: "Senior Software Engineer",
titleEn: "Senior Software Engineer",
tagline:
"Phần lớn thời gian tôi là Backend Software Engineer. Muốn tôi là Full Stack Developer, <span class='ok-possible name-highlight'>yes</span>, có thể.",
taglineEn:
"Building scalable software systems, intelligent logistics solutions, and practical AI applications.",
bio: "Senior Software Engineer với kinh nghiệm xây dựng hệ thống phân tán, logistics technology, và ứng dụng AI/ML vào bài toán thực tế. Tập trung vào system architecture, integration, và production-grade solutions.",
bioEn: "Senior Software Engineer with experience building distributed systems, logistics technology, and AI/ML applications for real-world problems. Focused on system architecture, integration, and production-grade solutions.",
email: "nguyendong_bkdn@yahoo.com",
githubUrl: "https://github.com/dong-nz",
linkedinUrl: "https://www.linkedin.com/in/dong-nz",
githubHandle: "dong-nz",
linkedinHandle: "dong-nz",
telegramUrl: "https://t.me/dongdn",
telegramHandle: "dongdn",
currentInterests: [
"AI in logistics",
"Digital twins",
"Simulation",
"LLM",
"Computer Vision",
"High-performance systems",
],
roles: [
"System Architect",
"Full-Stack Developer",
"System Engineer",
"AI/ML Application Engineer",
],
philosophy: [
{
title: "Giải pháp được xây dựng dựa trên vấn đề thực tế",
titleEn: "Build for the real problem",
description:
"Không bắt đầu bằng technology. Bắt đầu bằng problem.",
descriptionEn:
"Don't start with technology. Start with the problem.",
keywords: ["Problem-first", "Business value", "Measurement"],
},
{
title: "Think in systems",
titleEn: "Think in systems",
description:
"Quan tâm đến kiến trúc tổng thể, không chỉ từng component.",
descriptionEn:
"Care about the overall architecture, not just individual components.",
keywords: ["Architecture", "Integration", "Scalability", "Reliability"],
},
{
title: "Measure impact",
titleEn: "Measure impact",
description:
"Technical implementation phải gắn với measurable outcome.",
descriptionEn:
"Technical implementation must be tied to measurable outcomes.",
keywords: ["Performance", "Reliability", "Cost", "Efficiency"],
},
{
title: "Keep learning",
titleEn: "Keep learning",
description:
"Continuous exploration of new technologies and approaches.",
descriptionEn:
"Continuous exploration of new technologies and approaches.",
keywords: ["AI/ML", "Computer Vision", "LLM", "Distributed systems"],
},
{
title: "Kiến thức nghiệp vụ là chìa khóa thành công",
titleEn: "Business domain knowledge is a key of success",
description:
"Hiểu sâu về business domain giúp hiểu rõ vấn đề và đưa ra giải pháp phù hợp.",
descriptionEn:
"Don't start with technology. Start with the problem.",
keywords: ["Biz knowledge", "Business value"],
},
],
};
export const profile = profileJson as ProfileStructure;
+131
View File
@@ -0,0 +1,131 @@
[
{
"id": "iot-dws-integration",
"category": "logistics",
"role": "Senior Software Engineer — System Owner",
"technologies": [
"Java",
"HTTP",
"HMAC",
"RocketMQ",
"DWS"
],
"metrics": [
"16 sortations deployed"
],
"featured": true,
"sections": [
{
"id": "context",
"type": "text"
},
{
"id": "problem",
"type": "text"
},
{
"id": "solution",
"type": "text"
},
{
"id": "architecture",
"type": "diagram"
},
{
"id": "challenges",
"type": "text"
},
{
"id": "result",
"type": "text"
}
]
},
{
"id": "awb-detection",
"category": "computer-vision",
"role": "Senior Software Engineer — ML Engineering",
"technologies": [
"Python",
"OpenCV",
"YOLO",
"ONNX",
"OCR"
],
"metrics": [
"70,000 images/month processed"
],
"featured": true,
"sections": [
{
"id": "context",
"type": "text"
},
{
"id": "problem",
"type": "text"
},
{
"id": "pipeline",
"type": "diagram"
},
{
"id": "challenges",
"type": "text"
},
{
"id": "result",
"type": "text"
}
]
},
{
"id": "facility-management",
"category": "software-engineering",
"role": "Senior Software Engineer — Platform Design",
"technologies": [
"Go",
"TypeScript",
"Docker",
"Event-driven"
],
"featured": true,
"sections": [
{
"id": "vision",
"type": "text"
},
{
"id": "architecture",
"type": "diagram"
},
{
"id": "result",
"type": "text"
}
]
},
{
"id": "local-llm-experiments",
"category": "experiment",
"role": "Engineering Experiment",
"technologies": [
"llama.cpp",
"Qwen",
"MoE",
"Python",
"CUDA"
],
"featured": true,
"sections": [
{
"id": "exploration",
"type": "text"
},
{
"id": "learnings",
"type": "text"
}
]
}
]
+8 -225
View File
@@ -1,226 +1,9 @@
import type { ProjectDetail } from "@/types";
// Typed loader for the projects structure document (spec-v4 D2) — see the note
// in profile.ts. Titles, summaries, and section prose are localized text in the
// content dictionaries; ids, categories, roles, technologies, metrics,
// featured, and section {id, type} are language-neutral structure. Project ids
// already appear in URLs and the sitemap, so they are the stable join keys.
import projectsJson from './projects.json';
import type { ProjectStructure } from '../i18n/dict-types';
export const projects: ProjectDetail[] = [
{
id: "iot-dws-integration",
title: "Tích hợp hệ thống IoT-DWS",
titleEn: "IoT-DWS Integration System",
summary:
"Thiết kế và triển khai hệ thống integration giữa IoT devices và DWS (Dimensioning Weighing Scanning) machines cho 16 sortations.",
summaryEn:
"Designed and deployed an integration system between IoT devices and DWS (Dimensioning Weighing Scanning) machines across 16 sortations.",
category: "logistics",
role: "Senior Software Engineer — System Owner",
technologies: ["Java", "HTTP", "HMAC", "RocketMQ", "DWS"],
metrics: ["16 sortations deployed"],
featured: true,
sections: [
{
id: "context",
title: "Context",
titleEn: "Context",
content:
"Tiếp nhận và nhanh chóng làm chủ một hệ thống IoT-DWS sau khi thành viên phụ trách trước đó rời project. Cần hiểu nhanh architecture hiện tại và tiếp tục phát triển integration solution.",
contentEn:
"Took over and rapidly mastered an IoT-DWS system after the previous responsible team member left the project. Needed to quickly understand the current architecture and continue developing the integration solution.",
type: "text",
},
{
id: "problem",
title: "Problem",
titleEn: "Problem",
content:
"Cần integration giữa các IoT devices (sensors, cameras) và DWS machines — hệ thống vật lý phức tạp với nhiều protocol khác nhau (HMI, FTP, HTTP).",
contentEn:
"Needed integration between IoT devices (sensors, cameras) and DWS machines — a complex physical system with multiple different protocols (HMI, FTP, HTTP).",
type: "text",
},
{
id: "solution",
title: "Solution",
titleEn: "Solution",
content:
"Thiết kế HTTP-based integration engine với HMAC security, RocketMQ messaging, và protocol adapters cho HMI/FTP/HTTP.",
contentEn:
"Designed an HTTP-based integration engine with HMAC security, RocketMQ messaging, and protocol adapters for HMI/FTP/HTTP.",
type: "text",
},
{
id: "architecture",
title: "Architecture",
titleEn: "Architecture",
content:
"```text\nIoT Devices\n ↓\nProtocol Adapters (HMI/FTP/HTTP)\n ↓\nHTTP Engine + HMAC Security\n ↓\nRocketMQ\n ↓\nDWS Machines\n```",
contentEn:
"```text\nIoT Devices\n ↓\nProtocol Adapters (HMI/FTP/HTTP)\n ↓\nHTTP Engine + HMAC Security\n ↓\nRocketMQ\n ↓\nDWS Machines\n```",
type: "diagram",
},
{
id: "challenges",
title: "Challenges",
titleEn: "Challenges",
content:
"Nhiều protocol khác nhau, security requirements (HMAC signature), real-time data processing, production reliability.",
contentEn:
"Multiple different protocols, security requirements (HMAC signature), real-time data processing, production reliability.",
type: "text",
},
{
id: "result",
title: "Result",
titleEn: "Result",
content:
"Giải pháp được triển khai cho 16 sortations, ổn định trong production, hỗ trợ 3 protocols (HMI, FTP, HTTP).",
contentEn:
"Solution deployed across 16 sortations, stable in production, supporting 3 protocols (HMI, FTP, HTTP).",
type: "text",
},
],
},
{
id: "awb-detection",
title: "AWB Detection / Computer Vision",
titleEn: "AWB Detection / Computer Vision",
summary:
"Ứng dụng Computer Vision và Machine Learning để tự động phát hiện và OCR shipping label từ hình ảnh camera trên sortation.",
summaryEn:
"Applied Computer Vision and Machine Learning to automatically detect and OCR shipping labels from camera images on sortation lines.",
category: "computer-vision",
role: "Senior Software Engineer — ML Engineering",
technologies: ["Python", "OpenCV", "YOLO", "ONNX", "OCR"],
metrics: ["70,000 images/month processed"],
featured: true,
sections: [
{
id: "context",
title: "Context",
titleEn: "Context",
content:
"Sortation machines chụp ảnh packages khi di chuyển trên băng chuyền. Cần tự động đọc AWB (Air Waybill) từ ảnh để tracking và sorting.",
contentEn:
"Sortation machines capture images of packages as they move on conveyor belts. Need to automatically read AWB (Air Waybill) from images for tracking and sorting.",
type: "text",
},
{
id: "problem",
title: "Problem",
titleEn: "Problem",
content:
"White label trên white package — traditional CV methods không đủ robust. Cần ML-based detection.",
contentEn:
"White label on white package — traditional CV methods are not robust enough. Needed ML-based detection.",
type: "text",
},
{
id: "pipeline",
title: "Pipeline",
titleEn: "Pipeline",
content:
"```text\nImage\n ↓\nAWB/Label Detection (YOLO)\n ↓\nBounding Box / OBB\n ↓\nRotation Correction\n ↓\nCrop\n ↓\nOCR\n ↓\nText Extraction\n```",
contentEn:
"```text\nImage\n ↓\nAWB/Label Detection (YOLO)\n ↓\nBounding Box / OBB\n ↓\nRotation Correction\n ↓\nCrop\n ↓\nOCR\n ↓\nText Extraction\n```",
type: "diagram",
},
{
id: "challenges",
title: "Challenges",
titleEn: "Challenges",
content:
"White label on white package, rotated labels, varying lighting conditions, real-time inference requirements.",
contentEn:
"White label on white package, rotated labels, varying lighting conditions, real-time inference requirements.",
type: "text",
},
{
id: "result",
title: "Result",
titleEn: "Result",
content:
"Model fine-tuned cho AWB detection, xử lý 70,000 images/month. Presentation tại Tech Talk workshop.",
contentEn:
"Model fine-tuned for AWB detection, processing 70,000 images/month. Presented at Tech Talk workshop.",
type: "text",
},
],
},
{
id: "facility-management",
title: "Facility Management Platform",
titleEn: "Facility Management Platform",
summary:
"Xây dựng nền tảng digital twin cho logistics facilities — mô hình hóa facility, theo dõi real-time, và recommendation system.",
summaryEn:
"Built a digital twin platform for logistics facilities — facility modeling, real-time monitoring, and recommendation system.",
category: "software-engineering",
role: "Senior Software Engineer — Platform Design",
technologies: ["Go", "TypeScript", "Docker", "Event-driven"],
featured: true,
sections: [
{
id: "vision",
title: "Vision",
titleEn: "Vision",
content:
"Chuyển đổi từ manual operations sang Operation Intelligence Platform — thu thập data, monitor, analyze, recommend, decide.",
contentEn:
"Transition from manual operations to an Operation Intelligence Platform — collect data, monitor, analyze, recommend, decide.",
type: "text",
},
{
id: "architecture",
title: "Architecture",
titleEn: "Architecture",
content:
"```text\nPhysical Facility\n ↓\nData Collection\n ↓\nFacility Model\n ↓\nDigital Twin\n ↓\nSimulation\n ↓\nAnalytics\n ↓\nRecommendation\n ↓\nOperation Decision\n```",
contentEn:
"```text\nPhysical Facility\n ↓\nData Collection\n ↓\nFacility Model\n ↓\nDigital Twin\n ↓\nSimulation\n ↓\nAnalytics\n ↓\nRecommendation\n ↓\nOperation Decision\n```",
type: "diagram",
},
{
id: "result",
title: "Result",
titleEn: "Result",
content:
"Platform hỗ trợ facility modeling, real-time visibility, và recommendation cho capacity planning.",
contentEn:
"Platform supports facility modeling, real-time visibility, and recommendations for capacity planning.",
type: "text",
},
],
},
{
id: "local-llm-experiments",
title: "Local LLM Experiments",
titleEn: "Local LLM Experiments",
summary:
"Technical exploration về running local MoE LLMs với llama.cpp — GPU offloading, VRAM optimization, performance tracing.",
summaryEn:
"Technical exploration of running local MoE LLMs with llama.cpp — GPU offloading, VRAM optimization, performance tracing.",
category: "experiment",
role: "Engineering Experiment",
technologies: ["llama.cpp", "Qwen", "MoE", "Python", "CUDA"],
featured: true,
sections: [
{
id: "exploration",
title: "Exploration",
titleEn: "Exploration",
content:
"Technical exploration về MoE (Mixture of Experts), expert routing, GPU offloading, VRAM optimization, prefill/decode pipeline.",
contentEn:
"Technical exploration of MoE (Mixture of Experts), expert routing, GPU offloading, VRAM optimization, prefill/decode pipeline.",
type: "text",
},
{
id: "learnings",
title: "Lessons Learned",
titleEn: "Lessons Learned",
content:
"Understand the system → Measure → Analyze → Optimize. Không phải khoe hardware — mà thể hiện engineering approach.",
contentEn:
"Understand the system → Measure → Analyze → Optimize. Not about showing off hardware — but demonstrating engineering approach.",
type: "text",
},
],
},
];
export const projects = projectsJson as ProjectStructure[];
+64
View File
@@ -0,0 +1,64 @@
[
{
"id": "software-engineering",
"skills": [
"Java",
"Go",
"TypeScript",
"Distributed Systems",
"REST APIs",
"Microservices"
]
},
{
"id": "system-architecture",
"skills": [
"System Design",
"Integration Architecture",
"Event-driven Architecture",
"Message Queues",
"API Design"
]
},
{
"id": "logistics-technology",
"skills": [
"Sortation",
"Warehouse / Facility Operations",
"Package Flow",
"Operational Intelligence",
"Facility Modeling"
]
},
{
"id": "ai-ml",
"skills": [
"Computer Vision",
"Object Detection",
"OCR",
"Model Deployment",
"LLM",
"AI-assisted Engineering"
]
},
{
"id": "infrastructure",
"skills": [
"Docker",
"Linux",
"CI/CD",
"Networking",
"Middleware"
]
},
{
"id": "engineering-practices",
"skills": [
"Agile / Scrum",
"Technical Documentation",
"System Maintenance",
"Performance Optimization",
"Technical Research"
]
}
]
+6 -65
View File
@@ -1,66 +1,7 @@
import type { SkillGroup } from "@/types";
// Typed loader for the skills structure document (spec-v4 D2) — see the note
// in profile.ts. Group titles are localized text and live in the content
// dictionaries; only language-neutral ids and skill terms stay here.
import skillsJson from './skills.json';
import type { SkillGroupStructure } from '../i18n/dict-types';
export const skillGroups: SkillGroup[] = [
{
title: "Software Engineering",
titleEn: "Software Engineering",
skills: [
"Java",
"Go",
"TypeScript",
"Distributed Systems",
"REST APIs",
"Microservices",
],
},
{
title: "System Architecture",
titleEn: "System Architecture",
skills: [
"System Design",
"Integration Architecture",
"Event-driven Architecture",
"Message Queues",
"API Design",
],
},
{
title: "Logistics Technology",
titleEn: "Logistics Technology",
skills: [
"Sortation",
"Warehouse / Facility Operations",
"Package Flow",
"Operational Intelligence",
"Facility Modeling",
],
},
{
title: "AI / ML",
titleEn: "AI / ML",
skills: [
"Computer Vision",
"Object Detection",
"OCR",
"Model Deployment",
"LLM",
"AI-assisted Engineering",
],
},
{
title: "Infrastructure",
titleEn: "Infrastructure",
skills: ["Docker", "Linux", "CI/CD", "Networking", "Middleware"],
},
{
title: "Engineering Practices",
titleEn: "Engineering Practices",
skills: [
"Agile / Scrum",
"Technical Documentation",
"System Maintenance",
"Performance Optimization",
"Technical Research",
],
},
];
export const skillGroups = skillsJson as SkillGroupStructure[];