feat(finance): add financial disclosure publishing

2026-08-13 17:17:33 +08:00
parent 39a2e53e61
commit 65d23eab4a
49 changed files with 2096 additions and 3 deletions
@@ -287,3 +287,22 @@ Phase 0 提供：
 ```

 健康检查不得返回配置值、数据库连接串、密钥或其他敏感信息。业务 API 仍统一使用 `/api/v1` 前缀；基础设施健康检查不属于业务 API。
+
+---
+
+## 12. 财务公开文档 API
+
+公众接口：
+
+- `GET /api/v1/financial-disclosures`
+- `GET /api/v1/financial-disclosures/:publicId`
+
+只返回 `PUBLISHED` 文档，草稿和归档文档按不存在处理。
+
+管理端接口：
+
+- `GET/POST /api/v1/admin/financial-disclosures`
+- `GET/PATCH /api/v1/admin/financial-disclosures/:publicId`
+- `POST /api/v1/admin/financial-disclosures/:publicId/transition`
+
+创建、发布和归档使用客户端 UUID 幂等；编辑只允许草稿且要求 expectedRevision。状态为 `DRAFT → PUBLISHED → ARCHIVED`，状态变化与历史、审计事务一致。DOCX 在管理端浏览器转换为富文本，API 只接受并白名单清洗富文本，不执行 Office 文件。