nang cap san sang import

TASKS_ROADMAP.md

@@ -0,0 +1,145 @@
+# TASKS_ROADMAP.md — AfterSales CRM
+
+> **Mục đích:** Theo dõi tất cả các công việc: đã hoàn thành, đang làm, sẽ làm.
+> **Cập nhật:** Mỗi khi hoàn thành hoặc thêm task mới.
+
+---
+
+## ✅ ĐÃ HOÀN THÀNH (SOP Phase 1–8)
+
+### Giai đoạn 1: Mở rộng CSDL
+- [x] Bảng `departments` (id, name, manager_id → users)
+- [x] Bổ sung `feedback`: current_department_id, is_escalated
+- [x] Bảng `ticket_transfer_logs`
+- [x] Nâng cấp `feedback_attachments`: uuid, disk, collection
+- [x] Cài Spatie laravel-permission
+
+### Giai đoạn 2: Services & Logic
+- [x] `FileService`: upload, validation (jpg/png/pdf/mp4/mov ≤20MB), collection query, temporary URL
+- [x] `TransferService`: transfer department + reason required + notification
+- [x] `ClosingService`: role-gated close + proof_of_resolution check
+- [x] Policies dùng Spatie `hasRole()`
+- [x] Custom Rule `RequireProofOfResolution`
+
+### Giai đoạn 3: Notifications
+- [x] `TicketTransferred` (Database + Mail)
+- [x] `TicketClosed` (Database + Mail)
+
+### Giai đoạn 4: Filament UI
+- [x] `TransferDepartment` Action trên EditFeedback
+- [x] `CloseTicket` Action
+- [x] InteractionsRelationManager: role-aware status options
+- [x] FeedbackForm: current_department_id, is_escalated
+
+### Giai đoạn 5: Dashboard Widgets
+- [x] `ResolvedTicketsWidget`
+- [x] `AvgProcessingTimeWidget`
+- [x] `HandlerPerformanceWidget`
+
+### Giai đoạn 6: Testing
+- [x] Pest: 8 tests (21 assertions)
+
+### Giai đoạn 7: Seeder
+- [x] 4 departments, 5 channels, 5 products, 4 customers, 5 feedbacks, 5 tags, 5 interactions, 1 transfer log, 3 attachments
+
+### Giai đoạn 8: Polish & Bug Fix
+- [x] Dashboard widget filter Manager theo department
+- [x] Migration disk default fix
+- [x] File upload pattern fix
+- [x] Department + Escalated columns trên FeedbackTable
+- [x] Validation proof_of_resolution khi close từ form
+- [x] Manager chỉ đóng ticket phòng mình
+- [x] View Attachments trong Interaction History
+- [x] Docker deployment
+- [x] Migration notifications table
+
+---
+
+## 🔴 CHƯA LÀM — Theo AI Instructions
+
+### A: Module Hợp đồng (Contract) — từ `AI_01`, `AI_02`
+- [x] Tạo migration bảng `contracts`:
+  - `product_id` FK, `customer_id` FK
+  - `type` (LEASE/BCC/SALE)
+  - `start_date`, `end_date`
+  - `status` (Active/Expired/Liquidated)
+  - `printed_at`, `signed_status`
+- [x] Tạo Model `Contract` + Enum `ContractType`
+- [x] Relationships: `product()`, `customer()`, `feedbacks()`
+- [x] Tạo ContractResource Filament + ContractPolicy
+- [x] Tạo ContractsRelationManager trên ProductResource
+
+### B: Cơ chế Snapshot Hợp đồng — từ `AI_01`
+- [x] Tạo migration thêm `contract_id` (FK->contracts, nullable) vào bảng `feedback`
+- [x] Cập nhật Model `Feedback`: fillable + relationship `contract()`
+- [x] Logic auto-select active contract khi tạo Feedback mới (FeedbackForm)
+- [x] Hiển thị contract info trên Feedback list (FeedbackTable column)
+- [x] Gán contract_id cho feedback mẫu trong Seeder
+
+### C: Module Bàn giao (Handover) — từ `AI_01`, `AI_02`
+- [x] Tạo migration bảng `handovers`:
+  - `product_id` FK, `customer_id` FK
+  - `handover_date` (date)
+  - `status` (Chưa đủ điều kiện/Đủ ĐK/Đã lên lịch/Đã BG)
+  - `remark` (text nullable)
+- [x] Tạo Model `Handover` + Enum `HandoverStatus`
+- [x] Relationships: `product()`, `customer()`
+- [x] Tạo `HandoversRelationManager` gắn vào `ProductResource`
+- [x] Cập nhật Product model: thêm `handovers()` HasMany
+
+### D: Module Dịch vụ phụ trợ (ProductService) — từ `AI_02`
+- [x] Tạo migration bảng `product_services`:
+  - `product_id` FK
+  - `service_type` (MANAGEMENT_FEE/GRATITUDE/SELF_BUSINESS)
+  - `status`
+  - `actual_collection_date` (date nullable)
+  - `remark` (text nullable)
+- [x] Tạo Model `ProductService` + Enum `ServiceType`
+- [x] Relationship: `product()`
+- [x] Tạo `ProductServicesRelationManager` gắn vào `ProductResource`
+- [x] Cập nhật Product model: thêm `productServices()` HasMany
+
+### E: Enhancement ProductResource — từ `AI_02`
+- [x] Thêm RelationManagers vào `ProductResource::getRelations()`
+  - ContractsRelationManager ✅
+  - HandoversRelationManager ✅
+  - ProductServicesRelationManager ✅
+- [x] Product detail page có 3 tabs: Contracts + Handovers + Services
+
+### F: Tự động gợi ý transfer — từ `AI_01` (optional)
+- [ ] Hiển thị badge gợi ý: "Ticket BCC → khuyến nghị chuyển Pháp lý"
+- [ ] Logic detect contract type → suggest department
+
+### G: Data Import Pipeline — từ `AI_03`
+- [x] Cài package `spatie/simple-excel`
+- [x] Tạo Command `app:import-cskh {file_path} --dry-run`
+- [x] Logic: Lazy Collection, chunk 100 rows, DB::transaction, ProgressBar
+- [x] Pipeline per row: Product/Customer firstOrCreate → Contract/Handover/Service → Feedback + Interactions
+- [x] Tạo customer_product pivot record
+- [x] Xử lý DateTimeImmutable từ Excel
+- [x] Skip header/meta rows
+- [x] Đã test thành công với CSKH.xlsx (3658 rows → 3299 products, 2089 customers, 2637 contracts, 2077 handovers, 159 services, 71 feedbacks, 226 interactions)
+
+---
+
+## 📋 Ưu tiên phát triển
+
+| Ưu tiên | Task | Phụ thuộc |
+|---------|------|-----------|
+| 1 | ~~A: Module Hợp đồng (Migration + Model)~~ ✅ | Không |
+| 2 | ~~B: contract_id trên feedback (Snapshot)~~ ✅ | A |
+| 3 | ~~C: Module Bàn giao (Migration + Model + RelationManager)~~ ✅ | Không |
+| 4 | ~~D: Module Dịch vụ (Migration + Model + RelationManager)~~ ✅ | Không |
+| 5 | ~~E: Enhancement ProductResource~~ ✅ | A, C, D |
+| 6 | ~~G: Data Import Pipeline~~ ✅ | A, B, C, D |
+| 7 | F: Tự động gợi ý transfer (nice-to-have) | A |
+
+---
+
+## 📊 Tiến độ tổng quan
+
+```
+SOP Phase 1-8:        ████████████████████████ 100% (Hoàn thành)
+AI Instructions Core:  ███████████████████████░  85% (6/7 — Còn: auto-suggest transfer)
+Data Import Tested:    ████████████████████████ 100% (3658 rows real data imported successfully)
+```