[CLAUDE] Scaffold: khoi tao SOLUTION_ERP Phase 0
- .NET 10 Clean Architecture: Domain/Application/Infrastructure/Api (4 project) - 2 React + Vite + TS app: fe-admin (:8082), fe-user (:8080) voi proxy /api - Node engines >=20, .nvmrc = 20 cho CI (bai hoc NamGroup) - SQL Server 2022 qua docker-compose (dev) - Parse 8 FORM -> docs/forms-spec.md (catalog + ma HD format RG-001) - Parse QUY_TRINH -> docs/workflow-contract.md (9 phase state machine + role matrix) - docs: CLAUDE.md, STATUS.md, PROJECT-MAP.md, migration-todos.md (roadmap 5 phase) - .claude/skills: 3 placeholder (contract-workflow, form-engine, permission-matrix) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
68
README.md
Normal file
68
README.md
Normal file
@ -0,0 +1,68 @@
|
||||
# SOLUTION_ERP
|
||||
|
||||
Hệ thống quản lý Hợp đồng Nhà cung cấp / Thầu phụ / Tổ đội cho **Công ty TNHH Xây dựng Solutions**.
|
||||
|
||||
> 📘 AI context: [`CLAUDE.md`](CLAUDE.md) (pointer) → [`docs/CLAUDE.md`](docs/CLAUDE.md) (full)
|
||||
|
||||
## Quick start (dev)
|
||||
|
||||
**Yêu cầu:** .NET 10 SDK, Node 20+, SQL Server (local hoặc qua Docker).
|
||||
|
||||
```powershell
|
||||
# 1. DB — chạy SQL Server qua Docker (nếu chưa có local)
|
||||
docker compose up -d
|
||||
|
||||
# 2. Backend — migration + run Api (port 5443)
|
||||
dotnet ef database update --project src/Backend/SolutionErp.Infrastructure --startup-project src/Backend/SolutionErp.Api
|
||||
dotnet run --project src/Backend/SolutionErp.Api
|
||||
|
||||
# 3. Frontend admin (port 8082) — terminal mới
|
||||
cd fe-admin
|
||||
npm install
|
||||
npm run dev
|
||||
|
||||
# 4. Frontend user (port 8080) — terminal mới
|
||||
cd fe-user
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
Admin mặc định (sẽ seed sau Phase 1): `admin@solutionerp.local` / `Admin@123456`
|
||||
|
||||
## Architecture
|
||||
|
||||
```
|
||||
fe-admin (:8082) fe-user (:8080)
|
||||
│ │
|
||||
└────── /api proxy ──────┘
|
||||
▼
|
||||
SolutionErp.Api (:5443)
|
||||
│
|
||||
┌──────────────┼──────────────┐
|
||||
▼ ▼ ▼
|
||||
Application Domain Infrastructure ── SQL Server
|
||||
```
|
||||
|
||||
## Tech stack
|
||||
|
||||
- **Backend:** .NET 10 + Clean Architecture + CQRS (MediatR) + FluentValidation + AutoMapper + EF Core + ASP.NET Identity + JWT
|
||||
- **Frontend:** React 18 + Vite + TypeScript + Tailwind + shadcn/ui + TanStack Query
|
||||
- **DB:** SQL Server 2022
|
||||
- **Deploy:** Windows Server + IIS
|
||||
|
||||
## Roadmap
|
||||
|
||||
| Phase | Tuần | Focus |
|
||||
|---|---|---|
|
||||
| 0 Draft | T1 | Scaffold, parse FORM + QUY_TRINH |
|
||||
| 1 Alpha Core | T2-4 | Auth, Permission, CRUD master |
|
||||
| 2 Form Engine | T5-6 | Render template docx/xlsx |
|
||||
| 3 Workflow | T7-9 | State machine 9 phase |
|
||||
| 4 Report + Polish | T10-11 | Dashboard + Excel export |
|
||||
| 5 Production | T12-13 | CI/CD IIS, UAT, go-live |
|
||||
|
||||
Chi tiết ở [`docs/changelog/migration-todos.md`](docs/changelog/migration-todos.md).
|
||||
|
||||
## License
|
||||
|
||||
Proprietary — Công ty TNHH Xây dựng Solutions.
|
||||
Reference in New Issue
Block a user