[CLAUDE] Docs+Skill: chốt session 6 — 3 skill refresh + 2 rule audit định kỳ
Pure docs work — 0 thay đổi code/test. 77 test vẫn pass (Domain 54 + Infra 23). 3 skill refresh stale (audit định kỳ §6.4 + §9.4 phát hiện): - form-engine: "Phase 2 MVP missing PDF + form builder" → "Tier 3 feature-complete" + bỏ section duplicate "Gen mã HĐ chưa implement" (đã DONE Phase 3+6) - permission-matrix: 12 menu cũ → ~60 menu key (Bg_*/Pe_*/PeWf_*/Catalogs) + inheritance roots 4 group + Budgets KHÔNG inherit (gotcha #35) - ef-core-migration: "24 DbSet" → "52 bảng (15 migration)" 2 rule mới chốt: - rules.md §6.4 — Audit + compact MD định kỳ (cadence + checklist + anti-pattern) Triết lý: KHÔNG rewrite toàn bộ. Compact + patch drift. Cron solution-erp-skill-audit-monthly mở rộng scope (skill + doc drift combined) - rules.md §9.4 mở rộng cross-ref §6.4 Update STATUS Session 7+ priority + HANDOFF cảnh báo session 7 + migration-todos Phase 9 Session 6 done sub. Cron 2026-05-01 fire mai → combined audit theo checklist §6.4 + §9.4. Session log đầy đủ: docs/changelog/sessions/2026-04-30-chot-session-6-md-audit-compact.md Commit MD-only → CI skip (path filter gotcha #41). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@ -12,8 +12,9 @@ when-to-use:
|
||||
|
||||
# Form Engine Skill
|
||||
|
||||
> **Status:** Phase 2 implemented (MVP — placeholder replace cơ bản).
|
||||
> **Missing:** loop `{{#loop}}...{{/loop}}` cho table lặp, field spec JSON, PDF convert, form builder FE.
|
||||
> **Status (post Session 6 — 2026-04-30):** Tier 3 FEATURE-COMPLETE.
|
||||
> ✅ Placeholder replace + split-runs handling, ✅ FieldSpec JSON, ✅ Form builder FE (admin upload), ✅ DynamicForm renderer (Form↔JSON toggle), ✅ PDF export qua LibreOffice headless, ✅ .doc/.xls auto-convert tới .docx/.xlsx.
|
||||
> **Missing (low priority):** loop `{{#loop}}...{{/loop}}` cho table lặp (chưa cần — 8 form hiện không có table dynamic), Export PE phiếu PDF (Phase 9 carry over, không quan trọng).
|
||||
|
||||
## Tech stack
|
||||
|
||||
@ -99,14 +100,12 @@ foreach (var para in root.Descendants<Paragraph>()) {
|
||||
|
||||
## Known limitations
|
||||
|
||||
| # | Limitation | Phase fix |
|
||||
| # | Limitation | Status |
|
||||
|---|---|---|
|
||||
| 1 | Không support `{{#loop}}...{{/loop}}` cho table lặp | Phase 2 iteration 2 |
|
||||
| 2 | Không có field spec JSON — form builder FE phải điền JSON thủ công | Phase 2 iteration 2 |
|
||||
| 3 | 3 file `.doc` (FO-002.02/03/06) chưa convert → IsActive=false | Convert offline qua Word COM |
|
||||
| 4 | Không có PDF convert → preview chỉ download .docx | Phase 4 |
|
||||
| 5 | Không handle `.docm` (macro) — chỉ accept `.docx` / `.xlsx` | By design |
|
||||
| 6 | Không convert format trong template (vd number → `150,000,000 VND`) — BE phải format trước khi pass data | Phase 3 khi gen mã HĐ |
|
||||
| 1 | Không support `{{#loop}}...{{/loop}}` cho table lặp | Pending (chưa cần) |
|
||||
| 2 | Không handle `.docm` (macro) — chỉ accept `.docx` / `.xlsx` | By design (security) |
|
||||
| 3 | BE phải format số/tiền trước khi pass data (template không format) | By design — caller responsibility |
|
||||
| 4 | PE Export phiếu PDF chưa wire | Phase 9 carry over (không quan trọng) |
|
||||
|
||||
## Common pitfalls (xem gotchas.md)
|
||||
|
||||
@ -116,15 +115,8 @@ foreach (var para in root.Descendants<Paragraph>()) {
|
||||
- **SaveAs type conversion** — gotcha #11
|
||||
- **Template file không tồn tại** → throw `NotFoundException` ở RenderCommandHandler
|
||||
|
||||
## Gen mã HĐ (RG-001) — chưa implement (Phase 3)
|
||||
## Gen mã HĐ (RG-001) — DONE Phase 3 + Phase 6 PE
|
||||
|
||||
Xem [`docs/forms-spec.md §RG-001`](../../../docs/forms-spec.md). Tóm tắt format:
|
||||
Đã implement: `ContractCodeGenerator` + `PurchaseEvaluationCodeGenerator` (atomic SERIALIZABLE). Detail trong skill `contract-workflow` (HĐ) + format PE `PE/{YYYY}/{A|B}/{Seq:D3}`. 17 unit test cover (Infrastructure.Tests/Services).
|
||||
|
||||
| Loại HĐ | Format |
|
||||
|---|---|
|
||||
| HĐ Thầu phụ | `{Project}/HĐTP/SOL&{Partner}/{Seq}` |
|
||||
| HĐ Giao khoán | `{Project}/HĐGK/SOL&{Partner}/{Seq}` |
|
||||
| HĐ NCC | `{Project}/NCC/SOL&{Partner}/{Seq}` |
|
||||
| HĐ Nguyên tắc | `{Year}/NCC/SOL&{Partner}/{Seq}` |
|
||||
|
||||
Planned implementation: `IContractCodeGenerator.GenerateAsync()` với transaction SERIALIZABLE + `ContractCodeSequences` table để tránh race.
|
||||
Xem [`docs/forms-spec.md §RG-001`](../../../docs/forms-spec.md) cho format spec từng ContractType.
|
||||
|
||||
Reference in New Issue
Block a user