2.2 KiB
2.2 KiB
部署与上线检查清单
本文档用于客户大屏项目交付前的最后检查。
1. 本地构建
pnpm install
pnpm typecheck
pnpm build
单个客户项目构建:
pnpm --filter @dev-screen-starter/customer-a build
2. 环境变量
新项目会带 .env.example:
VITE_API_BASE_URL=http://localhost:3000
VITE_WS_URL=ws://localhost:3000/ws/screen
VITE_ENABLE_STAGE_DEBUG=true
交付环境建议:
- 开发环境可以打开
VITE_ENABLE_STAGE_DEBUG=true。 - 生产环境建议关闭调试浮层。
- API 和 WebSocket 地址不要写死在组件里,统一放到
dataSources.ts或.env。
3. Nginx 静态部署
构建完成后,把对应项目的 dist 发布到静态服务器。
示例 Nginx 配置在:
deploy/nginx.conf
4. Docker 部署
默认构建 demo:
docker build -t dev-screen-demo .
docker run --rm -p 8080:80 dev-screen-demo
构建指定客户项目:
docker build \
--build-arg APP_FILTER=@dev-screen-starter/customer-a \
--build-arg APP_PATH=apps/customer-a \
-t customer-a-screen .
5. 屏幕适配验收
至少检查这些尺寸:
1366x7681920x10802560x14403840x2160
至少检查这些模式:
?scaleMode=fit?scaleMode=fill?scaleMode=stretch
默认建议生产使用 fit。
6. 数据接入检查
- HTTP 数据源是否配置
baseUrl、timeoutMs、错误兜底。 - WebSocket 是否配置
reconnect和heartbeat。 - 实时列表是否设置
maxItems。 - 图表数据是否在
transform中清洗成组件需要的结构。 - 断网、接口 500、空数据时页面是否仍可读。
7. 视觉检查
- 标题、指标、图例、坐标轴在 1080p 和 4K 下都清晰。
- 自动滚动列表没有超出父容器。
- 图表容器没有空白 canvas。
- 关键数字没有挤压、换行或遮挡。
- 客户看屏页面不出现开发调试信息。
8. 上线前清单
pnpm typecheck通过。pnpm build通过。- 客户接口地址已切换为正式地址。
.env未提交到 git。- 生产关闭
VITE_ENABLE_STAGE_DEBUG。 - 浏览器全屏查看无滚动条、无遮挡。
- 大屏实际设备上验收一次。