chinh sua theo tieu chuan phan mem BDS_1
This commit is contained in:
@@ -1,64 +1,40 @@
|
||||
# HQLAND - HƯỚNG DẪN PHIÊN LÀM VIỆC TIẾP THEO
|
||||
|
||||
> File này giúp AI Agent nhanh chóng bắt nhịp khi bạn chuyển sang máy tính khác.
|
||||
> **Cập nhật:** 24/04/2026
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ THÔNG BÁO QUAN TRỌNG
|
||||
|
||||
Có **rất nhiều file thay đổi CHƯA COMMIT**. Bạn cần commit trước khi chuyển máy!
|
||||
|
||||
```bash
|
||||
git add -A
|
||||
git commit -m "Hoan thien core finance v2 - Calculation Pipeline, Form Templates"
|
||||
git push origin main
|
||||
```
|
||||
> **Cập nhật:** 28/04/2026
|
||||
|
||||
---
|
||||
|
||||
## 1. NHỮNG GÌ VỪA HOÀN THÀNH
|
||||
|
||||
### ✅ Kiến trúc mới: Calculation Pipeline
|
||||
- Tính toán giá BĐS tường minh, step-by-step với làm tròn tại mỗi bước
|
||||
- `RoundingRule`: NONE, UNIT (đồng), THOUSAND, MILLION
|
||||
- `CalculationStep`: Định nghĩa từng bước (tên, công thức, làm tròn, ghi đè)
|
||||
- `CalculationResult`: Lưu snapshot + price_sheet cho phiếu tính giá
|
||||
- `PriceCalculationService`: Pipeline chuyên BĐS (QSDĐ + Móng → Subtotal → CK → Net → VAT → Total)
|
||||
- `Contract::calculation_log`: JSONB lưu toàn bộ quá trình tính toán
|
||||
### ✅ Module mới: Sales Phases (Đợt mở bán)
|
||||
- **Models:** `SalesPhase`, `SalesPhaseProduct` (pivot)
|
||||
- **Migration:** `sales_phases`, `sales_phase_products`, `add_sales_phase_id_to_contracts`
|
||||
- **SalesPhaseResource:** Form + Table + Pages đầy đủ (Schemas)
|
||||
- **ContractForm:** Chọn `sales_phase_id` → auto-populate giá từ pivot
|
||||
- **CreateContract:** Fallback lấy `paymentTemplate` từ `salesPhase` nếu HĐ không chọn template trực tiếp
|
||||
- **Product/Project models:** Thêm relationships với SalesPhase
|
||||
|
||||
### ✅ Module mới: Form Templates (Biểu mẫu in ấn)
|
||||
- **Mail Merge Engine:** Admin tự tạo template HTML, chèn `{{ma_truong}}`
|
||||
- **FormField:** Định nghĩa nguồn dữ liệu (db_column, db_relation, formula, input, static)
|
||||
- **FormPrintLog:** Lưu snapshot khi in
|
||||
- **FormTemplateResource:** CRUD trong Filament với RichEditor WYSIWYG + Repeater fields
|
||||
- Layout: 3 section xếp dọc (Thông tin → Trường dữ liệu → Nội dung mẫu in)
|
||||
|
||||
### ✅ Các fix trước đó
|
||||
- EditAction namespace, User FilamentUser, ContractForm tạo lịch tự động
|
||||
- Payment validation, PaymentsTable đối soát, ContractsTable công nợ
|
||||
- PaymentFine/Appendix/Settlement Resources, Dashboard widgets
|
||||
### ✅ Kiến trúc cũ vẫn giữ nguyên
|
||||
- Calculation Pipeline, Form Templates, Payment/Finance modules
|
||||
- Dashboard widgets, PaymentFine/Appendix/Settlement Resources
|
||||
- 9 tests passing
|
||||
|
||||
---
|
||||
|
||||
## 2. CẤU HÌNH DATABASE
|
||||
|
||||
### Chạy migrate trên production (NẾU CHƯA CHẠY)
|
||||
### Chạy migrate (NẾU CHƯA CHẠY)
|
||||
```bash
|
||||
DB_HOST=127.0.0.1 php artisan migrate --force
|
||||
```
|
||||
|
||||
Các migration quan trọng:
|
||||
- `2026_04_24_083000_add_payment_template_id_to_contracts`
|
||||
- `2026_04_28_013900_add_calculation_log_to_contracts`
|
||||
- `2026_04_28_020000_create_form_templates_tables`
|
||||
|
||||
---
|
||||
|
||||
## 3. TEST
|
||||
|
||||
```bash
|
||||
DB_HOST=127.0.0.1 ./vendor/bin/pest --filter="ContractFinanceFlowTest|ContractResourceRenderTest"
|
||||
DB_HOST=127.0.0.1 ./vendor/bin/pest
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user