环境准备与本地启动

工作目录与准备

前端工程位于 ui/frontend，使用 uni-app、Vue 3 与 Vite。准备 Git、项目依赖支持的 Node.js/npm、微信开发者工具，并取得目标环境的受控配置。以当前 lockfile 和构建环境为准，不随意升级依赖。

从仓库根目录执行：

cd ui/frontend
node --version
npm --version
npm ci
npm run env:status

.env.local 需要由项目交付渠道提供。缺少配置时先核对运行参数，不把他人的凭据复制到代码中。

npm run dev

开发入口由当前工具链输出决定。需要项目封装的 H5 后台启动与状态查询时，使用 npm run dev:h5:start、npm run dev:h5:status 和 npm run dev:h5:stop。

npm run build -- mp-weixin

该命令生成日常开发包，并执行项目的小程序构建修补流程。微信开发者工具打开 ui/frontend/dist/build/mp-weixin，核对实际 AppID、接口环境和构建信息。日常开发不递增发布版本。

先确认首页公开数据可读，再验证登录与本人资料，最后进入目标业务。H5 可验证部分页面和合同，不能代替微信原生授权、分享送达与真机播放。

构建失败先保留首个错误，检查 Node 版本、依赖锁及环境参数；不要通过手工修改生成物掩盖源码或合同问题。文档站是独立 Node 工程，启动方式见维护手册。