# Hướng Dẫn Vận Hành Xử Lý & Lưu Trữ Báo Cáo (Skill Guide)

Tài liệu này hướng dẫn quy trình 2 bước tự động hóa việc đọc, trích xuất thông tin (OCR) từ các báo cáo thô nằm tại thư mục `Raw-Report` bằng AI, sau đó lưu trữ có hệ thống và tạo báo cáo tổng hợp tuần.

> **QUY TẮC PHẠM VI**: Chỉ làm việc với các nội dung nằm trong thư mục: `C:\antigra-DS\CLAW_LAM_VIEC\Bao cao - Hanh chinh\Dac-Phai-VIen-KT`.

---

## Danh Mục Phân Công Chuẩn Hóa Kỹ Thuật Viên & Nhà Máy

| STT | Kỹ thuật viên (Phái viên) | Danh sách Khách hàng / Nhà máy phụ trách |
| :---: | :--- | :--- |
| **1** | **Nguyễn Duy Tài** | BẢO HƯNG, THIẾT ĐAN |
| **2** | **Nguyễn Văn Linh** | DEMEYER, GEUTHER, MEKONG |
| **3** | **Nguyễn Đức Thăng** | KIM HUY, KIM PHONG |
| **4** | **Nguyễn Minh Thoại** | MINH HƯNG TIỀN, TÂN VIỆT TIẾN |
| **5** | **Lê Quang Khải** | TRƯỜNG THÀNH, Minh Dương |
| **6** | **Nguyễn Văn Đen** | ĐĂNG LONG, HẠNH PHÚC |
| **7** | **Lê Văn Hòa** | LIÊN MINH, ĐẤT MỚI |

---

## BƯỚC 1: TRÍCH XUẤT & PHÂN LOẠI (EXTRACT & CLASSIFY)

Khi nhận được các báo cáo rời rạc trong thư mục `Raw-Report` (dưới dạng file `.docx`, `.pdf` dạng văn bản/hình ảnh, hoặc các ảnh chụp bản viết tay `.jpg`, `.jpeg`, `.png`):

1. **Trích xuất nội dung bằng AI**:
   - Sử dụng script tự động gọi mô hình phù hợp (Gemini API) để đọc, nhận diện chữ viết tay và trích xuất toàn bộ nội dung báo cáo gốc một cách chính xác nhất.
2. **Lưu trữ văn bản trích xuất**:
   - Tạo file `.txt` hoặc `.md` chứa nội dung đã trích xuất.
   - Đặt tên file liên quan đến thông tin Ngày báo cáo (VD: `Nguyễn_Duy_Tài-BẢO_HƯNG-01-08-2026.txt`).
   - Lưu vào thư mục tương ứng theo số tuần tại: `Raw-Report/Da-Xu-Ly/Noi-Dung-TXT/Tuan-XX/`
3. **Lưu trữ file gốc**:
   - Di chuyển các file gốc (ảnh chụp, tài liệu PDF, DOCX) vào thư mục: `Raw-Report/Da-Xu-Ly/Hinh-Anh/Tuan-XX/`

---

## BƯỚC 2: TẠO BÁO CÁO TỔNG HỢP (WEEKLY SUMMARY REPORT)

Truy cập vào thư mục chứa các file văn bản đã được trích xuất ở Bước 1 (`Raw-Report/Da-Xu-Ly/Noi-Dung-TXT/Tuan-XX/`) để làm báo cáo tổng hợp tuần. Báo cáo tổng hợp được lưu vào thư mục `Bao-Cao-Tuan/` với định dạng `.docx` hoặc `.md`.

Báo cáo tổng hợp phải tuân thủ cấu trúc gồm 2 phần sau:

### Phần 1: Nêu bật các vấn đề nóng (Executive Summary)
- Tóm tắt các vấn đề nghiêm trọng, khẩn cấp phát sinh trong tuần từ các nhà máy.
- Tiến độ các mẫu hàng gấp hoặc phản hồi quan trọng của khách hàng.
- Các kiến nghị/đề xuất trọng tâm cần giải quyết ngay.

### Phần 2: Chi tiết cụ thể từng báo cáo (Detailed Reports)
- Trình bày chi tiết báo cáo của từng kỹ thuật viên/nhà máy phụ trách.
- **Yêu cầu bắt buộc**: Giữ nguyên nội dung gốc bóc tách được từ kỹ thuật viên ở Bước 1, không tự ý thêm bớt hoặc làm sai lệch câu chữ gốc.

---

## Hướng dẫn sử dụng công cụ Python

Để chạy toàn bộ quy trình trên, mở terminal tại thư mục làm việc và sử dụng script `process_reports.py`:

```bash
# Bước 1: Trích xuất và phân loại các báo cáo thô trong Raw-Report/
python process_reports.py --action extract

# Bước 2: Tạo báo cáo tổng hợp cho tuần chỉ định (ví dụ tuần 31)
python process_reports.py --action summarize --week 31
```