# gitPart02

**Repository Path**: ma-shaochen/gitpart02

## Basic Information

- **Project Name**: gitPart02
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-02
- **Last Updated**: 2025-07-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 随机点名系统

随机点名系统是一个基于Web的应用程序，它允许用户上传包含姓名的Excel文件，并从中随机选择名字。这个系统适用于课堂教学、会议签到、活动抽奖等场景，具有操作简单、界面美观、功能实用等特点。

## 功能特点

- **文件上传**：支持上传Excel文件(.xlsx, .xls)
- **列选择**：自动识别Excel列名，用户可选择包含姓名的列
- **随机点名**：具有流畅动画效果的随机选择过程
- **历史记录**：保存点名历史，显示每次点名的时间和结果
- **结果导出**：支持将点名结果导出为Excel文件
- **响应式设计**：适配各种屏幕尺寸
- **拖放功能**：支持拖放上传文件
- **深色模式**：内置深色/浅色主题切换

## 技术实现

- **前端框架**：纯HTML/CSS/JavaScript
- **样式设计**：使用Tailwind CSS v3实现现代UI设计
- **Excel处理**：使用SheetJS库(xlsx)解析和生成Excel文件
- **交互效果**：通过JavaScript实现丰富的动画和交互效果

## 安装与使用

### 安装

1. 克隆仓库到本地
2. 将项目文件放到Web服务器目录下
3. 确保浏览器支持现代JavaScript特性(ES6+)
4. 直接在浏览器中打开index.html文件即可使用

### 使用方法

1. 点击"选择文件"按钮或拖放Excel文件到指定区域
2. 系统会自动解析Excel文件并显示列名
3. 选择包含姓名的列
4. 点击"开始点名"按钮
5. 系统会进行随机选择并显示结果
6. 可以查看历史记录或再次点名
7. 需要时可以导出点名结果为Excel文件

## 代码结构

项目文件结构如下：
random-name-picker/
├── index.html                # 主页面
├── style.css                 # 样式文件
├── script.js                 # 交互逻辑
├── package.json              # 项目依赖
└── README.md                 # 使用文档
主要功能模块：

- 文件上传与解析
- 列选择与数据处理
- 随机点名算法与动画
- 历史记录管理
- 结果导出功能
- 主题切换与UI交互

## 自定义与扩展

1. 如需修改样式，可以编辑style.css文件或调整Tailwind配置
2. 如需添加新功能，可以在script.js中扩展
3. 可以添加更多的动画效果或交互方式
4. 支持多语言功能扩展
5. 可以添加用户认证和数据存储功能

## 注意事项

1. 确保上传的Excel文件格式正确，且包含有效的姓名数据
2. 系统会自动过滤空值和无效数据
3. 点名历史仅保存在内存中，刷新页面后会丢失
4. 导出的结果文件格式为.xlsx
5. 对于大文件(超过10MB)可能会有性能问题

## 浏览器兼容性

- Chrome 60+
- Firefox 52+
- Safari 10+
- Edge 16+
- Opera 47+

不支持IE浏览器，请使用现代浏览器访问。

## 贡献

欢迎贡献代码、报告问题或提出建议。请提交Pull Request或创建Issue。

## 许可证

本项目采用MIT许可证。