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

1.3 KiB

大屏项目交付流程

1. 接需求

确认内容:

  • 屏幕尺寸和播放设备。
  • 是否 1920x1080、4K、拼接屏或特殊比例。
  • 页面数量。
  • 指标定义。
  • 数据接口来源。
  • 刷新频率。
  • 是否需要实时推送。
  • 是否需要离线展示。
  • 客户视觉参考。

2. 新建项目

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 构建脚本