admin
8226bf1c27
- CHANGELOG: 2026-08-05 entry with deploy evidence, verification levels and open items - runbook: execution log entry + two new migrations in the sequence - AGENTS.md: macOS GNU stat shim requirement for release scripts
文档索引
根目录 README.md 是项目总入口。本文件只维护 docs/ 区的文档索引。
事实源优先级
同一事项出现不同表述时，按以下顺序裁决，不以会议原文、旧计划或设计图推断当前实现：
- 物业AI人力资源系统业务需求文档BRD.md 定义当前业务范围，物业AI人力资源系统开发规格TechSpec.md 定义工程契约。
- BRD_IMPLEMENTATION_AUDIT.md 与 API_INTEGRATION.md 说明当前实现、部署证据和接口限制。
- 专项 TechSpec 细化单个领域；实施计划可记录本地实现与验证，但部署和生产状态仍以审查文档、接口事实和真实环境证据为准。
prototypes/只作视觉回归基准；会议纪要、历史 Prompt、legacy/与archive/只作需求来源和追溯材料。
“问”模块的产品边界见《数字师傅工作 Agent 总体设计》，现役旧链路的实施与验证进度见《实施计划》；2026-08-04 Grounded Agent 已在现役文本入口受控切换为 ACTIVE，仅覆盖符合门禁的 KNOWLEDGE_QA 与 LIVE_MY_WORK，媒体、资源、外网、写入、训练和不合格计划继续走旧链路，其架构与运行边界以专项 TechSpec和ADR-002为准。认证态用户逐例问答、客户端状态 UI 全量验收和人工黄金集召回评测仍未完成。工作助手相关术语、实施状态与文档关系集中在《工作助手与今日工作成果迭代计划》。阶段一“练”的唯一后续施工范围见《AI陪练完整交付计划》，公司消息现状见九项能力设计与大喇叭纠偏增量方案。不得把受控 ACTIVE、已部署但尚未完成 Agent 专项生产回归的包存在性，或已验证的全员文件消息和直通车闭环，外推为 Agent 全量正式验收、消息修订、强触达、工单流转、完整个人知识空间或完整试点已经完成。
当前项目文档
| 文档 | 用途 |
|---|---|
| ../CHANGELOG.md | 按明确时间记录源码、生产发布、线上验证和未验收边界 |
| DEV_SETUP.md | Linux/macOS 与 Windows + Docker Desktop 的本地端口、账号、启动步骤、基础链路验证和静态发布 |
| MOBILE_APP_PACKAGING.md | mobile-uni Android/iOS 资源构建、隐私/签名边界和出包前置条件 |
| MOBILE_APP_DEVICE_ACCEPTANCE.md | Android/iOS 自定义基座或签名包的真机验收清单 |
| 帮道8月1日Android内测Go-No-Go-20260728.md | 更新至 2026-07-30 的当前候选 APK、最新后端、生产/真机复验与正式来源门禁 Go/No-Go 结论 |
| 生活顾问调研转化清单-20260728.md | 将仓库外原始访谈脱敏映射为待业务审核的 SOP、知识、题目和对练候选池 |
| 帮道8月1日生活顾问内容候选审核包-20260729.md | 5 个脱敏场景与 30 道政策问题的待审候选包；明确 0 个正式场景、0 道正式来源标准答案及业务签认路径 |
| 帮道8月1日业务内容与五通道签认单-20260729.md | 5 个生产场景、30 道策略题和五通道真实闭环的统一签认入口；场景/通道/结构回归已有证据，逐题正式来源仍失败关闭 |
| FIGMA_DESIGN_INVENTORY.md | Figma 页面节点索引、设计批次范围、取消项和全文件一致性审计结果 |
| FIGMA_DESIGN_SYSTEM_GUIDE.md | 员工端通用视觉元素、业务元素、状态映射和 LLM 组页规则 |
| FIGMA_IMPLEMENTATION_MATRIX.md | 70 张正式画板与代码/线上实现状态、二期边界和剩余动作 |
| FIGMA_ONLINE_DELTA.md | Figma 目标与线上 H5 实测差异矩阵、当前实施边界和验收口径 |
| FIGMA需求覆盖与版本偏差审计-20260717.md | 旧版功能、已确认需求、Figma 实际画板与当前实现的四方对照，以及防止遗漏旧功能和误拉后续阶段的事实源规则 |
| DEMO_ACCEPTANCE.md | 一期 MVP 演示脚本、录屏兜底、MVP 演示流验收清单 |
| API_INTEGRATION.md | 后端 API 对接顺序、数字师傅 Agent、正式试点 CSV、移动端训练/复盘、候选资料和 SOP 接口 |
| AIHR_GROUNDED_AGENT_TECHSPEC.md | 受约束语义规划、双工具、证据/事实分型、有界执行、逐结论引用和结构化会话状态的现役契约；生产仅在有限文本范围 ACTIVE，仍记录未完成的认证态和人工黄金集验收 |
| adr/ADR-002-GROUNDED-AGENT-EXECUTION.md | 采用 Spring 内受约束工具执行、证据分型和 fail-closed 门禁，不引入自由 Agent 框架的架构决策 |
| DIGITAL_ASSET_PROCESSING_GOVERNANCE.md | 企业数字资产从原始保存、规范化、结构化、质量门禁、人工审核到发布、撤回和规则自动化演进的总体方案 |
| data-quality-audit.md | 数据质量、脏数据治理、信任边界、数据血缘与当前本地实施证据的只读审计基线 |
| superpowers/specs/2026-07-24-digital-master-agent-design.md | “问”模块最终 Agent 产品/架构边界，以及当前已实现与后续工具范围 |
| superpowers/plans/2026-07-24-digital-master-agent.md | Agent 实施、自动化/H5/浏览器验证记录和剩余专项生产/真机验收边界 |
| superpowers/plans/2026-07-31-mobile-citation-source-viewer.md | 手机端回答引用点击全文、图片和视频定位的分阶段实施计划；每阶段必须记录自动化、权限、Range、性能、生产和真机实际结果 |
| P0_PILOT_ACCEPTANCE_CHECKLIST.md | 正式试点执行模板：按当前批次填写角色、窗口与证据；不在仓库保存个人身份、验证码或旧窗口结论 |
| 20260718/问师傅多轮会话与原始资料交付设计.md | Agent 底层复用的知识短会话、指代改写、意图路由和受控原文件/视频交付契约 |
| KNOWLEDGE_PLATFORM_RUNBOOK.md | 银城/美途知识空间初始化、授权、令牌、内容迁移、监控验证和安全回滚手册 |
| RUOYI_AI_INCREMENTAL_MIGRATION.md | 从 ageerle/ruoyi-ai 分片迁移知识库、模型能力、文档解析、Qdrant/RAG 和 chat 的执行边界 |
| superpowers/specs/2026-07-16-multi-tenant-knowledge-platform-design.md | 银城/美途独立租户、多知识空间、多调用应用统一问答、授权交集、受控数据工具和安全验收的完整需求方案 |
| superpowers/plans/2026-07-16-multi-tenant-knowledge-platform.md | 多租户多知识空间统一问答平台按 schema、授权、检索、上传、数据工具、管理端、多端联调和发布拆分的实施计划 |
| AI人力资源系统项目规划方案与AI接口说明.md | 对外会议版口径、数字师傅定位、AI 接口和供应商规划 |
| 银城员工端APP分阶段实施总纲.md | 三阶段总纲:陪练 → 大喇叭+知识学习平台(含学模块、开放问题榜、员工个人 AI 助理) → 北森对接;身份三轴模型与防遗漏分发策略 |
| 个人AI助理阶段二专项TechSpec.md | 工作助手确认式统一采集的当前契约，以及后续个人知识空间的数据分域、检索、权限、安全和测试规格 |
| 工作助手与今日工作成果迭代计划-20260721.md | 工作助手项目选择、统一采集、来源追溯、今日成果、主管视图、成果投稿和外部流转的分阶段计划；含本地实施状态、390×844 证据和剩余生产边界 |
| 帮道产品功能优先级与实施计划-20260721.md | 2026-07-21 历史优先级快照；只用于追溯当时事实校正，当前状态以 BRD 审查为准 |
| 帮道-练与银城大喇叭功能介绍.md | “练”、公司消息和问模块的产品介绍；实现与验收状态仍以 BRD 审查为准 |
| 银城大喇叭与问模块纠偏增量方案-20260722.md | 已部署的大喇叭、单文件提炼、多岗位解读、消息追问和独立五通道直通车边界，以及仍待补齐的定向正反例、修订、补推和强触达 |
| superpowers/specs/2026-07-24-company-message-nine-capabilities-design.md | 图示九项公司消息能力的归并口径、R1—R3 当前架构与明确不承担的聊天、工单、SLA 边界 |
| M0自动化验收说明.md | 本机受控写入的“发布—阅读—追问—撤回”接口验收边界、运行方式与清理约束 |
| 个人AI助理阶段二开发推进计划.md | 后续个人资料/网页/PPT 能力的 P0/P1 任务计划；“记一下”当前实现以专项 TechSpec 为准 |
| prototypes/personal-assistant-work-helper-voice-first-v2.png | 个人助理并入「问 · 数字师傅」后的语音优先会话、自动内部路由与确认记忆卡实现基准 |
| prototypes/work-report-voice-conversation-v1.png | 当前“工作上报”（产品目标名“成果投稿”）会话式页面的视觉回归基准；不代表工作助手日常采集或今日成果页 |
| prototypes/work-assistant-project-context-v3.png | 工作助手多项目、项目化确认卡与今日成果的权威高保真输入；运行截图另见迭代计划 §1.5 |
| visual-evidence/20260721/ | 工作助手项目选择、确认卡、员工今日成果和主管项目成果的 390×844 本地运行截图证据 |
| presentations/数字师傅工作助手迭代汇报-20260721.pptx | 工作助手、多项目、今日成果、权限与发布边界的 5 页内部汇报稿 |
| AI陪练完整交付计划-20260724.md | 当前阶段一“练”模块的唯一后续施工范围：住宅物业 × 五岗位 × 三级成长；定义现有基线、收口动作、验收门槛与明确不做项 |
| 帮道8月1日Android安装包测试版任务计划-20260727.md（Word 同步版） | 2026-08-01 Android 受控内测 APK 的冻结范围、P0 任务、倒排日程、真机门禁、Go/No-Go 与后续边界；Markdown 为事实源 |
| AI陪练二期开发推进计划.md | 2026-07-11 历史推进记录；保留 M0-M5 的工程追溯，不再作为当前施工范围 |
| 员工端版本功能对比与功能对齐清单-20260717.md | 旧版/历史需求/当前实现/生产验收的版本对比，以及 2026-07-17 客户反馈逐项处理结果 |
| BRD_IMPLEMENTATION_AUDIT.md | 当前生产基线、尚未部署的本地增量、三端输入/BRD 匹配、客户反馈完成分层和正式试点剩余硬门槛；旧发布流水从当前真相源移除 |
| BRD_PRODUCTION_MIGRATION_RUNBOOK.md | AIHR BRD 生产 schema/内置内容迁移顺序、结构核验、当前运行基线、单项热修复回滚和发布后回归口径 |
| 20260708/uni-app用户侧前端重建计划.md | mobile-uni/ 重建阶段留档；当前完成状态以 BRD 审查和版本功能对比为准 |
| 20260708/数字师傅学练问报整合方案.md | 产品定义(学练问报+问题榜+学分晋升+个人 AI 助理)及 v1.8 “问”模块 Agent 关联与实施边界 |
| 20260708/发布会演示候选题单.md | 2026-07-08 发布会演示候选题单，作为产品讨论留档，不作为阶段一开发入口 |
| 基于AI的银城员工端APP项目立项与开发规划会议-2026年07月07日-来自【Get 笔记】.md | 2026-07-07 立项会纪要原文(总纲的输入源,只作留档) |
| 20260708/企业内部AI培训学习APP产品需求与发布会内容讨论(纪要) | 2026-07-08 产品讨论纪要原文及客户"第三版"docx(整合方案的输入源,只作留档) |
| open-org-sync-api-design-v1.md | 开放组织同步系统 /api/open/v1 接口设计,POST /api/aihr/org/sync 的外部契约 |
| 物业AI人力资源系统业务需求文档BRD.md | 业务需求、范围边界、角色、风险与验收 |
| 物业AI人力资源系统开发规格TechSpec.md | 工程结构、数据模型、页面路由、API 和核心实现规格 |
| BACKLOG.md | 需求池与延后事项（B1–B8：数据权限/人设语音/生成图片/生成视频/员工画像/视觉检索/数字师傅） |
| H5_REDESIGN.md | H5 前端重构设计蓝本（随身师傅定位、双引擎首页、答案卡、岗位化、路线图） |
| AI陪练功能优化与缺口分析(修订).md | 陪练功能缺口 24 项核实修订与排期建议（原 docx 的代码实况校对版，排期以此为准） |
| PC管理端功能差异TODO.md | 阶段一管理端差异与阶段二/三延后项；不作为当前阶段一完成证明 |
| feedback/ | 用户反馈原始截图与解读（按日期归档，含 ANALYSIS.md） |
| CODEBASE_ORIGINS.md | 代码库来源与上游仓库说明 |
| prototypes/ai-hr-dashboard.png | 后台首页高保真目标图 |
| prototypes/ai-hr-p0-pages-composite.png | P0 四个页面组合高保真原型图 |
| prototypes/员工端-首页.png | 移动端员工/用户端首页目标图 |
| prototypes/候选人端-首页.png | 移动端候选人端首页目标图 |
| prototypes/主管端-首页.png | 移动端主管端首页目标图 |
参考材料
| 路径 | 用途 |
|---|---|
| WORK_REPORT_IMPLEMENTATION_AGENT_PROMPT.md | 已完成的工作上报会话化历史实施说明，仅保留当前边界和后续权威入口，不再作为可执行 Prompt |
| legacy/物业AI陪练系统一期建设实施方案.md | 旧陪练系统一期方案，作为 HR 系统范围收敛的参考 |
| legacy/物业AI陪练系统建设方案研判报告.md | 旧陪练系统方案研判 |
阶段归档
这些文件只作阶段交付留档，不作为当前施工入口。
| 路径 | 用途 |
|---|---|
| archive/2026-07-mvp-delivery/ | 2026-07 MVP 作战清单、演示 PPT 和阶段交付材料 |
Word 原件
这些文件只作归档，不作为开发入口。