25dad7f36f
- .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>
69 lines
2.1 KiB
Markdown
69 lines
2.1 KiB
Markdown
# 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.
|