Files

pqhuy1987 7ca6c914fa

Deploy SOLUTION_ERP / build-deploy (push) Successful in 2m55s

Details

[CLAUDE] Docs: chốt session 2 — PE skeleton + G-084 + skill audit

User feedback: "phần Duyệt NCC chưa xong đâu đấy nhé, còn chỉnh nhiều"
→ mark PE module skeleton (not feature-complete), liệt kê chi tiết chức
năng/UX/edge-case còn missing cho session tiếp.

Update 7 file:
 - STATUS.md — phase = "PE skeleton + refinement WIP", In Progress liệt
   kê 4 nhóm: A Chức năng MISSING (9 item), B UX/Polish (6 item),
   C Edge case (4 item), D Deploy/Ops (1 item). +G-084 row Recently Done.
 - HANDOFF.md — TL;DR "PE skeleton, còn chỉnh nhiều" + Priority 0 section
   cho session tiếp (9 task PE refinement) + cảnh báo runner + G-084.
 - migration-todos.md — Phase 7 checklist (A/B/C/D nhóm) trước Phase 8
   post-launch. Pending migrations: PaymentTermFields + DepartmentOpinions
   + CodeSequences.
 - architecture.md — Section 9 PurchaseEvaluation module (ERD + workflow
   A/B + kế thừa HĐ flow).
 - CLAUDE.md (root) — 5 file đọc đầu (thêm HANDOFF), Modules table, 12
   migration 46 bảng, +PurchaseEvaluation commit scope.
 - .claude/skills/ — 4 skill cross-ref Phase 6:
   * README: trạng thái updated với Phase 6 note
   * contract-workflow: note PE workflow tách table riêng
   * permission-matrix: +Pe_*/PeWf_* menu keys + TODO grant non-admin
   * ef-core-migration: 12 migration history + Phase 7 pending
 - docs/changelog/sessions/2026-04-23-2359-chot-session-pe-skeleton.md —
   session log full commits + MD files updated + session tiếp priorities
   + notes (PE là skeleton, runner check, G-084 rule, MaPhieu format).

2026-04-23 17:46:41 +07:00

4.0 KiB

Raw Blame History

Skill Library — SOLUTION_ERP

Skill này là tài liệu chuyên biệt để Claude (và developer khác) dùng khi cần deep-dive 1 domain area. Claude tự động invoke qua Skill tool dựa trên semantic matching với description trong từng SKILL.md.

Skills hiện có

Domain skills (logic nghiệp vụ)

Skill	Mục đích	Trigger ví dụ	Trạng thái
`contract-workflow`	State machine 9 phase + versioned workflow per ContractType + role × phase guard + SLA + auto-gen mã HĐ RG-001	"approve contract", "chuyển phase", "versioned workflow", "HĐ cũ giữ cũ"	✅ Tier 3 + Phase 6 cross-ref PE workflow
`form-engine`	Render template docx/xlsx + FieldSpec JSON + DynamicForm + PDF export LibreOffice	"export contract as word", "điền form", "render template", "PDF export"	✅ Active
`permission-matrix`	Role × MenuKey × CRUD + seed + 3-layer resolution + inherit Contracts/Workflows/PurchaseEvaluations	"permission denied", "gán role", "menu không hiện", "inherit permission"	✅ Active (Phase 6 +Pe_/PeWf_)

Ops/infra skills (devops + security + schema)

Skill	Mục đích	Trigger ví dụ	Trạng thái
`dependency-audit-erp`	Scan CVE NuGet + npm 2 FE, respect pin constraint (MediatR 12.4.1, Swashbuckle 6.9.0)	"npm audit", "dotnet vulnerable", "deps scan", "nâng cấp package"	✅ New Tier 3
`ef-core-migration`	Tạo/revert EF Core 10 migration, 3-file rule, DesignTimeDbContextFactory, 12 migration history (+ Phase 7 pending)	"thêm migration", "EF migration", "schema update", "snapshot lỗi"	✅ Updated Phase 6
`iis-deploy-runbook`	3 IIS site + win-acme cert + gitea-runner + LibreOffice + debug 500/502/SignalR prod + G-084 IPv4/IPv6 hardening	"prod 500", "IIS fail", "cert hết hạn", "restart app pool", "deploy IIS", "port hijack"	✅ Updated (G-084)

Format chuẩn 1 skill

Mỗi skill là 1 folder với ít nhất SKILL.md + optional examples/ + references/:

.claude/skills/<skill-name>/
├── SKILL.md                  ← Entry point: description, when-to-use, workflow
├── examples/                 ← Code snippets mẫu (optional)
│   └── *.cs | *.tsx
└── references/               ← Link đến file code thật, docs (optional)

Frontmatter SKILL.md (BẮT BUỘC when-to-use để skill auto-trigger):

---
name: skill-name-kebab-case
description: 1-3 câu mô tả skill làm gì + stack specificity (để embedding match chính xác)
when-to-use:
  - "trigger phrase 1"
  - "trigger phrase 2"
  - "keyword tiếng Việt"
---

# Skill Name

## Context
...

## Workflow / Commands
...

## Pitfalls
...

## Code pointers
- `path/to/file.cs`

Tạo skill mới — checklist

Tạo folder .claude/skills/<kebab-case-name>/
Viết SKILL.md với frontmatter + sections: Context / Workflow / Code pointers / Common pitfalls
Add row vào bảng "Skills hiện có" phía trên
Update docs/CLAUDE.md (dòng skill count)
Commit [CLAUDE] Skill: add <name>

Nguyên tắc design skill

PROJECT-SPECIFIC, không clone generic:

Skill user-level global đã có sẵn (code-reviewer, sql-database-assistant, focused-fix, ...)
Skill project-level phải encode kiến thức SOLUTION_ERP-only mà generic không có:
- Commit convention [CLAUDE] <scope>: ...
- Path pattern src/Backend/SolutionErp.*/...
- Pin constraint (MediatR 12.4.1, Swashbuckle 6.9.0, TypeScript 6 erasableSyntaxOnly)
- Gotcha-referenced (dẫn chiếu docs/gotchas.md#N)
- Workflow Vietnamese-first

Keep it actionable:

Commands copy-pastable (không pseudocode)
Paths đầy đủ (không src/...)
Version pinned (không "latest")
Dẫn chiếu gotcha/migration # cụ thể

docs/CLAUDE.md — quick rules + full stack context
docs/gotchas.md — 32 bẫy đã gặp
docs/changelog/migration-todos.md — roadmap 5 phase + Tier 3

4.0 KiB Raw Blame History Unescape Escape