minishouyin/doc/启动指南.md

65 lines
1.9 KiB
Markdown
Raw Normal View History

2025-11-12 11:35:57 +08:00
# 迷你收银台系统启动指南
## 🚀 一键启动方法
### 方法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是否被其他程序占用
---
**祝您使用愉快!** 🎉