TF
T-Fluencers Docs
Quay lại SRS

10. Xuất dữ liệu (Exports)#

Mục tiêu#

Quản lý các job xuất dữ liệu bất đồng bộ (CSV/Excel) từ các nguồn khác nhau (Profiles, Campaigns, Analytics...), cho phép Admin tải về file đã hoàn thành.

Luồng nghiệp vụ#

  1. Từ các trang khác (VD: Profiles, Analytics), Admin click nút Export → mở dialog chọn:
    • Định dạng: CSV / Excel
    • Các trường dữ liệu cần xuất (metrics)
  2. Submit → tạo export job → thêm vào hàng đợi.
  3. Hệ thống hiển thị toast "Job đã được tạo".
  4. Admin chuyển sang trang Exports để xem danh sách job.
  5. Trạng thái job: Waiting → Running → Completed / Failed.
  6. Job hoàn thành:
    • Hiển thị nút Download (kích hoạt)
    • Click Download → hệ thống sinh URL tải → trình duyệt tải file
  7. Job thất bại: Hiển thị lý do lỗi, có nút Retry nếu khả dụng.
  8. Bảng Exports: 20 job/trang, cột: Tên, Loại, Người tạo, Thời gian tạo, Trạng thái, Thao tác.

API đã triển khai#

  • POST /data-exports — Tạo job export mới
  • GET /data-exports — Danh sách job (phân trang)
  • GET /data-exports/:id — Chi tiết job
  • GET /data-exports/:id/download — Lấy URL tải file
  • POST /data-exports/:id/retry — Thử lại job thất bại

Tiêu chí chấp nhận#

#Tiêu chíĐiều kiện đạt
AC-DB.10.1Tạo job exportClick Export từ trang khác → dialog mở → chọn format → submit → job tạo
AC-DB.10.2Chọn định dạngChọn CSV/Excel → job tạo đúng format tương ứng
AC-DB.10.3Danh sách ExportsHiển thị đúng trạng thái (Waiting/Running/Completed/Failed) với badge màu
AC-DB.10.4Tải file hoàn thànhClick Download job Completed → file tải về thành công, đúng định dạng
AC-DB.10.5Disable DownloadJob chưa Completed → nút Download bị disable
AC-DB.10.6Phân trang20 job/trang, chuyển trang đúng
AC-DB.10.7Job thất bạiJob Failed → hiển thị lý do lỗi, có nút Retry
AC-DB.10.8Retry jobClick Retry → job chuyển về Waiting, xử lý lại