File size: 3,154 Bytes
f689c7d
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
# TaskPilot Bi-Weekly Progress Tracker Package

Gói công cụ và thư mục quản lý tiến độ thực hiện Đồ án 2 (SE121 - UIT).  
Tự động hóa theo dõi, ghi nhận mốc thời gian, phân tích ý nghĩa/tác dụng kỹ thuật và xuất báo cáo tiến độ 2 tuần một lần gửi Giảng viên hướng dẫn.

---

## 📁 Cấu trúc thư mục (Directory Structure)

```
progress-tracker/
├── README.md                      # Tài liệu hướng dẫn sử dụng gói
├── PROGRESS_INDEX.md              # Bảng mục lục tổng hợp tiến độ toàn bộ các đợt
├── templates/
│   └── biweekly-progress-template.md  # Biểu mẫu báo cáo chuẩn theo mẫu Đồ án UIT
├── logs/
│   ├── period-2026-w35-w36.md     # Báo cáo chi tiết đợt 1 (Tuần 35-36)
│   └── template.md                # Biểu mẫu trắng để nhân bản cho kỳ mới
└── scripts/
    ├── generate_biweekly_report.py# Tool tự động quét Git commit 3 repos & xuất báo cáo
    └── log_milestone.py           # Tool CLI ghi nhanh công việc vừa hoàn thành
```

---

## 🚀 Hướng Dẫn Sử Dụng

### 1. Ghi nhận nhanh một công việc vừa hoàn thành (Quick Milestone Logging)
Khi bạn hoặc AI Agent vừa hoàn thành một đợt refactor, viết xong tính năng, hoặc sửa lỗi:
```bash
python3 progress-tracker/scripts/log_milestone.py \
  --period "2026-W35-W36" \
  --task "Refactor Backend Controllers using ApiResponse helpers" \
  --category "BE" \
  --impact "Loại bỏ 397 dòng boilerplate, chuẩn hóa mã HTTP response, tăng tốc độ bảo trì" \
  --metrics "-397 LOC, 100% test pass"
```

### 2. Tự động quét Git commits và xuất dự thảo báo cáo 2 tuần (Auto-generate Bi-Weekly Report)
Vào ngày cuối của chu kỳ 2 tuần, chạy lệnh:
```bash
python3 progress-tracker/scripts/generate_biweekly_report.py \
  --period "2026-W35-W36" \
  --start-date "2026-08-25" \
  --end-date "2026-09-08"
```
Script sẽ tự động:
- Đọc git log từ cả 3 kho mã: `taskpilot` (Backend), `taskpilot-frontend` (Frontend), và `report` (Báo cáo).
- Phân loại commit (`refactor`, `feat`, `fix`, `docs`, `test`, `chore`).
- Thống kê tổng số dòng code thêm (+), bớt (-), tính toán LOC tối ưu.
- Điền sẵn vào mẫu báo cáo tại `progress-tracker/logs/period-YYYY-Wxx-Wyy.md`.

### 3. Cập nhật Bảng tổng quan tiến độ (Master Index)
Mỗi đợt báo cáo mới sẽ được ghi một dòng vào `PROGRESS_INDEX.md` để theo dõi xuyên suốt từ đầu kỳ (01/09/2026) đến cuối kỳ (01/01/2027).

### 4. Đồng bộ lên GitHub
Gói công cụ này được thiết kế để nằm trực tiếp trong kho mã nguồn Git (`taskpilot` và `report`), bạn chỉ cần chạy:
```bash
git add progress-tracker/ .agents/skills/biweekly-progress-tracker/
git commit -m "docs(progress): update bi-weekly progress logs"
git push origin main
```
Toàn bộ lịch sử tiến độ sẽ được lưu trữ an toàn trên GitHub!