Browse Source

docs(home): record post-merge review

anubis 1 month ago
parent
commit
0542e8797a

+ 2 - 2
01-项目文档_docs/00-项目管理/03-交付验收/功能模块总进度表.md

@@ -34,7 +34,7 @@
 | PRI-MP-BASE-001 | 基础框架与应用壳层 | 已归档 | 开发者 AI | 2026-06-22 | feature/PRI-MP-BASE-001-app-shell | pri-mp-base-001-app-shell | 已完成基础壳层源码、OpenSpec change、静态自检、微信开发者工具导入运行确认,并已合并回 develop | 2026-06-22 开发者自检验收 Agent 静态审查通过,源码层面未发现阻塞缺陷 | 2026-06-22 项目管理复核通过 | 无阻塞问题反馈 | OpenSpec 已归档至 `openspec/changes/archive/2026-06-22-pri-mp-base-001-app-shell`;归档总结:`01-项目文档_docs/06-归档总结/01-模块归档总结/2026-06-22_PRI-MP-BASE-001_归档总结.md` |
 | PRI-MP-COMMON-001 | 上传下载与服务器资源复用 | 已归档 | 开发者 AI | 2026-07-07 | feature/PRI-MP-COMMON-001-resource-reuse | pri-mp-common-001-resource-reuse | `c0f2d88` 实现资源复用工具;`6a20e62` 已串行合并回 develop;`355dd3e` 按旧源码补齐咨询/患者照片资源地址拼接;增强 `utils/resource.js` 和 `utils/hospital.js`,补齐资源 URL 归一、上传 URL/下载 URL 归一、`wx.uploadFile`/`wx.downloadFile` 封装、上传返回解析和错误兜底 | 2026-07-07 开发者自检通过,报告:`01-项目文档_docs/04-验收报告/01-模块验收报告/2026-07-07_PRI-MP-COMMON-001_开发者自检验收报告.md`;OpenSpec strict 通过;JS/JSON 静态检查通过 | 项目管理复核通过,已归档;主 Agent 集成准备报告:`01-项目文档_docs/04-验收报告/02-专项评审与审查/2026-07-07_PRI-MP-COMMON-001与PRI-MP-CONTENT-001_主Agent集成复核准备报告.md` | 无阻塞问题反馈;真实微信合法域名、真实上传/下载环境需人工联调 | 覆盖旧源码资源 host、图片拼接、上传下载、加载失败兜底;当前模块目录:`01-项目文档_docs/03-功能模块/已归档_PRI-MP-COMMON-001_上传下载与服务器资源复用`;OpenSpec 已归档至 `openspec/changes/archive/2026-07-07-pri-mp-common-001-resource-reuse`;正式 spec:`openspec/specs/resource-reuse/spec.md`;归档总结:`01-项目文档_docs/06-归档总结/01-模块归档总结/2026-07-07_PRI-MP-COMMON-001_归档总结.md`。 |
 | PRI-MP-COMMON-002 | WebView、PDF 与外部预览能力 | 已归档 | 主 Agent | 2026-07-09 | feature/PRI-MP-COMMON-002-webview-preview | pri-mp-common-002-webview-preview | `4ed0709` 实现统一 `utils/preview.js`、`pages/common/webview`、`pages/common/preview`,注册路由并回接科普外链、眼健康文章和订单发票预览;`9053fc6` 已由主 Agent 串行合并回 develop;`80e8fcd` 完成 OpenSpec archive | 2026-07-09 开发者自检通过,报告:`01-项目文档_docs/04-验收报告/01-模块验收报告/2026-07-09_PRI-MP-COMMON-002_开发者自检验收报告.md`;OpenSpec strict、JS/JSON 静态检查、git diff --check 通过 | 2026-07-09 项目管理复核有条件通过,报告:`01-项目文档_docs/04-验收报告/01-模块验收报告/2026-07-09_PRI-MP-COMMON-002_项目管理复核验收报告.md`;OpenSpec archive 完成 | 无阻塞问题反馈;WebView 业务域名、downloadFile 合法域名、PDF/openDocument、previewImage 真机表现需人工联调 | 当前模块目录:`01-项目文档_docs/03-功能模块/已归档_PRI-MP-COMMON-002_WebView、PDF与外部预览能力`;正式 spec:`openspec/specs/webview-preview/spec.md`;归档总结:`01-项目文档_docs/06-归档总结/01-模块归档总结/2026-07-09_PRI-MP-COMMON-002_归档总结.md`。 |
-| PRI-MP-HOME-001 | 首页与医院配置 | 已归档 | 开发者 AI / 项目管理主 Agent | 2026-08-03 | feature/PRI-MP-HOME-001-home-hospital;fix/PRI-MP-HOME-001-design-coverage-hardening;feature/PRI-MP-HOME-001-home-ui-style-experiment | pri-mp-home-001-home-hospital;pri-mp-home-001-design-coverage-hardening;pri-mp-home-001-service-icon-text-wrap(均已归档);pri-mp-home-001-home-ui-style-experiment(正式采用待集成) | 原模块与历史 follow-up commits 保留;首页新版 UI commits `5819fe5`、`e7530c0`、`b00693b`、`1339f00`、`8ea0309`、`06d0577`;正式采用 `2f3a5a4`;同步最新 develop `c9dfe90` | 2026-08-03 首页新版 UI 开发者自检通过,报告:`01-项目文档_docs/04-验收报告/01-模块验收报告/2026-08-03_PRI-MP-HOME-001_开发者自检验收报告.md`;17 项离线测试、文档链接、OpenSpec strict 与差异检查通过 | 项目负责人确认当前首页为首页专项正式基线,五个一级页面原生视觉和科普真实链路验证通过;其他页面 UI 标准保持不变;待合并后项目管理复核 | 无新增阻塞问题;发布前继续由微信开发者工具检查实际上传包体 | 历史 archive 保持不变;active change `openspec/changes/pri-mp-home-001-home-ui-style-experiment` 已转为正式采用口径,待合并、项目管理复核和后续 archive;首页专项素材约 205KB,Phosphor MIT 许可随源码保留 |
+| PRI-MP-HOME-001 | 首页与医院配置 | 已归档 | 开发者 AI / 项目管理主 Agent | 2026-08-03 | feature/PRI-MP-HOME-001-home-hospital;fix/PRI-MP-HOME-001-design-coverage-hardening;feature/PRI-MP-HOME-001-home-ui-style-experiment | pri-mp-home-001-home-hospital;pri-mp-home-001-design-coverage-hardening;pri-mp-home-001-service-icon-text-wrap(均已归档);pri-mp-home-001-home-ui-style-experiment(正式采用已集成、待归档) | 原模块与历史 follow-up commits 保留;首页新版 UI commits `5819fe5`、`e7530c0`、`b00693b`、`1339f00`、`8ea0309`、`06d0577`;正式采用 `2f3a5a4`;同步最新 develop `c9dfe90`;主 Agent 集成 `1c21478` | 2026-08-03 首页新版 UI 开发者自检通过,报告:`01-项目文档_docs/04-验收报告/01-模块验收报告/2026-08-03_PRI-MP-HOME-001_开发者自检验收报告.md`;17 项离线测试、文档链接、OpenSpec strict 与差异检查通过 | 2026-08-03 项目管理复核通过,报告:`01-项目文档_docs/04-验收报告/01-模块验收报告/2026-08-03_PRI-MP-HOME-001_项目管理复核验收报告.md`;项目负责人确认当前首页为首页专项正式基线,五个一级页面原生视觉和科普真实链路通过,其他页面 UI 标准不变 | 无新增阻塞问题;发布前继续由微信开发者工具检查实际上传包体 | 首页正式基线已合并 `develop`;历史 archive 保持不变;active change `openspec/changes/pri-mp-home-001-home-ui-style-experiment` 待后续流程归档;首页专项素材约 205KB,Phosphor MIT 许可随源码保留 |
 | PRI-MP-USER-001 | 就诊人列表与选择组件 | 已归档 | 开发者 AI | 2026-06-25 | feature/PRI-MP-USER-001-patient-selector | pri-mp-user-001-patient-selector | 6 个 commit 已 fast-forward 合并至 `develop` 并 push 至 `origin/develop`(`381561f..7d38d96`):`0424d86`、`68073e0`、`8b1b1f6`、`9b8f8aa`、`6db01aa`、`7d38d96`;2026-06-25 主 Agent 直接修复极短敏感字段脱敏边界 | 2026-06-24 开发者自检验收 Agent 通过,报告:`01-项目文档_docs/04-验收报告/01-模块验收报告/2026-06-24_PRI-MP-USER-001_开发者自检验收报告.md` | 2026-06-25 项目管理复核通过,报告:`01-项目文档_docs/04-验收报告/01-模块验收报告/2026-06-25_PRI-MP-USER-001_项目管理复核验收报告.md`;OpenSpec validate 通过 | `01-项目文档_docs/05-问题反馈/01-模块问题反馈/2026-06-25_PRI-MP-USER-001_项目管理复核问题反馈.md`:P2 脱敏边界已整改;开发者自检 hotfix 反馈仍保留索引 | OpenSpec 已归档至 `openspec/changes/archive/2026-06-25-pri-mp-user-001-patient-selector`;正式 spec:`openspec/specs/patient-selector/spec.md`;归档总结:`01-项目文档_docs/06-归档总结/01-模块归档总结/2026-06-25_PRI-MP-USER-001_归档总结.md` |
 | PRI-MP-HOME-002 | 医院选择与切换 | 已归档 | 开发者 AI | 2026-06-30 | feature/PRI-MP-HOME-002-hospital-switch;最终归档基线为 `develop` | pri-mp-home-002-hospital-switch | 当前 `develop` 已包含医院选择与切换核心能力:当前医院显示、搜索、省份筛选、距离排序、真实 `02010009`、字段归一、切换后缓存/全局态同步;同时已包含首页医院卡恢复(`c953075`)、主 Agent 审查记录(`61a14a9`)和医院简介优化(`faf3851`)。本次只同步文档状态,不修改已完成功能代码 | 2026-06-25 开发者自检有条件通过,报告:`01-项目文档_docs/04-验收报告/01-模块验收报告/2026-06-25_PRI-MP-HOME-002_开发者自检验收报告.md`;2026-06-30 代码包含性复核通过 | 2026-06-30 项目管理复核通过,报告:`01-项目文档_docs/04-验收报告/01-模块验收报告/2026-06-30_PRI-MP-HOME-002_项目管理复核验收报告.md`;OpenSpec archive 通过 | `01-项目文档_docs/05-问题反馈/01-模块问题反馈/2026-06-25_PRI-MP-HOME-002_开发者自检问题反馈.md`:真实接口字段映射和刷新链路提示项已按代码复核关闭;腾讯地图 key 为空保留为配置项,不阻塞归档 | OpenSpec 已归档至 `openspec/changes/archive/2026-06-30-pri-mp-home-002-hospital-switch`;正式 spec:`openspec/specs/hospital-switch/spec.md`;归档总结:`01-项目文档_docs/06-归档总结/01-模块归档总结/2026-06-30_PRI-MP-HOME-002_归档总结.md` |
 | PRI-MP-HOME-003 | 找医生与医生详情 | 已归档 | 开发者 AI | 2026-07-03 | feature/PRI-MP-HOME-003-doctor-search-detail;最终归档基线为 `develop` | pri-mp-home-003-doctor-search-detail | `91f1814 feat(PRI-MP-HOME-003): implement doctor search detail`;`07f1aa8 docs(PRI-MP-HOME-003): mark doctor module ready for review`;新增找医生、专家团队、医生详情、我的医生页面和医生领域工具,首页专家团队/找医生入口、挂号入口承接、OpenSpec change 与自检报告已提交;OpenSpec archive 已执行 | 2026-07-03 开发者自检通过,报告:`01-项目文档_docs/04-验收报告/01-模块验收报告/2026-07-03_PRI-MP-HOME-003_开发者自检验收报告.md`;JS/JSON/OpenSpec strict、禁止 mock、禁止越界接口扫描均通过;项目复核同步补齐验收清单勾选 | 2026-07-03 项目管理复核有条件通过,报告:`01-项目文档_docs/04-验收报告/01-模块验收报告/2026-07-03_PRI-MP-HOME-003_项目管理复核验收报告.md`;OpenSpec archive 完成,正式 spec:`openspec/specs/doctor-search-detail/spec.md` | 无阻塞问题反馈;真实扫码加密串、正式接口字段、关注/取消关注真实写操作结果待人工用例确认 | OpenSpec 已归档至 `openspec/changes/archive/2026-07-03-pri-mp-home-003-doctor-search-detail`;归档总结:`01-项目文档_docs/06-归档总结/01-模块归档总结/2026-07-03_PRI-MP-HOME-003_归档总结.md`;承接搜索医生/科室、热门/全部科室、搜索历史、推荐医生、医生详情、扫码医生详情、关注医生、我的医生和医生排班只读入口;不包含挂号下单、咨询支付、IM/TRTC、真实支付、医保;关注/取消关注 `03100126/03100127` 按旧源码真实链路执行;当前模块目录:`01-项目文档_docs/03-功能模块/已归档_PRI-MP-HOME-003_找医生与医生详情`。 |
@@ -91,7 +91,7 @@ AI 验收完成后,由验收 Agent 或项目负责人更新:
 | 模块 | 开发归档状态 | 当前全量验收状态 | corrective OpenSpec / 当前处理 | 当前阻塞或下一步 |
 | --- | --- | --- | --- | --- |
 | PRI-MP-BASE-001 | 已归档 | 静态回归通过,人工终验待验证 | `archive/2026-07-29-pri-mp-base-001-security-boundary` | 固定 Basic 与旧版 IM 客户端签名链已按负责人裁定统一;源码及离线检查通过,待 TIM/TRTC 最终人工用例。 |
-| PRI-MP-HOME-001 | 已归档 | 首页新版 UI 原生视觉与科普链路人工验证通过;静态回归通过 | `pri-mp-home-001-home-ui-style-experiment`(正式采用待集成) | 项目负责人确认当前首页为首页专项正式基线,其他页面 UI 标准不变;待主 Agent 合并后完成项目管理复核,发布前检查实际上传包体。 |
+| PRI-MP-HOME-001 | 已归档 | 首页新版 UI 原生视觉与科普链路人工验证通过;静态回归及项目管理复核通过 | `pri-mp-home-001-home-ui-style-experiment`(已集成、待归档) | 首页正式基线已合并 `develop@1c21478`,其他页面 UI 标准不变;发布前检查实际上传包体。 |
 | PRI-MP-HOME-002 | 已归档 | 待全量验收 | — | L1 医院切换、缓存和跨模块上下文。 |
 | PRI-MP-HOME-003 | 已归档 | 待全量验收 | — | L1 医生查询、详情与排班入口;扫码/关注写操作受控验证。 |
 | PRI-MP-CONTENT-001 | 已归档 | 静态回归通过 | `pri-mp-content-001-webview-allowlist` | L1 验证业务域名白名单、失败回调与返回。 |

+ 1 - 0
01-项目文档_docs/03-功能模块/已归档_PRI-MP-HOME-001_首页与医院配置/README.md

@@ -75,6 +75,7 @@ source_dir: 04-新项目源码_source/pri-smart-hospital-miniprogram
 - 首页专项本地素材约 205KB;三张 Banner 和吉祥物来源于已提交临时稿,图标来源于 Phosphor 2.1.1 MIT。实际上传包体继续纳入发布工具检查。
 - 本次采用不改变模块历史 `已归档` 状态;active change 在合并和项目管理复核后再按流程 archive。
 - 正式采用提交:`2f3a5a4`;同步最新 `develop@e3912dd` 的合并提交:`c9dfe90`。同步后全量固定检查通过。
+- 主 Agent 串行集成提交:`1c21478`;项目管理复核通过,报告:`01-项目文档_docs/04-验收报告/01-模块验收报告/2026-08-03_PRI-MP-HOME-001_项目管理复核验收报告.md`。active change 待后续按流程 archive。
 
 ## 必读顺序
 

+ 85 - 0
01-项目文档_docs/04-验收报告/01-模块验收报告/2026-08-03_PRI-MP-HOME-001_项目管理复核验收报告.md

@@ -0,0 +1,85 @@
+# 2026-08-03 PRI-MP-HOME-001 项目管理复核验收报告
+
+## 1. 复核结论
+
+结论:**通过,允许将集成结果推送至 `origin/develop`**。
+
+项目负责人已明确裁定:当前首页作为首页专项正式基线;五个一级页面原生视觉、共享 TabBar 一致性和科普真实链路验证通过;除首页及共享底部导航外,其他页面继续执行现行 UI 标准。
+
+主 Agent 已从最新 `origin/develop@e3912dd` 以无快进方式串行合并 `feature/PRI-MP-HOME-001-home-ui-style-experiment@bbdc3f1`,集成提交为 `1c21478`。合并过程无冲突,合并后固定检查全部通过。
+
+## 2. 集成污染检查
+
+| 检查项 | 结果 |
+| --- | --- |
+| 目标分支基线 | `origin/develop@e3912dd` |
+| 待集成分支 | `feature/PRI-MP-HOME-001-home-ui-style-experiment@bbdc3f1` |
+| 集成提交 | `1c21478 merge(home): adopt homepage UI baseline` |
+| 合并冲突 | 无 |
+| 工作区状态 | 合并后干净;仅后续复核文档待提交 |
+| 变更规模 | 59 个文件,新增 3592 行、删除 152 行 |
+| 输入资料 | 仅包含上游 `develop` 已有的临时原型 CSS 一行变更,本次没有改写设计输入 |
+| 公共能力 | 未修改公共请求、登录、支付、医保、实名、处方、IM/TRTC 底层契约 |
+
+## 3. 设计与 UI 口径复核
+
+通过。
+
+1. `新版UI标准.md` 仅新增“首页专项正式基线”章节,没有修改其他页面的颜色、字号、间距、组件、表单、详情或高风险业务页面标准。
+2. 首页正式基线覆盖顶部、五类轮播、快捷就医、常用服务、推荐医生、医院信息、健康科普和共享 TabBar。
+3. 原历史临时原型继续只作为来源证据;后续首页执行标准为正式源码、`home-hospital` OpenSpec 和项目负责人裁定。
+4. 首页紧凑顶部的视觉高度保持不变,透明触控热区扩展到不小于 `88rpx`,并补充可访问标签。
+5. 项目负责人确认原生视觉验证通过;仓库未伪造 Codex 本地微信开发者工具截图。
+
+## 4. 真实链路与入口语义复核
+
+通过。
+
+- 医院、就诊人、待办、菜单、医生、科普、公告、当前就诊与复诊数据继续来自真实接口或现行缓存状态。
+- 当前就诊、复诊、缴费、报告、就诊码、医院切换、AI 导诊、医生预约、检查预约、科普等入口均进入现有下游模块。
+- 首页没有重复实现支付、医保、预约提交、处方、患者写入或 IM/TRTC 高风险能力。
+- 接口失败与确认空结果保持区分,没有以原型静态患者、医生、时间或临床结论替代真实结果。
+- 项目负责人已确认科普真实链路在最新修复后验证通过。
+
+## 5. 状态与视觉证据矩阵复核
+
+| 范围 | 正常态 | 小屏/长文本 | 加载/空/错 | 禁用/上下文缺失 | 结论 |
+| --- | --- | --- | --- | --- | --- |
+| 首页 | 项目负责人原生验证 | 320px 几何与截断门禁 | 骨架、局部空态、重试保留 | 医院/就诊人/登录引导保留 | 通过 |
+| 五个一级 Tab | 项目负责人原生验证 | 等宽布局与统一图标门禁 | 消息角标动态保留 | 防重复点击保留 | 通过 |
+| 常用服务 | 项目负责人原生验证 | 四列等宽 grid 门禁 | 固定真实入口 | 不可用能力有明确边界 | 通过 |
+| 科普 | 项目负责人真实链路验证 | 标题截断/列表跳转保留 | 加载、空、错、重试保留 | 外链按既有白名单 | 通过 |
+
+## 6. 素材与包体复核
+
+- 首页专项素材 30 个文件,共 209909 bytes,约 205KB。
+- Banner 和吉祥物来源于已提交设计输入;项目负责人已确认当前首页进入正式基线。
+- Phosphor 2.1.1 MIT 许可随源码保留;医生样例图未进入业务源码。
+- 静态候选包体约 2.70MiB,不等同于微信压缩后的实际上传包。当前环境无微信开发者工具,本轮不以首页变更为由重构全项目分包;实际上传包分析继续作为发布检查项。
+
+## 7. 固定检查证据
+
+合并提交 `1c21478` 上执行:
+
+| 检查 | 结果 |
+| --- | --- |
+| `npm run validate:source` | 117 条路由、189 个业务 JS、128 个 JSON 通过 |
+| `npm test` | 17 项离线测试全部通过 |
+| `npm run validate:docs` | 831 个文档文件、3 个本地链接通过 |
+| `npm run validate:openspec` | strict:38 项通过、0 失败 |
+| `git diff --check origin/develop...HEAD` | 通过 |
+
+新增本报告后已再次执行文档链接、OpenSpec strict 和差异检查:832 个文档文件、3 个本地链接通过,38 项 OpenSpec strict 全部通过,差异检查通过;可随集成结果推送 `develop`。
+
+## 8. 问题与剩余事项
+
+无阻塞问题反馈。
+
+保留两个非阻塞后续事项:
+
+1. 发布前在微信开发者工具检查实际上传包体。
+2. 项目管理复核与 `develop` 推送完成后,active change `pri-mp-home-001-home-ui-style-experiment` 再按 OpenSpec 流程归档;本次不伪造历史试验目录名,也不在本报告中直接 archive。
+
+## 9. 回退策略
+
+如需整体撤销,通过 `1c21478` 合并提交执行可审计回退;如仅有局部入口或样式问题,另建 HOME corrective change。任何回退均不得删除或改写下游真实业务模块和接口契约。

+ 1 - 1
openspec/changes/pri-mp-home-001-home-ui-style-experiment/tasks.md

@@ -70,4 +70,4 @@
 - [x] 9.3 在不改变已验收视觉尺寸的前提下,将顶部可点击控件透明热区扩展到不小于 `88rpx` 并补充可访问标签。
 - [x] 9.4 复核素材来源和包体增量:首页专项素材约 205KB;保留原始来源及 Phosphor MIT 许可,实际上传包体继续纳入发布工具检查。
 - [x] 9.5 完成开发者自检验收材料、全量固定检查和最新 `develop` 同步。
-- [ ] 9.6 由主 Agent 串行合并并推送 `develop`,合并后执行项目管理复核;OpenSpec archive 仍按项目流程另行执行。
+- [x] 9.6 由主 Agent 串行合并并推送 `develop`,合并后项目管理复核通过;OpenSpec archive 仍按项目流程另行执行。