feat: add raw artifact audit trail

docs/product_roadmap.md

@@ -100,22 +100,45 @@
 
 ### M1.4 原始数据留存与文件哈希
 
+状态：已完成。
+
 目标：
 
 - 每次导入都记录原始文件位置、哈希、大小、导入人和入库批次。
-- 正式导入结果写入 `raw`/`silver`/`audit`，并与 `audit.ingestion_runs` 关联。
+- 将原始文件资产与 `audit.ingestion_runs` 关联，支持重复文件识别。
 
 交付物：
 
 - `audit.raw_artifacts`
 - 导入批次关联 raw artifact。
-- PostgreSQL 导入执行接口。
+- `GET /api/v1/raw-artifacts`
+- `POST /api/v1/raw-artifacts`
+- Python 文件指纹命令。
 
 验收标准：
 
 - 同一文件重复导入可识别。
 - 任一指标可以追溯到原始数据批次。
 
+### M1.5 PostgreSQL 导入执行接口
+
+目标：
+
+- 将已校验模板数据正式写入 PostgreSQL 的 `raw`/`silver`/`audit`。
+- 导入执行必须关联 `audit.ingestion_runs` 和 `audit.raw_artifacts`。
+
+交付物：
+
+- PostgreSQL 导入执行 API。
+- 支持板块月度指标和小区月度指标的 upsert。
+- 导入失败时写入明确错误并保留审计记录。
+
+验收标准：
+
+- 校验失败不写入业务表。
+- 导入成功后可通过批次追溯到原始文件哈希。
+- 重复导入同一文件时能识别并提示。
+
 ## M2 资产研究工作台
 
 ### M2.1 板块详情页