Neo-ZQYY/docs/_overview/04c-feedback/00-P2-feedback-response-summary.md

P2 反馈响应总报告

日期:2026-05-04 / 触发:Neo 在 04c-conflicts-P2-detail.md 13 条 P2 + 5 子项 上写下斜体反馈 主线 + 2 个子代理(H-1 课程体系+看板限制 / H-2 prompt 答疑+无权限页设计) / 状态:调研完成,等 Neo 拍板进入实施

一、13 项 P2 + 5 子项 处理状态总览

#	Neo 反馈	处理	关键结论
P2-1	选项 A	直接确认	tabBar 旧文档同步为"动态过滤"
P2-2	选项 A	直接确认	维客线索 tag 改枚举 + label 双字段
P2-3	选项 A	直接确认	维客线索 source 改枚举 + recorded_by_name
P2-4	要再调研	P2-4-and-P2-7-research.md	A 两套独立体系;无两级嵌套;ROOM 是死代码
P2-5	选项 A	直接确认	ChatMessage timestamp → createdAt
P2-6	选 A + 问 prompt	P2-6-and-P2-9-design.md	不改 APP1 prompt;推荐 R2 SQL LEFT(content,16) 写 title;title 字段已存在未写入
P2-7	选 B + 调研其他限制	P2-4-and-P2-7-research.md	新发现 board-finance 隐式 null Bug(area≠all 三板块凭空消失);board-customer 无问题
P2-8	选项 B(改原 A→B)	直接确认	site_admin/tenant_admin 不混入 dev-tools
P2-9	选 A + 设计 + 实施 + 测试	P2-6-and-P2-9-design.md	表名 biz.site_contact_info / 3 端点 / Wave 5 全部 1.7 人天
P2-10	选项 B	直接确认	Pydantic Field alias 显式写
P2-11	选项 A	直接确认	AI 需求 2 表头 6→8
P2-12	同意建议	直接确认	NS4 加职责边界节
P2-13.1	A	直接确认	NS3 加 72 组合二分逻辑节
P2-13.2	B(改 A→B)	直接确认	biz/cfg_event_types.py 维护源 + 文档自动生成
P2-13.3	A	直接确认	接受双入口现状 + PRD 解释
P2-13.4	同意建议	直接确认	校对 auth.py 实际路径 + 同步 NS1
P2-13.5	A	直接确认	getSelectedKeys 改造支持多 group 展开

二、4 件 Neo 必须知道的事

1. P2-4 — 课程体系的"两套" + 死代码隐患

H-1 实测发现:

• course_type(cfg_skill_type)只有 BASE / BONUS 两类,BD 手册说有 ROOM 但数据库实际无(BD 手册过期)
• category_code(cfg_area_category)6 类(BILLIARD/SNOOKER/MAHJONG/KTV/SPECIAL/OTHER)
• 两套完全独立,不是两级嵌套
• 死代码隐患:CourseType.ROOM 枚举 + DWS room_* 列均存在,但配置数据未提供 → 所有 ROOM 相关代码分支永不命中

修正后 P2-4 选项:

• 推荐 B 清理代码冗余:决定 ROOM 是去掉(不需要)还是补配置(需要)
• service-record-card 组件用 vip/tip 与 COURSE_TAG_MAP basic/room/incentive 不一致,需统一

category_code不是课程，是项目分类。课程的调研不对，不够深入，课程全部应该有 包厢课 麻将课 基础课 激励课 但应该分布在不同的表中。继续深入调研。

2. P2-7 — 新发现 board-finance 隐式 null Bug

H-1 全看板扫描:

• board-coach(已知):time=last_6m + sort=sv_desc 后端 400,前端无禁用提示 → 需双向变灰
• board-finance(新发现):area≠all 时后端 recharge / cashflow / expense 三板块返回 null,前端无任何提示,板块凭空消失 → 需补占位文案
• board-customer:无组合限制

意外多挖出 1 个 D Bug(P2-7 board-finance 隐式 null),严重度比 P2-7 主体高(用户看不到原因)。

area≠all 时后端 recharge / cashflow / expense 三板块返回 null,前端无任何提示是可以的。找到的BUG进行修复。

3. P2-6 — 不改 APP1 prompt,因为 prompt 在百炼云端不入 git

H-2 调研:

• APP1 prompt 在百炼控制台云端,改动不可追溯(不在 git)
• SSE 流式纯文本末尾插结构化 title 会破坏流式体验
• biz.ai_conversations.title 字段已存在但当前未写入(意外发现)
• chat_service.generate_title() 已有"客户姓名 / 首句 20 字 / 新对话"回退链(意外发现 2)

推荐 R2 起步:Wave 5 用 SQL LEFT(content, 16) 在首轮结束时写 title。R1(qwen-turbo 异步轻量摘要)后续观察再决定。

APP1 prompt 在百炼控制台云端,改动不可追溯，但如果有改动的必要，我可以手动操作。并且现在应该有路径保存了当前所有Prompt。现在用你的推荐方案是可行的，暂时不改Prompt我同意。但要记录后续观察的需求，需要跟踪。

4. P2-9 — no-permission 编辑入口设计完成,Wave 5 实施 1.7 人天

H-2 设计:

• 表名:biz.site_contact_info PK=site_id
• 字段:display_name / phone / wechat_id / notes / updated_by / updated_at
• 默认值:display_name = '门店管理员',不预填真名(让 Neo 上线后手工配置)
• 3 端点:
  • GET /api/tenant/site-contact(tenant 端读)
  • PATCH /api/tenant/site-contact(tenant 端改)
  • GET /api/xcx/site-contact(小程序 no-permission 拉)
• 小程序从 token 推 site_id,前端不传(防伪造)
• Wave 5 全部 1.7 人天(后端 + tenant-admin + 小程序 + 测试)

H-2 提的 7 个审稿题(表名 / 拦真名黑名单 / 刷新时机 / 菜单文字 / 自动建行 / 审计 / R2-R1) 待 Neo 答。

同意。

三、按 Wave 重新分配的 P2 执行清单

Wave	任务
Wave 1-3 / 即时	board-finance 隐式 null Bug(P2-7 副发现,Wave 1 协同)
Wave 5	全部 P2 主体 — 13 项主条目 + 5 子项,统一文档收尾 + 小代码改动批

四、给 Neo 的 P2 决策提问

#	问题	我的建议
1	P2-4 ROOM 死代码处理:去掉 / 补配置 / 维持现状	去掉(BD 手册更新为 BASE+BONUS 两类)
2	P2-4 service-record-card 组件命名是否同步改 vip/tip → vip-tag/tip-tag?	Y(统一命名)
3	P2-7 board-finance 隐式 null Bug 是否纳入 D Bug 清单	Y(D Bug)
4	P2-9 H-2 提的 7 个审稿题(表名/拦真名/菜单文字/审计...)是否一次答完	Y
5	P2-6 接受 R2 起步(SQL LEFT 16 字)+ R1 后续观察	Y

五、产出文件索引

docs/_overview/04c-feedback/
├── 00-P2-feedback-response-summary.md       (本文)
├── P2-4-and-P2-7-research.md                (H-1)
└── P2-6-and-P2-9-design.md                  (H-2)

---

全部 P0(2 轮)+ P1(2 轮)+ P2 反馈调研完成。下一步:Neo 答 P2 5 问 + P1 二轮 5 问 + H-2 的 7 个审稿题。