68 lines
3.0 KiB
Markdown
68 lines
3.0 KiB
Markdown
# admin-web 页面补全设计
|
||
|
||
## 问题
|
||
|
||
当前 `admin-web` 多数页面只有创建表单和空表格，缺少列表加载、数据绑定等核心能力：
|
||
|
||
- Dashboard 统计数字写死为 0。
|
||
- 渠道主体、渠道账号、会话/群聊、联系人页面只创建不查询，刷新后数据丢失。
|
||
- 会话/群聊缺少账号绑定 UI。
|
||
- 发送记录需要手动拼 JSON，体验差。
|
||
|
||
## 目标
|
||
|
||
在不改变现有表结构和业务规则的前提下，补全前后端的基础 CRUD 与列表展示能力，使管理后台可以独立完成主体、账号、会话、人员的维护，以及测试发送。
|
||
|
||
## 方案
|
||
|
||
### 后端：新增列表/统计接口
|
||
|
||
保持 Controller 风格一致，均为 `ApiResponse` 包装。
|
||
|
||
| 接口 | 方法 | 说明 |
|
||
|---|---|---|
|
||
| `/api/v1/channel-subject/list` | GET | 查询当前租户渠道主体列表 |
|
||
| `/api/v1/channel-account/list` | GET | 查询当前租户渠道账号列表 |
|
||
| `/api/v1/conversation/list` | GET | 查询当前租户会话列表 |
|
||
| `/api/v1/person/list` | GET | 查询当前租户联系人列表 |
|
||
| `/api/v1/send/list` | GET | 查询当前租户发送任务/日志列表（最近 50 条） |
|
||
| `/api/v1/dashboard/stats` | GET | 返回渠道主体数、账号数、会话数、今日发送数 |
|
||
|
||
实现方式：在现有 Service 中新增 `listXxx(String tenantCode)` 方法，使用 MyBatis-Plus 按 `tenant_code` 查询，逻辑删除字段 `deleted=0` 已由全局配置处理。
|
||
|
||
### 前端：补全页面交互
|
||
|
||
1. **Dashboard.vue**
|
||
`onMounted` 调用 `/api/v1/dashboard/stats`，填充 4 个统计卡片。
|
||
|
||
2. **ChannelSubject.vue / ChannelAccount.vue / Conversation.vue / Person.vue**
|
||
- `onMounted` 加载列表。
|
||
- 创建成功后刷新列表（或直接 unshift 新记录）。
|
||
- ChannelSubject 补充 `corpId`、`agentId` 输入框（已有字段，只是 UI 没暴露）。
|
||
|
||
3. **Conversation.vue**
|
||
- 增加「绑定发送账号」列/弹窗，调用 `/api/v1/conversation/{id}/bind-account`。
|
||
- 列表展示当前绑定的发送主号/备用号（可选，首期先保证能绑定）。
|
||
|
||
4. **SendRecord.vue**
|
||
- 当目标类型为「会话」时，目标值改为下拉选择会话（从 `/api/v1/conversation/list` 加载），而不是手动填 JSON。
|
||
- 内容类型为 `text` 时，内容改为普通文本输入框，自动包装成 `{"text": "..."}`。
|
||
- 保留高级 JSON 模式入口（非必须，首期不做）。
|
||
|
||
5. **API 层**
|
||
在 `admin-web/src/api/channel.ts`、`crm.ts`、`send.ts`、`account.ts`（dashboard 可单放或复用 client）中补充对应的 list 函数。
|
||
|
||
## 非目标
|
||
|
||
- 不做分页、搜索、编辑、删除（这些可以后续按需加）。
|
||
- 不改数据库表结构。
|
||
- 不做复杂的权限控制。
|
||
|
||
## 成功标准
|
||
|
||
- Dashboard 刷新后显示真实数量。
|
||
- 渠道主体、账号、会话、联系人页面创建后能在列表中显示。
|
||
- 会话页面可以直接绑定发送账号。
|
||
- 发送记录页面可以通过下拉选择会话并发送文本消息。
|
||
- `npm test` 通过，外部 API 脚本通过。
|