Case study VN: Build miniERP quản lý nhân sự trong 8 giờ

Từ zero đến production: Build miniERP quản lý nhân sự, chấm công, tính lương 3P trong 8 giờ với Claude Code, tiết kiệm 90% thời gian so với phát triển truyền thống

Định nghĩa

MiniERP là hệ thống quản lý doanh nghiệp thu nhỏ tích hợp nhân sự, chấm công, tính lương và văn hóa nội bộ. Case study này ghi lại quá trình xây dựng miniERP từ con số 0 đến production trong 8 giờ liên tục bằng Claude Code, sử dụng "compressed development loops" — kết hợp Planning Mode, Auto Mode và CLAUDE.md để nén chu kỳ phát triển từ 2-3 tuần xuống còn một ngày làm việc.

Giải thích chi tiết

Bài toán thực tế của doanh nghiệp Việt

Tâm Văn — founder CBE (Cafe Business Excellence) — cần hệ thống quản lý nội bộ đặc thù:

Chấm công & tính lương: Theo công thức 3P (Pay for Person, Pay for Position, Pay for Performance) kết hợp chính sách BHXH, thuế TNCN và nghỉ phép 12 ngày/năm + 1 ngày cống hiến/5 năm
Tuyển dụng: Tracking pipeline ứng viên, báo cáo hiệu quả kênh tuyển
Văn hóa nội bộ: Hệ thống "tặng sao" giữa nhân viên, đổi sao lấy hàng hóa trên CBE Shop
Báo cáo: Daily report auto-sync theo tuần/tháng/năm và phân loại theo phòng ban

Thách thức: Developer truyền thống cần 2-3 tuần chỉ để setup boilerplate (auth, CRUD, migrations, UI scaffolding) trước khi chạm vào business logic thực sự.

Kiến trúc "Time Collapse"

Claude Code áp dụng Time Collapse Principle — loại bỏ ba loại ma sát thời gian:

1. Context Switching Tax CLAUDE.md đóng vai trò "bộ nhớ ngoài" (external prefrontal cortex). File này lưu trữ vĩnh viễn các quy tắc đặc thù: "Nhân viên nghỉ phép năm 12 ngày vẫn hưởng nguyên lương", "Công thức 3P = lương cơ bản × hệ số vị trí × KPI tháng". AI không bao giờ quên các rule này giữa các session, khác biệt hoàn toàn với ChatGPT session thông thường.

2. Permission Friction Auto Mode chuyển workflow từ "nhập-prompt-đợi-approve-nhập-prompt" sang mô hình "film director": bạn phê duyệt storyboard (Planning Mode) rồi để AI chạy continuous takes. Safety classifier tự động review từng file edit, chỉ dừng lại khi gặp destructive operation.

3. Translation Overhead Thay vì dịch "nghiệp vụ tiếng Việt → logic tiếng Anh → code → comments tiếng Việt", Claude Code xử lý trực tiếp mô tả tiếng Việt: "Tạo form xin nghỉ phép có validation không được nghỉ quá số ngày còn lại" được biên dịch thành React form + Prisma schema + API validation trong một turn.

Timeline 8 giờ chi tiết

Hour 0-1: Khởi tạo bộ nhớ dự án

/init thiết lập tech stack: React frontend, Node.js backend, PostgreSQL database
Ghi nhớ domain rules vào ./CLAUDE.md: Bảng lương BHXH theo Nghị định 38/2022, công thức tính phép năm, logic tặng sao (double-entry bookkeeping đơn giản)

Hour 1-2: Planning Mode

/plan phân rã hệ thống thành 4 module: Nhân sự (hồ sơ), Chấm công (check-in/out), Lương (tính toán 3P), Văn hóa (star system)
Output: Database schema chi tiết, API contracts, component hierarchy, ước tính 4.5 giờ cho phase implementation

Hour 2-6: Auto Mode & Subagents

Kích hoạt --permission-mode auto để Claude tự động execute 50+ file edits liên tục
Subagent parallelization:
- Agent A: Frontend forms (React + Tailwind)
- Agent B: Backend APIs (Express + Zod validation)
- Agent C: SQL migrations và triggers tính lương tự động
Context isolation đảm bảo mỗi agent làm việc trong "clean room" riêng, không pollute main conversation

Hour 6-7: Quality Gates

/test generate unit tests cho logic tính lương (edge case: nghỉ phép cưới 3 ngày có lương)
/lint enforce code style với Prettier/ESLint thông qua PostToolUse hooks
MCP PostgreSQL server kết nối database thật để test migrations trên data sample

Hour 7-8: Deployment

Human review: Kiểm tra logic BHXH và tính toán thuế
claude -p "generate production docker-compose" tạo deployment config
Push lên GitHub, setup GitHub Actions cơ bản cho CI

Kết quả: ~15,000 dòng code được generate với ~200 human interventions (prompts/quyết định architecture) thay vì hàng nghìn lần edit thủ công.

Ví dụ thực tế

Module tính lương 3P đặc thù Việt Nam

Yêu cầu nghiệp vụ: "Tính lương theo công thức 3P, tự động trừ BHXH 10.5%, nếu nhân viên nghỉ quá 12 ngày phép năm thì ngày thứ 13 trở đi không lương"

Claude Code tự động:

Tạo SQL view salary_calculation với CTE (Common Table Expressions) tính toán từng thành phần:
- pay_person: Thâm niên × hệ số lương cơ bản
- pay_position: Phụ cấp chức danh
- pay_performance: Biến động theo KPI tháng
Generate trigger function PostgreSQL tự động cập nhật net_salary mỗi khi bảng attendance có thay đổi
Tạo React dashboard cho HR xem breakdown chi tiết từng thành phần lương

Thay vì viết 200 dòng SQL thủ công, founder mô tả bằng tiếng Việt và Claude xử lý phần implementation, chỉ yêu cầu xác nhận lại logic BHXH trước khi apply.

Hệ thống "tặng sao" văn hóa doanh nghiệp

Tính năng độc đáo: Nhân viên tặng "sao" (points) cho đồng nghiệp để công nhận đóng góp, sau đó đổi sao lấy hàng hóa trên internal shop.

Subagent "culture-engineer": Thiết kế schema star_transactions với double-entry bookkeeping (debit/credit) để đảm bảo không mất mát điểm
Subagent "inventory-connector": Dùng MCP server kết nối với WooCommerce API của CBE Shop, tạo endpoint đổi sao lấy voucher giảm giá
Hook automation: PostToolUse hook tự động gửi Slack notification mỗi khi có giao dịch tặng sao, tăng tính tương tác nội bộ

Báo cáo tự động theo phòng ban

Sử dụng /loop để tạo scheduled task:

8h sáng mỗi ngày: Truy vấn MCP PostgreSQL server lấy dữ liệu chấm công, tính toán tỷ lệ đi làm muộn theo phòng ban
Generate báo cáo HTML với Recharts visualization
Tự động gửi email qua Resend API cho managers

Thay vì setup cron job phức tạp, founder chỉ cần nói: "Mỗi sáng gửi báo cáo tình hình nhân sự cho tôi" và Claude xử lý phần implementation và scheduling.

Ứng dụng

Startup Việt (5-20 nhân sự)

CTO/founder không có team dev riêng, cần nhanh chóng có internal tools quản lý nhân sự, chấm công linh hoạt theo chính sách riêng. Chi phí ~ $20 API credits (Sonnet 3.5) so với$ 2,000-5,000 thuê agency hoặc 2-3 tuần công sức founder tự code.

HR/Admin Team không technical

Team HR cần tự động hóa quy trình nội bộ (approval nghỉ phép, tính lương đặc thù) nhưng không biết lập trình. Sử dụng vibe coding để iterate nhanh chính sách mới (ví dụ: thay đổi cách tính thưởng Tết) mà không cần đợi dev team có slot.

Doanh nghiệp SME đang digital transform

Migration từ Excel quản lý nhân sự (thường gặp lỗi formula, khó trace history) sang hệ thống có database thực sự và audit trail. Thời gian ngắn (8 giờ) cho phép "thử nghiệm" với chi phí thấp — nếu quy trình không phù hợp thì rebuild lại nhanh chóng không tốn kém.

Freelancer/Dev Agency Việt Nam

Dùng làm throwaway prototype để demo cho khách hàng trước khi ký hợp đồng phát triển chính thức. Trong 8 giờ có thể demo luồng chấm công, tính lương thực tế với data của khách hàng, giúp khách hình dung rõ hơn requirements trước khi invest vào giải pháp enterprise như SAP hay Oracle.

So sánh

Tiêu chí	Phát triển truyền thống	Claude Code 8 giờ
Thời gian	2-3 tuần (setup + code + test)	8 giờ liên tục
Lines of Code	~15,000 LOC (tương đương)	~15,000 LOC generated
Human interventions	Hàng nghìn lần edit thủ công	~200 prompts/quyết định
Chi phí nhân sự	Developer full-time 2-3 tuần	$20 API credits + 8 giờ giám sát
Tính năng đặc thù	Khó customize (phụ thuộc vendor)	Dễ dàng mô tả bằng tiếng Việt
Technical Debt	Có kiến trúc rõ ràng nhưng lâu	Tích lũy nhanh nếu không maintain CLAUDE.md
Production-ready	Có thể scale	Cần rewrite nếu scale hơn 100 nhân sự

Kết luận: Claude Code phù hợp cho "throwaway ERP" — prototype để validate quy trình nghiệp vụ và chính sách HR, sau đó rebuild đúng chuẩn nếu doanh nghiệp scale. Đây không phải thay thế cho SAP hay Workday, mà là cách để doanh nghiệp nhỏ có hệ thống "đủ tốt" (good enough) trong thời gian ngắn nhất có thể.