# 🚀 快速启动指南

## ⚡ 一句话启动

### macOS/Linux
```bash
cd /Users/hexiaodong/Desktop/git/erp2025/Antis.Erp.Plat/sy && python3 -m http.server 8888
```

### Windows
```cmd
cd C:\Users\hexiaodong\Desktop\git\erp2025\Antis.Erp.Plat\sy && python -m http.server 8888
```

---

## 📱 访问地址

打开浏览器，访问以下地址：

| 页面 | URL |
|------|-----|
| 🔐 **登录页** | http://localhost:8888/login.html |
| 🛒 **商品列表** | http://localhost:8888/home.html |
| 💳 **收银台** | http://localhost:8888/settlement.html |
| 👤 **会员管理** | http://localhost:8888/member.html |

---

## 🎯 核心功能速记

### 登录页面
```
1. 输入用户名
2. 输入密码
3. 选择门店
4. 点击「登录」
```

### 收银台快捷键
| 按键 | 功能 |
|------|------|
| **E** | 整单折扣 |
| **R** | 整单改价 |
| **U** | 抹零 |
| **SPACE** | 收款 |
| **ESC** | 返回 |

---

## 🔗 后端API

```
基础地址: https://www.ponggame.cn
```

### 核心接口
```
POST   /api/oauth/Login                      # 登录
GET    /api/oauth/CurrentUser                # 获取当前用户
GET    /api/permission/Users                 # 用户列表
GET    /api/Extend/WtMd                      # 门店列表
GET    /api/Extend/WtSp                      # 商品列表
GET    /api/Extend/wthy/{id}                 # 会员信息
POST   /api/Extend/wtxsckd                   # 提交订单
```

---

## 📊 数据存储

所有数据存储在浏览器 `localStorage`：

```javascript
localStorage.getItem('token')           // 访问令牌
localStorage.getItem('userId')          // 用户ID
localStorage.getItem('username')        // 用户名
localStorage.getItem('selectedStore')   // 门店信息
localStorage.getItem('addgoodlist')     // 购物清单
localStorage.getItem('hyinfo')          // 会员信息
localStorage.getItem('ckinfo')          // 仓库信息
```

---

## 🐛 调试技巧

### 查看 localStorage
```javascript
// 在浏览器控制台输入
JSON.stringify(localStorage, null, 2)
```

### 查看网络请求
```javascript
// F12 打开开发者工具
// 切换到 Network 标签
// 监控所有 API 调用
```

### 清空缓存重新登录
```javascript
// 在浏览器控制台输入
localStorage.clear()
location.reload()
```

---

## ✅ 验证清单

- [ ] 服务器启动成功（端口 8888）
- [ ] 能访问 http://localhost:8888/login.html
- [ ] 后端 API 在线（https://www.ponggame.cn）
- [ ] 用户名/密码正确
- [ ] 门店已选择
- [ ] 登录成功，跳转到商品列表
- [ ] 能添加商品到购物车
- [ ] 能进入收银台
- [ ] 支付方式选择正常
- [ ] 订单提交成功

---

## 💡 常见错误排查

| 错误 | 原因 | 解决方案 |
|------|------|---------|
| 无法访问 localhost:8888 | 服务未启动 | 重新运行启动命令 |
| CORS 错误 | 跨域请求被拒 | 检查后端CORS配置 |
| 登录失败 | 用户名/密码错 | 确认凭证并重试 |
| 商品列表空 | API未返回数据 | 检查网络和后端 |
| localStorage 报错 | 浏览器禁用存储 | 检查隐私设置 |

---

## 📞 联系方式

- 📧 Email: support@example.com
- 💬 WeChat: (需要补充)
- 🐛 Bug Report: (需要补充)

---

**最后更新**: 2025-01-01  
**版本**: 1.0.0