# 迷你收银台系统启动指南

## 🚀 一键启动方法

### 方法1：双击启动脚本（推荐）
1. 双击运行 `启动系统.bat` 文件
2. 系统会自动：
   - 检测和安装依赖
   - 构建前端应用
   - 启动服务器和桌面应用

### 方法2：手动启动
1. 打开命令行，进入项目目录
2. 运行命令：`npm run dev`

## 🔑 登录系统

系统启动后，您需要使用以下默认账号登录：

**默认管理员账号：**
- 用户名：`admin`
- 密码：`admin123`

**其他可用账号：**
- 经理账号：`manager` / `admin123`
- 收银员账号：`cashier1` / `cashier123`

## 🎯 系统功能

登录成功后，您将看到完整的收银台系统界面：

- **收银台** - 商品扫码、价格计算、支付处理
- **商品管理** - 商品信息录入、修改、库存管理
- **订单管理** - 订单查询、挂起订单处理
- **报表统计** - 销售数据、商品排行、业绩统计
- **系统设置** - 店铺信息、打印机设置

## ⚠️ 常见问题解决

### 问题1：卡在"正在加载收银台系统..."
**解决方案：**
1. 检查控制台是否显示服务器已启动在端口3000
2. 如果服务器正常启动，可能是前端API连接问题
3. 按Ctrl+C停止当前进程，然后重新运行启动脚本

### 问题2：登录页面没有显示
**解决方案：**
1. 检查浏览器控制台是否有错误信息
2. 确认服务器端口3000是否可访问
3. 尝试手动访问 `http://localhost:3000/api/health` 测试API

### 问题3：端口被占用
**解决方案：**
系统会自动尝试其他端口（3001, 3002, 3003等），请查看控制台输出确认实际使用的端口。

## 📞 技术支持

如果遇到任何问题，请检查：
1. Node.js是否正确安装（版本建议16+）
2. 网络连接是否正常（用于依赖包下载）
3. 端口3000是否被其他程序占用

---

**祝您使用愉快！** 🎉