# HƯỚNG DẪN LÀM SẠCH DỮ LIỆU BÁO CÁO LÀM MẪU (SKILL LÀM SẠCH & BÁO CÁO)

## 1. Quy tắc ánh xạ trạng thái mẫu
* **DK (Đã Ký)**: Tương ứng với cột "KH đã ký" (Cột O trong file gốc). Cần được ưu tiên kiểm tra đầu tiên vì một mẫu đã ký có thể vẫn được đánh dấu đã hoàn thành.
* **HT (Hoàn Thành)**: Tương ứng với cột "Đã hoàn thành" (Cột N trong file gốc).
* **ĐL (Đang làm)**: Tương ứng với cột "Đang làm" (Cột M trong file gốc).

## 2. Chuẩn hóa dữ liệu nhân sự (Tên kỹ thuật)
* `Trần Dũng` / `Trần dũng` / `Trần dung` $\rightarrow$ **Trần Dũng**
* `Trần Thanh dung` $\rightarrow$ **Trần Thanh Dũng**
* `Nguyên hưu lợi` / `Nguyễn hưu lợi` / `HỮU LỢI` $\rightarrow$ **Nguyễn Hữu Lợi**
* `V.Thưởng` / `V. Thuởng` / `Thưởng` $\rightarrow$ **Trần Văn Thưởng** / **Thưởng** (theo danh sách chuẩn hóa)

## 3. Cách sử dụng công cụ tự động làm sạch (Skill Code)
Công cụ làm sạch được lưu trữ tại file: [data_cleaner.py](file:///C:/antigra-DS/CLAW_LAM_VIEC/Bao%20cao%20-%20Hanh%20chinh/Bao%20cao%20lam%20mau/data_cleaner.py)

Lệnh chạy làm sạch một file bất kỳ:
```bash
python data_cleaner.py <đường_dẫn_file_gốc.xlsx> <đường_dẫn_file_sạch_đầu_ra.xlsx>
```

**Ví dụ:**
```bash
python data_cleaner.py "TUẦN 24 (08-14.06).xlsx" "da lam sach/Tuan_24_08-14.06_DA-LAM-SACH.xlsx"
```

## 4. Cách tạo báo cáo so sánh đối chiếu 4 tuần (Reporting)
Công cụ tạo báo cáo Word (.docx) được lưu trữ tại file: [generate_report.py](file:///C:/antigra-DS/CLAW_LAM_VIEC/Bao%20cao%20-%20Hanh%20chinh/Bao%20cao%20lam%20mau/generate_report.py)

Lệnh chạy tạo báo cáo:
```bash
python generate_report.py
```
*Lưu ý: Chương trình sẽ tự động lấy dữ liệu từ 4 file sạch gần nhất trong thư mục `da lam sach` để đối chiếu.*

Báo cáo kết quả sẽ được xuất ra tại thư mục `Bao cao`:
[Bao_cao_tien_do_lam_mau_tuan_24_27.docx](file:///C:/antigra-DS/CLAW_LAM_VIEC/Bao%20cao%20-%20Hanh%20chinh/Bao%20cao%20lam%20mau/Bao%20cao/Bao_cao_tien_do_lam_mau_tuan_24_27.docx)