WIP: SoftDelete Contract/Payment/Customer, collected_by, Notifications, ProjectReport, ExportDebtReport

AGENTS.md

@@ -1,7 +1,7 @@
 # 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.  
-> **Cập nhật:** 28/04/2026  
+> **Cập nhật:** 29/04/2026  
 > **Dự án:** HQLand - Hệ thống quản lý Bất động sản  
 > **Stack:** Laravel 13 + Filament v5.5 (Schemas Architecture) + PostgreSQL + UUID
 
@@ -303,10 +303,13 @@
 - [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] **Sales Phase Module:** Quản lý đợt mở bán, giá bán riêng theo đợt, tích hợp vào ContractForm
+- [x] **ProjectReport Page:** Báo cáo thống kê bán hàng, thanh toán theo từng dự án
+- [x] **ExportDebtReport Command:** Xuất Excel báo cáo công nợ khách hàng (2 sheet: Tổng hợp + Chi tiết đợt TT)
+- [x] **Notification System:** `PaymentDueNotification` + `SendPaymentDueNotifications` command + `RecentNotifications` widget
 
 ### 5.2. Đang dở / Cần tiếp tục
 - [x] **Dashboard thống kê:** Đã tạo `ContractStatsOverview` + `UpcomingPaymentsTable`
-- [ ] **Notification:** Cảnh báo đợt thanh toán sắp đến hạn (chưa có hệ thống notification)
+- [x] **Notification:** Đã có hệ thống cảnh báo đợt thanh toán sắp đến hạn (database notifications)
 
 ### 5.3. Vấn đề kỹ thuật ĐÃ XỬ LÝ
 - [x] ContractTable đã thêm cột `paid_amount` / `remaining_amount`, chuyển sang dùng `ContractsTable` Schemas
@@ -332,10 +335,10 @@
 8. **Discount Engine:** Tính toán tự động chiết khấu từ `discount_details` vào giá trị hợp đồng
 
 ### Giai đoạn 3: Báo cáo & Tối ưu (Ưu tiên THẤP)
-9. **Dashboard Tài chính:** Tổng doanh thu, dòng tiền dự kiến, công nợ phải thu
-10. **Báo cáo theo Dự án:** Thống kê bán hàng, thanh toán theo từng dự án
-11. **Export Excel:** Xuất báo cáo công nợ khách hàng
-12. **Notification:** Cảnh báo đợt thanh toán sắp đến hạn
+9. **Dashboard Tài chính:** Tổng doanh thu, dòng tiền dự kiến, công nợ phải thu ✅
+10. **Báo cáo theo Dự án:** Thống kê bán hàng, thanh toán theo từng dự án ✅
+11. **Export Excel:** Xuất báo cáo công nợ khách hàng ✅
+12. **Notification:** Cảnh báo đợt thanh toán sắp đến hạn ✅
 
 ---
 
@@ -370,12 +373,16 @@ DB_HOST=127.0.0.1 php artisan migrate
 - `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`
+- `database/migrations/2026_04_29_000000_create_notifications_table.php`
 
 ### Services mới
 - `app/Services/DiscountEngine.php` - Tính toán chiết khấu
 - `app/Services/Calculation/` - Calculation Pipeline (RoundingRule, CalculationStep, CalculationResult, CalculationPipeline, PriceCalculationService)
 - `app/Services/Forms/MailMergeService.php` - Engine xử lý biểu mẫu in ấn
 - `app/Console/Commands/GenerateContractSchedules.php` - Command tạo lịch hàng loạt
+- `app/Console/Commands/ExportDebtReport.php` - Command xuất Excel báo cáo công nợ
+- `app/Console/Commands/SendPaymentDueNotifications.php` - Command gửi cảnh báo đợt TT sắp đến hạn
+- `app/Notifications/PaymentDueNotification.php` - Database notification cho đợt thanh toán
 
 ### Filament Resources mới
 - `app/Filament/Resources/PaymentFines/` (Resource + Form + Table + Pages)
@@ -387,6 +394,10 @@ DB_HOST=127.0.0.1 php artisan migrate
 ### Widgets mới
 - `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/RecentNotifications.php` - Danh sách thông báo chưa đọc
+
+### Filament Pages mới
+- `app/Filament/Pages/ProjectReport.php` - Báo cáo thống kê theo dự án
 
 ### Models mới
 - `app/Models/SalesPhase.php` - Đợt mở bán
@@ -408,11 +419,14 @@ DB_HOST=127.0.0.1 php artisan migrate
 - `app/Filament/Resources/Payments/PaymentResource.php` - Thêm eager load `scheduleItem.payments`
 
 ### Config/Provider sửa đổi
-- `app/Providers/Filament/AdminPanelProvider.php` - Đăng ký widgets mới
+- `app/Providers/Filament/AdminPanelProvider.php` - Đăng ký widgets mới (ContractStatsOverview, UpcomingPaymentsTable, RecentNotifications)
 - `phpunit.xml` - Cấu hình PostgreSQL testing (DB_HOST, DB_DATABASE, etc.)
 - `config/database.php` - Default `pgsql`
 - `composer.json` - Xóa script tạo SQLite
 
+### Views mới
+- `resources/views/filament/pages/project-report.blade.php` - View cho ProjectReport Page
+
 ---
 
 ## 9. FILE HỖ TRỢ CHUYỂN MÁY