vietreport-admin/solution-erp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
54d6c9ba52f7cd651cf7a9ed25cdaa82de4292c9
solution-erp/docs/STATUS.md
pqhuy1987 54d6c9ba52 [CLAUDE] Phase1.2: CRUD Master + Permission Matrix + FE admin pages 
Backend:
- Domain/Master: Supplier (+ SupplierType 5 loai), Project, Department (AuditableEntity)
- Domain/Identity: MenuItem, Permission, MenuKeys const (12 menu)
- EF Configurations voi unique Code + query filter IsDeleted
- DbSets + IApplicationDbContext interface update
- Application: PagedResult + PagedRequest generic
- Application/Master CQRS CRUD 3 entity (Create/Update/Delete/Get/List voi paging search sort)
- Application/Permissions: GetMyMenuTree (union OR role, filter tree), ListMenuItems, ListPermissionsByRole, UpsertPermission (guard admin khong tu giam quyen), ListRoles
- Api/Authorization: MenuPermissionRequirement + Handler (Admin bypass, query DB)
- Program.cs: register 48 policy {menu}.{action} tu MenuKeys x Actions
- Api/Controllers: Suppliers, Projects, Departments, Menus, Roles, Permissions
- DbInitializer: seed 12 menu + admin full CRUD permissions
- Migration AddMasterData + AddPermissions

Frontend (fe-admin):
- Types: menuKeys.ts const, menu.ts (MenuNode/Role/Permission), master.ts (Supplier/Project/Department + SupplierType const-object)
- AuthContext: load menu from /menus/me, cache localStorage, refreshMenu()
- usePermission hook + PermissionGuard component (wrap button)
- UI kit them: Dialog (modal overlay), Textarea, Select
- Generic: DataTable (column config, sortable, loading, empty) + Pagination
- PageHeader component
- apiError helper extract message tu ProblemDetails
- Layout rewrite: render menu dong tu AuthContext.menu (MenuGroup collapsible + NavLink + lucide icon map)
- Pages: master/Suppliers, master/Projects, master/Departments (CRUD + search + sort + paging + Dialog form)
- Page system/Permissions: ma tran Role x MenuKey x CRUD checkbox (tick tu dong PUT upsert)
- App.tsx them 4 route moi

Bug fix:
- MenuPermissionHandler: EF expression tree khong support switch expression -> tach switch ra ngoai AnyAsync
- TS erasableSyntaxOnly khong cho enum -> SupplierType const-object pattern (typeof[keyof])

E2E verified via Vite proxy:
- GET /menus/me -> 6 root + 6 child nodes (12 menus)
- GET /roles -> 12 roles
- POST/GET/PUT/DELETE /suppliers -> full CRUD, soft delete OK
- tsc -b fe-admin pass

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-21 11:30:14 +07:00

3.8 KiB
Raw Blame History

STATUS — Snapshot hiện tại

Update rule: trước khi bắt đầu 1 task → ghi row vào 🔥 In Progress. Xong → chuyển sang ✅ Recently Done.

Last updated: 2026-04-21 11:30

📍 Phase hiện tại: Phase 1 — Alpha Core (đợt 2 xong) — sẵn sàng Phase 2 Form Engine

🔥 In Progress

(không có — Phase 1 đợt 2 hoàn tất)

✅ Recently Done (newest on top)

Ngày Ai Task Commit
2026-04-21 Claude Phase 1 đợt 2 HOÀN TẤT — BE: Supplier/Project/Department CRUD + Permission Matrix (MenuItem/Permission + Authorization handler) + 2 migration. FE: DataTable/Dialog generic, usePermission, PermissionGuard, 3 trang CRUD admin, Permission Matrix page, Layout menu động (sắp commit)
2026-04-21 Claude Docs addition — database-guide.md + flows/ 6 doc 49a5f57
2026-04-21 Claude Phase 1 foundation HOÀN TẤT — BE Clean Arch + Identity + JWT + FE 2 app + Tailwind 4 + login E2E 702411f
2026-04-21 Claude Phase 0 HOÀN TẤT — scaffold + parse FORM/QUY_TRINH + docs + skills + git init 25dad7f

Session logs:

🎯 Next up — Phase 2 Form Engine (có thể bắt ngay)

  • Convert 3 file .doc (FO-002.02/03/06) → .docx qua PowerShell COM hoặc LibreOffice headless
  • Parse chi tiết field specs cho 5 template HĐ → JSON spec
  • Add NuGet: DocumentFormat.OpenXml, ClosedXML
  • Domain/Entities/ContractTemplate, ContractClause + EF config
  • Application/Forms/Services/IFormRenderer + DocxRenderer + XlsxRenderer
  • Api/Controllers/FormsController (list template, get spec, render preview, render final)
  • FE: form builder dynamic render từ fieldSpec
  • FE admin: upload template + manage ContractClause (rich text editor)
  • Test: FO-002.05 Giao khoán render → docx khớp mẫu 100%

Chi tiết: docs/flows/form-render-flow.md + docs/changelog/migration-todos.md section Phase 2.

🔄 Còn có thể làm parallel (optional, không block Phase 2)

  • FE Users management (tạo user + gán role) — cần để test permission với role khác Admin
  • FE Roles CRUD (tạo custom role mới)
  • Contract entity skeleton (không state machine, chỉ CRUD draft)
  • E2E test permission: tạo user role Drafter-only → verify không thấy menu System/Admin

📊 Thông số sau Phase 1 đợt 2

  • Backend LOC: ~1500 (Domain 150 + Application 800 + Infrastructure 350 + Api 200)
  • Migrations: Init + AddMasterData + AddPermissions
  • DB tables: 7 Identity + 3 Master (Suppliers/Projects/Departments) + 2 Permission (MenuItems/Permissions)
  • API endpoints: 20+ (Auth 4 + Suppliers 5 + Projects 5 + Departments 5 + Menus 2 + Roles 1 + Permissions 2)
  • Frontend routes: 5 (Dashboard + 3 CRUD + Permission Matrix)
  • FE LOC: ~1700 (fe-admin; fe-user vẫn minimal)

🚨 Blockers / risks

  • ⏳ Gitea remote — URL chờ user cấp
  • ⚠️ fe-user chưa được update với menu động — Phase 2 sẽ sync
  • ⚠️ Users CRUD chưa có UI → khó test permission với non-admin role thật
  • ⚠️ 3 file .doc Phase 2 cần convert COM

Credentials mặc định

Email:    admin@solutionerp.local
Password: Admin@123456

URLs dev: