ccdi/docs/plans/fullstack/2026-03-20-model-info-xlsx-update-implementation.md

模型信息 XLSX 更新实施计划

For agentic workers: REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (- [ ]) syntax for tracking.

Goal: 直接更新 assets/模型信息.xlsx，仅对未真实实现模型补齐可明确推出的字段，并新增 SQL 可执行性与缺少内容结论列。

Architecture: 先以项目代码、规则定义、数据库表结构为依据，逐行判定模型是否已经具备真实命中逻辑；对未实现模型再执行表格回填和 SQL 可执行性校验，最后补充实施记录。整个过程不新增业务规则，不修改后端实现逻辑，只更新资料文件与文档。

Tech Stack: Python 3、openpyxl、rg、MySQL MCP、Git

---

Task 1: 梳理实现状态与回填依据

Files:

• Modify: assets/模型信息.xlsx

• Reference: docs/design/2026-03-20-model-info-xlsx-update-design.md

• Reference: docs/reports/implementation/2026-03-17-model-sql-check-and-rewrite.md

• Step 1: 列出 XLSX 中的全部模型行

Run:

python3 - <<'PY'
from openpyxl import load_workbook
wb = load_workbook('assets/模型信息.xlsx')
ws = wb['Sheet1']
for idx, row in enumerate(ws.iter_rows(min_row=2, values_only=True), start=2):
    if row[2]:
        print(idx, row[2], row[3], row[6], row[7])
PY

Expected: 输出每一行对应的序号、模型名称、相关指标和指标英文名。

• Step 2: 检索项目内真实规则实现与占位规则

Run:

rg -n "HOUSE_OR_CAR_EXPENSE|TAX_EXPENSE|SINGLE_LARGE_INCOME|CUMULATIVE_INCOME|ANNUAL_TURNOVER|LARGE_CASH_DEPOSIT|ABNORMAL_CUSTOMER_TRANSACTION|LOW_INCOME_RELATIVE_LARGE_TRANSACTION|MULTI_PARTY_GAMBLING_TRANSFER|GAMBLING_SENSITIVE_KEYWORD|MONTHLY_FIXED_INCOME|FIXED_COUNTERPARTY_TRANSFER|FOREX_BUY_AMT|INTEREST_PAYMENT_BY_OTHERS|LARGE_PURCHASE_TRANSACTION|SUPPLIER_CONCENTRATION|STOCK_TFR_LARGE|WITHDRAW_CNT|SALARY_QUICK_TRANSFER" ccdi-project ruoyi-ui sql docs

Expected: 区分哪些模型已有真实命中逻辑，哪些只有占位规则或文档描述。

• Step 3: 用当前数据库结构确认 SQL 校验基线

Run:

python3 - <<'PY'
from openpyxl import load_workbook
wb = load_workbook('assets/模型信息.xlsx')
ws = wb['Sheet1']
print('rows=', ws.max_row, 'cols=', ws.max_column)
PY

Expected: 确认当前工作簿可正常读取，为后续回写做基线检查。

Task 2: 更新 XLSX 未实现模型信息

Files:

• Modify: assets/模型信息.xlsx

• Step 1: 追加两列表头

实现要求：

在现有最后一列后新增：
1. 当前环境是否可执行SQL
2. 当前缺少内容

• Step 2: 对已真实实现模型保持跳过

实现要求：

只标记为“已实现并跳过”，不重写该行原有内容，不填新增结论列。

• Step 3: 对未实现模型补齐可明确推出的字段

实现要求：

优先补充指标英文名、风险筛查对象、技术口径、可疑结果返回、风险等级；
仅在项目代码、规则表、SQL 或当前库结构能明确支持时回填，不能唯一确定则保留原值。

• Step 4: 写入 SQL 可执行性结论

实现要求：

当前环境可直接执行写“是”，否则写“否”；
“当前缺少内容”列中写最小必需缺项或明确错误，可执行则写“/”。

• Step 5: 保存工作簿

Run:

python3 - <<'PY'
from openpyxl import load_workbook
wb = load_workbook('assets/模型信息.xlsx')
wb.save('assets/模型信息.xlsx')
print('saved')
PY

Expected: 输出 saved，且文件可再次被 openpyxl 正常打开。

Task 3: 校验结果并补充实施记录

Files:

• Modify: assets/模型信息.xlsx

• Create: docs/reports/implementation/2026-03-20-model-info-xlsx-update-record.md

• Step 1: 抽样读取更新后的关键行

Run:

python3 - <<'PY'
from openpyxl import load_workbook
wb = load_workbook('assets/模型信息.xlsx')
ws = wb['Sheet1']
for row_no in [10, 11, 12, 14, 18, 22, 25, 26, 28, 31]:
    vals = [ws.cell(row_no, col).value for col in range(3, ws.max_column + 1)]
    print(row_no, vals)
PY

Expected: 关键未实现模型行已带有新增结论列，且补充信息与设计口径一致。

• Step 2: 记录本次实施内容和判定依据

实施记录应包含：

1. 已实现模型跳过的判定口径
2. 未实现模型的回填原则
3. 新增列说明
4. SQL 可执行性判断依据
5. 抽样验证结果

• Step 3: 检查 Git 变更范围

Run:

git status --short

Expected: 只包含本次任务相关文件；如存在无关变更，不纳入提交。

• Step 4: 提交本次修改

Run:

git add docs/plans/fullstack/2026-03-20-model-info-xlsx-update-implementation.md docs/reports/implementation/2026-03-20-model-info-xlsx-update-record.md assets/模型信息.xlsx
git commit -m "更新模型信息xlsx并补充校验结论"

Expected: 生成仅包含本次任务文件的中文提交。