Tài Liệu Hướng Dẫn Nghiệp Vụ Chính Thức · 2026

Cẩm Nang Sử Dụng & Kiểm Thử SimulPM

Hệ thống mô phỏng quản trị dự án Thương mại điện tử thời gian thực chuẩn quốc tế SimulTrain® Thụy Sĩ kết nối 100% CSDL SQLite Native

💻 Vào Bàn Làm Việc PM ⚡ Kịch Bản 5 Phút Cho Sếp

📑 Mục Lục Hướng Dẫn & Đột Phá Kỹ Thuật (v2.2)

1. Tổng quan dành cho Lãnh đạo 2. Kịch bản 5 bước Test-drive (5 phút) 3. Cơ chế Lịch trình & CPM (11 tuần) 4. Cơ chế Phân bổ Nhân sự (Không gán thì sao?) 5. Hộp thoại Chi tiết & Gán nhanh (4 lớp kiểm duyệt) 6. Cơ chế Biến cố & Pop-up quyết định 7. Cơ chế Động lực đội ngũ (85 điểm) 8. Cơ chế Chất lượng sản phẩm (100 điểm) 9. Hệ thống EVM chuẩn PMI quốc tế 10. Hướng dẫn 10 màn hình chức năng 11. Cấu hình CSDL SQLite Native & .env 12. Câu hỏi thường gặp (FAQ)

🧑‍💼 1. Tổng Quan Dành Cho Lãnh Đạo (Executive Summary)

Mục đích, phạm vi và 4 trụ cột đánh giá của hệ thống mô phỏng SimulPM

SimulPM đặt người dùng vào vị trí Giám đốc Dự án (PM) điều hành một dự án phát triển hệ thống Thương mại điện tử (E-Commerce) kéo dài 11 tuần (55 ngày làm việc, 440 giờ làm việc) với tổng ngân sách được duyệt là 220,000 CHF.

💡 Điểm khác biệt cốt lõi: Không giống như các phần mềm tĩnh hay trắc nghiệm lý thuyết, SimulPM là một Hệ thống State Machine thời gian thực. Mọi thao tác gán người, bước nhảy thời gian hay ra quyết định đều gửi trực tiếp và xử lý tại cơ sở dữ liệu SQLite Native, ngay lập tức định hình 4 chỉ số sinh tồn của dự án:
Trụ Cột Dự Án Mục Tiêu Chuẩn Cơ Chế Đo Lường Hậu Quả Nếu Sai Lầm
💰 1. Chi phí (Cost) Ngân sách 220,000 CHF ($CPI \ge 1.0$) Lương giờ 25 nhân sự + Chi phí quyết định + Phạt chậm trễ Vượt ngân sách ($CPI < 1.0$, $EAC > 220k$ CHF)
⏱️ 2. Lịch trình (Schedule) 11 Tuần / 440 Giờ ($SPI \ge 1.0$) Mạng CPM, 17 task WBS, Đường găng (Critical Path) Trễ hạn bàn giao, vỡ cam kết với khách hàng
⭐ 3. Chất lượng (Quality) $\ge 90$ Điểm (Gốc: 100 điểm) Độ khớp kỹ năng (SkillFit), Kiểm thử, Thuê chuyên gia Sản phẩm lỗi, khách hàng phàn nàn, phạt tiền
🔥 4. Động lực (Motivation) $\ge 85$ Điểm (Gốc: 85 điểm) Tải công việc, Họp 1-on-1, Ăn trưa BBQ, Quyết định hợp lý Nhân viên kiệt sức, đình công, làm việc chậm trễ

⚡ 2. Kịch Bản 5 Bước Trải Nghiệm Nhanh (5-Minute Test Drive Cho Sếp)

Thực hiện chính xác theo 5 bước dưới đây để sếp thấy ngay tính chân thực và độ nhạy của hệ thống

BƯỚC 1 Khởi động & Nhận diện vạch xuất phát
Truy cập http://localhost:3001/dashboard. Quan sát thanh đồng hồ: Tuần 1 | Thứ Hai | 08:00.
Toàn bộ 17 hoạt động ở mức 0% tiến độ, Chi phí đốt 0 CHF, Chất lượng 100, Động lực 85.
BƯỚC 2 Quy luật 1: "Nếu KHÔNG gán người thì sao?"
Bấm nút +1 Giờ (hoặc Khởi chạy). Đồng hồ nhảy sang 09:00, 10:00...
Quan sát kết quả: Tiến độ của 17 task vẫn là 0% và Chi phí vẫn là 0 CHF.
👉 Minh chứng: Dự án không thể tự sinh ra tiến độ nếu thiếu bàn tay con người làm việc!
BƯỚC 3 Quy luật 2: "Gán đúng người, chi phí nhảy tiền thật"
Vào tab Đội ngũ (Team): Gán nhân sự Sue (75 CHF/h) và Tim (65 CHF/h) vào Hoạt động 1.
Quay lại Văn phòng, bấm +1 Giờ.
Quan sát kết quả: Tiến độ Hoạt động 1 tăng ngay ~3.5%. Chi phí trên Whiteboard nhảy đúng +140 CHF tiền lương thật!
BƯỚC 4 Quy luật 3: "Biến cố nổ ra & Ra quyết định tức thời"
Bấm tiếp +1 Giờ cho đến mốc 10:00 (Thứ Hai, Tuần 1). Cô trợ lý xuất hiện mang tài liệu, hộp thoại khẩn cấp tự động mở ra: "Họp khởi động dự án...".
Chọn Phương án A và nhấn Xác nhận Quyết định.
Quan sát kết quả: Modal đóng dứt khoát ngay, Động lực tăng ngay +8 điểm (lên 93), Chất lượng tăng +5 điểm, ghi vào Nhật ký bên phải.
BƯỚC 5 Quy luật 4: "Đường găng CPM & Quản trị Rủi ro"
Vào tab Sơ đồ CPM (Network): 7 công việc đường găng viền đỏ nổi bật. Bất kỳ công việc nào trễ đều kéo sập deadline 11 tuần.
Vào tab Rủi ro (Risk): Bấm triển khai đối phó để triệt tiêu nguy cơ phát sinh biến cố.

⏱️ 3. Cơ Chế Lịch Trình & CPM (Schedule & Critical Path Engine)

Quy tắc kiểm tra tiền nhiệm và công thức tích lũy tiến độ công việc theo giờ

Dự án gồm 11 tuần (55 ngày làm việc, 440 giờ làm việc). Một công việc $T_i$ chỉ được phép bắt đầu tích lũy tiến độ khi thỏa mãn 3 điều kiện đồng thời:

  1. Tuần hiện tại của dự án $\ge$ Tuần bắt đầu dự kiến: $W_{\text{current}} \ge W_{\text{start}}(T_i)$.
  2. 100% công việc tiền nhiệm (Predecessors) đã hoàn thành: $\forall P \in \text{Pred}(T_i), \text{Progress}(P) = 100\%$.
  3. Có ít nhất 1 nhân sự được phân công vào công việc đó ($N_{\text{assigned}} \ge 1$).
ΔProgress_mỗi_giờ = (1 / Thời_lượng_giờ) × SkillFit × 100%

*Ví dụ: Hoạt động 4 (Thiết kế CSDL) chỉ có thể chạy khi Hoạt động 2 (Nghiên cứu thị trường) đã đạt 100%. Nếu gán chuyên gia có SkillFit = 1.25, tốc độ tăng tiến độ nhanh hơn 25%.

👥 4. Cơ Chế Phân Bổ Nhân Sự (Resource Allocation & Skill Fit)

Hệ số năng suất kỹ năng và quy luật đốt chi phí lương thực tế

🔴 NẾU KHÔNG GÁN NGƯỜI THÌ SAO?
1. Tiến độ = 0%: Công việc bị đóng băng hoàn toàn.
2. Chi phí = 0 CHF: Không đốt tiền lương của nhân sự.
3. Hậu quả: Nếu công việc nằm trên Đường Găng, cả dự án bị chậm tương ứng từng giờ, kéo tụt $SPI < 1.0$ và có nguy cơ vỡ hạn chót 11 tuần!

NẾU GÁN SAI NGƯỜI / NGƯỜI THIẾU KỸ NĂNG:

Mỗi công việc yêu cầu các kỹ năng chuyên biệt (Web, DB, Code, Biz, Sales). Hệ số SkillFit biến thiên từ 0.70x (kém) đến 1.25x (giỏi):

Trường Hợp Phân Bổ Hệ Số SkillFit Tốc Độ Tiến Độ Tác Động Chất Lượng
Gán đúng chuyên gia có điểm kỹ năng cao 1.25x Nhanh hơn +25% so với kế hoạch Chất lượng giữ vững hoặc tăng
Gán nhân sự đạt yêu cầu trung bình 1.00x Đúng thời lượng dự kiến Chất lượng ổn định
Gán người trái ngành / thiếu kỹ năng 0.70x Chậm hơn 30% so với kế hoạch Phạt trừ -0.1 điểm Chất lượng/giờ do sinh lỗi
Chi_phí_đốt_mỗi_giờ (BurnRate) = Σ Lương_giờ_nhân_sự_được_gán (CHF/h)

⚡ 5. Hộp Thoại Chi Tiết Hoạt Động & Gán Nhanh Nhân Sự (Activity Detail Modal)

Thao tác trực tiếp từ Biểu đồ Gantt (SCR-03) và Mạng lưới CPM (SCR-07) với 4 lớp kiểm duyệt thông minh

Để tối ưu hóa trải nghiệm điều hành và không bắt buộc PM phải chuyển qua lại liên tục giữa tab Đội dự án và các màn hình tiến độ, hệ thống trang bị hộp thoại ActivityDetailModal tích hợp sẵn ngay tại màn hình Gantt và Mạng lưới CPM.

👆 Cách tương tác: Nhấp chuột trực tiếp vào bất kỳ dòng hoạt động hoặc thanh bar trên Gantt Chart, hoặc nhấp vào bất kỳ khối thẻ nút CPM nào. Modal chi tiết sẽ mở ra ngay lập tức với đầy đủ thông số kỹ thuật, tiến độ % và bảng gán người.

4 Lớp Kiểm Tra Trạng Thái Nhân Sự Thông Minh:

Lớp Kiểm Tra Trạng Thái Phát Hiện Quy Tắc Xử Lý Hệ Thống Hành Động Khóa / Cho Phép
1. Biến Cố Ngoại Cảnh Cá Nhân Nghỉ ốm (sick), Nghỉ lễ (holiday), Đang đào tạo (training) theo tuần thực tế Gắn nhãn cảnh báo rõ ràng: 🤒 Ốm (Tuần W), 🏖️ Nghỉ lễ (Tuần W), 🎓 Đào tạo Khóa nút gán — Ngăn chặn PM giao việc trái đạo đức/luật lao động
2. Tuần Khả Dụng Gia Nhập Nhân sự chưa tới tuần rảnh việc (availableFromWeek > currentWeek) Ví dụ: Alex rảnh từ Tuần 4, Anna từ Tuần 2. Hệ thống gắn nhãn ⏳ Rảnh từ TW Khóa nút gán cho đến khi đồng hồ chạy tới đúng tuần đó
3. Hiện Trạng Phân Công Rảnh rỗi / Đang làm task khác / Đang làm task này • Rảnh: Badge 🟢 Sẵn sàng (Rảnh)
• Bận: Badge Đang làm HĐ #X
• Thuộc task này: Badge ✓ Đang làm HĐ này		 Cho phép Gán nhanh (tự chuyển task) hoặc [Hủy gán] với phản hồi cập nhật tức thời vào DB
4. Đánh Giá Độ Khớp Kỹ Năng So khớp 5 kỹ năng (Web, DB, Code, Biz, Sales) với đòi hỏi của hoạt động • Khớp tốt: Badge ⭐ Rất phù hợp (x1.25 năng suất)
• Thiếu kỹ năng: Badge cảnh báo ⚠️ Thiếu kỹ năng (CODE: 2/4)		 Cảnh báo trực quan trước khi PM quyết định gán để tránh bị phạt trừ chất lượng (-0.1/h)

🚨 6. Cơ Chế Sự Kiện Biến Cố & Pop-up Quyết Định (Decision Engine)

Kịch bản 68 sự kiện chuẩn SimulTrain, tính Idempotency và hình phạt chậm trễ

Kịch bản gồm 68 sự kiện biến cố trong SQLite. Khi đồng hồ chạm trigger_hour, trợ lý ảo bước vào và modal quyết định bật mở tự động.

⚠️ TẠI SAO ĐỒNG HỒ KHÔNG ĐÓNG BĂNG KHI CÓ SỰ KIỆN?
Theo triết lý SimulTrain chuẩn Thụy Sĩ: "Thế giới kinh doanh không dừng lại chờ PM suy nghĩ". Nếu PM bỏ mặc sự kiện và để đồng hồ trôi qua, dự án sẽ tính Hình phạt Chậm trễ (Delay Penalties):
  • Phạt chi phí (Idle Cost): +25 CHF cho mỗi giờ ngâm việc.
  • Phạt tiến độ (Schedule Delay): +0.05 ngày trễ cho mỗi giờ ngâm việc.
  • Phạt động lực (Motivation Penalty): -1 điểm động lực cho mỗi 4 giờ ngâm việc.

Cơ chế chống lặp (Idempotency): Mỗi sự kiện chỉ kích hoạt pop-up đúng 1 lần duy nhất. Khi người dùng bấm Xác nhận hoặc Hủy bỏ, modal đóng dứt khoát và không bị pop lại lần thứ 2.

🔥 7. Cơ Chế Động Lực & Tinh Thần Đội Ngũ (Team Motivation Score)

Thang điểm từ 0 đến 100 (Điểm xuất phát: 85 điểm)

Động_lực_hiện_tại = Clamp(0, 100, 85 + ΔQuyết_định + ΔLịch_trình - Phạt_chậm_trễ)

✅ Yếu tố làm TĂNG động lực:

  • Chấp thuận họp kickoff, thưởng thêm giờ (+5 đến +8 điểm).
  • Tab Lịch: Ăn trưa gắn kết (Lunch: +3 điểm).
  • Tab Lịch: Tiệc nướng BBQ cuối tuần (+6 điểm).
  • Tab Lịch: Hoạt động thể thao (+4 điểm).
  • Họp 1-on-1 giải tỏa bức xúc khi nhân viên bất mãn.

❌ Yếu tố làm GIẢM động lực:

  • Ép buộc tăng ca đêm / cuối tuần (-5 đến -10 điểm).
  • Giao việc quá tải phụ tải (>100% công suất) liên tục.
  • Chậm trễ đưa ra quyết định khi biến cố khẩn cấp xảy ra.
  • Đưa ra các quyết định độc đoán, cắt giảm tiện ích.

⭐ 8. Cơ Chế Chất Lượng Sản Phẩm (Quality Score)

Thang điểm từ 0 đến 100 (Điểm xuất phát: 100 điểm)

Chất lượng phản ánh mức độ đáp ứng đặc tả kỹ thuật và độ tin cậy của hệ thống Thương mại điện tử.

📊 9. Hệ Thống Đo Lường Giá Trị Thu Được (Earned Value Management - EVM)

Bộ công thức chuẩn quốc tế PMI giúp lãnh đạo nắm bắt ngay sức khỏe tài chính dự án

Chỉ Số Tên Đầy Đủ Ý Nghĩa Thực Tế Công Thức Ngưỡng Chuẩn
BAC Budget at Completion Tổng ngân sách được duyệt 220,000 CHF Cố định
PV Planned Value Giá trị kế hoạch cần làm ra đến giờ t Σ (PlannedProgress × Budget) Theo kế hoạch
EV Earned Value Giá trị thực tế công việc đã làm ra Σ (ActualProgress × Budget) Càng cao càng tốt
AC Actual Cost Chi phí thực tế đã đốt (lương + phạt) Lương giờ + Biến cố + Phạt Càng thấp càng tốt
CPI Cost Performance Index Chỉ số hiệu quả sử dụng chi phí CPI = EV / AC CPI ≥ 1.0 (Tiết kiệm)
SPI Schedule Performance Index Chỉ số hiệu quả sử dụng thời gian SPI = EV / PV SPI ≥ 1.0 (Vượt tiến độ)
EAC Estimate at Completion Dự báo tổng chi phí khi hoàn tất dự án EAC = BAC / CPI ≤ 220,000 CHF
VAC Variance at Completion Số tiền thừa / thiếu so với ngân sách VAC = BAC - EAC VAC ≥ 0 (Dư tiền)

🖥️ 10. Hướng Dẫn Chi Tiết Thao Tác 10 Màn Hình Nghiệp Vụ

Bản đồ điều hướng và chức năng của từng màn hình trong hệ thống

Màn 1: Đăng nhập Phiên (SCR-01)

Nhập mã nhóm (Team_01...) và mã phiên để kết nối CSDL SQLite độc lập.

Màn 2: Bàn làm việc PM (SCR-02)

Whiteboard 4 KPI, máy tính iMac mở hòm thư, cô trợ lý ảo, nút điều khiển đồng hồ, nút Reset dự án.

Màn 3: Biểu đồ Gantt (SCR-03)

Theo dõi 17 hoạt động WBS qua 11 tuần. Nhấp vào bất kỳ thanh hoạt động nào để mở Hộp thoại Chi tiết & Gán nhân sự nhanh với 4 lớp kiểm duyệt.

Màn 4: Đội ngũ Nhân sự (SCR-04)

Xem 25 nhân sự, radar kỹ năng, phân công việc và kiểm soát biểu đồ phụ tải (Histogram).

Màn 5: Lịch trình Dự án (SCR-05)

Lập lịch ăn trưa, BBQ, thể thao, đào tạo kỹ năng để phục hồi động lực và chất lượng.

Màn 6: Báo cáo & Radar (SCR-06)

Biểu đồ Radar 4 trục, phân tích phương sai SV, CV và chỉ số EVM tổng hợp.

Màn 7: Mạng lưới CPM (SCR-07)

Tính toán thời điểm sớm/muộn (ES, EF, LS, LF, Slack). Nhấp vào bất kỳ thẻ nút CPM nào để mở modal chi tiết và phân bổ nhân sự.

Màn 8: Ma trận RACI (SCR-08)

Phân định rõ Responsible, Accountable, Consulted, Informed cho 17 hoạt động.

Màn 9: Ngân sách & S-Curve (SCR-09)

Đường cong chi phí S-Curve đối chiếu PV, EV và AC giúp phát hiện sớm nguy cơ thâm hụt.

Màn 10: Sổ Rủi ro (SCR-10)

Quản lý 15 rủi ro dự án, tính giá trị kỳ vọng (EMV) và triển khai phương án đối phó.

💾 11. Đặc Tả Kỹ Thuật CSDL SQLite Native & Cấu Hình Biến Môi Trường (.env)

Kiến trúc lưu trữ bền vững, cơ chế WAL và cách tùy biến môi trường triển khai

🚀 Không cần cài đặt CSDL bên ngoài: SimulPM chạy hoàn toàn bằng mô-đun node:sqlite nhúng trực tiếp trong Node.js (v22.5+), khởi tạo tệp CSDL tại web/simulpm.db với chế độ ghi trước WAL (Write-Ahead Logging) cho tốc độ tức thời và an toàn dữ liệu.

📁 Tệp Cấu Hình Biến Môi Trường

Tạo hoặc tùy chỉnh tệp web/.env.local (dựa theo mẫu web/.env.example):

# Đường dẫn tệp SQLite Native
DATABASE_PATH=simulpm.db

# Môi trường chạy
NODE_ENV=development
PORT=3001

📊 9 Bảng Dữ Liệu Thời Gian Thực

  • sessions: Giờ, ngày, tuần, phase, 4 KPI.
  • tasks: 17 hoạt động WBS, % tiến độ, chi phí đốt, gán người.
  • team_members: 25 nhân sự, lương giờ, kỹ năng, task ID.
  • decisions: Lịch sử ra quyết định và tác động 4 chỉ số.
  • events: 68 biến cố kịch bản chuẩn SimulTrain.
  • risks, calendar_events, raci_matrix, kpi_history.

❓ 12. Câu Hỏi Thường Gặp (FAQ Dành Cho Người Thử Nghiệm)

Giải đáp nhanh các tình huống thực tế khi chạy thử nghiệm

Q1: Tải lại trang (F5) hoặc chuyển tab có bị mất dữ liệu không?

Tuyệt đối không. Hệ thống lưu trữ 100% dữ liệu vào SQLite Native (chế độ WAL). Mọi tiến độ, đồng hồ và quyết định đều được bảo toàn trọn vẹn.

Q2: CSDL đang chạy ở đâu và làm sao để cấu hình đường dẫn khác?

Tệp cơ sở dữ liệu mặc định nằm tại web/simulpm.db. Bạn có thể thay đổi đường dẫn này bằng cách đặt biến môi trường DATABASE_PATH=/duong/dan/moi/db.sqlite trong tệp web/.env.local. Khi chạy, hệ thống sẽ tự động tạo bảng và nạp 100% dữ liệu chuẩn nếu tệp mới chưa có.

Q3: Làm thế nào để reset lại từ đầu để thử nghiệm một kịch bản khác?

Tại màn hình Văn phòng, nhấn nút màu đỏ [Reset Dự Án] ở góc trên bên phải. Hệ thống sẽ đưa đồng hồ về Tuần 1 (08:00), hủy gán nhân sự, đưa tiến độ và chi phí về 0 và khôi phục 68 sự kiện chưa giải quyết.

Q4: Làm thế nào để đạt điểm số tối đa khi kết thúc dự án?

Tiêu chuẩn xếp loại PM xuất sắc: Giữ $CPI \approx 1.0$ (không vượt 220,000 CHF), $SPI \ge 1.0$ (hoàn tất 17 task trước hoặc đúng hạn 11 tuần), Chất lượng $\ge 90$ điểm và Động lực $\ge 85$ điểm.