Compare commits
2 Commits
49aa20a634
...
0712046f4b
| Author | SHA1 | Date | |
|---|---|---|---|
| 0712046f4b | |||
| e229da5e8c |
58
AGENTS.md
58
AGENTS.md
@@ -1,7 +1,7 @@
|
|||||||
# HQLAND - TRẠNG THÁI CODEBASE & LỘ TRÌNH PHÁT TRIỂN
|
# HQLAND - TRẠNG THÁI CODEBASE & LỘ TRÌNH PHÁT TRIỂN
|
||||||
|
|
||||||
> File này được tạo để lưu trữ ngữ cảnh dự án cho các phiên làm việc sau.
|
> File này được tạo để lưu trữ ngữ cảnh dự án cho các phiên làm việc sau.
|
||||||
> **Cập nhật:** 24/04/2026
|
> **Cập nhật:** 28/04/2026
|
||||||
> **Dự án:** HQLand - Hệ thống quản lý Bất động sản
|
> **Dự án:** HQLand - Hệ thống quản lý Bất động sản
|
||||||
> **Stack:** Laravel 13 + Filament v5.5 (Schemas Architecture) + PostgreSQL + UUID
|
> **Stack:** Laravel 13 + Filament v5.5 (Schemas Architecture) + PostgreSQL + UUID
|
||||||
|
|
||||||
@@ -51,6 +51,13 @@
|
|||||||
4. Mọi trường JSONB trong Model phải khai báo trong `$casts = ['field' => 'array']`.
|
4. Mọi trường JSONB trong Model phải khai báo trong `$casts = ['field' => 'array']`.
|
||||||
5. Naming database: **snake_case** cho mọi bảng và cột.
|
5. Naming database: **snake_case** cho mọi bảng và cột.
|
||||||
|
|
||||||
|
### ⚠️ Quy tắc Layout Filament v5.5 (BÀI HỌC QUAN TRỌNG)
|
||||||
|
- **Section muốn full width** phải thêm `->columnSpanFull()` ngay sau `Section::make()`
|
||||||
|
- **Schema mặc định** có thể tự động chia cột nếu không chỉ định `columnSpanFull`
|
||||||
|
- **Grid::make(3)** chỉ dùng *bên trong* Section để chia field thành cột, KHÔNG dùng để bọc nhiều Section
|
||||||
|
- **Layout đúng:** Section xếp dọc (mỗi Section `->columnSpanFull()`), bên trong Section dùng Grid chia field
|
||||||
|
- **RichEditor tăng chiều cao:** `->extraInputAttributes(['style' => 'min-height: 500px;'])`
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 3. CẤU TRÚC MODULE HIỆN TẠI
|
## 3. CẤU TRÚC MODULE HIỆN TẠI
|
||||||
@@ -121,6 +128,7 @@
|
|||||||
**Quan hệ:**
|
**Quan hệ:**
|
||||||
- `product()`, `customers()` (belongsToMany qua contract_customers)
|
- `product()`, `customers()` (belongsToMany qua contract_customers)
|
||||||
- `paymentTemplate()` (belongsTo PaymentTemplate)
|
- `paymentTemplate()` (belongsTo PaymentTemplate)
|
||||||
|
- `salesPhase()` (belongsTo SalesPhase)
|
||||||
- `appendices()`, `paymentSchedule()`, `scheduleItems()` (HasManyThrough)
|
- `appendices()`, `paymentSchedule()`, `scheduleItems()` (HasManyThrough)
|
||||||
- `payments()`, `paymentFines()`
|
- `payments()`, `paymentFines()`
|
||||||
|
|
||||||
@@ -207,6 +215,38 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
### 3.6. Sales Phases (Đợt mở bán)
|
||||||
|
**Models:** `SalesPhase`, `SalesPhaseProduct` (pivot)
|
||||||
|
|
||||||
|
**SalesPhase:**
|
||||||
|
- `project_id`, `name`, `code`, `status` (Chuẩn bị | Đang mở bán | Tạm dừng | Đã đóng)
|
||||||
|
- `start_date`, `end_date`, `description`
|
||||||
|
- `payment_template_id` - Mẫu lịch thanh toán mặc định cho đợt
|
||||||
|
- `discount_policy` (JSONB) - Chính sách chiết khấu mặc định
|
||||||
|
|
||||||
|
**SalesPhaseProduct (pivot):**
|
||||||
|
- `sales_phase_id`, `product_id`
|
||||||
|
- `sale_price`, `land_value`, `foundation_value` - Giá bán riêng của đợt
|
||||||
|
- `discount_details` (JSONB) - Chiết khấu riêng cho từng sản phẩm trong đợt
|
||||||
|
- `status` (Còn hàng | Đã giữ | Đã bán | Khóa)
|
||||||
|
|
||||||
|
**Quan hệ:**
|
||||||
|
- `SalesPhase` belongsTo `Project`, belongsTo `PaymentTemplate`
|
||||||
|
- `SalesPhase` belongsToMany `Product` qua `sales_phase_products`
|
||||||
|
- `Product` belongsToMany `SalesPhase`
|
||||||
|
- `Project` hasMany `SalesPhase`
|
||||||
|
- `Contract` belongsTo `SalesPhase` (nullable)
|
||||||
|
|
||||||
|
**Logic tích hợp:**
|
||||||
|
- `ContractForm`: Khi chọn `sales_phase_id` + `product_id`, tự động populate giá trị tài chính từ `SalesPhaseProduct` pivot
|
||||||
|
- `CreateContract`: Nếu HĐ có `sales_phase_id` và không có `payment_template_id` trực tiếp, tự động lấy template từ `salesPhase->paymentTemplate`
|
||||||
|
- `SalesPhaseForm`: Repeater `phaseProducts` cho phép thêm sản phẩm với giá và chiết khấu riêng
|
||||||
|
|
||||||
|
**Filament Resources:**
|
||||||
|
- `SalesPhaseResource` → `SalesPhaseForm` + `SalesPhasesTable`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## 4. CÁC COMMAND IMPORT DỮ LIỆU
|
## 4. CÁC COMMAND IMPORT DỮ LIỆU
|
||||||
|
|
||||||
### `import:products-excel {file=sanpham.xlsx}`
|
### `import:products-excel {file=sanpham.xlsx}`
|
||||||
@@ -262,6 +302,7 @@
|
|||||||
- [x] **Discount Engine:** Tính toán tự động chiết khấu + hiển thị `final_value` trong ContractForm
|
- [x] **Discount Engine:** Tính toán tự động chiết khấu + hiển thị `final_value` trong ContractForm
|
||||||
- [x] **Calculation Pipeline:** Kiến trúc tính toán tường minh (Step-by-step) với làm tròn tại mỗi bước
|
- [x] **Calculation Pipeline:** Kiến trúc tính toán tường minh (Step-by-step) với làm tròn tại mỗi bước
|
||||||
- [x] **Form Templates:** Mail Merge Engine cho phiếu tính giá, HĐ, phụ lục - Admin tự tạo template
|
- [x] **Form Templates:** Mail Merge Engine cho phiếu tính giá, HĐ, phụ lục - Admin tự tạo template
|
||||||
|
- [x] **Sales Phase Module:** Quản lý đợt mở bán, giá bán riêng theo đợt, tích hợp vào ContractForm
|
||||||
|
|
||||||
### 5.2. Đang dở / Cần tiếp tục
|
### 5.2. Đang dở / Cần tiếp tục
|
||||||
- [x] **Dashboard thống kê:** Đã tạo `ContractStatsOverview` + `UpcomingPaymentsTable`
|
- [x] **Dashboard thống kê:** Đã tạo `ContractStatsOverview` + `UpcomingPaymentsTable`
|
||||||
@@ -327,6 +368,8 @@ DB_HOST=127.0.0.1 php artisan migrate
|
|||||||
- `database/migrations/2026_04_24_083000_add_payment_template_id_to_contracts.php`
|
- `database/migrations/2026_04_24_083000_add_payment_template_id_to_contracts.php`
|
||||||
- `database/migrations/2026_04_28_013900_add_calculation_log_to_contracts.php`
|
- `database/migrations/2026_04_28_013900_add_calculation_log_to_contracts.php`
|
||||||
- `database/migrations/2026_04_28_020000_create_form_templates_tables.php`
|
- `database/migrations/2026_04_28_020000_create_form_templates_tables.php`
|
||||||
|
- `database/migrations/2026_04_28_030000_create_sales_phases_tables.php`
|
||||||
|
- `database/migrations/2026_04_28_031000_add_sales_phase_id_to_contracts.php`
|
||||||
|
|
||||||
### Services mới
|
### Services mới
|
||||||
- `app/Services/DiscountEngine.php` - Tính toán chiết khấu
|
- `app/Services/DiscountEngine.php` - Tính toán chiết khấu
|
||||||
@@ -339,20 +382,27 @@ DB_HOST=127.0.0.1 php artisan migrate
|
|||||||
- `app/Filament/Resources/Appendices/` (Resource + Form + Table + Pages)
|
- `app/Filament/Resources/Appendices/` (Resource + Form + Table + Pages)
|
||||||
- `app/Filament/Resources/Settlements/` (Resource + Form + Table + Pages)
|
- `app/Filament/Resources/Settlements/` (Resource + Form + Table + Pages)
|
||||||
- `app/Filament/Resources/FormTemplates/` (Resource + Form + Table + Pages)
|
- `app/Filament/Resources/FormTemplates/` (Resource + Form + Table + Pages)
|
||||||
|
- `app/Filament/Resources/SalesPhases/` (Resource + Form + Table + Pages)
|
||||||
|
|
||||||
### Widgets mới
|
### Widgets mới
|
||||||
- `app/Filament/Widgets/ContractStatsOverview.php` - Dashboard tổng quan tài chính
|
- `app/Filament/Widgets/ContractStatsOverview.php` - Dashboard tổng quan tài chính
|
||||||
- `app/Filament/Widgets/UpcomingPaymentsTable.php` - Danh sách đợt TT sắp đến hạn
|
- `app/Filament/Widgets/UpcomingPaymentsTable.php` - Danh sách đợt TT sắp đến hạn
|
||||||
|
|
||||||
|
### Models mới
|
||||||
|
- `app/Models/SalesPhase.php` - Đợt mở bán
|
||||||
|
- `app/Models/SalesPhaseProduct.php` - Pivot model giá bán theo đợt
|
||||||
|
|
||||||
### Models sửa đổi
|
### Models sửa đổi
|
||||||
- `app/Models/Contract.php` - Thêm `paymentTemplate()`, accessor `final_value`
|
- `app/Models/Contract.php` - Thêm `paymentTemplate()`, `salesPhase()`, accessor `final_value`
|
||||||
- `app/Models/PaymentScheduleItem.php` - Thêm accessor `paid_amount`, `remaining_amount`
|
- `app/Models/PaymentScheduleItem.php` - Thêm accessor `paid_amount`, `remaining_amount`
|
||||||
|
- `app/Models/Product.php` - Thêm `salesPhases()`, `activeSalesPhase()`
|
||||||
|
- `app/Models/Project.php` - Thêm `salesPhases()`
|
||||||
- `app/Models/User.php` - Thêm `FilamentUser` interface để user có quyền truy cập panel
|
- `app/Models/User.php` - Thêm `FilamentUser` interface để user có quyền truy cập panel
|
||||||
|
|
||||||
### Forms/Tables sửa đổi
|
### Forms/Tables sửa đổi
|
||||||
- `app/Filament/Resources/Contracts/ContractResource.php` - Fix action `EditAction` namespace (`Filament\Actions\EditAction`)
|
- `app/Filament/Resources/Contracts/ContractResource.php` - Fix action `EditAction` namespace (`Filament\Actions\EditAction`)
|
||||||
- `app/Filament/Resources/Contracts/Schemas/ContractForm.php` - Fix `payment_template_id`, thêm `final_value_display`
|
- `app/Filament/Resources/Contracts/Schemas/ContractForm.php` - Fix `payment_template_id`, thêm `final_value_display`, thêm `sales_phase_id` với auto-populate giá từ SalesPhaseProduct
|
||||||
- `app/Filament/Resources/Contracts/Pages/CreateContract.php` - Refactor dùng `$contract->payment_template_id`
|
- `app/Filament/Resources/Contracts/Pages/CreateContract.php` - Refactor dùng `$contract->payment_template_id`, fallback lấy từ `salesPhase->paymentTemplate`
|
||||||
- `app/Filament/Resources/Payments/Schemas/PaymentForm.php` - Thêm validation amount + helper text công nợ
|
- `app/Filament/Resources/Payments/Schemas/PaymentForm.php` - Thêm validation amount + helper text công nợ
|
||||||
- `app/Filament/Resources/Payments/Tables/PaymentsTable.php` - Thêm cột Loại đợt, Đối soát, Còn thiếu
|
- `app/Filament/Resources/Payments/Tables/PaymentsTable.php` - Thêm cột Loại đợt, Đối soát, Còn thiếu
|
||||||
- `app/Filament/Resources/Payments/PaymentResource.php` - Thêm eager load `scheduleItem.payments`
|
- `app/Filament/Resources/Payments/PaymentResource.php` - Thêm eager load `scheduleItem.payments`
|
||||||
|
|||||||
121
ASSESSMENT.md
Normal file
121
ASSESSMENT.md
Normal file
@@ -0,0 +1,121 @@
|
|||||||
|
# HQLAND - ĐÁNH GIÁ HIỆN TRẠNG & ĐỀ XUẤT PHÁT TRIỂN
|
||||||
|
|
||||||
|
> Đánh giá khách quan sau phiên làm việc 28/04/2026
|
||||||
|
> Ngườ đánh giá: AI Assistant (Kimi)
|
||||||
|
> **Lưu ý:** Đây là đánh giá tự phê bình để cải thiện chất lượng hệ thống
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## I. ĐIỂM MẠNH (Đã hoàn thành tốt)
|
||||||
|
|
||||||
|
### 1. Kiến trúc kỹ thuật
|
||||||
|
- **Schemas Architecture:** Tách biệt Form/Table ra khỏi Resource → code gọn gàng, dễ bảo trì
|
||||||
|
- **UUID 100%:** Phù hợp với hệ thống phân tán, khó đoán ID
|
||||||
|
- **PostgreSQL + JSONB:** Tận dụng tốt khả năng lưu trữ linh hoạt của Postgres
|
||||||
|
- **Testing:** PHPUnit cấu hình đúng PostgreSQL, test tự động chạy được
|
||||||
|
|
||||||
|
### 2. Nghiệp vụ tài chính
|
||||||
|
- **Calculation Pipeline:** Tính toán step-by-step có làm tròn tại mỗi bước → đúng chuẩn kế toán
|
||||||
|
- **PaymentObserver:** Tự động tính công nợ + khấu trừ dư → giảm sai sót thủ công
|
||||||
|
- **Lịch thanh toán:** Tạo từ template, hỗ trợ nhiều đợt với ngày đến hạn linh hoạt
|
||||||
|
- **Form Templates:** Mail Merge Engine cho phép admin tự tạo mẫu in → giảm phụ thuộc dev
|
||||||
|
|
||||||
|
### 3. Import dữ liệu
|
||||||
|
- Import Excel cho Products, Customers, Contracts đều hoạt động
|
||||||
|
- Xử lý được ngày tháng Excel (serial number), số điện thoại phức tạp
|
||||||
|
- Logic "bắc cầu" 2 file hợp đồng khá thông minh
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## II. ĐIỂM YẾU & LỖI TIỀM ẨN (Cần sửa gấp)
|
||||||
|
|
||||||
|
### 🔴 Nghiêm trọng - Có thể crash/mất dữ liệu
|
||||||
|
|
||||||
|
| # | Vấn đề | Mô tả | Hệ quả |
|
||||||
|
|---|--------|-------|--------|
|
||||||
|
| 1 | **~~MailMergeService dùng `eval()`~~ [ĐÃ SỬA]** | `safeEval()` execute string bằng `eval('return ' . $expression)` | Nếu sanitize lỗi → Remote Code Execution. Hiện filter regex chưa đủ chặt |
|
||||||
|
| 2 | **~~`Contract::saved()` gọi `saveQuietly()`~~ [ĐÃ SỬA]** | Sau khi save HĐ, trigger tính toán rồi save lại | Nếu logic thay đổi → infinite loop. Hiện tại may mắn không loop vì chỉ update `calculation_log` nhưng rủi ro cao |
|
||||||
|
| 3 | **~~Không có Transaction~~ [ĐÃ SỬA]** | `ImportContractsComplex` dùng `DB::beginTransaction` nhưng các service khác không | Nếu tạo HĐ thành công nhưng tạo lịch TT lỗi → dữ liệu lệch |
|
||||||
|
| 4 | **Không có Soft Delete** | Tất cả model dùng `Model::delete()` cứng | Xóa nhầm HĐ/Thu tiền → mất vĩnh viễn, không audit được |
|
||||||
|
|
||||||
|
### 🟡 Trung bình - Ảnh hưởng trải nghiệm
|
||||||
|
|
||||||
|
| # | Vấn đề | Mô tả |
|
||||||
|
|---|--------|-------|
|
||||||
|
| 5 | **Chưa có phân quyền** | Chỉ có 1 loại user, ai cũng vào được mọi chức năng | Nhân viên thu ngân có thể xóa HĐ, sửa giá |
|
||||||
|
| 6 | **Chưa có API** | Hiện chỉ có Filament Admin Panel | Không làm app mobile, không tích hợp với website bán hàng |
|
||||||
|
| 7 | **ContractForm chưa hiển thị `calculation_log` đúng** | Khi create HĐ mới, `final_value_display` dùng `DiscountEngine` cũ thay vì Pipeline | Giá trị hiển thị có thể khác với giá trị lưu DB |
|
||||||
|
| 8 | **Payment chưa liên kết người thu** | `Payment` chỉ có `contract_id`, không có `collected_by` | Không biết ai thu tiền, khó trách nhiệm |
|
||||||
|
| 9 | **Chưa có sổ quỹ** | Thu tiền nhưng không ghi nhận vào quỹ tiền mặt/ngân hàng | Không đối soát được thực thu với ngân hàng |
|
||||||
|
|
||||||
|
### 🟢 Thấp - Cần cải thiện lâu dài
|
||||||
|
|
||||||
|
| # | Vấn đề | Mô tả |
|
||||||
|
|---|--------|-------|
|
||||||
|
| 10 | **Chưa có CRM Pipeline** | Không quản lý khách hàng tiềm năng (Lead) | Mất dữ liệu khách hàng đến xem nhà nhưng chưa mua |
|
||||||
|
| 11 | **~~Không có đợt mở bán~~ [ĐÃ SỬA]** | Sản phẩm chỉ có status "Đang mở bán", không có đợt/bLOCK mở bán riêng | Không áp dụng chính sách giá khác nhau theo đợt |
|
||||||
|
| 12 | **Chưa có báo cáo BCTC** | Chỉ có Dashboard widget đơn giản | Kế toán không lấy được báo cáo theo quý/năm để nộp thuế |
|
||||||
|
| 13 | **Không có quản lý hạ tầng sau bán** | `infrastructure_status` chỉ là JSONB tĩnh | Không theo dõi bảo hành đường, điện, nước |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## III. SO SÁNH VỚI CHUẨN NGÀNH BĐS VIỆT NAM
|
||||||
|
|
||||||
|
| Tiêu chí | HQLand hiện tại | Phần mềm BĐS chuyên nghiệp (Landsoft, REE) | Khoảng cách |
|
||||||
|
|----------|----------------|------------------------------------------|-------------|
|
||||||
|
| **CRM Lead** | Không có | Quản lý khách đến từ Facebook, sàn... | 🔴 Thiếu |
|
||||||
|
| **Pipeline bán hàng** | Không có | Lead → Chăm sóc → Giữ chỗ → HĐMB | 🔴 Thiếu |
|
||||||
|
| **Đợt mở bán** | ✅ Có - SalesPhase module | Mở bán Phase 1, 2, 3 với giá/chính sách khác nhau | 🟢 Tương đương |
|
||||||
|
| **Chính sách giá động** | Chiết khấu tĩnh | Chiết khấu theo đợt, theo khách hàng VIP, theo số lượng | 🟡 Cơ bản |
|
||||||
|
| **Tài chính** | Thu tiền + công nợ | BCTC, dòng tiền, đối soát ngân hàng | 🟡 Cơ bản |
|
||||||
|
| **In ấn** | Form Template | In HĐ, phiếu thu, phiếu tính giá | 🟢 Tương đương |
|
||||||
|
| **Phân quyền** | Không có | Role: Admin, Sales, Kế toán, Thu ngân... | 🔴 Thiếu |
|
||||||
|
| **Mobile App** | Không có | App cho sales, app cho khách hàng | 🔴 Thiếu |
|
||||||
|
|
||||||
|
**Nhận xét:** HQLand hiện tại mới đạt **30-40%** so với phần mềm BĐS chuyên nghiệp. Phù hợp làm **hệ thống nội bộ quản lý dữ liệu + thu tiền**, nhưng chưa đủ để làm **phần mềm bán hàng toàn diện**.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## IV. ĐỀ XUẤT LỘ TRÌNH PHÁT TRIỂN
|
||||||
|
|
||||||
|
### Giai đoạn 1: Sửa lỗi & An toàn (ĐÃ HOÀN THÀNH)
|
||||||
|
1. **~~Thay thế `eval()`~~ [DONE]** - Dùng shunting yard + bcmath trong MailMergeService
|
||||||
|
2. **~~Thêm `DB::transaction`~~ [DONE]** - `ContractScheduleService::generateFromTemplate()` đã có transaction
|
||||||
|
3. **Thêm Soft Delete** cho Contract, Payment, Customer + model `DeletedBy` để audit
|
||||||
|
4. **Thêm `collected_by`** vào bảng `payments` + hiển thị ngườ thu trong Form/Table
|
||||||
|
5. **~~Fix `Contract::saved()`~~ [DONE]** - Dùng `self::$calculating` guard flag + `updateQuietly()`
|
||||||
|
|
||||||
|
### Giai đoạn 2: Quyền hạn & Báo cáo (2 tuần)
|
||||||
|
6. **Cài Spatie Permission** - Phân quyền: Admin, Sales Manager, Sales, Kế toán, Thu ngân
|
||||||
|
7. **Báo cáo công nợ chi tiết** - Theo khách hàng, theo dự án, theo đợt TT
|
||||||
|
8. **Báo cáo thu chi** - Sổ quỹ tiền mặt, sổ quỹ ngân hàng
|
||||||
|
9. **Export Excel báo cáo** - Báo cáo doanh thu, công nợ cho kế toán
|
||||||
|
|
||||||
|
### Giai đoạn 3: Mở rộng nghiệp vụ (Đang làm)
|
||||||
|
10. **CRM Pipeline** - Lead → Opportunity → Contract với các stage tùy chỉnh
|
||||||
|
11. **~~Quản lý đợt mở bán~~ [DONE]** - SalesPhase module với giá bán và chiết khấu riêng theo đợt
|
||||||
|
12. **Chính sách bán hàng động** - Chiết khấu theo thờ điểm, theo số lượng, theo CTV
|
||||||
|
13. **Notification đợt TT** - Email/SMS nhắc thanh toán tự động
|
||||||
|
|
||||||
|
### Giai đoạn 4: Tích hợp & Tối ưu (2 tháng)
|
||||||
|
14. **API REST** cho mobile app / website bán hàng
|
||||||
|
15. **Đối soát ngân hàng** - Import sao kê ngân hàng, tự động match với phiếu thu
|
||||||
|
16. **Quản lý bảo hành** - Theo dõi sửa chữa hạ tầng, bàn giao nhà
|
||||||
|
17. **Báo cáo BCTC** - Theo chuẩn kế toán Việt Nam, có thể xuất cho thuế
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## V. KHUYẾN NGHỊ CHO BẠN
|
||||||
|
|
||||||
|
### Nên làm NGAY (tuần tới):
|
||||||
|
> Sửa lỗi nghiêm trọng #1, #2, #3. Không sửa → hệ thống có thể crash hoặc mất dữ liệu khi dữ liệu lớn lên.
|
||||||
|
|
||||||
|
### Nên làm TIẾP THEO (tháng tới):
|
||||||
|
> Phân quyền + Báo cáo tài chính. Đây là yêu cầu tối thiểu để kế toán và ban giám đốc sử dụng được.
|
||||||
|
|
||||||
|
### Có thể ĐỂ SAU:
|
||||||
|
> Mobile app, CRM Pipeline, đối soát ngân hàng. Các tính năng này tốn nhiều thời gian nhưng chưa ảnh hưởng đến vận hành cơ bản.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
*Đánh giá này dựa trên code review thực tế và so sánh với best practices trong ngành BĐS Việt Nam. Cần cập nhật định kỳ.*
|
||||||
60
FILAMENT_LAYOUT_NOTES.md
Normal file
60
FILAMENT_LAYOUT_NOTES.md
Normal file
@@ -0,0 +1,60 @@
|
|||||||
|
# FILAMENT LAYOUT NOTES - BÀI HỌC KHÔNG QUÊN
|
||||||
|
|
||||||
|
> Ghi chú nhanh để tránh lặp lại lỗi layout
|
||||||
|
> **Ngày:** 24/04/2026
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚠️ VẤN ĐỀ ĐÃ GẶP
|
||||||
|
Form tạo biểu mẫu (FormTemplate) bị chia cột: Section 1 và Section 2 nằm cùng hàng ngang thay vì xếp dọc full width.
|
||||||
|
|
||||||
|
## ✅ GIẢI PHÁP
|
||||||
|
|
||||||
|
### 1. Section xếp dọc full width
|
||||||
|
```php
|
||||||
|
Section::make('Tên section')
|
||||||
|
->columnSpanFull() // <-- BẮT BUỘC nếu muốn full width
|
||||||
|
->schema([...])
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Field chia cột BÊN TRONG Section
|
||||||
|
```php
|
||||||
|
Section::make('Thông tin')
|
||||||
|
->columnSpanFull()
|
||||||
|
->schema([
|
||||||
|
Grid::make(3) // Grid chỉ dùng BÊN TRONG Section
|
||||||
|
->schema([
|
||||||
|
TextInput::make('name'),
|
||||||
|
TextInput::make('code'),
|
||||||
|
Select::make('type'),
|
||||||
|
]),
|
||||||
|
])
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. KHÔNG dùng Grid bọc ngoài nhiều Section
|
||||||
|
```php
|
||||||
|
// ❌ SAI - Grid bọc ngoài sẽ ép Section vào cột
|
||||||
|
Grid::make(2)->schema([
|
||||||
|
Section::make('A')->schema([...]),
|
||||||
|
Section::make('B')->schema([...]),
|
||||||
|
])
|
||||||
|
|
||||||
|
// ✅ ĐÚNG - Section xếp dọc, Grid bên trong
|
||||||
|
Section::make('A')->columnSpanFull()->schema([
|
||||||
|
Grid::make(3)->schema([...])
|
||||||
|
]),
|
||||||
|
Section::make('B')->columnSpanFull()->schema([
|
||||||
|
Grid::make(3)->schema([...])
|
||||||
|
]),
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. RichEditor tăng chiều cao
|
||||||
|
```php
|
||||||
|
RichEditor::make('content')
|
||||||
|
->extraInputAttributes(['style' => 'min-height: 500px;'])
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📌 TÓM TẮT 1 DÒNG
|
||||||
|
> `Section` cần `->columnSpanFull()` để full width. `Grid::make(3)` chỉ dùng bên trong Section để chia field.
|
||||||
@@ -1,64 +1,40 @@
|
|||||||
# HQLAND - HƯỚNG DẪN PHIÊN LÀM VIỆC TIẾP THEO
|
# 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.
|
> 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
|
> **Cập nhật:** 28/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
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 1. NHỮNG GÌ VỪA HOÀN THÀNH
|
## 1. NHỮNG GÌ VỪA HOÀN THÀNH
|
||||||
|
|
||||||
### ✅ Kiến trúc mới: Calculation Pipeline
|
### ✅ Module mới: Sales Phases (Đợt mở bán)
|
||||||
- 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
|
- **Models:** `SalesPhase`, `SalesPhaseProduct` (pivot)
|
||||||
- `RoundingRule`: NONE, UNIT (đồng), THOUSAND, MILLION
|
- **Migration:** `sales_phases`, `sales_phase_products`, `add_sales_phase_id_to_contracts`
|
||||||
- `CalculationStep`: Định nghĩa từng bước (tên, công thức, làm tròn, ghi đè)
|
- **SalesPhaseResource:** Form + Table + Pages đầy đủ (Schemas)
|
||||||
- `CalculationResult`: Lưu snapshot + price_sheet cho phiếu tính giá
|
- **ContractForm:** Chọn `sales_phase_id` → auto-populate giá từ pivot
|
||||||
- `PriceCalculationService`: Pipeline chuyên BĐS (QSDĐ + Móng → Subtotal → CK → Net → VAT → Total)
|
- **CreateContract:** Fallback lấy `paymentTemplate` từ `salesPhase` nếu HĐ không chọn template trực tiếp
|
||||||
- `Contract::calculation_log`: JSONB lưu toàn bộ quá trình tính toán
|
- **Product/Project models:** Thêm relationships với SalesPhase
|
||||||
|
|
||||||
### ✅ Module mới: Form Templates (Biểu mẫu in ấn)
|
### ✅ Kiến trúc cũ vẫn giữ nguyên
|
||||||
- **Mail Merge Engine:** Admin tự tạo template HTML, chèn `{{ma_truong}}`
|
- Calculation Pipeline, Form Templates, Payment/Finance modules
|
||||||
- **FormField:** Định nghĩa nguồn dữ liệu (db_column, db_relation, formula, input, static)
|
- Dashboard widgets, PaymentFine/Appendix/Settlement Resources
|
||||||
- **FormPrintLog:** Lưu snapshot khi in
|
- 9 tests passing
|
||||||
- **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
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 2. CẤU HÌNH DATABASE
|
## 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
|
```bash
|
||||||
DB_HOST=127.0.0.1 php artisan migrate --force
|
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
|
## 3. TEST
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
DB_HOST=127.0.0.1 ./vendor/bin/pest --filter="ContractFinanceFlowTest|ContractResourceRenderTest"
|
DB_HOST=127.0.0.1 ./vendor/bin/pest
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
@@ -14,11 +14,16 @@ class CreateContract extends CreateRecord
|
|||||||
{
|
{
|
||||||
$contract = $this->record;
|
$contract = $this->record;
|
||||||
|
|
||||||
|
$template = null;
|
||||||
|
|
||||||
if ($contract->payment_template_id) {
|
if ($contract->payment_template_id) {
|
||||||
$template = $contract->paymentTemplate;
|
$template = $contract->paymentTemplate;
|
||||||
if ($template) {
|
} elseif ($contract->sales_phase_id && $contract->salesPhase?->payment_template_id) {
|
||||||
ContractScheduleService::generateFromTemplate($contract, $template);
|
$template = $contract->salesPhase->paymentTemplate;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if ($template) {
|
||||||
|
ContractScheduleService::generateFromTemplate($contract, $template);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -4,6 +4,7 @@ namespace App\Filament\Resources\Contracts\Schemas;
|
|||||||
|
|
||||||
use App\Models\Product;
|
use App\Models\Product;
|
||||||
use App\Models\PaymentTemplate;
|
use App\Models\PaymentTemplate;
|
||||||
|
use App\Models\SalesPhase;
|
||||||
use Filament\Forms\Components\Select;
|
use Filament\Forms\Components\Select;
|
||||||
use Filament\Forms\Components\TextInput;
|
use Filament\Forms\Components\TextInput;
|
||||||
use Filament\Forms\Components\DatePicker;
|
use Filament\Forms\Components\DatePicker;
|
||||||
@@ -12,6 +13,7 @@ use Filament\Schemas\Components\Grid;
|
|||||||
use Filament\Forms\Components\KeyValue;
|
use Filament\Forms\Components\KeyValue;
|
||||||
use Filament\Forms\Components\Placeholder;
|
use Filament\Forms\Components\Placeholder;
|
||||||
use Filament\Schemas\Schema;
|
use Filament\Schemas\Schema;
|
||||||
|
use Filament\Schemas\Components\Utilities\Get;
|
||||||
use Filament\Schemas\Components\Utilities\Set;
|
use Filament\Schemas\Components\Utilities\Set;
|
||||||
use Illuminate\Support\HtmlString;
|
use Illuminate\Support\HtmlString;
|
||||||
|
|
||||||
@@ -41,9 +43,47 @@ class ContractForm
|
|||||||
$set('total_value', $product->total_price);
|
$set('total_value', $product->total_price);
|
||||||
$set('land_value', $product->qsdd_value);
|
$set('land_value', $product->qsdd_value);
|
||||||
$set('foundation_value', $product->foundation_temp_value);
|
$set('foundation_value', $product->foundation_temp_value);
|
||||||
|
$set('sales_phase_id', null);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}),
|
}),
|
||||||
|
|
||||||
|
Select::make('sales_phase_id')
|
||||||
|
->label('Đợt mở bán')
|
||||||
|
->options(function (Get $get) {
|
||||||
|
$productId = $get('product_id');
|
||||||
|
if (! $productId) return [];
|
||||||
|
$product = Product::find($productId);
|
||||||
|
if (! $product) return [];
|
||||||
|
return SalesPhase::where('project_id', $product->project_id)
|
||||||
|
->whereIn('status', ['Chuẩn bị', 'Đang mở bán'])
|
||||||
|
->pluck('name', 'id');
|
||||||
|
})
|
||||||
|
->searchable()
|
||||||
|
->preload()
|
||||||
|
->live()
|
||||||
|
->helperText('Chọn đợt mở bán để áp dụng giá và chính sách của đợt')
|
||||||
|
->afterStateUpdated(function (Set $set, Get $get, $state) {
|
||||||
|
$productId = $get('product_id');
|
||||||
|
if ($state && $productId) {
|
||||||
|
$phaseProduct = \App\Models\SalesPhaseProduct::where('sales_phase_id', $state)
|
||||||
|
->where('product_id', $productId)
|
||||||
|
->first();
|
||||||
|
if ($phaseProduct) {
|
||||||
|
$set('land_value', $phaseProduct->land_value ?? $get('land_value'));
|
||||||
|
$set('foundation_value', $phaseProduct->foundation_value ?? $get('foundation_value'));
|
||||||
|
$total = (float) ($phaseProduct->land_value ?? $get('land_value')) + (float) ($phaseProduct->foundation_value ?? $get('foundation_value'));
|
||||||
|
if ($phaseProduct->sale_price > 0) {
|
||||||
|
$total = (float) $phaseProduct->sale_price;
|
||||||
|
}
|
||||||
|
$set('total_value', $total);
|
||||||
|
if ($phaseProduct->discount_details) {
|
||||||
|
$set('discount_details', $phaseProduct->discount_details);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}),
|
||||||
|
|
||||||
TextInput::make('contract_number')
|
TextInput::make('contract_number')
|
||||||
->label('Số HĐMB')
|
->label('Số HĐMB')
|
||||||
->required()
|
->required()
|
||||||
|
|||||||
@@ -17,8 +17,9 @@ class FormTemplateForm
|
|||||||
{
|
{
|
||||||
return $schema
|
return $schema
|
||||||
->components([
|
->components([
|
||||||
// BLOCK 1: Thông tin cơ bản
|
// SECTION 1: Full width, field chia 3 cột
|
||||||
Section::make('Thông tin biểu mẫu')
|
Section::make('Thông tin biểu mẫu')
|
||||||
|
->columnSpanFull()
|
||||||
->schema([
|
->schema([
|
||||||
Grid::make(3)
|
Grid::make(3)
|
||||||
->schema([
|
->schema([
|
||||||
@@ -39,10 +40,7 @@ class FormTemplateForm
|
|||||||
'App\Models\Customer' => 'Khách hàng',
|
'App\Models\Customer' => 'Khách hàng',
|
||||||
])
|
])
|
||||||
->required(),
|
->required(),
|
||||||
]),
|
|
||||||
|
|
||||||
Grid::make(3)
|
|
||||||
->schema([
|
|
||||||
Select::make('paper_size')
|
Select::make('paper_size')
|
||||||
->label('Khổ giấy')
|
->label('Khổ giấy')
|
||||||
->options([
|
->options([
|
||||||
@@ -55,8 +53,9 @@ class FormTemplateForm
|
|||||||
]),
|
]),
|
||||||
]),
|
]),
|
||||||
|
|
||||||
// BLOCK 2: Danh sách trường dữ liệu
|
// SECTION 2: Full width, Repeater item chia 3 cột
|
||||||
Section::make('Danh sách trường dữ liệu (Merge Fields)')
|
Section::make('Danh sách trường dữ liệu (Merge Fields)')
|
||||||
|
->columnSpanFull()
|
||||||
->schema([
|
->schema([
|
||||||
Repeater::make('fields')
|
Repeater::make('fields')
|
||||||
->relationship('fields')
|
->relationship('fields')
|
||||||
@@ -84,10 +83,7 @@ class FormTemplateForm
|
|||||||
])
|
])
|
||||||
->required()
|
->required()
|
||||||
->live(),
|
->live(),
|
||||||
]),
|
|
||||||
|
|
||||||
Grid::make(3)
|
|
||||||
->schema([
|
|
||||||
KeyValue::make('source_config')
|
KeyValue::make('source_config')
|
||||||
->label('Cấu hình nguồn')
|
->label('Cấu hình nguồn')
|
||||||
->keyLabel('Tham số')
|
->keyLabel('Tham số')
|
||||||
@@ -117,13 +113,13 @@ class FormTemplateForm
|
|||||||
->numeric()
|
->numeric()
|
||||||
->default(0)
|
->default(0)
|
||||||
->visible(fn ($get) => in_array($get('format'), ['number', 'currency', 'percent'])),
|
->visible(fn ($get) => in_array($get('format'), ['number', 'currency', 'percent'])),
|
||||||
]),
|
|
||||||
|
|
||||||
TextInput::make('display_order')
|
TextInput::make('display_order')
|
||||||
->label('Thứ tự')
|
->label('Thứ tự')
|
||||||
->numeric()
|
->numeric()
|
||||||
->default(0)
|
->default(0)
|
||||||
->hidden(),
|
->hidden(),
|
||||||
|
]),
|
||||||
])
|
])
|
||||||
->addActionLabel('Thêm trường dữ liệu')
|
->addActionLabel('Thêm trường dữ liệu')
|
||||||
->reorderable()
|
->reorderable()
|
||||||
@@ -133,15 +129,17 @@ class FormTemplateForm
|
|||||||
->columnSpanFull(),
|
->columnSpanFull(),
|
||||||
]),
|
]),
|
||||||
|
|
||||||
// BLOCK 3: Nội dung mẫu in - FULL WIDTH, TO RỘNG
|
// SECTION 3: Full width, RichEditor to
|
||||||
Section::make('Nội dung mẫu in')
|
Section::make('Nội dung mẫu in')
|
||||||
|
->columnSpanFull()
|
||||||
->schema([
|
->schema([
|
||||||
RichEditor::make('html_template')
|
RichEditor::make('html_template')
|
||||||
->label('')
|
->label('')
|
||||||
->required()
|
->required()
|
||||||
->placeholder('Soạn thảo nội dung biểu mẫu...')
|
->placeholder('Soạn thảo nội dung biểu mẫu...')
|
||||||
->helperText('Chèn trường dữ liệu bằng cú pháp {{ma_truong}}. Ví dụ: Tên khách hàng: {{ten_khach_hang}}')
|
->helperText('Chèn trường dữ liệu bằng cú pháp {{ma_truong}}. Ví dụ: Tên khách hàng: {{ten_khach_hang}}')
|
||||||
->columnSpanFull(),
|
->columnSpanFull()
|
||||||
|
->extraInputAttributes(['style' => 'min-height: 500px;']),
|
||||||
]),
|
]),
|
||||||
]);
|
]);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,11 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
namespace App\Filament\Resources\SalesPhases\Pages;
|
||||||
|
|
||||||
|
use App\Filament\Resources\SalesPhases\SalesPhaseResource;
|
||||||
|
use Filament\Resources\Pages\CreateRecord;
|
||||||
|
|
||||||
|
class CreateSalesPhase extends CreateRecord
|
||||||
|
{
|
||||||
|
protected static string $resource = SalesPhaseResource::class;
|
||||||
|
}
|
||||||
11
app/Filament/Resources/SalesPhases/Pages/EditSalesPhase.php
Normal file
11
app/Filament/Resources/SalesPhases/Pages/EditSalesPhase.php
Normal file
@@ -0,0 +1,11 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
namespace App\Filament\Resources\SalesPhases\Pages;
|
||||||
|
|
||||||
|
use App\Filament\Resources\SalesPhases\SalesPhaseResource;
|
||||||
|
use Filament\Resources\Pages\EditRecord;
|
||||||
|
|
||||||
|
class EditSalesPhase extends EditRecord
|
||||||
|
{
|
||||||
|
protected static string $resource = SalesPhaseResource::class;
|
||||||
|
}
|
||||||
19
app/Filament/Resources/SalesPhases/Pages/ListSalesPhases.php
Normal file
19
app/Filament/Resources/SalesPhases/Pages/ListSalesPhases.php
Normal file
@@ -0,0 +1,19 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
namespace App\Filament\Resources\SalesPhases\Pages;
|
||||||
|
|
||||||
|
use App\Filament\Resources\SalesPhases\SalesPhaseResource;
|
||||||
|
use Filament\Actions\CreateAction;
|
||||||
|
use Filament\Resources\Pages\ListRecords;
|
||||||
|
|
||||||
|
class ListSalesPhases extends ListRecords
|
||||||
|
{
|
||||||
|
protected static string $resource = SalesPhaseResource::class;
|
||||||
|
|
||||||
|
protected function getHeaderActions(): array
|
||||||
|
{
|
||||||
|
return [
|
||||||
|
CreateAction::make(),
|
||||||
|
];
|
||||||
|
}
|
||||||
|
}
|
||||||
42
app/Filament/Resources/SalesPhases/SalesPhaseResource.php
Normal file
42
app/Filament/Resources/SalesPhases/SalesPhaseResource.php
Normal file
@@ -0,0 +1,42 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
namespace App\Filament\Resources\SalesPhases;
|
||||||
|
|
||||||
|
use App\Filament\Resources\SalesPhases\Pages;
|
||||||
|
use App\Models\SalesPhase;
|
||||||
|
use App\Enums\NavigationGroup;
|
||||||
|
use Filament\Schemas\Schema;
|
||||||
|
use Filament\Resources\Resource;
|
||||||
|
use Filament\Tables\Table;
|
||||||
|
use App\Filament\Resources\SalesPhases\Schemas\SalesPhaseForm;
|
||||||
|
use App\Filament\Resources\SalesPhases\Tables\SalesPhasesTable;
|
||||||
|
|
||||||
|
class SalesPhaseResource extends Resource
|
||||||
|
{
|
||||||
|
protected static ?string $model = SalesPhase::class;
|
||||||
|
protected static string | \BackedEnum | null $navigationIcon = 'heroicon-o-rocket-launch';
|
||||||
|
protected static string | \UnitEnum | null $navigationGroup = NavigationGroup::WAREHOUSE->value;
|
||||||
|
protected static ?int $navigationSort = 2;
|
||||||
|
|
||||||
|
protected static ?string $modelLabel = 'Đợt mở bán';
|
||||||
|
protected static ?string $pluralModelLabel = 'Đợt mở bán';
|
||||||
|
|
||||||
|
public static function form(Schema $schema): Schema
|
||||||
|
{
|
||||||
|
return SalesPhaseForm::configure($schema);
|
||||||
|
}
|
||||||
|
|
||||||
|
public static function table(Table $table): Table
|
||||||
|
{
|
||||||
|
return SalesPhasesTable::configure($table);
|
||||||
|
}
|
||||||
|
|
||||||
|
public static function getPages(): array
|
||||||
|
{
|
||||||
|
return [
|
||||||
|
'index' => Pages\ListSalesPhases::route('/'),
|
||||||
|
'create' => Pages\CreateSalesPhase::route('/create'),
|
||||||
|
'edit' => Pages\EditSalesPhase::route('/{record}/edit'),
|
||||||
|
];
|
||||||
|
}
|
||||||
|
}
|
||||||
163
app/Filament/Resources/SalesPhases/Schemas/SalesPhaseForm.php
Normal file
163
app/Filament/Resources/SalesPhases/Schemas/SalesPhaseForm.php
Normal file
@@ -0,0 +1,163 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
namespace App\Filament\Resources\SalesPhases\Schemas;
|
||||||
|
|
||||||
|
use App\Models\PaymentTemplate;
|
||||||
|
use App\Models\Product;
|
||||||
|
use Filament\Forms\Components\DatePicker;
|
||||||
|
use Filament\Forms\Components\KeyValue;
|
||||||
|
use Filament\Forms\Components\Select;
|
||||||
|
use Filament\Forms\Components\Textarea;
|
||||||
|
use Filament\Forms\Components\TextInput;
|
||||||
|
use Filament\Forms\Components\Repeater;
|
||||||
|
use Filament\Schemas\Components\Section;
|
||||||
|
use Filament\Schemas\Components\Grid;
|
||||||
|
use Filament\Schemas\Schema;
|
||||||
|
use Filament\Schemas\Components\Utilities\Set;
|
||||||
|
|
||||||
|
class SalesPhaseForm
|
||||||
|
{
|
||||||
|
public static function configure(Schema $schema): Schema
|
||||||
|
{
|
||||||
|
return $schema
|
||||||
|
->components([
|
||||||
|
// SECTION 1: Thông tin đợt mở bán
|
||||||
|
Section::make('Thông tin đợt mở bán')
|
||||||
|
->columnSpanFull()
|
||||||
|
->schema([
|
||||||
|
Grid::make(3)
|
||||||
|
->schema([
|
||||||
|
Select::make('project_id')
|
||||||
|
->label('Dự án')
|
||||||
|
->relationship('project', 'name')
|
||||||
|
->searchable()
|
||||||
|
->preload()
|
||||||
|
->required()
|
||||||
|
->live(),
|
||||||
|
|
||||||
|
TextInput::make('name')
|
||||||
|
->label('Tên đợt mở bán')
|
||||||
|
->placeholder('Đợt 1 - Mở bán tháng 5/2026')
|
||||||
|
->required(),
|
||||||
|
|
||||||
|
TextInput::make('code')
|
||||||
|
->label('Mã đợt')
|
||||||
|
->placeholder('MB1')
|
||||||
|
->required()
|
||||||
|
->unique(ignoreRecord: true),
|
||||||
|
]),
|
||||||
|
|
||||||
|
Grid::make(3)
|
||||||
|
->schema([
|
||||||
|
DatePicker::make('start_date')
|
||||||
|
->label('Ngày bắt đầu')
|
||||||
|
->required()
|
||||||
|
->default(now()),
|
||||||
|
|
||||||
|
DatePicker::make('end_date')
|
||||||
|
->label('Ngày kết thúc')
|
||||||
|
->nullable(),
|
||||||
|
|
||||||
|
Select::make('status')
|
||||||
|
->label('Trạng thái')
|
||||||
|
->options([
|
||||||
|
'Chuẩn bị' => 'Chuẩn bị',
|
||||||
|
'Đang mở bán' => 'Đang mở bán',
|
||||||
|
'Tạm dừng' => 'Tạm dừng',
|
||||||
|
'Đã đóng' => 'Đã đóng',
|
||||||
|
])
|
||||||
|
->default('Chuẩn bị')
|
||||||
|
->required(),
|
||||||
|
]),
|
||||||
|
|
||||||
|
Textarea::make('description')
|
||||||
|
->label('Mô tả')
|
||||||
|
->rows(3)
|
||||||
|
->columnSpanFull(),
|
||||||
|
]),
|
||||||
|
|
||||||
|
// SECTION 2: Chính sách & Lịch thanh toán
|
||||||
|
Section::make('Chính sách & Lịch thanh toán')
|
||||||
|
->columnSpanFull()
|
||||||
|
->schema([
|
||||||
|
Grid::make(2)
|
||||||
|
->schema([
|
||||||
|
Select::make('payment_template_id')
|
||||||
|
->label('Mẫu lịch thanh toán')
|
||||||
|
->relationship('paymentTemplate', 'name')
|
||||||
|
->searchable()
|
||||||
|
->preload()
|
||||||
|
->helperText('Áp dụng cho các hợp đồng trong đợt mở bán này')
|
||||||
|
->columnSpan(1),
|
||||||
|
|
||||||
|
KeyValue::make('discount_policy')
|
||||||
|
->label('Chính sách chiết khấu mặc định')
|
||||||
|
->keyLabel('Loại chiết khấu')
|
||||||
|
->valueLabel('Giá trị')
|
||||||
|
->helperText('Ví dụ: open_sale => 5%, wholesale => 3%')
|
||||||
|
->columnSpan(1),
|
||||||
|
]),
|
||||||
|
]),
|
||||||
|
|
||||||
|
// SECTION 3: Danh sách sản phẩm trong đợt
|
||||||
|
Section::make('Sản phẩm trong đợt mở bán')
|
||||||
|
->columnSpanFull()
|
||||||
|
->schema([
|
||||||
|
Repeater::make('phaseProducts')
|
||||||
|
->relationship('phaseProducts')
|
||||||
|
->schema([
|
||||||
|
Grid::make(4)
|
||||||
|
->schema([
|
||||||
|
Select::make('product_id')
|
||||||
|
->label('Sản phẩm')
|
||||||
|
->options(function (callable $get, $state) {
|
||||||
|
$projectId = $get('../../project_id');
|
||||||
|
if (! $projectId) return [];
|
||||||
|
return Product::where('project_id', $projectId)
|
||||||
|
->pluck('code', 'id');
|
||||||
|
})
|
||||||
|
->searchable()
|
||||||
|
->required(),
|
||||||
|
|
||||||
|
TextInput::make('sale_price')
|
||||||
|
->label('Giá bán đợt này')
|
||||||
|
->numeric()
|
||||||
|
->prefix('VND')
|
||||||
|
->placeholder('Để trống nếu lấy giá gốc'),
|
||||||
|
|
||||||
|
TextInput::make('land_value')
|
||||||
|
->label('Giá trị QSDĐ')
|
||||||
|
->numeric()
|
||||||
|
->prefix('VND'),
|
||||||
|
|
||||||
|
TextInput::make('foundation_value')
|
||||||
|
->label('Giá trị móng')
|
||||||
|
->numeric()
|
||||||
|
->prefix('VND'),
|
||||||
|
|
||||||
|
KeyValue::make('discount_details')
|
||||||
|
->label('Chiết khấu riêng')
|
||||||
|
->keyLabel('Loại')
|
||||||
|
->valueLabel('Giá trị')
|
||||||
|
->columnSpan(2),
|
||||||
|
|
||||||
|
Select::make('status')
|
||||||
|
->label('Trạng thái')
|
||||||
|
->options([
|
||||||
|
'Còn hàng' => 'Còn hàng',
|
||||||
|
'Đã giữ' => 'Đã giữ chỗ',
|
||||||
|
'Đã bán' => 'Đã bán',
|
||||||
|
'Khóa' => 'Khóa',
|
||||||
|
])
|
||||||
|
->default('Còn hàng')
|
||||||
|
->columnSpan(2),
|
||||||
|
]),
|
||||||
|
])
|
||||||
|
->addActionLabel('Thêm sản phẩm vào đợt')
|
||||||
|
->reorderable()
|
||||||
|
->defaultItems(0)
|
||||||
|
->collapsible(),
|
||||||
|
]),
|
||||||
|
]);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,74 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
namespace App\Filament\Resources\SalesPhases\Tables;
|
||||||
|
|
||||||
|
use Filament\Tables;
|
||||||
|
use Filament\Tables\Table;
|
||||||
|
|
||||||
|
class SalesPhasesTable
|
||||||
|
{
|
||||||
|
public static function configure(Table $table): Table
|
||||||
|
{
|
||||||
|
return $table
|
||||||
|
->columns([
|
||||||
|
Tables\Columns\TextColumn::make('name')
|
||||||
|
->label('Tên đợt')
|
||||||
|
->searchable()
|
||||||
|
->sortable(),
|
||||||
|
|
||||||
|
Tables\Columns\TextColumn::make('code')
|
||||||
|
->label('Mã đợt')
|
||||||
|
->searchable()
|
||||||
|
->copyable(),
|
||||||
|
|
||||||
|
Tables\Columns\TextColumn::make('project.name')
|
||||||
|
->label('Dự án')
|
||||||
|
->searchable()
|
||||||
|
->sortable(),
|
||||||
|
|
||||||
|
Tables\Columns\TextColumn::make('start_date')
|
||||||
|
->label('Bắt đầu')
|
||||||
|
->date('d/m/Y')
|
||||||
|
->sortable(),
|
||||||
|
|
||||||
|
Tables\Columns\TextColumn::make('end_date')
|
||||||
|
->label('Kết thúc')
|
||||||
|
->date('d/m/Y')
|
||||||
|
->placeholder('Không giới hạn'),
|
||||||
|
|
||||||
|
Tables\Columns\TextColumn::make('status')
|
||||||
|
->label('Trạng thái')
|
||||||
|
->badge()
|
||||||
|
->color(fn (string $state): string => match ($state) {
|
||||||
|
'Đang mở bán' => 'success',
|
||||||
|
'Chuẩn bị' => 'warning',
|
||||||
|
'Tạm dừng' => 'danger',
|
||||||
|
'Đã đóng' => 'gray',
|
||||||
|
default => 'gray',
|
||||||
|
}),
|
||||||
|
|
||||||
|
Tables\Columns\TextColumn::make('products_count')
|
||||||
|
->label('Số SP')
|
||||||
|
->counts('products'),
|
||||||
|
|
||||||
|
Tables\Columns\TextColumn::make('paymentTemplate.name')
|
||||||
|
->label('Mẫu TT')
|
||||||
|
->placeholder('Chưa chọn'),
|
||||||
|
])
|
||||||
|
->filters([
|
||||||
|
Tables\Filters\SelectFilter::make('project_id')
|
||||||
|
->label('Dự án')
|
||||||
|
->relationship('project', 'name'),
|
||||||
|
|
||||||
|
Tables\Filters\SelectFilter::make('status')
|
||||||
|
->label('Trạng thái')
|
||||||
|
->options([
|
||||||
|
'Chuẩn bị' => 'Chuẩn bị',
|
||||||
|
'Đang mở bán' => 'Đang mở bán',
|
||||||
|
'Tạm dừng' => 'Tạm dừng',
|
||||||
|
'Đã đóng' => 'Đã đóng',
|
||||||
|
]),
|
||||||
|
])
|
||||||
|
->defaultSort('start_date', 'desc');
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -13,6 +13,8 @@ class Contract extends Model
|
|||||||
|
|
||||||
protected $guarded = [];
|
protected $guarded = [];
|
||||||
|
|
||||||
|
private static bool $calculating = false;
|
||||||
|
|
||||||
protected $casts = [
|
protected $casts = [
|
||||||
'metadata' => 'array',
|
'metadata' => 'array',
|
||||||
'discount_details' => 'array',
|
'discount_details' => 'array',
|
||||||
@@ -39,6 +41,11 @@ class Contract extends Model
|
|||||||
return $this->belongsTo(PaymentTemplate::class);
|
return $this->belongsTo(PaymentTemplate::class);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
public function salesPhase()
|
||||||
|
{
|
||||||
|
return $this->belongsTo(SalesPhase::class);
|
||||||
|
}
|
||||||
|
|
||||||
public function customers()
|
public function customers()
|
||||||
{
|
{
|
||||||
return $this->belongsToMany(Customer::class, 'contract_customers')
|
return $this->belongsToMany(Customer::class, 'contract_customers')
|
||||||
@@ -125,16 +132,26 @@ class Contract extends Model
|
|||||||
});
|
});
|
||||||
|
|
||||||
static::saved(function ($contract) {
|
static::saved(function ($contract) {
|
||||||
|
// Guard: tránh infinite loop khi lưu calculation_log
|
||||||
|
if (self::$calculating) return;
|
||||||
|
|
||||||
// Tự động tính toán và lưu snapshot sau khi lưu
|
// Tự động tính toán và lưu snapshot sau khi lưu
|
||||||
if ($contract->land_value || $contract->foundation_value) {
|
if ($contract->land_value || $contract->foundation_value) {
|
||||||
$result = \App\Services\Calculation\PriceCalculationService::calculateForContract($contract);
|
self::$calculating = true;
|
||||||
$contract->calculation_log = [
|
|
||||||
'steps' => $result->getSteps(),
|
try {
|
||||||
'final_values' => $result->getValues(),
|
$result = \App\Services\Calculation\PriceCalculationService::calculateForContract($contract);
|
||||||
'price_sheet' => $result->toPriceSheet(),
|
$contract->updateQuietly([
|
||||||
'calculated_at' => now()->toDateTimeString(),
|
'calculation_log' => [
|
||||||
];
|
'steps' => $result->getSteps(),
|
||||||
$contract->saveQuietly();
|
'final_values' => $result->getValues(),
|
||||||
|
'price_sheet' => $result->toPriceSheet(),
|
||||||
|
'calculated_at' => now()->toDateTimeString(),
|
||||||
|
],
|
||||||
|
]);
|
||||||
|
} finally {
|
||||||
|
self::$calculating = false;
|
||||||
|
}
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -42,4 +42,25 @@ class Product extends Model
|
|||||||
{
|
{
|
||||||
return $this->hasMany(Appendix::class);
|
return $this->hasMany(Appendix::class);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
public function salesPhases()
|
||||||
|
{
|
||||||
|
return $this->belongsToMany(SalesPhase::class, 'sales_phase_products')
|
||||||
|
->using(SalesPhaseProduct::class)
|
||||||
|
->withPivot('id', 'sale_price', 'land_value', 'foundation_value', 'discount_details', 'status')
|
||||||
|
->withTimestamps();
|
||||||
|
}
|
||||||
|
|
||||||
|
public function activeSalesPhase()
|
||||||
|
{
|
||||||
|
return $this->salesPhases()
|
||||||
|
->wherePivot('status', 'Còn hàng')
|
||||||
|
->where('sales_phases.status', 'Đang mở bán')
|
||||||
|
->whereDate('sales_phases.start_date', '<=', now())
|
||||||
|
->where(function ($q) {
|
||||||
|
$q->whereNull('sales_phases.end_date')
|
||||||
|
->orWhereDate('sales_phases.end_date', '>=', now());
|
||||||
|
})
|
||||||
|
->first();
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -26,4 +26,9 @@ class Project extends Model
|
|||||||
{
|
{
|
||||||
return $this->hasMany(PaymentTemplate::class);
|
return $this->hasMany(PaymentTemplate::class);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
public function salesPhases()
|
||||||
|
{
|
||||||
|
return $this->hasMany(SalesPhase::class)->orderBy('start_date', 'desc');
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
43
app/Models/SalesPhase.php
Normal file
43
app/Models/SalesPhase.php
Normal file
@@ -0,0 +1,43 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
namespace App\Models;
|
||||||
|
|
||||||
|
use Illuminate\Database\Eloquent\Concerns\HasUuids;
|
||||||
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
||||||
|
use Illuminate\Database\Eloquent\Model;
|
||||||
|
|
||||||
|
class SalesPhase extends Model
|
||||||
|
{
|
||||||
|
use HasUuids, HasFactory;
|
||||||
|
|
||||||
|
protected $guarded = [];
|
||||||
|
|
||||||
|
protected $casts = [
|
||||||
|
'discount_policy' => 'array',
|
||||||
|
'start_date' => 'date',
|
||||||
|
'end_date' => 'date',
|
||||||
|
];
|
||||||
|
|
||||||
|
public function project()
|
||||||
|
{
|
||||||
|
return $this->belongsTo(Project::class);
|
||||||
|
}
|
||||||
|
|
||||||
|
public function paymentTemplate()
|
||||||
|
{
|
||||||
|
return $this->belongsTo(PaymentTemplate::class);
|
||||||
|
}
|
||||||
|
|
||||||
|
public function phaseProducts()
|
||||||
|
{
|
||||||
|
return $this->hasMany(SalesPhaseProduct::class);
|
||||||
|
}
|
||||||
|
|
||||||
|
public function products()
|
||||||
|
{
|
||||||
|
return $this->belongsToMany(Product::class, 'sales_phase_products')
|
||||||
|
->using(SalesPhaseProduct::class)
|
||||||
|
->withPivot('id', 'sale_price', 'land_value', 'foundation_value', 'discount_details', 'status')
|
||||||
|
->withTimestamps();
|
||||||
|
}
|
||||||
|
}
|
||||||
33
app/Models/SalesPhaseProduct.php
Normal file
33
app/Models/SalesPhaseProduct.php
Normal file
@@ -0,0 +1,33 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
namespace App\Models;
|
||||||
|
|
||||||
|
use Illuminate\Database\Eloquent\Concerns\HasUuids;
|
||||||
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
||||||
|
use Illuminate\Database\Eloquent\Relations\Pivot;
|
||||||
|
|
||||||
|
class SalesPhaseProduct extends Pivot
|
||||||
|
{
|
||||||
|
use HasUuids, HasFactory;
|
||||||
|
|
||||||
|
protected $table = 'sales_phase_products';
|
||||||
|
|
||||||
|
protected $guarded = [];
|
||||||
|
|
||||||
|
protected $casts = [
|
||||||
|
'sale_price' => 'decimal:2',
|
||||||
|
'land_value' => 'decimal:2',
|
||||||
|
'foundation_value' => 'decimal:2',
|
||||||
|
'discount_details' => 'array',
|
||||||
|
];
|
||||||
|
|
||||||
|
public function salesPhase()
|
||||||
|
{
|
||||||
|
return $this->belongsTo(SalesPhase::class);
|
||||||
|
}
|
||||||
|
|
||||||
|
public function product()
|
||||||
|
{
|
||||||
|
return $this->belongsTo(Product::class);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -7,63 +7,67 @@ use App\Models\PaymentSchedule;
|
|||||||
use App\Models\PaymentScheduleItem;
|
use App\Models\PaymentScheduleItem;
|
||||||
use App\Models\PaymentTemplate;
|
use App\Models\PaymentTemplate;
|
||||||
use Carbon\Carbon;
|
use Carbon\Carbon;
|
||||||
|
use Illuminate\Support\Facades\DB;
|
||||||
|
|
||||||
class ContractScheduleService
|
class ContractScheduleService
|
||||||
{
|
{
|
||||||
/**
|
/**
|
||||||
* Tạo lịch thanh toán cho hợp đồng dựa trên mẫu.
|
* Tạo lịch thanh toán cho hợp đồng dựa trên mẫu.
|
||||||
* Nếu đã tồn tại lịch cũ, sẽ xóa và tạo lại.
|
* Nếu đã tồn tại lịch cũ, sẽ xóa và tạo lại.
|
||||||
|
* Toàn bộ quá trình được bọc trong DB Transaction để đảm bảo tính toàn vẹn.
|
||||||
*/
|
*/
|
||||||
public static function generateFromTemplate(Contract $contract, ?PaymentTemplate $template = null): PaymentSchedule
|
public static function generateFromTemplate(Contract $contract, ?PaymentTemplate $template = null): PaymentSchedule
|
||||||
{
|
{
|
||||||
if (! $template) {
|
return DB::transaction(function () use ($contract, $template) {
|
||||||
// Ưu tiên template của dự án
|
if (! $template) {
|
||||||
$template = $contract->product?->project?->paymentTemplate;
|
// Ưu tiên template của dự án
|
||||||
}
|
$template = $contract->product?->project?->paymentTemplate;
|
||||||
|
|
||||||
if (! $template) {
|
|
||||||
throw new \InvalidArgumentException('Không tìm thấy mẫu thanh toán cho hợp đồng này.');
|
|
||||||
}
|
|
||||||
|
|
||||||
// Xóa lịch cũ nếu có
|
|
||||||
if ($contract->paymentSchedule) {
|
|
||||||
$contract->paymentSchedule->items()->delete();
|
|
||||||
$contract->paymentSchedule->delete();
|
|
||||||
}
|
|
||||||
|
|
||||||
$schedule = PaymentSchedule::create([
|
|
||||||
'contract_id' => $contract->id,
|
|
||||||
'template_id' => $template->id,
|
|
||||||
]);
|
|
||||||
|
|
||||||
$items = $template->items()->orderBy('installment_no')->get();
|
|
||||||
$lastDueDate = Carbon::parse($contract->signing_date);
|
|
||||||
|
|
||||||
foreach ($items as $item) {
|
|
||||||
$dueDate = null;
|
|
||||||
|
|
||||||
if ($item->days_after_signing !== null) {
|
|
||||||
$dueDate = Carbon::parse($contract->signing_date)->addDays($item->days_after_signing);
|
|
||||||
} elseif ($item->days_after_previous !== null) {
|
|
||||||
$dueDate = $lastDueDate->copy()->addDays($item->days_after_previous);
|
|
||||||
} elseif ($item->due_date !== null) {
|
|
||||||
$dueDate = $item->due_date;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
PaymentScheduleItem::create([
|
if (! $template) {
|
||||||
'schedule_id' => $schedule->id,
|
throw new \InvalidArgumentException('Không tìm thấy mẫu thanh toán cho hợp đồng này.');
|
||||||
'installment_no' => $item->installment_no,
|
}
|
||||||
'type' => $item->type,
|
|
||||||
'percentage' => $item->percentage,
|
// Xóa lịch cũ nếu có
|
||||||
'amount' => $contract->total_value * ($item->percentage / 100),
|
if ($contract->paymentSchedule) {
|
||||||
'due_date' => $dueDate,
|
$contract->paymentSchedule->items()->delete();
|
||||||
|
$contract->paymentSchedule->delete();
|
||||||
|
}
|
||||||
|
|
||||||
|
$schedule = PaymentSchedule::create([
|
||||||
|
'contract_id' => $contract->id,
|
||||||
|
'template_id' => $template->id,
|
||||||
]);
|
]);
|
||||||
|
|
||||||
if ($dueDate) {
|
$items = $template->items()->orderBy('installment_no')->get();
|
||||||
$lastDueDate = $dueDate;
|
$lastDueDate = Carbon::parse($contract->signing_date);
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return $schedule;
|
foreach ($items as $item) {
|
||||||
|
$dueDate = null;
|
||||||
|
|
||||||
|
if ($item->days_after_signing !== null) {
|
||||||
|
$dueDate = Carbon::parse($contract->signing_date)->addDays($item->days_after_signing);
|
||||||
|
} elseif ($item->days_after_previous !== null) {
|
||||||
|
$dueDate = $lastDueDate->copy()->addDays($item->days_after_previous);
|
||||||
|
} elseif ($item->due_date !== null) {
|
||||||
|
$dueDate = $item->due_date;
|
||||||
|
}
|
||||||
|
|
||||||
|
PaymentScheduleItem::create([
|
||||||
|
'schedule_id' => $schedule->id,
|
||||||
|
'installment_no' => $item->installment_no,
|
||||||
|
'type' => $item->type,
|
||||||
|
'percentage' => $item->percentage,
|
||||||
|
'amount' => $contract->total_value * ($item->percentage / 100),
|
||||||
|
'due_date' => $dueDate,
|
||||||
|
]);
|
||||||
|
|
||||||
|
if ($dueDate) {
|
||||||
|
$lastDueDate = $dueDate;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return $schedule;
|
||||||
|
});
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -72,35 +72,116 @@ class MailMergeService
|
|||||||
$evalExpression = $expression;
|
$evalExpression = $expression;
|
||||||
foreach ($values as $key => $value) {
|
foreach ($values as $key => $value) {
|
||||||
if (is_numeric($value)) {
|
if (is_numeric($value)) {
|
||||||
$evalExpression = str_replace($key, (float) $value, $evalExpression);
|
$evalExpression = str_replace($key, $value, $evalExpression);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// Chỉ cho phép số và các phép toán cơ bản
|
// Chỉ cho phép số, dấu chấm, dấu phẩy và các phép toán cơ bản
|
||||||
|
$evalExpression = str_replace(',', '.', $evalExpression);
|
||||||
$evalExpression = preg_replace('/[^0-9.\+\-\*\/\(\)\s]/', '', $evalExpression);
|
$evalExpression = preg_replace('/[^0-9.\+\-\*\/\(\)\s]/', '', $evalExpression);
|
||||||
|
$evalExpression = str_replace(' ', '', $evalExpression);
|
||||||
|
|
||||||
if (empty($evalExpression)) return 0;
|
if (empty($evalExpression)) return 0;
|
||||||
|
|
||||||
try {
|
try {
|
||||||
// Eval an toàn với chỉ phép toán
|
$result = self::safeCalculate($evalExpression);
|
||||||
$result = self::safeEval($evalExpression);
|
|
||||||
return (float) $result;
|
return (float) $result;
|
||||||
} catch (\Throwable $e) {
|
} catch (\Throwable $e) {
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
protected static function safeEval(string $expression): float
|
protected static function safeCalculate(string $expression): float
|
||||||
{
|
{
|
||||||
// Loại bỏ các hàm nguy hiểm, chỉ giữ phép toán
|
// Tokenize: tách số và operators
|
||||||
$expression = preg_replace('/[^0-9.\+\-\*\/\(\)\s]/', '', $expression);
|
$tokens = [];
|
||||||
|
$number = '';
|
||||||
|
|
||||||
if (empty($expression) || preg_match('/[a-zA-Z]/', $expression)) {
|
for ($i = 0; $i < strlen($expression); $i++) {
|
||||||
|
$char = $expression[$i];
|
||||||
|
|
||||||
|
if (ctype_digit($char) || $char === '.') {
|
||||||
|
$number .= $char;
|
||||||
|
} else {
|
||||||
|
if ($number !== '') {
|
||||||
|
$tokens[] = (float) $number;
|
||||||
|
$number = '';
|
||||||
|
}
|
||||||
|
$tokens[] = $char;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if ($number !== '') {
|
||||||
|
$tokens[] = (float) $number;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Shunting yard algorithm: infix → postfix
|
||||||
|
$output = [];
|
||||||
|
$stack = [];
|
||||||
|
$precedence = ['+' => 1, '-' => 1, '*' => 2, '/' => 2];
|
||||||
|
|
||||||
|
foreach ($tokens as $token) {
|
||||||
|
if (is_numeric($token)) {
|
||||||
|
$output[] = $token;
|
||||||
|
} elseif ($token === '(') {
|
||||||
|
$stack[] = $token;
|
||||||
|
} elseif ($token === ')') {
|
||||||
|
while (!empty($stack) && end($stack) !== '(') {
|
||||||
|
$output[] = array_pop($stack);
|
||||||
|
}
|
||||||
|
array_pop($stack); // pop '('
|
||||||
|
} else {
|
||||||
|
// Operator
|
||||||
|
while (!empty($stack) && end($stack) !== '(' &&
|
||||||
|
isset($precedence[end($stack)]) &&
|
||||||
|
$precedence[end($stack)] >= $precedence[$token]) {
|
||||||
|
$output[] = array_pop($stack);
|
||||||
|
}
|
||||||
|
$stack[] = $token;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
while (!empty($stack)) {
|
||||||
|
$output[] = array_pop($stack);
|
||||||
|
}
|
||||||
|
|
||||||
|
// Evaluate postfix
|
||||||
|
$evalStack = [];
|
||||||
|
|
||||||
|
foreach ($output as $token) {
|
||||||
|
if (is_numeric($token)) {
|
||||||
|
$evalStack[] = $token;
|
||||||
|
} else {
|
||||||
|
$b = array_pop($evalStack);
|
||||||
|
$a = array_pop($evalStack);
|
||||||
|
|
||||||
|
if ($a === null || $b === null) {
|
||||||
|
throw new \InvalidArgumentException('Invalid expression');
|
||||||
|
}
|
||||||
|
|
||||||
|
switch ($token) {
|
||||||
|
case '+':
|
||||||
|
$evalStack[] = bcadd((string) $a, (string) $b, 10);
|
||||||
|
break;
|
||||||
|
case '-':
|
||||||
|
$evalStack[] = bcsub((string) $a, (string) $b, 10);
|
||||||
|
break;
|
||||||
|
case '*':
|
||||||
|
$evalStack[] = bcmul((string) $a, (string) $b, 10);
|
||||||
|
break;
|
||||||
|
case '/':
|
||||||
|
if ((float) $b == 0) throw new \InvalidArgumentException('Division by zero');
|
||||||
|
$evalStack[] = bcdiv((string) $a, (string) $b, 10);
|
||||||
|
break;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (count($evalStack) !== 1) {
|
||||||
throw new \InvalidArgumentException('Invalid expression');
|
throw new \InvalidArgumentException('Invalid expression');
|
||||||
}
|
}
|
||||||
|
|
||||||
// Dùng bc math nếu có, hoặc eval đơn giản
|
return (float) $evalStack[0];
|
||||||
return (float) eval('return ' . $expression . ';');
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|||||||
@@ -0,0 +1,54 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
use Illuminate\Database\Migrations\Migration;
|
||||||
|
use Illuminate\Database\Schema\Blueprint;
|
||||||
|
use Illuminate\Support\Facades\Schema;
|
||||||
|
|
||||||
|
return new class extends Migration {
|
||||||
|
public function up(): void {
|
||||||
|
Schema::create('sales_phases', function (Blueprint $table) {
|
||||||
|
$table->uuid('id')->primary();
|
||||||
|
$table->foreignUuid('project_id')->constrained('projects')->cascadeOnDelete();
|
||||||
|
$table->string('name'); // Tên đợt: Mở bán đợt 1, Đợt 2...
|
||||||
|
$table->string('code')->unique(); // Mã đợt: MB1, MB2...
|
||||||
|
$table->text('description')->nullable();
|
||||||
|
$table->date('start_date'); // Ngày bắt đầu mở bán
|
||||||
|
$table->date('end_date')->nullable(); // Ngày kết thúc
|
||||||
|
$table->string('status')->default('Đang mở bán'); // Đang mở bán, Đã đóng, Chuẩn bị
|
||||||
|
|
||||||
|
// Chính sách chiết khấu mặc định cho đợt
|
||||||
|
$table->jsonb('discount_policy')->nullable();
|
||||||
|
// Ví dụ: {"open_sale": "5%", "wholesale": "3%", "full_payment": "2%"}
|
||||||
|
|
||||||
|
// Mẫu thanh toán mặc định cho đợt
|
||||||
|
$table->foreignUuid('payment_template_id')->nullable()->constrained('payment_templates')->nullOnDelete();
|
||||||
|
|
||||||
|
$table->timestamps();
|
||||||
|
});
|
||||||
|
|
||||||
|
Schema::create('sales_phase_products', function (Blueprint $table) {
|
||||||
|
$table->uuid('id')->primary();
|
||||||
|
$table->foreignUuid('sales_phase_id')->constrained('sales_phases')->cascadeOnDelete();
|
||||||
|
$table->foreignUuid('product_id')->constrained('products')->cascadeOnDelete();
|
||||||
|
|
||||||
|
// Giá bán cụ thể trong đợt này (ghi đè giá gốc nếu có)
|
||||||
|
$table->decimal('sale_price', 15, 2)->nullable();
|
||||||
|
$table->decimal('land_value', 15, 2)->nullable();
|
||||||
|
$table->decimal('foundation_value', 15, 2)->nullable();
|
||||||
|
|
||||||
|
// Chiết khấu riêng cho sản phẩm này trong đợt
|
||||||
|
$table->jsonb('discount_details')->nullable();
|
||||||
|
|
||||||
|
// Trạng thái sản phẩm trong đợt
|
||||||
|
$table->string('status')->default('Còn hàng'); // Còn hàng, Đã giữ, Đã bán, Khóa
|
||||||
|
|
||||||
|
$table->unique(['sales_phase_id', 'product_id']);
|
||||||
|
$table->timestamps();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
public function down(): void {
|
||||||
|
Schema::dropIfExists('sales_phase_products');
|
||||||
|
Schema::dropIfExists('sales_phases');
|
||||||
|
}
|
||||||
|
};
|
||||||
@@ -0,0 +1,19 @@
|
|||||||
|
<?php
|
||||||
|
|
||||||
|
use Illuminate\Database\Migrations\Migration;
|
||||||
|
use Illuminate\Database\Schema\Blueprint;
|
||||||
|
use Illuminate\Support\Facades\Schema;
|
||||||
|
|
||||||
|
return new class extends Migration {
|
||||||
|
public function up(): void {
|
||||||
|
Schema::table('contracts', function (Blueprint $table) {
|
||||||
|
$table->foreignUuid('sales_phase_id')->nullable()->constrained('sales_phases')->nullOnDelete();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
public function down(): void {
|
||||||
|
Schema::table('contracts', function (Blueprint $table) {
|
||||||
|
$table->dropConstrainedForeignId('sales_phase_id');
|
||||||
|
});
|
||||||
|
}
|
||||||
|
};
|
||||||
Reference in New Issue
Block a user