初始提交：飞球 ETL 系统全量代码

.kiro/skills/bd-manual-db-docs/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: bd-manual-db-docs
+description: 当 PostgreSQL schema/表结构发生变化时，用于将变更以审计友好的方式落盘到 docs/bd_manual/（含变更原因、影响、回滚与验证 SQL）。
+---
+
+# 目的
+保证数据库结构变化可追溯、可审计、可回滚，并与 ETL/后端/小程序字段映射保持一致。
+
+# 触发条件
+- 迁移脚本/DDL 修改（新增/删除/改表、字段、类型、默认值、非空、约束、索引、外键）
+- ORM/Schema 定义变更导致实际 DB 结构变化
+- 手工执行 DDL（需用 manualTrigger hook 或本 Skill 补齐文档）
+
+# 输出要求（必须全部满足）
+所有输出必须落盘到：`docs/bd_manual/`
+
+至少包含：
+1) Schema Change Log（变更日志条目）
+2) Table Structure Doc（涉及表的结构文档更新）
+3) Rollback & Verification（回滚要点 + 至少 3 条验证 SQL）
+4) 溯源：日期 + Prompt-ID/Prompt 摘录 + Direct cause（必要性 + 方案简介）
+
+# 工作流
+## 1) 识别结构性变化
+- 列出新增/修改/删除的对象：schema/table/column/index/constraint/fk
+- 明确变更前后差异（before/after）
+
+## 2) 更新变更日志（Schema Change Log）
+- 在对应 schema 目录下追加一条变更记录（模板见 assets/schema-changelog-template.md）
+
+## 3) 更新表结构文档（Table Structure Doc）
+- 每张受影响的表都要更新（模板见 assets/table-structure-template.md）
+- 同步字段含义/口径说明，尤其是金额类字段：精度、币种、舍入
+
+## 4) 回滚与验证
+- 写清楚 DDL 回滚路径（必要时提供反向迁移）
+- 写至少 3 条验证 SQL（含约束/索引/关键字段检查）
+
+# 模板
+- `assets/schema-changelog-template.md`
+- `assets/table-structure-template.md`

.kiro/skills/bd-manual-db-docs/assets/schema-changelog-template.md

@@ -0,0 +1,27 @@
+# Schema 变更日志（Schema Change Log）
+
+- 日期（Asia/Taipei，YYYY-MM-DD）：
+- Prompt-ID：
+- 原始原因（Prompt 摘录/原文）：
+- 直接原因（必要性 + 方案简介）：
+- 影响的 Schema：
+- 变更摘要（一句话）：
+
+## 变更明细
+- 新增：
+- 修改：
+- 删除：
+
+## 影响范围
+- ETL：
+- 后端 API：
+- 小程序：
+
+## 回滚要点
+- DDL 回滚：
+- 数据回填/迁移注意事项：
+
+## 验证 SQL（至少 3 条）
+1)
+2)
+3)

.kiro/skills/bd-manual-db-docs/assets/table-structure-template.md

@@ -0,0 +1,22 @@
+# <schema>.<table>
+
+## 表用途（Purpose）
+- 该表代表什么业务对象/过程
+
+## 字段（Columns）
+| 字段名 | 类型 | 可空 | 默认值 | 约束/键 | 说明（含口径） |
+|---|---|---:|---|---|---|
+
+> 金额类字段必须注明：币种、精度、舍入/截断规则、是否允许负数。
+
+## 索引（Indexes）
+- 索引名 / 字段 / 是否唯一 / 备注
+
+## 约束与外键（Constraints & FKs）
+- 约束名 / 定义 / 备注
+
+## 数据不变量（Invariants）
+- 例如：状态机枚举范围、唯一性、跨字段一致性约束（如有）
+
+## 变更历史（Change History）
+- YYYY-MM-DD | Prompt-ID | 直接原因 | 变更摘要