sino-mci/docs/superpowers/specs/2026-07-07-admin-web-fill-out-design.md

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 脚本通过。