36 lines
1.8 KiB
Markdown
36 lines
1.8 KiB
Markdown
# 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` 或留空（同域）
|