Initial screen starter scaffold
This commit is contained in:
commit
d136b9dddc
49 files changed
+2966
No files matched your search
@@ -0,0 +1,74 @@
|
||||
# 大屏项目交付流程
|
||||
|
||||
## 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 构建脚本
|
||||
Reference in new issue
Block a user