minishouyin/doc/启动指南.md

迷你收银台系统启动指南

🚀 一键启动方法

方法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是否被其他程序占用

---

祝您使用愉快！ 🎉