# 点名系统启动说明

## 🚀 快速启动步骤

### 1. 启动后端服务器

打开命令行（CMD或PowerShell），进入项目目录：

```bash
cd d:\!!代码\web\手机点名器
node server.js
```

看到以下提示表示启动成功：
```
点名系统服务器已启动
访问地址: http://localhost:3000
后台管理: http://localhost:3000/admin.html
用户点名: http://localhost:3000/index.html
```

### 2. 访问系统

在浏览器中打开以下地址：

- **后台管理**: http://localhost:3000/admin.html
- **用户点名**: http://localhost:3000/index.html

### 3. 登录后台

- 用户名: `admin`
- 密码: `admin123`

## ❌ 常见错误解决

### 错误1: "Failed to fetch" 或 "无法连接到服务器"

**原因**: 后端服务器未启动

**解决方法**:
1. 确认已执行 `node server.js`
2. 检查命令行是否显示"服务器已启动"
3. 不要直接双击HTML文件打开，必须通过 http://localhost:3000 访问

### 错误2: "端口被占用"

**原因**: 3000端口已被其他程序使用

**解决方法**:
1. 修改 server.js 中的端口号（第189行）
2. 将 `const PORT = 3000;` 改为其他端口，如 `const PORT = 3001;`
3. 访问地址相应改为 http://localhost:3001

### 错误3: "node不是内部或外部命令"

**原因**: 未安装Node.js

**解决方法**:
1. 下载安装 Node.js: https://nodejs.org/
2. 安装后重启命令行
3. 验证安装: `node -v`

## 📝 使用流程

1. **启动服务器** → `node server.js`
2. **打开后台** → http://localhost:3000/admin.html
3. **登录系统** → admin / admin123
4. **创建名单** → 输入名单名称和成员
5. **获取编号** → 系统生成编号和二维码
6. **用户点名** → 打开index.html，输入编号
7. **完成点名** → 拍照或手动点名

## 🔧 技术说明

- **前端**: HTML + CSS + JavaScript
- **后端**: Node.js原生HTTP服务器
- **数据**: JSON文件存储
- **端口**: 默认3000
- **协议**: HTTP

## 💡 提示

- 服务器必须保持运行状态
- 关闭命令行窗口会停止服务器
- 数据保存在 data_lists.json 和 data_records.json
- 清除浏览器缓存不会丢失数据