First

启动说明.md

@@ -0,0 +1,86 @@
+# 点名系统启动说明
+
+## 🚀 快速启动步骤
+
+### 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
+- 清除浏览器缓存不会丢失数据