Skip to content

feat(analysis): Excel/CSV export missing filter criteria metadata — compliance audit traceability gap #385

@cct08311github

Description

@cct08311github

問題說明(金融合規情境)

當合規審計人員使用 Analysis 匯出 Excel/CSV 報告時,匯出檔案不包含「此報告使用了哪些篩選條件」的 metadata。這破壞了合規審計的可追溯性要求。

現況

AnalysisExcelExporter.Export() 和 CSV 匯出只包含:

  • 欄位標題行
  • 資料列

不包含:

  • 匯出時間戳
  • 使用的維度 / 量值 / 聚合函式
  • 篩選條件(欄位、運算子、值)
  • 資料截斷警告

合規審計需求

[匯出資訊]
匯出時間:2026-03-17 09:30:00 UTC
資料來源:MonthlyRevenueListVM
維度:Department, Month
量值:Amount Sum, Amount Avg
篩選:Year = 2026, Quarter = Q1
資料筆數:1,234 筆(未截斷)

[資料]
Department | Month    | Amount_Sum | Amount_Avg
...

AnalysisQueryResponse 已有 QueryHash

AnalysisQueryResponse.QueryHash 提供了 16 字元的 deterministic hash,可作為「篩選條件指紋」,但目前不包含在匯出檔案中。

建議

  1. 在匯出 Excel/CSV 前兩行加入 metadata 區塊(篩選條件、時間戳、截斷狀態)
  2. 或作為選項(includeMetadata: true/false
  3. QueryHash 加入匯出以支援可重現性驗證

優先級: P3(合規需求,但目前系統完全無此機制)
金融情境: #3 合規審計
模組: Analysis / AnalysisExcelExporter.cs, _AnalysisController.Export

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions