frontend-miniapp/docs/pdca/plan.md

PDCA 计划

项目：深圳自然博物馆 H5 智能导览前端

当前目标：完成 guide.whaoyue.com H5 部署闭环，确保馆内 3D 模型资源可稳定加载，并把上线验证、风险、后续用户流程闭环工作纳入可追踪进度。

范围

• H5 模式构建与部署。
• Nginx、SSL、静态资源和模型资源服务配置。
• 馆内 3D 模型加载链路，包括 manifest、楼层 GLB、POI 数据和缺失资源处理。
• 部署说明、验证记录、风险和后续行动管理。

暂不覆盖

• 微信小程序 mp-weixin 发布。
• 真实内容数据最终验收。
• 全量用户流程闭环修复，这部分当前作为后续行动和风险跟踪。

成功指标

• pnpm build:h5 成功，且 H5 产物包含 static/nav-assets。
• pnpm type-check 成功。
• Nginx 配置测试成功并 reload。
• 线上 manifest 返回 application/json。
• 线上 GLB 返回 model/gltf-binary。
• 缺失模型资源返回 404，不返回 index.html。
• 馆内 3D 默认加载当前楼层模型，降低首屏解析压力。
• 部署文档和 PDCA 进度可审计。

当前判断

• 部署与模型请求修复已完成。
• 2026-06-12 当前工作区复核：pnpm type-check、pnpm lint、pnpm build:h5、pnpm build:mp-weixin 均通过；lint 仍有 18 个历史 warning，构建仍有 Sass legacy API warning，均不阻断。
• 2026-06-12 线上 HTTP 复核：https://guide.whaoyue.com/ 返回 200，manifest 返回 200 JSON，L1.glb 返回 200 model/gltf-binary，缺失 GLB 返回 404。
• 当前未提交改动包含讲解内容数据源改为从导览资源包 POI 派生展厅/展项，以及讲解列表显示“暂无音频”；该方向已通过静态质量门，但仍需人工浏览器/真实设备验收和交付边界确认。
• 项目整体仍有用户流程闭环风险，需在下一轮集中处理搜索、详情、路线、设施选择、返回/取消/重试等关键链路。