docs: adopt 2026-07-08 product decisions — 学练问报 integration plan

- Add docs/20260708/: integration plan v1.2 (product definition vs launch
  demo split into four parts), meeting notes, customer 'third edition' docx,
  WeChat follow-up screenshot
- Decisions: directed mentorship rejected → open question board; 学 module
  upgraded to courses/no-fast-forward video/min reading time/irregular exams;
  direct-answer SOP format; credit-gated offline promotion exam
- Customer replies on three open items: multi-app jump deferred (D6 stays),
  leaderboard kept as opt-in switch (default off), manager evaluation gated
  by org-structure permissions
- Master plan → v0.3 (§4.4 open question board + permission-gated evaluation,
  §4.5 learning module, §8 resolved items); practice plan → v0.8 (sop_answer
  template, style-regen buttons, answer thumbs up/down, credit rules in M4)

docs/20260708/数字师傅学练问报整合方案.md

@@ -0,0 +1,252 @@
+# 银城数字师傅产品方案(整合修订)
+
+> 版本:v1.2 ｜ 日期:2026-07-08
+> 输入源:①客户方《物业数字师傅系统三期建设方案》(2026-07-08 早,下称"第三版")②《企业内部AI培训学习APP产品需求与发布会内容讨论》会议纪要(2026-07-08)③客户方会后微信补充(学模块课程化+考试;巡检点位转入职学习任务)。
+> v1.1 重构:按"产品是什么 → 发布会做什么 → 决策记录 → 执行"四部分分层,产品定义与发布会演示不再混写。
+> v1.2 更新(2026-07-08,客户回复三项待确认):①多端跳转议题**暂缓**,现阶段只保证能打开小程序页面;②工作积分排行榜**保留功能、可选择不用**(开关配置);③员工评价管理团队**按组织架构与权限控制**,需有权限才能评价。详见 §3.3。
+> 与《银城员工端APP分阶段实施总纲》《AI陪练二期开发推进计划》的关系:本方案是增量修订,不推翻既有阶段划分;§4.2 回写清单已于 2026-07-08 执行——总纲升 v0.3、二期计划升 v0.8(BRD 4.4 修订仍待落 v1.2)。
+
+---
+
+## 0. 一页总览
+
+**产品是什么**:面向物业一线员工(首岗生活顾问)的企业内部 AI 知识库与培训工具。员工每天用它做四件事——**学**(课程与考试)、**练**(AI 对手戏)、**问**(直给式 SOP 问答)、**报**(上报案例)——外加一个全员参与的**问题榜**;这些行为累计**学分**,学分决定晋升统考资格。远期演进为员工端"专业 AI 师傅"(公告、工单、报事报修全流程)。
+
+**发布会做什么**:半年会上的一次对外亮相,面向区域总及以上管理层,用**「生活顾问的一天」**做主线演示。只现场演示已稳定的功能(问答、对练),问题榜/学模块作规划展示,拍照识别不承诺。
+
+**两者的关系**:发布会是产品的营销切片,不是产品范围本身。产品按总纲三阶段推进;发布会只决定"哪天、给谁、演示哪一段"。
+
+---
+
+# 第一部分 产品:银城数字师傅是什么
+
+## 1.1 定位与用户
+
+| 项 | 口径 |
+|---|---|
+| 当前定位 | 企业内部 AI 知识库与培训工具(会议定案:定位分步走的第一步) |
+| 远期定位 | 员工端"专业 AI 师傅":集合公告推送(AI 提取"跟我相关")、工单巡检、报事报修全流程——对应总纲阶段二/三,不拉入当前主线 |
+| 首要用户 | 生活顾问(约 800 人,80% 以上为初级) |
+| 延伸用户 | 项目上其他岗位(保安、保洁主管、工程等)——"只要想学习、想晋升,就提供机会" |
+| 管理用户 | 主管(复盘、预警、派发)、HR/运营(内容、激励规则、评级) |
+
+## 1.2 产品功能全景
+
+自上而下五层;"状态"列区分已有/在建/规划,是排期与承诺的依据。
+
+| 层 | 模块 | 给员工解决什么 | 关键功能 | 状态 |
+|---|---|---|---|---|
+| 入口 | 载体与架构 | 一个入口找到所有工具 | 现阶段只保证能打开目标小程序页面(最小跳转);企微统一入口/多端架构暂缓再议 | 暂缓(3.3) |
+| 日常四模块 | **学** | 该会的知识按计划学、按要求考 | 岗位学习计划、入职任务包、文档/视频课件(防快进、最短阅读时长)、不定期考试(有截止时间) | 本期新建(最小集) |
+| | **练** | 每天 5 分钟,跟 AI 业主实战演练 | 场景对练(AI 控制生成)、语音对手戏、回复语气调节按钮、每日任务派发 | 已有主链,本期增强 |
+| | **问** | 现场遇事,一问就有能照做的答案 | 直给式问答(结论+一二三四五步骤)、语音提问、答案打勾/打叉、视频链接直出 | 已有,本期改格式 |
+| | **报** | 我的经验被看见、被沉淀 | 案例上报(文字+拍照+语音)、审核入库、署名计分 | 已有雏形,本期规范 |
+| 共创层 | 问题榜 | 遇到难题有人帮,答题有奖 | "今天遇到什么难题"+"有奖征问题"双入口、全员可答、最佳答案置顶、沉淀入库 | 阶段二(本期埋 knowledge_gap 日志) |
+| 成长层 | 学分与晋升 | 努力可积累,晋升有通道 | 学分规则(可配置)、初/中/高级成长进度、E1-E8 远期框架、学分达标→统考资格 | 本期最小集 |
+| 地基 | 知识库 | 一切模块的内容来源 | 全业态资料入库、多格式解析、混合检索、纠错闭环、分级访问 | 已有,2026-07-08 当周补资料 |
+
+## 1.3 各模块设计
+
+### 1.3.1 学——标准学习计划与知识课程(本次最大增量)
+
+对标大厂企业学习考试平台,最小可用集:
+
+| 能力 | 要求 |
+|---|---|
+| 学习计划 | 按岗位安排标准学习计划;新员工入职自动挂**入职学习任务包**(首包:生活顾问日常巡检要点——楼道、停车场、天台各点位关注什么,素材由业务侧从巡检标准拆分) |
+| 课程内容 | 文档 + 视频两种课件;复用知识库上传解析链路 |
+| 防快进 | 视频**不能快进**:禁用拖拽跳转,只允许回看(H5 播放器监听进度,超出已观看位置回拉) |
+| 阅读时长 | 文档设**最短打开时长**,达到才计学完(前端计时+页面可见性校验,后端存进度) |
+| 考试 | 学完可考;**不定期学习+不定期考试**;考试有**截止时间**;成绩留档;题库先由业务侧配套供题,后续 AI 辅助出题 |
+| 学分 | 完成课程/通过考试计学分(见 1.3.6) |
+
+范围控制:不做直播、线下签到、课程市场;只支撑"岗前课程 + 每日小训 + 不定期考试"三种形态。
+
+### 1.3.2 练——每日 5 分钟 AI 对手戏
+
+- 每天 **5 分钟训练**,系统推送进"今日安排"(与新员工每日三题统一走 `source='daily'` 派发口径);
+- 场景由 AI 主动控制生成(收费时遇到 A/B/C/D 类业主等),业务侧**不需要**编写对话脚本,只需保证知识库资料充足——会议已明确此分工;
+- **回复调节按钮**:AI 给出方案后,提供"再严肃 / 再温柔 / 更细致 / 更专业"等按钮,点击按该方向重新生成。这是"第三版"七维偏好体系的首期落地形态;偏好自动记忆、千人千面为远期。
+
+### 1.3.3 问——直给式 SOP 问答
+
+- 输出格式**直给**:先给结论,再按 1/2/3/4/5 步骤给操作指引(如报销:打开金蝶→选报销名录→填科目→……),不推大段原文;引用片段后置供核对。"物业人直给直拿"是明确验收口径;
+- 视频类流程(如采购平台操作)答案直接带视频链接;
+- **打勾/打叉**:每条 AI 答案可标好/差;打叉的知识条目在该问题上后续**不再推送**,并进后台待复核清单——解决"错误知识反复出现"的历史问题;
+- 悬赏问答不在问模块内,独立为问题榜(1.3.5)。
+
+### 1.3.4 报——案例上报与经验沉淀
+
+- 上报"今天处理了什么事、怎么处理的",支持文字+拍照+语音;目标**每个生活顾问每月至少 1 个有价值案例**;
+- 后台审核,采纳入库计学分并署名;与问题榜优质回答共同构成"行业经验知识库"原料;
+- "报"字面易与报事报修歧义,对外文案待定名,功能先行。
+
+### 1.3.5 问题榜——师带徒的替代方案
+
+会议明确否决定向师带徒(80% 以上生活顾问为初级、无带徒岗、无额外报酬,强推造成误解),替代设计:
+
+| 设计项 | 内容 |
+|---|---|
+| 双入口 | ①**"今天遇到什么难题了?"**——真实困难求助;②**"有奖征问题"**——悬赏征集好问题 |
+| 回答开放度 | **全公司所有人可答**(含管理层);不同层级答案分类呈现 |
+| 激励 | 提问、回答均有奖励;后台筛选**最佳答案置顶**;优质问答沉淀入库并署名 |
+| 经验萃取 | 前期邀请优秀生活顾问对高频问题做经验萃取,喂入 AI |
+| 定位 | "广谱师傅":想帮带的人通过答题帮带——留痕、可奖励、无固定关系绑定 |
+
+与总纲阶段二"新问题挂榜共创"是**同一件事**,本次定案其产品形态;落地节奏不变(阶段一只埋 `knowledge_gap` 日志,不做挂榜 UI)。
+
+### 1.3.6 成长体系——学分、等级、晋升对接
+
+**学分链路(会议定案)**:
+
+```
+日常行为(训练完成 / 回答被采纳 / 案例被采纳 / 课程考试通过)
+  → 累计学分(规则后台可配置)
+  → 学分达标 = 获得晋升统考资格
+  → 线下统考 + 主管/HR 评定 = 晋升结论
+```
+
+- 学分只是**资格门槛**,晋升结论由统考+人工确认——与 BRD G1(AI 辅助参考、人可否决)和二期计划"评级证据包"口径一致;
+- 等级框架:当前落地**初/中/高级生活顾问**三档(二期计划 M4);"第三版"E1-E8 作远期框架,其中"带过 N 名徒弟"晋升条件删除,替换为"问题榜优质回答/案例入库 N 条";"破格晋升"保留为人工通道;
+- **激励规则配置中心**("第三版"带徒福利引擎的改造保留):学分来源、分值、悬赏金额、徽章条件均后台可配,不写死代码;
+- 防刷分:学分只认"被采纳/通过考试"等有审核动作的行为;纯活跃行为给悬赏/徽章不给学分;学分与悬赏在 `incentive_point` 内分类型分账。
+
+### 1.3.7 知识库地基——资料治理口径(会议确认)
+
+| 项 | 口径 |
+|---|---|
+| 范围 | 全公司**全业态**各职能"应知应会":最新制度、业务手册、流程资料(含财务报销、行政等非业务条线) |
+| 时效 | 只放**现行有效**版本;废弃制度不放;已确认错误的内容入库前删除 |
+| 已完成 | 2022 版生活顾问手册初筛:已删智慧美家、享乐一安等停办业务及离职人员错误内容;业务类存疑项待严总复筛 |
+| 格式 | PDF/文字/PPT/语音/视频均可;**业务侧不需要预处理颗粒度**(现有解析链路已支持全部格式) |
+| 保密 | 涉密资料不入库;账号分级访问(知识分级是新增工程需求,阶段二前评审) |
+| 纠错 | 上线后靠打叉反馈+后台复核持续清洗 |
+
+### 1.3.8 载体与架构
+
+- 不整合成一个重 APP(改一处影响全局、升级不便);**企业微信统一入口**,点模块跳转独立小程序/H5;培训 APP 是其中一端;
+- 对 D6 的影响:2026-07-08 客户回复**多端跳转议题暂缓**——现阶段只保证能打开某个小程序的页面(最小跳转能力),不做统一入口工程;D6 维持 H5 套壳表述,统一入口待后续再议(3.3);
+- 电子名片:独立产品,不进本方案范围。
+
+---
+
+# 第二部分 发布会:半年会演示方案
+
+## 2.1 目的与观众
+
+- 场合:半年会产品发布(总纲既定硬死线,须带一线真实使用数据);
+- 观众:几十位**区域总及以上**管理层,少量获收费奖项的生活顾问/项目经理;
+- 目的:让管理层看到"这个产品能实际减轻生活顾问和项目经理的负担",为 9 月收费季前试点铺路。
+
+## 2.2 演示主线:「生活顾问的一天」
+
+三个候选框架(新人到高手 / 生活顾问的一天 / 晋升通道)中定案**「生活顾问的一天」**——最贴近实操、最容易让管理层代入。五幕动线:
+
+| 幕 | 一天中的时刻 | 演示动作 | 对应模块 |
+|---|---|---|---|
+| 1 | 上班前 5 分钟 | 今日安排推送每日训练任务,完成一轮微训 | 练 |
+| 2 | 晨会/巡检前 | 打开岗前课程,查看"楼道巡检关注点"学习任务 | 学 |
+| 3 | 现场遇事 | 语音提问 SOP,得到一二三四五直给步骤 | 问 |
+| 4 | 收费/投诉现场 | AI 扮演业主实战对练,展示语气调节按钮 | 练 |
+| 5 | 下班前 | 上报今日处理的一个案例,学分到账 | 报 |
+
+## 2.3 展示分级
+
+发布会内容分三档,**只有第一档做现场实操**:
+
+| 档 | 内容 | 理由 |
+|---|---|---|
+| **现场实操演示** | 问(直给问答)、练(对练+调节按钮)——即幕 1/3/4 | 已稳定或 2026-07-10 前可稳定;演示问题**提前预设并验证** |
+| **规划展示(讲即可)** | 学模块(课程/考试)、问题榜、学分晋升链路——幕 2/5 可用界面稿或最小页面走过场 | 功能在建/在阶段二,不做现场输入交互 |
+| **不提/不承诺** | 拍照识别巡检点位数值、扫码点位问答、大喇叭推送 | 会议结论"先喂足资料看效果,后续再推进";若发布会前验证稳定可作彩蛋,不写进流程 |
+
+## 2.4 准备与兜底
+
+- 演示问题全部**提前预设**,每题验证输出符合预期后锁定;
+- 止损口径沿用总纲:保"陪练 + 总结卡 + 1 条示范视频";
+- 录屏兜底沿用一期做法:现场网络/模型异常即切录屏。
+
+---
+
+# 第三部分 决策记录
+
+## 3.1 本次定案汇总(会议+微信补充)
+
+| # | 议题 | 结论 |
+|---|---|---|
+| 1 | 产品定位 | 第一步=企业内部 AI 知识库与培训工具;远期=员工端专业 AI 师傅 |
+| 2 | 四模块 | 学/练/问/报;学=专业学习与考试,练=每日 5 分钟 AI 互动,问=查 SOP 话术,报=上报案例 |
+| 3 | 学模块 | 课程化+防快进+阅读时长+不定期考试(有截止时间),参考大厂平台 |
+| 4 | 巡检知识 | 作入职学习任务进学模块;扫码/拍照识别后置 |
+| 5 | 师带徒 | 定向师带徒**不做**,替换为开放问题榜 |
+| 6 | 答案反馈 | 打勾/打叉,打叉不再推送;练模块回复可按钮调节重新生成 |
+| 7 | AI 回答格式 | 直给:一二三四五步骤,不推大段资料 |
+| 8 | 晋升对接 | 学分绑定统考资格;统考保留线下 |
+| 9 | 知识库资料 | 全业态现行版;错误内容删除;多格式均收;不需业务侧调颗粒度;涉密不入库、账号分级 |
+| 10 | 架构 | 企微统一入口+多端跳转,不做单一重 APP;电子名片独立 |
+| 11 | 发布会主线 | 「生活顾问的一天」 |
+| 12 | 当周排期 | 2026-07-08(周三)交资料 → 07-10(周五)测试版 → 07-10~12 业务方测试 |
+
+## 3.2 "第三版"逐项处置对照
+
+| "第三版"内容 | 处置 | 说明 |
+|---|---|---|
+| 一期·岗位工作量化体系(对接 ERP/工单/财务) | **后置** | 依赖外部系统对接,归总纲阶段三节奏;画像先用训练侧数据 |
+| 一期·E1-E8 等级体系 | **修正采纳** | 删带徒条件;当前落初/中/高三档,E 级为远期框架(1.3.6) |
+| 一期·工作积分实时排行榜 | **保留为可选功能** | 2026-07-08 客户回复:保留功能、可选择不用——做成开关配置项,默认关(3.3) |
+| 一期·提问精调七维标签+偏好记忆 | **裁剪采纳** | 首期只做调节按钮+打勾打叉;偏好自动记忆、千人千面为远期 |
+| 二期·师徒传承整章(师傅池/双向盲选/带徒福利/师徒PK) | **替换** | 会议否决;由问题榜承载(1.3.5);二期计划"主管传帮带工作台"不受影响,继续保留 |
+| 二期·可配置福利引擎 | **改造保留** | 平移为激励规则配置中心(1.3.6) |
+| 三期·纯AI陪练四角色(教练/业主/评委/分析师) | **采纳为演进方向** | AI业主+AI评委已有;AI教练≈定向再练+每日派发;AI分析师≈画像聚合;按二期计划 M4 演进,不另起炉灶 |
+| 三期·游戏化五要素 | **最小集采纳** | 学分+徽章+等级进度条;排行榜缓;BOSS挑战/师徒副本不进当前范围 |
+| 补充·语音优先/5分钟法则/情景代入 | **采纳** | 与现有设计一致,作体验原则贯穿 |
+| 补充·学习小组/对练PK/社交化 | **缓** | 个人闭环验证后再评估 |
+| 补充·专属AI师傅人设 | **部分已有** | 员工端已是数字师傅形态;"主动关心"推送依赖触达通道(§4.3) |
+| 补充·荣誉墙/成长档案导出 | **采纳(后置)** | 证据包导出已在二期计划 M4/M5;荣誉墙随徽章落地 |
+
+## 3.3 待确认项处置(2026-07-08 客户已回复)
+
+| 项 | 原冲突/依赖 | 客户回复(2026-07-08) | 落地口径 |
+|---|---|---|---|
+| 多端跳转架构 | 王总此前要求整合单一 APP | **暂时忽略多端跳转议题**,现阶段只保证能打开某个小程序的页面 | 不做统一入口工程;先验证"从当前 H5/企微打开目标小程序页面"的最小跳转能力;D6 表述维持 H5 套壳不动,统一入口待后续再议 |
+| 工作积分排行榜 | 与既定"不做同侪排名、先自我对比"口径冲突 | **保留功能,可以选择不用** | 排行榜作为**可开关配置项**开发(默认关);上线与否由运营按项目选择,既定"先自我对比"仍是默认态 |
+| 员工评价管理团队 | 组织风险(总纲已列敏感项闸门) | **以组织架构、权限为依据,需权限才能评价** | 不再是"待独立评审的敏感项闸门",转为**权限控制的正常功能**:依组织架构 + 权限模型(复用 `role_perm_mapping`/D1 数据权限)控制谁可评价;仍属阶段二范围 |
+
+---
+
+# 第四部分 执行
+
+## 4.1 当周排期(2026-07-08 ~ 07-12)
+
+| 时间 | 事项 | 责任 |
+|---|---|---|
+| 2026-07-08(周三)下班前 | 知识库资料交付(全业态现行制度/手册/流程) | 业务方;严总补业务端并交叉核对 |
+| 07-08 ~ 07-10 | 资料批量导入解析;`sop_answer` 直给格式改造;预设演示问题走查 | 开发方 |
+| 2026-07-10(周五) | 第一个可测试版本(与二期计划 Alpha 锚点重合) | 开发方 |
+| 07-10 ~ 07-12 | 业务方实测:问答准确性、直给格式、对练体验,反馈问题清单(可请生活顾问参测) | 业务方 |
+| 半年会前 | 按 §2 锁定演示脚本与预设问题;录屏兜底 | 双方 |
+
+## 4.2 文档回写清单
+
+| 增量 | 落点 | 动作 |
+|---|---|---|
+| 学模块(课程/防快进/阅读时长/考试) | 总纲阶段二"知识学习平台" | 总纲 §4/§5 增补;出学模块专项设计(表:课程、课件、学习进度、考试、成绩);岗前课程最小版可视资源提前到阶段一试点后 |
+| 问答直给格式 | 二期计划 M1 提示词模板体系 | 新增 `sop_answer` 模板(结论先行+编号步骤+引用后置),随 2026-07-10 测试版调整 |
+| 答案打勾/打叉 | 新机制 | 新表(答案反馈);检索融合对打叉条目降权/屏蔽;后台待复核清单 |
+| 练模块调节按钮 | 二期计划 M2 | turn 接口支持 style 重生成参数,模板化注入 |
+| 问题榜形态定案 | 总纲阶段二"新问题挂榜共创" | 用 1.3.5 更新总纲对应条目;阶段一继续只埋 `knowledge_gap` |
+| 师带徒否决 | 二期计划 §2 暂缓表、BRD 4.4 | "师徒演练暂缓"升级为"定向师带徒不做,由问题榜承载";BRD 同步修订 |
+| 学分/激励规则配置中心 | `incentive_point` 体系 | 学分与悬赏分账;规则可配置;统考资格口径写入 M4 成长路径 |
+| 知识分级权限 | 知识库 | 账号等级 × 知识密级访问控制,新增工程需求(阶段二前评审) |
+| 载体口径 | 总纲 §7、D6/D8、§8 | 2026-07-08 定为暂缓:D6 维持 H5 套壳;只保证小程序页面可打开(3.3),总纲 §8 该行已更新 |
+
+## 4.3 风险
+
+| 风险 | 控制 |
+|---|---|
+| 资料质量(错误知识入库) | 只收现行版+入库前删已知错误+打叉反馈闭环;业务复筛不阻塞导入,先导后清 |
+| 学模块范围膨胀 | 只承诺 1.3.1 最小集;直播/课程市场/线下签到明确不做;完整 LMS 在阶段二 |
+| 两天出测试版极紧 | 测试版验收聚焦"资料导入+问答直给";调节按钮/打叉允许迟于 07-10 分批上;演示兜底录屏 |
+| 触达通道 | "主动关心"推送、考试截止提醒依赖企微通道(D8 只列不实现)→ 阶段二开工前决策;当前用站内今日安排承载 |
+| 学分刷分 | 只认有审核动作的行为计学分;纯活跃给悬赏/徽章不给学分 |
+| 口径冲突已收敛 | 3.3 三项已获客户回复并落口径:多端暂缓、排行榜可选、评价走权限;剩余敞口=统一入口后续再议 |