--- **Đóng vai:** Bạn là một Senior System Anal...

---

Đóng vai: Bạn là một Senior System Analyst kiêm Lập trình viên Full-stack (Laravel/VueJS) kỳ cựu. Tôi sẽ cung cấp cho bạn toàn bộ mã nguồn của dự án "Hệ thống quản lý nhân viên" (Mã dự án: 2306-2308-D1-Intern-N-PHP).

Nhiệm vụ: Đọc, phân tích sâu mã nguồn thực tế và viết một file README.md cực kỳ chi tiết mang văn phong học thuật CNTT. File README này không chỉ dùng để hướng dẫn sử dụng mà còn là nguồn dữ liệu cốt lõi để tôi đưa vào "Báo cáo thực tập tốt nghiệp" (đáp ứng chuẩn đầu ra CLO của trường Đại học).

Yêu cầu bắt buộc: Bỏ qua các hướng dẫn cài đặt cơ bản. Hãy tập trung bóc tách kiến trúc, cơ sở dữ liệu, API, kiểm thử và luồng logic trực tiếp từ code. Tuyệt đối không bịa đặt dữ liệu.

Hãy cấu trúc file README.md theo định dạng Markdown với 9 phần sau:

1. TỔNG QUAN DỰ ÁN (Project Overview)

• Giới thiệu bài toán hệ thống quản lý nhân sự số hóa.
• Liệt kê công nghệ (Tech Stack) chi tiết: Backend (PHP, Laravel 10.x, Eloquent ORM, Sanctum), Frontend (VueJS 3, Composition API), Infrastructure (Docker, Gitlab-CI), Database (MySQL).

2. KHUNG THAM CHIẾU VÀ TIÊU CHUẨN KỸ THUẬT (Technical Standards)

• Liệt kê các chuẩn coding convention đã áp dụng (PSR-12 cho PHP/Laravel, VueJS Style Guide).
• Chuẩn thiết kế API (RESTful API guidelines).
• Tiêu chuẩn bảo mật (Mã hóa mật khẩu, Authentication bằng Bearer Token qua Sanctum, OWASP Top 10).
• Chuẩn hạ tầng (Docker Engine Specification).

3. PHÂN TÍCH & THIẾT KẾ HỆ THỐNG (System Architecture & Design)

• Tóm tắt luồng hoạt động Client-Server tách biệt.
• Phân tích 3 Tác nhân (Actors) chính và các Usecase tương ứng: Root account, Manager (Quản lý phòng ban), Employee (Nhân viên).
• Thiết kế Database: Đọc các file thư mục database/migrations và kẻ bảng Markdown mô tả các bảng chính (users, employee_profiles, departments, attendances, company_holidays, leave_requests). Bao gồm: Tên trường, Kiểu dữ liệu, Ràng buộc khóa, Mô tả.
• Sơ đồ tuần tự (Sequence Diagram bằng Mermaid.js): Đọc code Controller/Action và sinh ra mã Mermaid.js cho 2 luồng:
  (1) Luồng Check-in/Check-out.
  (2) Luồng Xin nghỉ phép (Từ lúc nộp đơn -> Manager duyệt).

4. ĐẶC TẢ RESTFUL API CHI TIẾT (API Specifications)

• Kẻ một bảng tổng hợp các API quan trọng nhất từ file routes/api.php. Cột bao gồm: HTTP Method | Endpoint | Auth/Role | Chức năng (Controller@method) | HTTP Status Codes trả về.

5. DANH SÁCH TÍNH NĂNG CHI TIẾT (Features & Modules)

• Root: Quản lý tài khoản, Quản lý phòng ban, Lịch nghỉ lễ (Company Holiday), Gửi email xác thực.
• Manager: Xem danh sách cấp dưới (lọc tháng, tổng giờ), Duyệt/Từ chối đơn xin nghỉ (kèm lý do), Xuất file báo cáo Excel.
• Employee: Đăng nhập, Đổi mật khẩu lần đầu, Quản lý Profile, Check-in/Check-out, Xin nghỉ phép.

6. BÓC TÁCH KỸ THUẬT & GIẢI QUYẾT KHÓ KHĂN (Challenges & Solutions)
Hãy đọc code và giải thích chi tiết cách hệ thống xử lý các vấn đề sau dưới góc độ kỹ thuật:

• Vấn đề 1: Xung đột Docker (File không cập nhật sau khi đổi code) -> Giải quyết bằng cấu hình mount volume trong docker-compose.yml.
• Vấn đề 2: Lỗi lệch tham số định tuyến (Route parameters mismatch) khi thực hiện CRUD phòng ban.
• Vấn đề 3 (Cực kỳ quan trọng): Đảm bảo tính toàn vẹn dữ liệu khi đồng bộ bảng users và employee_profiles bằng kĩ thuật Database Transactions (Begin, Commit, Rollback).
• Vấn đề 4 (Cực kỳ quan trọng): Chặn spam và khắc phục lỗi tính toán âm giờ khi bấm Check-in/Check-out quá nhanh (Sử dụng thư viện Carbon và hàm trị tuyệt đối abs()).

7. KIỂM THỬ HỆ THỐNG (System Testing)

• Đọc các file trong thư mục app/Http/Requests. Suy luận và kẻ một bảng Test Cases (khoảng 5-7 cases cốt lõi).
• Các cột: STT | Chức năng | Dữ liệu đầu vào (Input) | Kết quả mong đợi.
• Bắt buộc phải có các test case: (1) Đăng nhập sai tài khoản, (2) Thêm nhân viên trùng Email, (3) Thao tác check-in quá nhanh gây âm giờ.

8. LỘ TRÌNH TRIỂN KHAI (Task Roadmap)

• Tóm tắt lộ trình phát triển qua 16 tasks (Từ khảo sát Specs, thiết kế Database, init Docker, CRUD, đến Timesheet).
• Lưu ý: Phải làm nổi bật "Task 2: Q&A (Issue #2)" để chứng minh năng lực giao tiếp, làm rõ yêu cầu với khách hàng/Mentor trước khi code.