文档:更新项目文档,新增显示设置和性能优化说明

This commit is contained in:
yuantao
2026-01-16 18:13:34 +08:00
parent 9475f04737
commit 46756f2501
2 changed files with 86 additions and 1 deletions

View File

@@ -63,18 +63,21 @@ rollingDraw/
- ✅ 自定义字段配置
- ✅ 删除参与者
- ✅ 清空名单
- ✅ 分页显示(支持大数据量)
### 2. 奖品管理
- ✅ 添加奖品
- ✅ 设置库存数量
- ✅ 实时库存管理
- ✅ 删除奖品
- ✅ 库存进度条显示
### 3. 轮次管理
- ✅ 创建抽奖轮次
- ✅ 关联奖品
- ✅ 设置抽取人数
- ✅ 轮次状态跟踪
- ✅ 轮次序号显示
### 4. 抽奖控制
- ✅ 开始/停止抽奖
@@ -87,6 +90,8 @@ rollingDraw/
- ✅ 实时记录中奖信息
- ✅ 导出中奖名单
- ✅ 按轮次筛选
- ✅ 动态显示所有字段
- ✅ 分页显示(支持大数据量)
### 6. 大屏展示
- ✅ 滚动动画效果
@@ -94,8 +99,19 @@ rollingDraw/
- ✅ 自定义背景图片
- ✅ 快捷键控制
- ✅ 多列布局支持
- ✅ 显示设置(字体颜色、字体大小、显示字段)
- ✅ 字段标签控制
- ✅ 人名按抽取数量显示
- ✅ 刷新后不显示历史结果
### 7. 数据同步
### 7. 显示设置
- ✅ 每行显示人数设置
- ✅ 字体颜色设置(轮次名称、人名、奖品名称)
- ✅ 字体大小设置(轮次名称、奖品名称、人名)
- ✅ 显示字段选择
- ✅ 字段标签显示/隐藏
### 8. 数据同步
- ✅ IndexedDB 本地存储
- ✅ 跨标签页实时同步
- ✅ 数据持久化
@@ -124,6 +140,13 @@ rollingDraw/
- **lottery_displayMode** - 显示模式
- **lottery_backgroundImage** - 背景图片
- **lottery_columnsPerRow** - 每行列数
- **lottery_displayFontColor** - 大屏端字体颜色
- **lottery_prizeNameFontColor** - 奖品名称字体颜色
- **lottery_roundNameFontSize** - 轮次名称字体大小
- **lottery_prizeNameFontSize** - 奖品名称字体大小
- **lottery_participantFontSize** - 人名字体大小
- **lottery_displayFields** - 大屏端显示的字段列表
- **lottery_showFieldLabels** - 是否显示字段标签
## 快捷键
@@ -170,12 +193,18 @@ npm run preview
- 可配置的轮次和奖品
- 灵活的展示布局
### 性能优化
- 分页显示支持大数据量
- 虚拟滚动优化
- 延迟加载
## 注意事项
1. **数据备份**:建议定期导出参与者名单和中奖记录进行备份
2. **浏览器兼容性**:需要支持 IndexedDB 的现代浏览器
3. **图片限制**:背景图片最大支持 10MB
4. **CSV 格式**:导入文件第一行为字段名,后续行为数据
5. **性能建议**:单次导入建议不超过 1000 人,大量数据请分批导入
## 技术亮点
@@ -185,6 +214,8 @@ npm run preview
- **Fisher-Yates 洗牌算法** - 公平的随机抽取
- **跨标签页同步** - 实时数据更新
- **CSS 变量** - 主题定制和样式管理
- **分页优化** - 大数据量性能优化
- **动态字段系统** - 灵活的自定义字段支持
## 开发规范
@@ -205,6 +236,12 @@ npm run preview
- 工具函数放在 `utils/` 目录
- 样式文件放在 `src/styles/` 目录
### 组件设计原则
- 单一职责:每个组件只负责一个功能
- 可复用:提取公共逻辑为可复用组件
- 可测试:组件逻辑易于测试
- 性能优先:避免不必要的重渲染
## 许可证
版权所有 © 上海潘哆呐科技有限公司