---
description: Vòng lặp Dọn dẹp Rác Backend - Tự động quét và gom nhóm các file log, scratch script, temp output vào đúng thư mục chuẩn.
---

# Backend Junk Cleanup Workflow (Dọn Rác)

**CONCEPT:** Workflow này dùng để ra lệnh cho AI (như tao) tự động dọn dẹp các thư mục làm việc, đặc biệt là thư mục `backend`, tránh việc xả rác file tạm, file log và script nháp lung tung.

## CÁC BƯỚC THỰC HIỆN

### 🧹 Bước 1: Quét và Định vị Rác
Sử dụng tool `list_dir` để soi thư mục Root của `backend` (hoặc thư mục được chỉ định). Hãy tìm các loại file sau:
1. **Scratch Scripts:** Các file Python bắt đầu bằng `scratch_`, `test_`, `eval_`, `dump_`... (chỉ dùng để test nháp 1 lần).
2. **Output/Logs:** Các file `*.json`, `*.txt` do AI/Agent nhả ra trong lúc test (vd: `response.json`, `audit_out.txt`, `log.txt`).
3. **Runners:** Các file script điều khiển như `run.txt`, `*.sh`, `*.ps1`.

### 📂 Bước 2: Tạo cấu trúc thư mục Scripts chuẩn
Nếu chưa có, hãy tạo cấu trúc thư mục sau bên trong `backend/`:
- `scripts/`
  - `scripts/scratch/` (để chứa các đoạn code test/nháp)
  - `scripts/outputs/` (để chứa các file log, json output rác)

### 🚚 Bước 3: Di chuyển file
Sử dụng tool `run_command` (với lệnh PowerShell) để dọn dẹp:
1. **Move** tất cả file thuộc nhóm **Scratch Scripts** vào `scripts/scratch/`.
2. **Move** tất cả file thuộc nhóm **Output/Logs** vào `scripts/outputs/`.
3. **Move** tất cả **Runners** vào `scripts/` (trừ khi nó cần nằm ở ngoài phục vụ Docker thì giữ lại 1 bản).

> [!WARNING] Cẩn thận rác thật với hàng xịn
> Tuyệt đối không chạm vào các file cấu hình quan trọng như `.env`, `requirements.txt`, `server.py`, `worker.py`, hay `config.py`.

### ✅ Bước 4: Kiểm tra lại (Verification)
Chạy lại lệnh `ls` hoặc `list_dir` trong thư mục gốc. 
Nếu chỉ còn lại các file chính thức yếu nhân của server, hãy thông báo: "🎉 Chúc mừng bro, nhà đã sạch bóng!"
