# 门店 Web 后台 · 技术选型草案（Q5）

> 状态：**推荐方案**（编码前口头确认即可；不阻塞 PRD）  
> 日期：2026-07-10  
> 上游：`docs/门店管理后台-PhaseA-页面清单PRD.md`、`docs/门店管理后台升级方案-对标宠老板.md`  
> 约束：`rule:BR-ADMIN-004`；与小程序共用 `/api/**` 与 service 规则

---

## 1. 结论（推荐）

| 项 | 选择 |
|----|------|
| 形态 | **独立 SPA**：仓库内新建 `admin/`（与 `frontend/` 小程序并列） |
| 框架 | **Vue 3 + Vite + TypeScript** |
| UI | **Element Plus**（中后台表格/筛选/抽屉成熟） |
| 路由/状态 | Vue Router + Pinia |
| 鉴权 | 复用现网 `sessionToken`；请求头与小程序一致 |
| API | axios/fetch 封装；**禁止**另造业务状态机 |
| 部署 | 静态资源独立域名或 `/admin/` path；Nginx 反代 `/api` → 现网后端 |

**不推荐**：在 uni-app 里硬撑 PC 后台；用 React 另起技术栈（团队已是 Vue 3）；把 admin 塞进 `frontend/` 与小程序同构建。

---

## 2. 方案对比

| 方案 | 优点 | 缺点 | 结论 |
|------|------|------|------|
| A. monorepo `admin/` + Vue3 + Element Plus | 与现网 Vue 技能复用；桌面组件全；与小程序构建隔离 | 多一个前端工程 | **推荐** |
| B. uni-app H5 加宽屏布局 | 少一个仓 | 表格/筛选体验差；与门店端页面耦合 | 否 |
| C. React + Ant Design Pro | 中后台模板多 | 与现网 Vue 分裂；学习/规范成本 | 否（除非专招 React） |
| D. 纯后端模板（Thymeleaf 等） | 无前端仓 | 交互与迭代慢；难复用 H5 预览 | 否 |

---

## 3. 目录与边界（建议）

```text
petstore/
├── frontend/          # uni-app 小程序 + H5（既有）
├── admin/             # Web 门店后台（新建）
│   ├── src/views/     # workbench / appointments / …
│   ├── src/api/       # 仅调 /api/**
│   └── …
└── backend/           # 共用；新增 /api/admin/service-customers 等
```

| Owner | 写入 |
|-------|------|
| Store Admin FE（新建角色） | `admin/**` |
| Backend Core | `GET /api/admin/service-customers` 及工作台聚合（若做） |
| Report Media Backend | 报告列表/成片重试相关若需扩展时 |
| Store Miniapp FE | **不写** admin；小程序履约页保持原边界 |

---

## 4. 与现网契约

- 登录：`GET /api/user/info` 校验 `boss|staff`；customer → 403 文案。
- 预约开始服务：Web 调 `POST /api/appointment/start`（与小程序同规则）。
- 客户列表：**新** `GET /api/admin/service-customers`（见 PRD §7.6）。
- 公开报告预览：新开现有 H5/`report-view`，不在 admin 内嵌改报告。
- 本体：实现时把 planned entrypoint 升 `anchored`，跑 `validate_ontology` + `audit_drift`。

---

## 5. 非功能

| 项 | Phase A 口径 |
|----|----------------|
| 浏览器 | 近两年版 Chrome / Edge；不做 IE |
| 响应式 | 桌面优先；平板可用；不做手机后台 |
| 国际化 | 仅中文 |
| 主题 | 简洁中后台即可；不对标宠老板视觉像素级 |

---

## 6. 开放确认

- [x] Q5 推荐：**Vue3 + Vite + Element Plus + `admin/`**  
- [ ] 编码启动前负责人口头确认（或提出改 React / 改目录名）  
- [x] Q4 成片 `processing` 超时：**30 分钟** 算异常（工作台/报告筛选）

---

## 修订记录

| 日期 | 说明 |
|------|------|
| 2026-07-10 | 首版推荐方案 |