crm-backend-matt/.scratch/a7-acceptance

A7 后台管理验收包（a7-acceptance）

• 生成：2026-09-09（一期 a7-parity 12 tab + 二期 a7-heavy 3 tab 合并；合并脚本 _merge_demo.py 可重放）
• 目标环境：测试服务 https://ai.itc.vip/crm-api（demo 默认基址已指向，双击即用；如需换环境，访问一次 index.html?api=<新基址> 即被记住）

交付物清单

文件	用途
demo/index.html	15 tab 统一验收 demo（双击即用，默认管理员登录入口）
验收步骤清单.md	逐 tab 逐步操作与预期说明，结果列留白待验收人填写
验收结果汇总.md	验收结果登记表（结构化缺陷块，可整文件回喂 AI 定位修复）
issues/_TEMPLATE.md	单缺陷工单模板（本地 issue tracker 惯例，一缺陷一文件）
parity-smoke-result.json / heavy-smoke-result.json	冒烟自测证据（58 步 + 22 步）
shots-parity/ · shots-heavy-run/	冒烟截图（各 10 张 / 9 张）
_merge_demo.py · _check_demo.py · _gen_checklist.py	再生成 / 静态校验 / 清单再生成工具

新人上手（4 步）

1. 打开：双击 demo/index.html，页头「API:」应显示 https://ai.itc.vip/crm-api。
2. 登录：点「uid 登录」→ 应显示「已登录：罗伟健 (739564171091247104)」。
3. 验收：按《验收步骤清单.md》逐 tab 从上到下点每个步骤按钮——输出框绿色 = PASS，红色（失败 + code=）= 候选缺陷；每步结果填进清单结果列。
4. 记缺陷：FAIL 的按《验收结果汇总.md》格式登记（界面红框原文、执行日志面板里的请求 URL/参数直接复制）；每 tab 末尾的「清理」步骤必须执行，不留演示数据。

覆盖范围（15 tab = A7 全分区）

tab	原型分区	覆盖
用户管理 user	A7-1	用户列表 / 统计三时间戳 / 移交预览·自移交 61019·执行清零·返还
同步任务 sync	A7-1-2（二期票01）	任务化契约 SYNC-MMdd / 异步终态 / 61023 并发占位 / 分页倒序 / 详情五块 / 设置读写+61022 / lastSyncTime 切表
角色管理 role	A7-2	stats 四计数 / 批量增量分配 / copy 停用草稿 / enable 61021 / 内置角色保护
权限点管理 res	A7-2	references 引用清单 / 停启 roundtrip / 禁删两段 61009+61020
方案推送规则 push	A7-3	D-01 无步骤④发布 / 4 步骤回显 / 64029 / 64030 / copy / 64027
项目查重规则 dedup	A7-3	发布+referenceCount / 64031 两路 / 引用计数入账 / 64030 / 64033
项目规则 projrule	A7-3	current 5 区块聚合 / 分区保存回显 / 64036 比例校验
线索池 pool	A7-3 线索规则	三类异人成员建池回填 / 导出导入 BatchResult / 列表 / 清理
公海绑定数 poolrule	A7-3-4（二期票03）	部门专用规则发布 / boundOppCount 增量 base+n / 默认规则兜底 / 清理
全局日志 glog	A7-4（二期票02 · crm-log）	AOP 采集 / 操作·登录·批量三日志 / 结果文件下载 ZIP / 打包下载 / 40401 形态 / BUDDY 权限拒绝
字典种子验证 seed	A7-5	opp_stage 06/07 + opportunity_status 4 值
分组管理 dgroup	A7-5（v3 契约）	新建/编辑/启停/删除/设默认值（仅二级项）
字典项管理 ditem	A7-5（v3 契约）	无键值自动编码 / 组内名称唯一 63007 / 复合子项 / 63013 默认项禁停
两级树 dtree	A7-5	一级列表 + 行内二级展开
引用计数联测 dref	A7-5	客户引用 +1 / 换引用迁移 / 引用项禁删 63009 / 归档保留计数

登录与账号

• 管理员：罗伟健 739564171091247104（页头默认选中）
• 非管理员：曾偲青(BUDDY) 744842318024015872——全局日志 tab 步骤 9 用它验证权限拒绝口径
• 登录通道 = GET /api/auth/debug/token?userId=（verify 环境调试通道）；输入框可粘贴任意测试环境 userId 直登
• 演示数据一律 e2d- 前缀可辨；操作/登录/批量日志行与同步任务行为审计数据，留存不删

已知边界与争议留白（🟡 不报缺陷）

• 数据共享 3 页（A7-2-3 backup）：等原型正式化，未纳入盘点。
• 同步任务两态容忍：测试环境钉钉凭据不可达 → 任务落 all_failed（或长时间 running）为正常形态；61023 并发占位同理。
• lastSyncTime 口径 = 同步任务表最新成功行 endTime，无成功行为空。
• 职务下拉值域来源、「参与商机数」列、池规则冗余列、幻影挂账 3 端点、项目规则「阶段提醒」区块：争议留白，见清单尾部待确认清单。
• 全局日志采集 = 写侧（POST）先行不采查询 GET；登录日志仅「退出」钩子采集（debug/token 不走登录采集点）。

冒烟自测（可选，验收人自证环境可用）

# python 用仓库自带 venv；两个脚本均已支持 E2D_* 环境变量
E2D_API=https://ai.itc.vip/crm-api \
E2D_DEMO='E:\code\crm-backend-matt\.scratch\a7-acceptance\demo\index.html' \
E2D_SHOTS='E:\code\crm-backend-matt\.scratch\a7-acceptance\shots-parity' \
E2D_RESULT='E:\code\crm-backend-matt\.scratch\a7-acceptance\parity-smoke-result.json' \
.scratch/customer-e2e/.venv10/Scripts/python.exe .scratch/a7-parity/demo_smoke.py      # 一期 58 步

E2D_API=... E2D_DEMO=... E2D_SHOTS='...shots-heavy-run' E2D_RESULT='...heavy-smoke-result.json' \
.scratch/customer-e2e/.venv10/Scripts/python.exe .scratch/a7-heavy/demo_smoke.py       # 二期 22 步

最近结论（2026-09-09）：一期 58/58、二期 22/22 ALL_PASS（对测试服务），console/page error 双零（BUDDY 403 拒绝豁免除外），网络层零 PUT/DELETE、零路径变量形态。

给负责人的回喂流程

新人填完《验收结果汇总.md》→ 整个文件直接交给 AI（附本目录与后端仓 E:\code\crm-backend-matt 路径）→ AI 按缺陷块逐条定位修复；争议留白项等负责人确认后再改版。