Spaces:
Running
Running
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!
|