vietreport-admin/solution-erp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
309dcd976859c2e87920ace1a2c581f6ea8d101a
solution-erp/docs/CLAUDE.md
pqhuy1987 e71e0eba65
All checks were successful
Deploy SOLUTION_ERP / build-deploy (push) Successful in 2m53s
Details
[CLAUDE] Docs: tai cau truc cleanup — archive raw, compact migration-todos, update CLAUDE+flows 
User request: 'review cap nhat va tai cau truc lai MD sao cho phu hop
voi hien tai, cac phan thua va da dieu chinh co the bo ra luon hoac
cap nhat lai'.

Cleanup highlights:
1. Archive 2 file Phase 0 raw dump → docs/_archive/ (forms-spec-raw 657
   line + workflow-raw 62 line). Update link reference 2 file goc.
2. Compact migration-todos.md 386 → 114 line (-71%). Collapse Phase 0-5
   + Tier 3 + Sessions detailed thanh 1 bang summary. Detail xem session
   logs. Phase 6 iter 1+2 + Phase 7 active checklist.
3. Compact STATUS.md In Progress: bo ~17 row ✅ done (giu chỉ 5+ task
   pending: 3 PE feature gap + 4 optional polish + 2 Ops). Recently Done
   table giu day du history.
4. Update flows/README — tat ca 6 flow ✅ Implemented + them PE row
   reference architecture.md §9.
5. Update docs/CLAUDE.md — project layout co PurchaseEvaluations, _archive,
   skills 6 (3 dom + 3 ops). Roadmap them Phase 6 ✅ + Phase 7 WIP. Lien
   he them prod URL solutions.com.vn + SSH config + login admin.
6. Skill ef-core-migration: 13 migration label.

Net delta: -800 line docs (chu yeu archive + collapse migration-todos).
2026-04-25 14:17:53 +07:00

8.5 KiB
Raw Blame History

CLAUDE.md — Full Context (SOLUTION_ERP)

1. Giới thiệu

SOLUTION_ERP là hệ thống quản lý Hợp đồng Nhà cung cấp / Thầu phụ / Tổ đội / Dịch vụ + Phiếu Duyệt NCC tiền-HĐ cho Công ty TNHH Xây dựng Solutions, thay thế quy trình giấy / Word+Excel hiện tại.

Scope chính:

  1. Số hóa 8 form hợp đồng (template engine điền field → export .docx/.xlsx)
  2. Workflow 9 phase trình ký HĐ (state machine + role guard + SLA auto-approve + versioned WF per ContractType)
  3. Tự gen mã HĐ theo Quy định SOL-CCM-RG-001
  4. Dashboard báo cáo HĐ theo NCC, dự án, trạng thái, giá trị
  5. Module Duyệt NCC (Phase 6) — phiếu trình duyệt so sánh giá tiền-HĐ, 2 quy trình A/B, kế thừa HĐ 1-click khi DaDuyet

2. Kiến trúc tổng thể

┌────────────────┐  ┌────────────────┐
│  fe-admin      │  │  fe-user       │    React 18 + Vite + TS + shadcn/ui
│  :8082         │  │  :8080         │    TanStack Query, Tailwind
└────────┬───────┘  └────────┬───────┘
         │                   │
         │   Vite proxy /api → :5443
         ▼                   ▼
┌──────────────────────────────────────┐
│  SolutionErp.Api :5443               │    ASP.NET Core 10 + JWT
│  Controllers / Middleware / Swagger  │
└──────────────┬───────────────────────┘
               │
      ┌────────▼─────────┐
      │ SolutionErp.     │    CQRS + MediatR
      │ Application      │    FluentValidation + AutoMapper
      └────────┬─────────┘
               │
      ┌────────▼─────────┐    ← SolutionErp.Infrastructure
      │ SolutionErp.     │         (EF Core, Identity, Repos, External services)
      │ Domain           │
      └──────────────────┘
               │
               ▼
       ┌────────────────┐
       │  SQL Server    │    dbo schema, GUID PK
       └────────────────┘

3. Project layout

SOLUTION_ERP/
├── src/Backend/
│   ├── SolutionErp.Domain/         Entities + Enums (Contracts/, PurchaseEvaluations/, Forms/, Identity/, Master/, Notifications/)
│   ├── SolutionErp.Application/    CQRS handlers, DTOs, Validators, Mappings, Interfaces
│   ├── SolutionErp.Infrastructure/ EF DbContext, Identity, Repositories, External services
│   └── SolutionErp.Api/            Controllers, Middleware, Program.cs, appsettings
├── fe-admin/                       (admin UI — CRUD master, approve, dashboards, workflow designer, permission matrix)
├── fe-user/                        (user UI — soạn HĐ + duyệt phiếu PE + inbox)
├── docs/
│   ├── CLAUDE.md                   (file này)
│   ├── STATUS.md                   ⭐ snapshot hiện tại + Recently Done
│   ├── HANDOFF.md                  ⭐ brief 5 phút cho session tiếp
│   ├── PROJECT-MAP.md              bản đồ tổng quan
│   ├── rules.md                    coding conventions
│   ├── architecture.md             layered + PE module §9
│   ├── gotchas.md                  38 pitfall đã gặp
│   ├── forms-spec.md               8 form catalog + RG-001
│   ├── workflow-contract.md        9 phase HĐ + role matrix
│   ├── database/
│   │   ├── database-guide.md       conventions + migration workflow
│   │   └── schema-diagram.md       ERD 47 bảng (+§11 PE)
│   ├── flows/                      6 sequence diagram (auth/permission/contract/form/sla + PE ref architecture)
│   ├── guides/                     setup, cicd, deploy, runbook, security
│   ├── changelog/
│   │   ├── migration-todos.md      roadmap compact (Phase 0-5+Tier3 collapsed)
│   │   └── sessions/               session logs YYYY-MM-DD
│   └── _archive/                   raw dump Phase 0 (forms-spec-raw, workflow-raw)
├── .claude/skills/                 6 skill: 3 domain (contract-workflow, form-engine, permission-matrix) + 3 ops (dependency-audit-erp, ef-core-migration, iis-deploy-runbook)
├── scripts/                        deploy, migrate-domains, backup, deps-audit
├── SolutionErp.slnx                Solution file
├── global.json                     .NET 10 SDK pin
└── CLAUDE.md                       Pointer → docs/CLAUDE.md

4. Tech stack chi tiết

Layer Tech Version
.NET SDK .NET 10.0.104
ORM EF Core 10
DB SQL Server 2019+ (LocalDB dev)
API ASP.NET Core Web API 10
Mediator MediatR latest
Validation FluentValidation latest
Mapping AutoMapper latest
Auth JWT Bearer + ASP.NET Identity 10
Logging Serilog latest
OpenAPI Swashbuckle latest
FE Build Vite 8
FE Lib React 19 (auto-scaffolded)
FE Lang TypeScript 6
FE Styling Tailwind CSS + shadcn/ui Phase 1 install
FE Data TanStack Query Phase 1 install
Node (local) >= 20 local có thể Node 22
Node (CI) pin 20.x bài học từ NamGroup

5. Reference projects

  • NamGroup (D:\Dropbox\CONG_VIEC\NAMGROUP\SOURCECODE_CÔNG_TY\NAMGROUP\) — template 2 FE + IIS deploy + permission matrix
  • DH_Y_DUOC (D:\Dropbox\CONG_VIEC\DAI_Y_DUOC\DH_Y_DUOC_SOURCECODE\DH_Y_DUOC\) — template backend hiện đại (Clean Arch + CQRS + EF migrations)

6. Roadmap (status 2026-04-24)

Phase Focus Trạng thái
0 Draft Scaffold, parse FORM + QUY_TRINH ✅ Done
1 Alpha Core Auth + Permission + CRUD master + Contract draft ✅ Done
2 Form Engine OpenXml + ClosedXML + LibreOffice PDF + DynamicForm ✅ Done
3 Workflow 9 phase state machine + RG-001 code gen + SLA job + attachments + SignalR ✅ Done
4 Reporting Dashboard KPI + Excel export + MyDashboard role-aware ✅ Done
5 Production CI/CD Gitea Actions + 3 IIS site + Let's Encrypt + Security headers + Users CRUD ✅ Done
Tier 3 Versioned WF + 3-panel layout + 4-bảng + 4 catalogs + 16 demo users + Brand identity ✅ Done
6 Module Duyệt NCC PE iter 1 (skeleton) + iter 2 (UX polish) + Domain rebrand .solutions.com.vn ✅ Done
7 PE feature gap Designer UI + Ý kiến 4 phòng ban + Export PDF + UAT thật + SMTP 📝 WIP
8+ Post-launch E-signature, Bravo/SAP, Mobile, AI OCR 📝 Future

Chi tiết atomic tasks: changelog/migration-todos.md. Session logs: changelog/sessions/.

7. Quy ước code

  • Ngôn ngữ UI: 100% tiếng Việt. Code + comment + tên DB table: English.
  • Tên file: PascalCase cho .cs, kebab-case cho TS/TSX (trừ React component = PascalCase).
  • Null safety: .NET bật nullable reference types. TS strict: true.
  • Async/await cho mọi I/O.
  • Error handling BE: GlobalExceptionMiddleware → map exception → ProblemDetails. KHÔNG try-catch ở controller.
  • Error handling FE: error boundary + toast. Dùng useErrorHandler hook.
  • Logging: Serilog structured. Không Console.WriteLine.

8. Security baseline

  • HTTPS everywhere (IIS redirect HTTP → HTTPS)
  • JWT expiry 1h, refresh token 7d
  • Password hash: Identity default (PBKDF2)
  • CORS: whitelist chỉ 2 FE origin
  • Rate limit: 100 req/min/IP cho endpoint auth
  • SQL injection: EF Core parameterized (không raw SQL trừ khi cần)
  • Audit log: mọi write → AuditLog table

9. Liên hệ + Production