义父把「documents 归属 / 任务系统合并 / 可砍三条」三件全部交给我出方案。
下面是我的推荐方案,每件事含:查到了什么 → 我建议怎么做 → 具体步骤 → 风险与回滚。
结论先行,你看完说"照做"或指出哪条要改,我就动手。
| 项 | 事实 |
|---|---|
| 内容 | 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 任务 |
| 2 | task_templates + tasks 两个端点下线 | 模板表 0 行、从未启用;credit_tasks 已直接存 17 条具体任务,模板层是多余的一层 |
| 3 | 两套在 A端 导航上并列呈现、名字区分清楚 | 「福钥任务」与「工分任务」放同组,运营一眼看出是两个东西 |
| 模块 | 证据 | 判定 |
|---|---|---|
| promoters | 端点在,关联表根本不存在 | 死代码 |
| site_texts | 0 行;真通道是 content_items(文案字典,C端 在消费) | 早期另一套,已被取代 |
| quotes | quote_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 取代"
而不是"废弃",并抄送给相关人。
| 顺序 | 事项 | 风险 | 是否动数据 |
|---|---|---|---|
| 1 | documents 16 篇导出到文档站 | 零 | 否(只新增文件) |
| 2 | 三条端点注释下线 | 低 | 否 |
| 3 | task_templates + tasks 端点下线 | 低 | 否(0 行) |
| 4 | 工分任务补 A端 管理入口 | 中 | 是(可写,但仅新增入口) |
| 5 | 两套任务在导航上并列呈现 | 低 | 否 |
| 6 | (两周后)删除三条端点代码与 quotes 表 | 中 | 是 |
第 1、2、3、5 步我现在就能做,全是低风险且不动数据。
第 4 步(补入口)需要你确认"工分任务还要不要继续做" —— 如果这套不打算要了,
补入口就没意义,直接整块下线更干净。