Initial commit: 浼佷笟寰俊 AI 鏈哄櫒浜哄姪鐞?MVP
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
35
docs/phase3.md
Normal file
35
docs/phase3.md
Normal file
@@ -0,0 +1,35 @@
|
||||
# Phase 3:管理后台基础页面 + API 联通
|
||||
|
||||
## 新增内容
|
||||
|
||||
- **前端**:Next.js App Router,路由组 `(main)` 下会话/知识库/设置共用布局
|
||||
- **登录**:`/login` → 存 token 到 localStorage → 跳转 `/sessions`
|
||||
- **会话列表**:`/sessions`,调用 `GET /api/sessions`,表格 + 查看消息链接
|
||||
- **会话详情**:`/sessions/[id]`,消息列表 + 手动回复输入 + 「转人工/创建工单」按钮
|
||||
- **知识库**:`/knowledge`,拖拽上传,调用 `POST /api/knowledge/upload`(占位)
|
||||
- **设置**:`/settings`,调用 `GET /api/settings`(占位)
|
||||
- **API 封装**:`lib/api.ts`,统一带 `Authorization: Bearer <token>`
|
||||
|
||||
## 本地启动
|
||||
|
||||
1. 后端与 DB 已起(Phase 2):`docker-compose up -d db backend` 或全栈 `docker-compose up -d`
|
||||
2. 前端(从项目根):
|
||||
- **Bash:** `cd admin` → `npm install` → `npm run dev`
|
||||
- **PowerShell:** `cd admin` → `npm install` → 设置 API 再启动:
|
||||
```powershell
|
||||
$env:NEXT_PUBLIC_API_BASE="http://localhost:8000"; npm run dev
|
||||
```
|
||||
或新建 `admin/.env.local` 内容 `NEXT_PUBLIC_API_BASE=http://localhost:8000`,然后 `npm run dev`
|
||||
3. 浏览器打开 `http://localhost:3000`,根路径会重定向到 `/login` 或 `/sessions`
|
||||
|
||||
## 验证
|
||||
|
||||
- 使用 `admin` / `admin` 登录(需已执行迁移并 seed)
|
||||
- 会话列表可为空(Phase 5 入库后会有数据)
|
||||
- 会话详情页可点「转人工/创建工单」、输入内容点「发送」(后端占位返回成功)
|
||||
- 知识库页拖拽上传任意文件,应提示上传成功(占位)
|
||||
- 设置页展示空对象 `{}`
|
||||
|
||||
## 关键配置
|
||||
|
||||
- `NEXT_PUBLIC_API_BASE`:前端请求的后端地址。本地直连填 `http://localhost:8000`;经 nginx 填 `http://localhost` 或留空(同域)
|
||||
Reference in New Issue
Block a user