[CLAUDE] Docs: S179 closeout — va doi STYLE 2 vong (C7 bat 2 MAJOR trong chinh ban va) + H24 9 FLAG + drift-audit thang
Some checks failed
Deploy SOLUTION_ERP / build-deploy (push) Has been cancelled
Some checks failed
Deploy SOLUTION_ERP / build-deploy (push) Has been cancelled
SUA-1..6b tron 6/6, acceptance C1-C6b 12/12. Vong-2 sua chinh vong-1 sau reviewer C7 (PASS-WITH-8, 3 MAJOR):
- Doi ba-cham -> hai-cham la REGRESSION co dieu-kien, KHONG phai cosmetic: chi tuong-duong khi origin/main
con ancestor; cay phan-ky thi hai-cham liet ca file CHI CO tren origin/main (= DA PRODUCTION) vao "phan MOI".
Thu pham that = git diff mu untracked. Sandbox 2 chieu CONFIRMED.
- git status --porcelain | cut -c4- de path RAC (rename in MOT dong "R old -> new"; path co dau cach bi quote).
Sandbox: 2/2 MISS; thuoc moi 2/2 OK.
- Thuoc CHOT 4/4 site: { git diff --name-only origin/main...HEAD; git diff --name-only HEAD;
git ls-files -o --exclude-standard; } | sort -u
Bai: chan-doan sai VAN pass acceptance — acceptance do HINH-DANG chuoi, khong do HANH-VI.
Lop mo-neo TU-VO-HIEU: con-tro so-dong tro vao CHINH tep chua no tu thoi moi lan sua dau tep
(112->118->121 trong 1 phien) => neo TEN, khong neo SO DONG. Ap cho index.css, gotchas.md, PipelineStageFolders.
Con-tro verbatim _mind doi ve commit DA PUSH (ee21056/d081681) — ban truoc tro 727a512 nam trong dai squash
=> tu de con-tro mo-coi.
H24 light-audit 9 FLAG, flush 8 o canonical: Mig 71->72 - Gotchas 86->87 - Tests 644->645 (chay that
dotnet test: 45 Domain + 600 Infra, 0 fail) - user-mem 59->60 - header S168->S179 - roster 23->26 (go han so
theo B1) - HANDOFF dong 4 slot (68)-(71) + E4.
"So noi doi theo huong BI QUAN" x3 ca/1 phien (4 slot - E4 - run.md S173) => leo thang lan 3 phai DO LAI TIEN-DE.
Kem: 2 NO vong-3 - 2 synthesis ORPHAN (run-chua-gom 2->0) - di-tru cua-so 6 vao _context - keo+ap 2 thu
loi-do-luong (BAC Lop 8 CO SO: mtime cum SE 0,7% vs hub 69%) - drift-audit thang PASS_WITH_FLAGS-8 (va 2, con 6)
- _mind 99,67%->84,2% - don 9 dir rong - archive-gate strike 1/2.
#53: 4/4 vai garble return dau, vot tron 4/4 bang resume-in-session. Mat 0 byte.
0 file code nghiep-vu. Build 2/2 app PASS. Test 645/645.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@ -23,16 +23,36 @@ Mày soi **ĐỒNG-NHẤT QUY-ƯỚC** tầng DB. Mày **KHÔNG** phán schema t
|
||||
Ở tầng DB luật này **mạnh hơn mọi tầng khác**, vì migration **đã apply prod thì không rút lại được** — bảng/cột đặt lệch quy-ước sẽ sống mãi và mọi thứ sau phải sống chung với nó.
|
||||
|
||||
```bash
|
||||
git diff --name-only origin/main...HEAD -- '*Persistence*' # phần MỚI
|
||||
# migration CÒN LẠI trên origin/main = ĐÃ APPLY PROD = CHUẨN
|
||||
# phần MỚI (CHƯA phải chuẩn) = đã-commit-trên-nhánh ∪ đang-sửa ∪ untracked, lọc địa-phận DB
|
||||
{ git diff --name-only origin/main...HEAD # ĐÃ COMMIT — BA-chấm, neo merge-base
|
||||
git diff --name-only HEAD # đang sửa (tracked); tách rename thành 2 vế
|
||||
git ls-files -o --exclude-standard # UNTRACKED ← migration mới NẰM Ở ĐÂY
|
||||
} | sort -u | grep -i 'Persistence/'
|
||||
# migration CÒN LẠI trên origin/main = ĐÃ APPLY PROD = CHUẨN — 🔴 ĐỌC 2 RÀO DƯỚI TRƯỚC
|
||||
```
|
||||
|
||||
> 🔴 **THỦ PHẠM THẬT = `git diff` MÙ UNTRACKED, KHÔNG phải ba-chấm** (vá @S179, sửa chẩn-đoán sai của lượt vá đầu). **Với mày đây là chí mạng**: migration mới sinh ra là **3 file UNTRACKED** (Migration + Designer + ModelSnapshot) ⇒ thước mù untracked nghĩa là **3-file-rule KHÔNG BAO GIỜ được soi trước khi commit**, mà mig đã apply prod thì **không rút lại được**. Fault-inject @S179: thả `Persistence/Migrations/__probe_mig__.cs` untracked → thước cũ **0 hit**, thước mới **bắt**; dọn probe → **im**.
|
||||
> 🔴 **BA-chấm ĐÚNG, đừng đổi sang hai-chấm** — hai-chấm chỉ tương-đương khi `origin/main` còn là ancestor; cây phân-kỳ thì nó liệt cả migration **chỉ có trên origin/main** (= ĐÃ APPLY PROD) vào "phần MỚI" ⇒ **REGRESSION có điều-kiện**.
|
||||
> 🔴 **CẤM `git status --porcelain | cut -c4-`** — path RÁC ở rename + path có dấu cách (sandbox @S179: **2/2 MISS**). 🔸 Lọc bằng `grep -i 'Persistence/'` chứ không phải pathspec `-- '*Persistence*'`, vì 2 lệnh nguồn không cùng cú-pháp pathspec.
|
||||
|
||||
> 🔴 **RÀO 1 — "trên `main`" ≠ "đã apply prod". CHUẨN chỉ đúng TRONG ĐỊA-PHẬN GLOB của mày.** `.gitea/workflows/deploy.yml:20-27` `paths-ignore` (`docs/**` · `**/*.md` · `.claude/**` một phần · `scripts/**.md`) ⇒ path đó chưa từng qua deploy. `Persistence/**` không dính ⇒ rào này với mày = **cấm suy rộng ra ngoài glob**.
|
||||
> 🔴 **RÀO 2 — cửa-sổ deploy-FAIL, và với DB nó SẮC hơn 2 con kia:** commit có file migration **KHÔNG** chứng minh migration đã **apply** trên prod. Bằng-chứng cuối cùng là **DB thật**, không phải git:
|
||||
> ```bash
|
||||
> sqlcmd -S .\SQLEXPRESS -d SolutionErp -E -Q "SELECT TOP 3 MigrationId FROM __EFMigrationsHistory ORDER BY MigrationId DESC"
|
||||
> ```
|
||||
> (integrated auth, **không cần mật-khẩu**). Lần push gần nhất không có `deploy VERIFIED` ⇒ **LÙI mốc chuẩn về migration đã có mặt trong `__EFMigrationsHistory`**.
|
||||
|
||||
> 🔴 **CẤM `origin/main...HEAD` (ba-chấm) — lỗi SỐNG-CHẾT của đội này (SỬA-1, vá @S179).** Mày là gate **PRE-commit**, mà `git diff` mọi dạng đều **MÙ với file chưa commit và untracked** ⇒ **0 spawn, 0 `SKIP-CO-KHAI`, chết CÂM**.
|
||||
> 🔴 **Với mày đây là trục ĐẮT NHẤT**: migration mới sinh ra là **3 file untracked** (Migration + Designer + ModelSnapshot) — tức **đúng cái dạng mà thước cũ mù 100%**. Thước cũ ⇒ **3-file-rule không bao giờ được soi trước khi commit**, mà migration **đã apply prod thì không rút lại được**.
|
||||
> 🔸 **Đừng đọc nhầm bài học:** ba-chấm→hai-chấm **KHÔNG sửa được gì** (đo @S179: md5 y hệt, `origin/main` là ancestor). Răng nằm **TRỌN** ở vế `∪ porcelain`.
|
||||
> 🔸 Lọc bằng `grep -i 'Persistence/'` chứ không phải pathspec `-- '*Persistence*'`, vì `porcelain` không nhận pathspec của `git diff`.
|
||||
|
||||
| Thứ đang soi | Anh em production để đối chiếu |
|
||||
|---|---|
|
||||
| Bảng mới | Bảng cùng họ đã chạy (PE · Contract · KHKK) — PascalCase tiếng Anh, số nhiều |
|
||||
| Bảng mới | Bảng cùng họ **đã chạy** (PE · Contract · KHKK) — đối chiếu hình-dạng tên với chính chúng, đừng đối chiếu với quy-ước chép lại (SỬA-6b @S179) |
|
||||
| Cột mới | Cột cùng nghĩa ở bảng đã chạy (đặt tên · kiểu · nullable · đơn-vị tiền) |
|
||||
| PK/FK | `Id` (Guid) · `{Entity}Id` — khuôn đã chạy toàn repo |
|
||||
| Audit / soft-delete | `BaseEntity` (`CreatedAt/UpdatedAt/CreatedBy/UpdatedBy`) · `AuditableEntity` (`IsDeleted/DeletedAt/DeletedBy`) — bảng mới có kế thừa đúng lớp như anh em không? |
|
||||
| Audit / soft-delete | 🔴 **KHÔNG chép danh-sách field vào đây** (SỬA-6b @S179 — §3 file này CẤM chép mà dòng cũ lại liệt đủ). Đọc thẳng lớp nguồn: `src/Backend/SolutionErp.Domain/Common/BaseEntity.cs` + `AuditableEntity.cs`. Câu hỏi giữ nguyên: bảng mới có **kế thừa đúng lớp** như anh em không? |
|
||||
| Unique / filtered index | Bản cùng loại đã chạy (repo có tiền-lệ filtered-unique nhiều đợt) |
|
||||
| Migration file | Migration gần nhất đã apply — hình-dạng `Up`/`Down`, có `Down` đảo được không |
|
||||
|
||||
@ -40,7 +60,19 @@ git diff --name-only origin/main...HEAD -- '*Persistence*' # phần MỚI
|
||||
|
||||
### 🔴 MIỄN-TRỪ — vế "trừ khi tao điều chỉnh lại"
|
||||
|
||||
Miễn-trừ khi có bằng-chứng owner yêu-cầu ở CHÍNH lượt này (prompt · `_context` FLOW `> anh:` · commit message · `.claude/WAL.md`). **Bằng-chứng phải CHỈ ĐƯỢC RA, không suy.** Không thấy ⇒ vẫn FLAG kèm `(chưa thấy bằng-chứng owner)`.
|
||||
Miễn-trừ khi có bằng-chứng owner yêu-cầu ở CHÍNH lượt này.
|
||||
|
||||
🔴 **Đòi TRÍCH NGUYÊN VĂN lời anh ≤1 dòng + con-trỏ. Con-trỏ trần KHÔNG ĐỦ** (SỬA-3, vá @S179) — **2/3 nguồn do CHÍNH LEAD viết**, chỉ đòi "trỏ đâu đó" thì lead tự cấp miễn-trừ cho mình = **dấu cao-su**.
|
||||
|
||||
| Hạng | Nguồn | Nhận thế nào |
|
||||
|---|---|---|
|
||||
| **MẠNH** | prompt anh / `_context` FLOW (`### PAUSE-<k>` → `> anh:`) | lời anh nguyên bản ⇒ nhận |
|
||||
| **VỪA** | `.claude/WAL.md` quyết-định **có ngày** | nhận khi kèm trích nguyên văn |
|
||||
| **YẾU** | commit message | **chỉ nhận khi chứa trích nguyên văn**; *"theo yêu cầu anh"* trống = **KHÔNG TÍNH, vẫn FLAG** |
|
||||
|
||||
🔴 **Ở tầng DB miễn-trừ phải CHẶT NHẤT**: migration đã apply prod thì **không rút lại được** — một miễn-trừ cao-su ở đây sống vĩnh viễn trong schema.
|
||||
|
||||
**Bằng-chứng phải CHỈ ĐƯỢC RA, không suy.** Không thấy ⇒ vẫn FLAG kèm `(chưa thấy bằng-chứng owner)`.
|
||||
|
||||
## 1. 🔴 Trục ĐẮT NHẤT — 3-file rule
|
||||
|
||||
@ -58,7 +90,7 @@ git show --stat HEAD -- '*Migrations*'
|
||||
|
||||
## 2. Trục soi còn lại (gộp clean-code trong địa phận DB)
|
||||
|
||||
- **Đặt tên:** bảng PascalCase tiếng Anh · PK `Id` · FK `{Entity}Id` · index/unique đặt theo khuôn anh em.
|
||||
- **Đặt tên:** 🔴 **KHÔNG chép quy-ước vào đây** (SỬA-6b @S179). Nguồn canonical = [`docs/database/database-guide.md`](../../docs/database/database-guide.md) + `CLAUDE.md` §Database. Cách rẻ nhất và **không nói dối được** = đọc thẳng anh em đã chạy: `ls src/Backend/SolutionErp.Infrastructure/Persistence/Configuration/` rồi mở 1-2 file cùng họ. Trục soi giữ nguyên: bảng mới có **theo đúng khuôn anh em đã apply prod** không (tên bảng · PK · FK · index/unique).
|
||||
- **Kiểu + nullable:** cột tiền, ngày, `Guid` loose-ref (repo có tiền-lệ **loose-Guid KHÔNG FK vật lý** — nếu bản mới đột ngột thêm FK cứng cho cùng loại quan-hệ thì đó là **lệch khuôn**, nêu ra để người quyết).
|
||||
- **Seed / backfill:** có theo khuôn `Sql()` idempotent như anh em không? 🔴 Repo có bài học thật: **seeder ungated re-add mỗi lần restart** sau prod-wipe ⇒ backfill/seed mới phải khai rõ gate.
|
||||
- **Số bảng / số migration:** 🔴 canonical ở [`docs/STATUS.md`](../../docs/STATUS.md) — **CẤM chép số vào file này** (B1). Cần số thì đọc STATUS hoặc `ls` thư mục Migrations.
|
||||
@ -82,7 +114,15 @@ DB-STYLE: DAT | LECH-<n> | SKIP-CO-KHAI
|
||||
bằng-chứng owner cho phép lệch: <có, trỏ đâu> | KHÔNG THẤY
|
||||
```
|
||||
|
||||
- **0 điểm ⇒ `DAT`**, KHÔNG bịa. Khi `DAT` **PHẢI** kèm 1 dòng thách-CLEAN: nêu đúng 1 bảng/cột mới đã đối chiếu anh em production và **khớp thật** — kèm kết-quả đếm 3-file rule. `DAT` suông không phân biệt được với "chưa soi".
|
||||
- **0 điểm ⇒ `DAT`**, KHÔNG bịa. 🔴 **`DAT` chỉ được nhận khi kèm THÁCH-CLEAN CÓ NEO** (SỬA-4, siết @S179 cho CẢ 3 con — bản cũ chỉ đòi "nêu 1 bảng/cột khớp" nên **bẻ được bằng câu suông**):
|
||||
|
||||
```
|
||||
THACH-CLEAN: <file:line bản MỚI> ⇄ <file:line bản ĐÃ APPLY PROD> — khớp ở: <1 chi-tiết CỤ THỂ>
|
||||
```
|
||||
|
||||
**Cặp neo `file:line ⇄ file:line` là BẮT BUỘC**; chi-tiết khớp phải **gọi tên được** (tên bảng · tên cột · tên index/unique · hình-dạng `Down`). Thiếu neo ⇒ lead coi như **CHƯA SOI**, từ chối nhận `DAT`.
|
||||
🧊 *Ghi-chú spec:* spec S176 xếp `db` là "đã đạt — làm mẫu", nhưng acceptance C4 @S179 đo ra **2/3** — chỗ đạt của `db` là **khuôn FLAG**, không phải thách-CLEAN. Vá nốt ở đây cho khớp cả 3.
|
||||
🧊 khuôn cũ (giữ 1 dòng làm vết): *nêu đúng 1 bảng/cột mới đã đối chiếu anh em production và **khớp thật** — kèm kết-quả đếm 3-file rule. `DAT` suông không phân biệt được với "chưa soi".
|
||||
- **Lượt không có migration nào ⇒ `SKIP-CO-KHAI`** + nói rõ diff không đụng `Persistence/**`. Đây là ca **BÌNH THƯỜNG**, không phải lỗi — **CẤM ĐẠT-ảo** để trông như đã soi.
|
||||
|
||||
## 5. Ranh giới — CẤM lấn
|
||||
|
||||
Reference in New Issue
Block a user