三件事处置方案(2026-09-25 · 波波)

义父把「documents 归属 / 任务系统合并 / 可砍三条」三件全部交给我出方案。
下面是我的推荐方案,每件事含:查到了什么 → 我建议怎么做 → 具体步骤 → 风险与回滚。
结论先行,你看完说"照做"或指出哪条要改,我就动手。

事一:documents(16 篇方案文档)

查到了什么

项事实
内容16 篇真实方案文档:「阿里目的地平台分析与落地计划」「套餐产品模型说明书 v2.0」<br>「定位与功能布局研究」「四入口系统分析(运营五维)」「淡季新业态盈利研究」「预售券锚点设计」等
协作痕迹21 个版本、64 条成员关系、51 条审计日志
成员4 人,每人挂全部 16 篇 —— 其中 id=36 李总(139…)、id=1、id=6、id=39
时间全部创建于 2026-08-28 ~ 08-29 两天内,之后无新增
入口C端 / A端 / B端 均无入口,12 个接口三端都没调用

判断:这不是长期在用的系统,是 8 月底一次性使用(像给李总汇报的方案集),

之后没再接入口。但数据是真资产,绝不能删。

我建议:内容迁到文档站,后端转存档

理由很直接:documents 里存的就是文档,而我们已经有一个文档站(doc.kailashi.cn)。

放在一张没人能打开的表里,等于没有。

步骤动作风险
1把 16 篇文档导出为 md,放进 docs/archive/2026-08-方案集/零(纯新增)
2推送 → auto-docs 自动同步,文档站立即可读(李总也能直接看链接)零
3后端 12 个接口:保留代码、不删除,文件头标注「历史存档,8-29 后停用,内容已迁文档站」零
4观察两周无异议后,再决定是否摘掉路由注册低(可回滚)

好处:资产永久可读 + 后端系统可停用 + 全程不删任何数据。


事二:任务系统(我原来猜"三套并存",查完是两套)

查到了什么(更正我上一轮的说法)

端点实际操作的表说明
tasks-full(5 端点)credit_tasks / credit_task_claims / credit_journal / user_wallets它就是工分任务的完整流程(发布/提交/验收/我的)
tasks(2 端点)task_templates(0 行)模板层端点,没启用

⇒ 不是三套,是两套:

系统表奖励物数据量状态
福钥任务key_tasks / key_task_claims福钥(reward_keys,有库存)20 任务 / 60 次领取✅ 在用(WIP-303)
工分任务credit_tasks / credit_task_claims积分(reward_credits,每日上限+地理围栏)17 条,含 4 条真实 UGC⚠️ 有内容,无入口

外加一个没启用的模板层(task_templates,0 行)。

我建议:不合并,明确定位;只清理没启用的模板层

为什么不合并:两套的奖励物根本不同——福钥 vs 积分,业务上是两条独立的激励链路。

硬合并会把两套账(福钥账 / 积分钱包)搅在一起,风险远大于收益。

但要做的三件事:

#动作理由
1给工分任务补 A端 管理入口(同我做攻略/向导档案那样)现在 17 条只能改库,违反铁律;里面还有 4 条真实 UGC 任务
2task_templates + tasks 两个端点下线模板表 0 行、从未启用;credit_tasks 已直接存 17 条具体任务,模板层是多余的一层
3两套在 A端 导航上并列呈现、名字区分清楚「福钥任务」与「工分任务」放同组,运营一眼看出是两个东西

事三:可砍三条

查到了什么

模块证据判定
promoters端点在,关联表根本不存在死代码
site_texts0 行;真通道是 content_items(文案字典,C端 在消费)早期另一套,已被取代
quotesquote_sessions / quote_vouchers 均 0 行空

我建议:先"下线"再"删除",分两步,可回滚

一次性删代码太急。我的做法是:

阶段动作可回滚性
第一步(本周)在 main.py 注释掉这三个 router 的注册,文件头标注「2026-09-25 下线,观察两周;原因为:表不存在/0 行/已被 content_items 取代」✅ 改一行注释即可恢复
第二步(两周后无异议)删除 router 文件与相关表(quotes 两个表;promoters 无表;site_texts 表保留观察)❌ 需 git 恢复

为什么先注释不直接删:万一有人(阿仁/小齐)正在本地分支上接着做,

直接删会让他们 rebase 时撞墙。注释掉是"停用"信号,不影响代码存在。

注意 site_texts 是阿仁的(WIP-289) —— 我会在注释里写明是"已被 content_items 取代"

而不是"废弃",并抄送给相关人。


汇总:按风险排的执行顺序

顺序事项风险是否动数据
1documents 16 篇导出到文档站零否(只新增文件)
2三条端点注释下线低否
3task_templates + tasks 端点下线低否(0 行)
4工分任务补 A端 管理入口中是(可写,但仅新增入口)
5两套任务在导航上并列呈现低否
6(两周后)删除三条端点代码与 quotes 表中是

第 1、2、3、5 步我现在就能做,全是低风险且不动数据。

第 4 步(补入口)需要你确认"工分任务还要不要继续做" —— 如果这套不打算要了,

补入口就没意义,直接整块下线更干净。


需要你回一句的两点

  1. 工分任务(credit_tasks,4 条真实 UGC)还要不要?
  2. 要 → 我补 A端 入口(第 4 步)
  3. 不要 → 我把它和福钥分开处理,整块转存档(不删数据)
  4. 以上顺序你认可吗? 认可我就按 1→2→3→5 先做,做完给你看结果。