# SME-OmniStore 项目总管理文档
**创建时间**: 2026-05-05 02:30 GMT+12  
**负责人**: 深思的笨蛋 (thinking-bendan)  
**状态**: 🔄 进行中

---

## 项目概述

- **项目名称**: SME-OmniStore 多租户 SaaS 电商中台
- **技术栈**: FastAPI + SQLAlchemy2.0 (MySQL) + Nuxt 3 (商城) + Vue 3 (后台)
- **项目路径**: `/home/node/.openclaw/agents/thinking-bendan/workspace/python 商城/sme-omnistore/`

---

## 任务分配

| 子Agent | 职责 | 状态 |
|---------|------|------|
| `backend-completion` | 后端补全（deps.py, store/orders, store/auth） | 🔄 运行中 |
| `admin-frontend-completion` | 管理后台补全（API, Auth, Views） | 🔄 运行中 |
| `store-frontend-completion` | 商城前台补全（checkout, account, useApi） | 🔄 运行中 |
| `docker-deployment` | 远程部署 + 真机测试 | 🔄 运行中 |

---

## 缺陷清单（从 README.md 提取）

### P0 — 网络层（阻塞）
- [ ] 浏览器无法访问 `http://192.168.50.139:8000`
  - 服务器内部正常，外部访问被拒绝
  - 修复：`sudo ufw disable` 或 `sudo ufw allow 8000/tcp`

### P1 — checkout/index.vue 缺少 Authorization header
- [ ] `POST /store/orders` 未带 `Authorization: Bearer <token>`
- [ ] 后端 `create_order` 需要 `get_current_customer`

### P1 — account/index.vue 使用 mock 数据
- [ ] 刷新后页面空白
- [ ] 需在 `setup()` 调用 `GET /store/orders`

### P2 — products/index.vue 绕过 useApi()
- [ ] 直接用 `$fetch('/store/products', { base: ... })`

### P2 — nuxt.config.ts SSR 代理缺失
- [ ] SSR 时 `/api/store/...` 404

---

## 工作阶段

### Phase 1: 代码补全（并发）
- 子Agent `backend-completion` → 修复后端
- 子Agent `admin-frontend-completion` → 修复管理后台
- 子Agent `store-frontend-completion` → 修复商城前台

### Phase 2: 部署测试（串行，在 Phase 1 完成后）
- 子Agent `docker-deployment` → 同步代码到远程 → 安装依赖 → 启动服务 → 功能测试

### Phase 3: 验收汇总
- 汇总所有子Agent报告
- 生成最终测试报告
- 更新 MEMORY.md

---

## 输出文件

1. `backend/BACKEND_COMPLETION_REPORT.md` — 后端补全报告
2. `frontend/admin/ADMIN_COMPLETION_REPORT.md` — 管理后台补全报告
3. `frontend/store/STORE_COMPLETION_REPORT.md` — 商城前台补全报告
4. `DEPLOYMENT_REPORT.md` — 部署测试报告（最终汇总）
5. `TEST_REPORT.md` — 功能测试汇总（最终交付物）

---

## 成功标准

- ✅ 后端 API 完整可调用（所有 store 和 admin 端点）
- ✅ 管理后台可正常登录和操作
- ✅ 商城前台所有页面正常渲染
- ✅ 下单流程（购物车→结算→订单）完整走通
- ✅ 部署到远程服务器并真机测试通过
- ✅ 所有功能点和测试结果记录到文档