施工方案总目(plans/)

版本:v1.0 | 2026-08-31 | 出品:小齐(方案+验收)| 执行:扣子一号(前端)/ 扣子二号(后端)
本目录是小齐转「方案+验证」岗后的施工方案唯一来源。扣子 agent 领任务=读对应 PLAN 文档执行。

一、分工铁律(刘总 2026-08-31 拍板,AGENTS.md §9.2)

角色职责禁区
扣子一号(coze1)前端:miniprogram/ 全部页面与 services不碰 backend/、不写迁移
扣子二号(coze2)后端:backend/ 路由/服务/脚本/迁移、文档修订不碰 miniprogram/
小齐出方案(本目录)+ staging 验收把关不再写业务代码
刘总拍板、生产部署确认—

二、执行流程(每个 PLAN 都走这六步)

  1. 认领:在 docs/TASKS.md 登记表加一行开工声明(WIP 编号取当前最大号+1,push 前 git pull 防撞号)。
  2. 读三样:对应 PLAN 文档 → PLAN 里列的依据文档 → AGENTS.md(尤其 §2 铁律、§7 前端规范、§9.7 git 规范)。
  3. 施工:严格遵守 PLAN 的「范围/禁区」。契约里没有的字段、表结构变更、新配置键——不许自创,回小齐出补充方案。
  4. 提交:git push origin main 即自动部署 staging(post-receive 钩子:rsync→自动迁移→重建→健康检查,输出在 push 回显的 [auto-deploy] 行)。文档类提交在 message 里带 [no-deploy] 跳过。
  5. 自测:按 PLAN「验收标准」逐条在 staging 实测(接口 http://100.64.1.230:8089),未自测全绿不许报完成。自测证据(curl 输出/截图)贴进 TASKS.md 完成登记。
  6. 验收:小齐复核+抽查实测。不达标打回,不折扣。

三、通用红线(违反=打回)

四、方案清单(按建议施工顺序)

编号方案执行人优先级预估产出
PLAN-01站内信 N1-N12 接线收尾扣子二号P0notifications.py 13 触发点全接线
PLAN-02订单域定时任务四件套扣子二号P0order_housekeeping.py + cron
PLAN-03订单域前端接管与联调扣子一号P0订单/核销码/工作台页面上 staging 真接口
PLAN-04站点配置接口收口+管理端(B-026)扣子二号(后端)+扣子一号(console UI)P1site_config 白名单+校验+管理端配置页
PLAN-05前端硬编码清理(B-025)扣子一号P1清理报告 + L1/L2 硬编码清零
PLAN-06分销 v2.2 §8 资金口径修订(T-1)扣子二号P1方案文档对齐保证金废止口径
PLAN-07状态条 P0 链(B-011~B-020 史诗)扣子二号(后端)+扣子一号(前端)P1状态条全链路上线
PLAN-01/02 有依赖关系(N2/N7 由定时任务触发),建议 01→02 连做;PLAN-03 与 01/02 可并行;PLAN-04/05 联动(05 依赖 04 的配置消费能力);PLAN-07 在订单域收尾后启动。

五、方案冲突处理