dev-screen-starter/doc/delivery-workflow.md

75 lines
1.3 KiB
Markdown

# 大屏项目交付流程
## 1. 接需求
确认内容:
- 屏幕尺寸和播放设备。
- 是否 1920x1080、4K、拼接屏或特殊比例。
- 页面数量。
- 指标定义。
- 数据接口来源。
- 刷新频率。
- 是否需要实时推送。
- 是否需要离线展示。
- 客户视觉参考。
## 2. 新建项目
```bash
pnpm new customer-a 客户A运营大屏
pnpm install
pnpm --filter @dev-screen-starter/customer-a dev
```
## 3. 实现页面
推荐顺序:
1. 先定设计稿尺寸和布局。
2. 写静态页面。
3. 接 mock 数据。
4. 接真实接口。
5. 做不同屏幕适配验证。
6. 做截图验收。
## 4. 数据接入
低频数据:
- HTTP + `usePollingData`
中频数据:
- SSE 或 WebSocket
高频数据:
- 项目单独实现实时通道,不放进 starter 的默认能力。
## 5. 验收
检查项:
- 目标屏幕比例下没有裁切错误。
- 4K 或客户实际设备下文字清晰。
- 图表 resize 正常。
- loading、empty、error 状态可接受。
- 接口断开时页面不崩溃。
- 浏览器全屏展示正常。
- 构建产物可以独立部署。
## 6. 部署
推荐:
- `pnpm --filter <project> build`
- 将 `dist/` 部署到 Nginx 或客户静态服务。
- 数据接口通过环境变量配置。
后续可以补充:
- Dockerfile
- Nginx config
- CI 构建脚本