23. Quản lý file dữ liệu & Xuất dữ liệu#

Mục tiêu#

Cho phép Admin tải xuống file dữ liệu (đối soát, thanh toán, analytics) dạng Excel.

Luồng nghiệp vụ#

1. Admin thao tác "Xuất dữ liệu".
2. Hệ thống tạo request với trạng thái "Đang tạo".
3. Background job: truy vấn → tạo Excel → lưu MinIO → cập nhật "Thành công".
4. Admin tải file qua link bảo mật (presigned URL, hiệu lực 30 giây).
5. Ghi log: user, thời điểm, IP.

API đã triển khai#

• POST /data-exports — Tạo yêu cầu xuất
• GET /data-exports — Danh sách
• GET /data-exports/:id/pre-sign — Lấy link tải

Tiêu chí chấp nhận (Acceptance Criteria)#

#	Tiêu chí	Điều kiện đạt
AC-23.1	Tạo yêu cầu xuất	Nhấn "Xuất dữ liệu" → tạo request trạng thái "Đang tạo", hiển thị trong danh sách
AC-23.2	Xử lý background	Background job chạy → tạo Excel → lưu MinIO → trạng thái "Thành công"
AC-23.3	Tải file	Nhấn tải → presigned URL hiệu lực 30 giây → tải file thành công
AC-23.4	Link hết hạn	Truy cập link sau 30 giây → lỗi access denied
AC-23.5	Ghi log	Mỗi lần tải ghi log: user, thời điểm, IP

---