# 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 派生展厅/展项，以及讲解列表显示“暂无音频”；该方向已通过静态质量门，但仍需人工浏览器/真实设备验收和交付边界确认。
- 项目整体仍有用户流程闭环风险，需在下一轮集中处理搜索、详情、路线、设施选择、返回/取消/重试等关键链路。