可疑模块调查结论(2026-09-25 · 波波)

义父对《功能账》表 3 批了「查」⇒ 逐个查清楚再定。

结论:我原先"多半可砍"的判断大部分是错的,必须更正。


⚠️ 先更正我自己的错误

原判断依据:「三端都没调用 ⇒ 多半是历史遗留,可砍」。

这个推理是错的——没人调用 ≠ 没价值。查完数据发现:

documents 里躺着 16 篇真实的公司方案文档,kora_routes 有 2 条真实转山线路,

credit_tasks 有 4 条真实 UGC 任务。都砍不得。

教训:**判断"该不该砍"必须查数据(行数 + is_test + 内容样本),
不能只看"有没有人调接口"。** 接口没人调,可能是"还没接上",不是"没人要"。

一、调查总表

模块接口数据实况归属我的结论
key_tasks(福钥任务)620 任务 / 60 次领取WIP-303✅ 在用,保留
documents(文档协作)1216 篇真实文档 / 21 版本 / 64 成员 / 51 审计日志无标注🔴 不能砍(见下)
credit_tasks(UGC 任务)—17 条,含 4 条真实(供氧房素材征集、温泉拍摄、卓玛拉路况播报、温泉评价)无标注⚠️ 有真实内容,查是否并入福钥
kora_routes(转山线路)103 条线路(2 条真实:外转三日 / 内转一日)+ 21 路点 + 6 路段阿仁 WIP-168⚠️ 有真实数据,阿仁的,需他确认
agent(找朋友·代办管家)91 合同 / 10 委托 / 10 委托项"B2B2C 代理分销,2026-08-15 定稿"⚠️ 有数据,概念仍在?
tasks + tasks-full7task_templates 0 行无标注⚠️ 模板表空;与 key_tasks 是否重复待查
site_texts(站点文案)40 行(空壳)阿仁 WIP-289✅ 可下线(content_items 才是真通道)
promoters(推广员)2关联表不存在无标注✅ 死端点,可砍
stalls(摊位)21 条 lead无标注⚠️ 极少,近乎空
quotes(报价/券)60 / 0(空)无标注✅ 空,可砍
config-governance5配置草稿/版本/发布/回滚无标注⚠️ 与 A端「品牌配置版本」可能重复

二、逐条说明

🔴 documents —— 砍了会出事

16 篇文档,随手抄几条真实标题:

还有 64 个文档成员、51 条审计日志、21 个版本。

⇒ 这是一个被真实使用过的文档协作系统,存的是公司的方案资产。

它现在前端没入口,但数据不能删。建议:保留后端与数据,找它的主人确认要不要接入。

⚠️ kora_routes —— 阿仁的,有真实线路

文件头标注:WIP-168 M2 · 阿仁。⇒ 归属明确,要动得先问阿仁。

⚠️ credit_tasks —— 有真实 UGC 任务

4 条非测试样本:

「城堡酒店 · 供氧房素材征集」「温泉实景拍摄(转山前打卡点)」

「卓玛拉山口路况播报」「温泉体验评价」

这像是素材/内容征集类任务。是否已并入福钥(key_tasks)?

两套任务系统并存的话,需要合并或明确分工。

✅ 真·可砍的三条(证据充分)

模块证据
promoters端点在,但关联表根本不存在 ⇒ 纯死代码
site_texts0 行;且 content_items(文案字典)才是 C端 真通道,WIP-289 这套是早期另一套
quotessessions / vouchers 均 0 行

这三条砍掉不影响任何数据。


三、请你拍板的三件事

  1. documents(16 篇方案文档)归谁? —— 是有主的资产,我只是没找到主人。

建议保留;如果你知道是谁的,我找他确认要不要接入口。

  1. 任务系统要合并吗? —— 现在有 key_tasks(福钥,在用)、credit_tasks(UGC,有真实内容)、

tasks+tasks-full(模板表空)三套并存的迹象。建议统一到一套。

  1. 可砍的三条(promoters / site_texts / quotes)要不要我现在动?

证据充分(表不存在或 0 行),砍掉是纯减负。等你一句话我就做。


四、这轮调查的方法(可复跑)

  1. /openapi.json 取运行时接口,按 tag 过滤出可疑模块
  2. count(*) 查真实行数 —— 注意:pg_class.reltuples = -1 不代表 0 行,

那是"从未 ANALYZE",必须跑真实 count(我第一版差点被这个骗了)

  1. 查 is_test 分布 + 内容样本,区分"真实数据"与"测试种子"
  2. 查 router 文件头标注确定归属(kora_routes/site_texts 就是这样找到阿仁的)