init git

.claude/skills/sa-3-enablement/templates/design-review-log.md

@@ -0,0 +1,150 @@
+# DREV — Design Review Log — <PROJECT>
+
+| | |
+|---|---|
+| **Cập nhật** | YYYY-MM-DD |
+| **Author** | <SA> (skill sa-3-enablement) |
+| **Scope** | |
+
+> **Đây là sổ sống** — ghi thêm liên tục, không lên version, không archive. Mục cũ không bao
+> giờ sửa; sai thì thêm mục mới tham chiếu ngược.
+
+---
+
+## 1. Tóm tắt
+
+| Trạng thái | Số mục |
+|---|---|
+| Đang chờ SA (⏳) | |
+| Đã kết luận, đang thực hiện | |
+| Đã đóng | |
+| Sinh ra `ADR` mới | |
+| Sinh ra `TD` | |
+
+**Thời gian chờ trung bình:** … ngày · **mục tiêu: ≤ 2 ngày làm việc**
+
+🔴 Chờ lâu hơn 2 ngày thì dev sẽ đi tiếp mà không chờ — và review thành phê bình sau khi đã
+code xong: vô ích và gây mâu thuẫn.
+
+## 2. Nhật ký
+
+### DREV-nnn — <tiêu đề ngắn>
+
+| | |
+|---|---|
+| **Ngày nhận** | |
+| **Người hỏi** | |
+| **Loại** | ❓ câu hỏi làm rõ · 🔧 đề xuất thay đổi thiết kế · ⚠️ phát hiện thiết kế sai |
+| **Trạng thái** | ⏳ chờ SA · 🔄 đang thực hiện · ✅ đóng |
+| **Ngày kết luận** | |
+
+**Bối cảnh** — *(dev mô tả gì, đang gặp vấn đề gì thật)*
+
+**Điểm radar** *(theo `../../sa-lifecycle/references/decision-radar.md` §2)*
+
+| Tiêu chí | Điểm | Lý do |
+|---|---|---|
+| Chi phí đảo ngược | | |
+| Bán kính ảnh hưởng | | |
+| Chạm thuộc tính chất lượng | | |
+| Ràng buộc dài hạn | | |
+| Tranh cãi | | |
+| **Tổng** | /10 | ⇒ *(0–2 trả Tech Lead · 3–4 `DEC` · 5–7 `ADR` · 8–10 `ADR` + POC)* |
+
+**Đối chiếu thiết kế**
+
+| Tài liệu | Nội dung liên quan | Có mâu thuẫn không |
+|---|---|---|
+| `ADR-nnn` | | |
+| `QAS-nnn` | | |
+| `SAD` §… | | |
+
+**Phương án** — *(≥ 2, kể cả khi dev chỉ đưa 1. Phần lớn giá trị của review nằm ở đây.)*
+
+| # | Phương án | Ưu | Nhược | Chi phí |
+|---|---|---|---|---|
+| 1 | | | | |
+| 2 | | | | |
+
+**Kết luận** — chọn đúng một trong bốn:
+
+- [ ] ✅ **Đúng thiết kế** — không cần làm gì
+- [ ] 🟡 **Lệch nhưng chấp nhận được** ⇒ `TD-nn`, hạn …
+- [ ] 🔴 **Lệch phải sửa** ⇒ việc: …, chủ: …, hạn: …
+- [ ] ⚠️ **Thiết kế sai, cần `ADR` mới** ⇒ `ADR-nnn` (`Supersedes: ADR-nnn`)
+
+**Người quyết · ngày:** …
+
+**Việc phát sinh**
+
+| Việc | Chủ | Hạn | Ghi ở đâu |
+|---|---|---|---|
+
+---
+
+### DREV-nnn — <tiêu đề>
+
+*(cùng cấu trúc)*
+
+---
+
+## 3. Mẫu tham khảo — một mục đã hoàn chỉnh
+
+### DREV-012 — Gọi thẳng CSDL module Order từ module Report
+
+| | |
+|---|---|
+| **Ngày nhận** | 2026-09-12 |
+| **Người hỏi** | anh Nam (dev) |
+| **Loại** | 🔧 đề xuất thay đổi thiết kế |
+| **Trạng thái** | ✅ đóng |
+| **Ngày kết luận** | 2026-09-13 |
+
+**Bối cảnh** — Báo cáo tổng hợp cần join 3 bảng của module Order. Gọi qua interface công khai
+mất 4,1 giây, vượt `QAS-003` (p95 ≤ 3s). Dev đề xuất truy vấn thẳng CSDL của Order.
+
+**Điểm radar: 8/10** — chi phí đảo ngược 1 · bán kính 2 · chạm `QAS` 2 · ràng buộc dài hạn 2 ·
+tranh cãi 1 ⇒ cần `ADR`, không quyết trong PR.
+
+**Đối chiếu:** `ADR-004` chốt module chỉ giao tiếp qua interface công khai. `QAS-003` yêu cầu
+p95 ≤ 3s — **thiết kế hiện tại không đạt**. Dev đúng về vấn đề, sai về cách giải.
+
+**Phương án**
+
+| # | Phương án | Ưu | Nhược | Chi phí |
+|---|---|---|---|---|
+| 1 | Giữ ranh giới + read model riêng cho báo cáo | Đúng `ADR-004`, mở đường tách service | Thêm cơ chế đồng bộ | +1 tuần |
+| 2 | Giữ ranh giới + cache kết quả | Rẻ nhất, +2 ngày | Dữ liệu trễ ≤ 5 phút | +2 ngày |
+| 3 | Gọi thẳng CSDL | Nhanh nhất | Vi phạm `ADR-004`, chặn việc tách service sau này | +0 |
+| 4 | Nới `QAS-003` lên 5s | Không phải làm gì | Cần PO chấp nhận | +0 |
+
+**Kết luận:** ⚠️ hỏi PO trước (`OQ-034`: báo cáo trễ 5 phút có chấp nhận được không).
+PO trả lời 2026-09-13: chấp nhận ⇒ chọn **PA-2**.
+
+**Người quyết:** SA + Tech Lead, sau khi PO trả lời `OQ-034` · 2026-09-13
+
+**Việc phát sinh**
+
+| Việc | Chủ | Hạn | Ghi ở đâu |
+|---|---|---|---|
+| Bổ sung `QAS-003` ghi rõ "dữ liệu báo cáo trễ ≤ 5 phút" | SA | 2026-09-15 | `QAS` v1.1 |
+| Ghi `DEC-07` về mức trễ chấp nhận được | SA | 2026-09-15 | `00-index/DEC` |
+| Cài cache + cơ chế làm mới | anh Nam | 2026-09-19 | |
+
+---
+
+## 4. Câu hỏi lặp lại ⇒ tài liệu chưa rõ
+
+*Cùng một câu hỏi từ ≥ 2 người ⇒ không phải lỗi của dev, là lỗi của tài liệu.*
+
+| Câu hỏi | Số lần bị hỏi | Tài liệu phải sửa | Đã sửa |
+|---|---|---|---|
+| | | `AGD` §… / `ICD` §… | ☐ |
+
+## 5. Phản hồi "kiến trúc không thực tế"
+
+*Cùng một phản hồi về cùng một chỗ, ≥ 3 lần ⇒ khả năng cao thiết kế sai thật.*
+
+| Chỗ bị phản hồi | Số lần | Ai | Đã đánh giá lại | Kết luận |
+|---|---|---|---|---|
+| | | | ☐ | |