hqland-app/NEXT_SESSION.md

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!

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

✅ 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: 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

---

2. CẤU HÌNH DATABASE

Chạy migrate trên production (NẾU CHƯA CHẠY)

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

DB_HOST=127.0.0.1 ./vendor/bin/pest --filter="ContractFinanceFlowTest|ContractResourceRenderTest"

---

4. VIỆC CẦN LÀM TIẾP THEO

• Notification: Cảnh báo đợt thanh toán sắp đến hạn
• Export Excel: Báo cáo công nợ khách hàng
• In ấn thực tế: Tích hợp MailMergeService với action "In" trong ContractResource

---

5. TÀI KHOẢN

• Email: admin@phuongtc.com
• Password: 1Qazxsw2@!321

---

Commit ngay lập tức trước khi tắt máy!