portal-api/docs/refactor-priority.md

Refactor Priority

Danh sách file nên chỉnh sửa, chia theo mức độ ưu tiên dựa trên độ lớn controller, số nhánh nghiệp vụ, và mức độ trộn giữa validation, query, mapping response.

Cao

• app/Http/Controllers/Api/Service/OrderController.php - controller lớn nhất, ôm nhiều luồng order, invoice, payment, VM.
• app/Http/Controllers/admin/CustomerController.php - nhiều action, nhiều query, nhiều workflow admin/customer.
• app/Http/Controllers/admin/VCenterManagerController.php - nhiều helper nội bộ, tree/detail API, query và render view lẫn nhau.
• app/Http/Controllers/Api/Admin/Customer/CustomerController.php - CRUD + thống kê + response mapping.
• app/Http/Controllers/Api/Service/VmController.php - nhiều flow VM, log, Telegram, xử lý lỗi lặp.
• app/Http/Controllers/Api/Admin/Invoice/InvoiceController.php - CRUD + datatable + business rules.
• app/Http/Controllers/Api/Client/Service/ServiceController.php - nhiều endpoint, lookup VM/vCenter lặp.
• app/Http/Controllers/Api/Admin/Product/ProductController.php - validate lớn, create/update, sync pricing/OS.
• app/Http/Controllers/Api/Transaction/TransactionController.php - callback VNPay, update balance, log, job dispatch.
• app/Http/Controllers/admin/OrderController.php - nhiều khả năng đang gom nhiều workflow.

Trung bình

• app/Http/Controllers/Api/Admin/VCenter/VCenterController.php - controller có vẻ vừa query vừa mapping response.
• app/Http/Controllers/Api/Admin/IpPool/IpPoolController.php - nhiều validation và action CRUD.
• app/Http/Controllers/Api/Admin/DnsManager/DomainController.php - CRUD + logic domain management.
• app/Http/Controllers/Api/Admin/DnsManager/RecordController.php - tương tự, cần tách request/DTO nếu logic lớn.
• app/Http/Controllers/Api/Client/Service/DomainController.php - validate và xử lý domain cho client.
• app/Http/Controllers/Api/Transaction/ManualDepositController.php - nhiều nhánh xử lý nạp/hủy/kiểm tra pending.
• app/Http/Controllers/Api/Admin/Payment/PaymentController.php - đang dùng request->all() và repository filter.
• app/Http/Controllers/Api/Admin/Order/OrderController.php - validate + create + upload + trạng thái.
• app/Http/Controllers/Api/Admin/Addon/AddonController.php - CRUD + bulk actions.
• app/Http/Controllers/Api/Admin/Product/ProductCategoryController.php - nhiều action và bulk IDs.

Thấp

• app/Http/Controllers/Api/Admin/Setting/SettingController.php - ít action hơn, nhưng vẫn nên chuẩn hoá validation.
• app/Http/Controllers/Api/Admin/Bank/BankController.php - nhỏ hơn, chủ yếu CRUD.
• app/Http/Controllers/Api/Admin/Auth/AuthController.php - nhỏ, ít thay đổi.
• app/Http/Controllers/Api/Client/ClientController.php - đã có service/request, chỉ cần dọn dẹp dần.
• app/Http/Controllers/Api/Service/SnapshotController.php - nhiều validate nhưng scope hẹp hơn.
• app/Http/Controllers/Api/Service/PaymentController.php - kiểm tra nếu bắt đầu phình ra.

Ghi chú

• Ưu tiên tách DTO trước cho các file ở mục Cao, vì chúng có payload rõ và đang trộn nhiều trách nhiệm.
• Các file ở mục Trung bình nên xử lý sau khi đã ổn định nhóm Cao.
• Không tính vendor/, .env, hoặc file hệ thống Git.