Handoff S170 → Phiên mới

Ngày: 2026-04-04 | Phiên: S170 (INFRA + KB v2 + API fix)

TÓM TẮT 1 CÂU

S170 ĐÓNG: Backup ✅, KB Protection v2 UPSERT ✅, mem_limit ✅, API 4 bugs fix ✅, OR v7.46 271 DOT. Còn: §2.2 naming + §12.3 DOT types (~5 phút) → Đ37 GĐ2.

API FIX (mới nhất)

GET 401→200, POST 422→201, PUT revision→409, 401→403. DOT_API_HEALTH daily. 6/6 E2E PASS. Files changed: server.py (auth, parent_id, revision), pg_store.py (WHERE revision clause).

CÒN NHỎ

1. §2.2 naming: verify snapshot_at vs date_created trên kb_documents_history + kb_audit_log
2. §12.3 DOT types: set dot_type cho DOT_KB_PROTECT, DOT_KB_VERIFY, DOT_KB_RESTORE, DOT_API_HEALTH

SAI LẦM + BÀI HỌC

#	Sai	Bài học
1	Prompt 200+ dòng, sửa 23 lần	MẪU S135H ≤60 dòng. Nói WHAT không HOW.
2	INSERT history tích tụ	"Không tạo rác" > "Dọn rác". UPSERT.
3	Trigger+session var thay WHERE clause	PG FIRST: WHERE clause đơn giản nhất.
4	AP-CLOSE 4 lần liên tiếp	Anti-pattern cố hữu.
5	Không đối chiếu Đ33	Luật liên quan PHẢI đọc trước khi soạn.

VIỆC TIẾP

1. §2.2 + §12.3 (~5 phút)
2. Đ37 GĐ2 — 12 TD ← NEXT
3. S150-P3 + Đ28

TÀI LIỆU

File	Rev
OR	v7.46 rev 31
Tracker	rev 12
Handoff	rev 5
API fix report	reports/api-upload-fix-report
KB v2 report	reports/s170-final-kb-v2-report

---

S170 ĐÓNG | 271 DOT | Tiếp: §2.2 → Đ37 GĐ2