server/sino-mci

Fork 0

Files

marsal 758ed73f9d fix: 渠道账号群聊同步缓存 key 及成员名称兜底；统一 Docker/Maven 项目约定

2026-07-10 15:55:30 +08:00

25 KiB

Raw Blame History

消息中台管理后台菜单重构与界面设计

日期：2026-07-09
状态：已确认，待实现
关联文档：消息与客户互动中台架构设计

1. 背景与问题

当前管理后台采用 14 项平铺菜单，功能随需求逐步叠加，导致：

职责割裂：同一业务对象（如渠道账号）的初始化、状态监控、登录操作分散在不同页面。
工作流不连贯：运营人员完成一次“发消息”需要跳转发送记录、测试发送、发送策略等多个平级菜单。
设计不统一：部分页面是对象管理 CRUD，部分是流程编排，部分是工具页面，缺少统一的信息架构。

本设计从三类用户（平台管理员、租户管理员/技术人员、运营人员）的实际工作流出发，重新梳理菜单层级与功能定义。

2. 设计目标

按工作流组织顶层菜单：让用户按“接入 → 客户关系 → 运营发送 → 编排流程 → 系统管理”的路径找到功能。
按业务对象聚合二级功能：同一对象（渠道账号、会话、联系人）的关联操作放在同一模块下。
明确功能边界：每个菜单项都有清晰的功能定义、面向角色和与现有页面的映射关系。
统一设计语言：
- 列表页 = 筛选 + 表格 + 顶部「新增」按钮 + 分页
- 新增 = 弹窗/小抽屉，只填核心字段
- 编辑/详情 = 大抽屉，基础信息区 + 标签字段 + 关联内容区
预留扩展位：钉钉/飞书/IVR 本期仅保留入口，不实现具体能力。

3. 设计决策

采用 混合式组织：

顶层按 工作流/职责域 划分，降低日常操作路径长度。
模块内按 业务对象 分组，保持数据模型与 UI 结构一致。
权限按角色控制菜单可见性，而不是为每个角色单独一套菜单。

4. 角色定义

角色	说明	典型操作
平台管理员	中台平台级管理	创建租户、维护平台角色
租户管理员	业务系统技术人员/管理员	配置渠道、管理用户、配置流程
运营人员	日常消息运营	发送、查看记录、维护联系人/群

说明：运营人员缺少部分租户内容管理，其他权限与租户管理员相同。具体可见性通过角色权限控制，不由菜单结构区分。

5. 菜单结构

5.1 一级菜单总览

一级菜单	定位	可见角色
概览	运营总览、快捷入口	全部
渠道接入	渠道资源与账号接入	租户管理员、运营人员
客户关系	联系人、会话、标签资产	租户管理员、运营人员
消息运营	发送、记录、消息查询	租户管理员、运营人员
流程编排	入站消息处理配置	租户管理员
系统管理	租户、用户、角色	平台管理员、租户管理员

5.2 概览

二级菜单	功能定义	页面/备注
运营总览	展示今日发送量、成功/失败/待发送统计、最近异常、关键指标卡片	复用并增强现有 Dashboard
快捷入口	提供常用功能的一键跳转（测试发送、发送记录、渠道账号）	新增

5.3 渠道接入

二级菜单	功能定义	页面/备注
渠道主体	维护企业在各渠道的主体信息；企微主体支持会话存档、员工/客户/群聊/会话存档同步	现有 ChannelSubject 页面增强
渠道账号	维护用于收发消息的载体账号；支持按 ID 拉取企微信息、pywechat 扫码登录、同步会话	现有 ChannelAccount 页面迁移
应用管理	企微应用的配置：agent_id、agent_secret、能力验证；本期只实现企微，其他占位	新增

5.4 客户关系

二级菜单	功能定义	页面/备注
联系人	维护 Person；详情抽屉涵盖基本信息、渠道身份、标签、所属会话	现有 Person 页面增强
会话/群聊	维护 Conversation；详情抽屉涵盖基本信息、成员、收发账号绑定、标签、历史消息	现有 Conversation 页面迁移
标签体系	树形标签管理；标签用于表达角色/合同/机构/供应商等业务属性	现有 Tag 页面升级为体系化管理

5.5 消息运营

二级菜单	功能定义	页面/备注
发送记录	按任务查询发送明细、状态、结果；支持取消待发送任务；失败固定重试 2 次	现有 SendRecord 页面迁移
测试发送	模拟出站/入站消息，用于业务系统联调和发送逻辑验证	现有 MessageTest 页面迁移并改名
消息查询	聊天界面查看入站/出站消息事件，支持按会话、人员、来源筛选	新增

5.6 流程编排

二级菜单	功能定义	页面/备注
入站 Webhook	配置业务系统接收入站消息的 webhook URL、签名方式、测试连通性	现有 InboundWebhook 页面迁移
入站流程	画布配置入站消息处理流程，支持多轮上下文与槽位收集	现有 InboundFlow 页面增强

本期不做：IVR 流程、发送策略配置。

5.7 系统管理

二级菜单	功能定义	页面/备注
租户管理	平台管理员创建/编辑租户；租户管理员维护本租户基础信息	现有 TenantManagement 页面增强
用户管理	中台用户增删改查、重置密码、启用/停用、绑定角色	现有 UserManagement 页面迁移
角色权限	平台角色 admin/operator/viewer 的权限配置与分配	新增

6. 现有菜单调整映射

当前菜单	调整方式	新位置
概览	保留并增强	概览 → 运营总览
渠道主体	保留并增强	渠道接入 → 渠道主体
渠道账号	拆分	渠道接入 → 渠道账号 / 应用管理
会话/群聊	保留，绑定功能移入详情	客户关系 → 会话/群聊
联系人	保留，增强	客户关系 → 联系人
标签	升级为体系	客户关系 → 标签体系
发送记录	保留	消息运营 → 发送记录
消息测试	保留，改名	消息运营 → 测试发送
发送策略	本期移除	—
入站流程	保留并增强	流程编排 → 入站流程
IVR 流程	本期移除	—
入站 Webhook	保留	流程编排 → 入站 Webhook
流程追踪	合并	消息运营 → 发送记录（详情）/ 消息查询
用户管理	保留	系统管理 → 用户管理
租户管理	保留	系统管理 → 租户管理
账号初始化	删除独立菜单	能力分散到渠道主体/账号/联系人/会话
渠道身份	删除独立菜单	并入联系人详情
账号-会话绑定	删除独立菜单	并入会话详情

7. 统一页面设计语言

7.1 列表页

顶部筛选区（可折叠）
右上角「新增」按钮
表格展示核心字段 + 标签 + 关联数量
行内操作：编辑 / 详情 / 删除 / 启用禁用
底部分页

7.2 新增

弹窗或小抽屉
只收集创建必需的字段
创建成功后刷新列表

7.3 编辑/详情

大抽屉
基础信息区（可编辑）
标签字段（树形多选，随基础信息一起保存）
关联内容区（只读列表 + 快捷操作）
不同对象按自身关联内容展示，不拆成多个 Tab

8. 渠道接入模块详细设计

8.1 渠道主体

列表字段

字段	说明
渠道	wecom / dingtalk / feishu（本期仅 wecom 可用）
主体编码	`subject_code`
主体名称	`subject_name`
CorpID	`corp_id`
会话存档	开启 / 关闭
状态	启用 / 禁用
操作	编辑 / 详情 / 删除 / 启用禁用

新增/编辑

渠道类型
主体编码
主体名称
CorpID
CorpSecret（通讯录同步 secret）
AgentID
AgentSecret
会话存档开关
会话存档 RSA 私钥

详情抽屉（企微能力区）

能力	所需凭证	操作
验证主体连通	`corp_id + corp_secret`	点击验证
同步企业员工	`corp_id + corp_secret`	拉取通讯录，写入 `mci_person` + `mci_channel_identity` + `department_path`
同步客户/客户群	主体下配置的企微应用 `agent_secret`	拉取外部联系人和客户群
同步会话存档	应用管理中配置的会话存档应用 secret	用 Finance SDK 拉取最近消息

每个能力执行后展示状态、上次执行时间、成功/失败数量、错误信息，并写入 mci_channel_subject_sync_task 日志表。

8.2 渠道账号

列表字段

字段	说明
账号类型	企微内部账号 / 企微应用 / pywechat 个人号
渠道	wecom / wechat_personal
账号 ID	`account_id`
名称	`account_name`
所属主体	`subject_name`
登录状态	已登录 / 未登录
在线状态	在线 / 离线
状态	启用 / 禁用
操作	编辑 / 删除 / 启用禁用 / 初始化 / 同步会话

企微内部账号

创建/编辑时输入 userid 后，可点击「从企微拉取」回填姓名、部门信息
会话存档开关（标记该员工是否开启存档）

企微应用

应用凭证在「应用管理」维护
渠道账号中创建时选择应用，自动带出 agent_id
提供「验证应用」按钮

pywechat 个人号

创建时填写 wxid / bot_code 和 server_host
行操作「扫码登录」：返回二维码，轮询登录状态
行操作「同步会话」：拉取该个人号所在群聊

8.3 应用管理

列表字段

字段	说明
应用名称	`app_name`
应用类型	wecom / wecom_session_archive / dingtalk / feishu
agent_id	企微应用 ID
所属主体	`subject_name`
状态	启用 / 禁用
操作	编辑 / 验证 / 删除 / 启用禁用

新增/编辑

应用名称
所属主体
应用类型
agent_id
agent_secret
状态

操作

验证并获取能力：用 corp_id + agent_id + agent_secret 获取 access_token，验证通过更新状态
钉钉/飞书应用仅保留表单入口，验证按钮禁用

9. 客户关系模块详细设计

9.1 联系人

列表字段

字段	说明
人员编码	`person_code`
姓名	`person_name`
手机号	`phone`
类型	内部人员 / 供应商人员 / 客户 / 司机
所属机构	`institution_id` 名称
部门路径	多个标签式展示
标签	直接展示绑定的标签
渠道身份数	几个渠道身份
参与会话数	该人员在多少个会话中
状态	启用 / 禁用
操作	编辑 / 详情 / 删除 / 启用禁用

新增

弹窗字段：

人员编码
姓名
手机号
类型
所属机构
状态

编辑/详情抽屉

基础信息区

人员编码、姓名、手机号
类型
所属机构、供应商、合同
部门路径（支持多条）
状态

标签字段

树形多选，已选标签平铺展示

渠道身份区

列表展示所有渠道身份
行内新增 / 编辑 / 删除
新增时：选择渠道 → 选择主体 → 输入渠道用户 ID → 「拉取企微信息」回填昵称

所属会话区

展示该人员参与的会话列表
点击会话名称打开会话详情抽屉

9.2 会话/群聊

列表字段

字段	说明
会话类型	单聊 / 群聊
渠道	wecom / wechat_personal
渠道会话 ID	`channel_conversation_id`
会话名称	`conversation_name`
群主/负责人	`owner_account_id` 名称
所属主体	`subject_id` 名称
标签	直接展示
成员数	群聊显示成员数量
业务绑定	机构 / 供应商 / 合同 / 渠道编码
状态	启用 / 禁用
操作	编辑 / 详情 / 删除 / 同步成员

新增

弹窗字段：

会话类型
渠道
所属主体
渠道会话 ID
会话名称
负责人账号
状态

编辑/详情抽屉

基础信息区

会话类型、渠道、所属主体
渠道会话 ID、会话名称
负责人账号
关联机构 / 供应商 / 合同 / 渠道编码
状态

标签字段

树形多选

成员区

列表展示 mci_conversation_participant
字段：人员姓名、渠道身份、角色
操作：同步成员、移除
人员名称可点击进入联系人详情

收发账号绑定区

展示发送主号 / 发送备用号 / 接收主号 / 接收备用号
行内新增、编辑优先级、删除
单聊限制：只能绑定同 channel_type 的账号
群聊允许跨渠道绑定，但给出提示

历史消息区

展示该会话最近消息列表
可跳转消息查询页面

9.3 标签体系

列表字段

字段	说明
标签名	`tag_name`
路径	`tag_path`
层级	`level`
来源	system / business_sync / manual
状态	启用 / 禁用
关联人员数	使用数量
关联会话数	使用数量
操作	新增子标签 / 编辑 / 删除 / 启用禁用

新增/编辑

弹窗字段：

标签名
父标签（树形选择，顶级为根）
来源
状态

详情抽屉

标签基本信息
关联人员列表（分页）
关联会话列表（分页）

10. 消息运营模块详细设计

10.1 发送记录

页面结构

顶部统计卡片：今日发送总数 / 成功 / 失败 / 待发送
筛选区：任务 ID、发送时间、渠道、状态、目标类型
记录列表
详情抽屉

列表字段

字段	说明
任务 ID	`task_id`
目标类型	单人会话 / 群聊 / 人员 / 标签 / 规则
目标摘要	会话名称 / 人员姓名 / 标签名 / 规则描述
渠道	wecom / wechat_personal
发送账号	实际使用的账号名称
状态	待发送 / 发送中 / 成功 / 失败
发送时间	`send_time`
完成时间	`finish_time`
操作	详情 / 取消（仅待发送）

详情抽屉

基础信息：任务 ID、目标、渠道、发送账号、内容摘要
内容区：完整 content_body
策略与回调：channel_strategy、callback_url
渠道结果：channel_result 格式化展示
关联跳转：会话 / 人员 / 账号 / 消息事件
时间线：创建 → 发送中 → 完成 / 失败

失败固定重试 2 次，由后端策略处理，前台不配置。

10.2 测试发送

工具型页面，两个 Tab：

Tab 1：出站测试

字段	说明
目标类型	会话 / 人员 / 标签 / 规则
目标	根据类型选择或输入
内容类型	text / markdown / image / file / news 等
内容	对应内容编辑器
渠道策略	优先渠道、备用渠道
回调地址	可选

点击「发送测试」后展示返回的 task_id，并刷新发送记录。

Tab 2：入站模拟

字段	说明
事件 ID	自定义事件 ID
渠道类型	wecom / wechat_personal
消息来源	realtime / session_archive
会话 ID	选择已有会话
发送人	选择人员或输入 channel_user_id
接收账号	选择接收账号
内容类型	text / image / voice 等
内容	消息内容

点击「模拟入站」后触发入站流程编排，展示处理结果。

10.3 消息查询

页面布局

三栏式聊天界面：

┌─────────────┬─────────────────────┬─────────────┐
│  会话列表    │      聊天内容        │  会话信息    │
│  搜索/筛选   │                     │  成员/标签   │
└─────────────┴─────────────────────┴─────────────┘

左侧：会话列表

按时间倒序展示会话
每个会话卡片：会话名称、最后一条消息预览、最后消息时间、标签小圆点
搜索：会话名称、成员姓名、消息内容
筛选：渠道、消息来源（实时/会话存档）、会话类型、标签

中间：聊天内容区

按时间顺序展示消息气泡
区分入站消息（左侧）、出站消息（右侧）、系统事件（中间）
根据 msgtype 渲染：文本、图片、语音、视频、文件、撤回提示等
支持按时间范围筛选，滚动加载历史消息

右侧：会话信息

基础信息：会话名称、渠道、来源、群主
业务绑定：机构 / 供应商 / 合同 / 渠道编码
标签：直接展示，可编辑
成员列表
快捷操作：查看发送记录、跳转联系人详情、同步成员

11. 流程编排模块详细设计

11.1 入站 Webhook

每个租户独立配置一个入站推送地址。

页面内容

字段	说明
Webhook URL	业务系统接收中台入站消息的地址
签名算法	HMAC-SHA256 / HMAC-SHA512 / 无
Webhook Secret	签名密钥
超时时间	推送超时秒数，默认 10s
失败重试	固定重试 2 次

操作

保存
测试推送
查看最近推送日志（状态、响应码、响应摘要）

这是流程中 Webhook 节点的默认推送地址，只有流程走到该节点才会触发。

11.2 入站流程

页面布局

保留三栏画布：

┌────────────┬─────────────────────────┬────────────┐
│  流程列表   │       流程画布           │  节点配置   │
│  组件面板   │                         │            │
└────────────┴─────────────────────────┴────────────┘

流程节点

节点	作用
接收消息	流程入口，指定渠道
加载上下文	读取当前会话已有的 intent / slots / 轮次
意图识别	LLM / 规则识别本轮意图和槽位
合并槽位	把本轮新槽位合并到会话上下文
槽位校验	检查必需槽位是否齐全
自动追问	缺槽位时自动生成追问文案并回复
Webhook	槽位齐全后推送给业务系统
回复消息	可配置固定回复
保存上下文	把更新后的 intent / slots 写回
清空上下文	Webhook 成功后结束当前会话

多轮流程示例

接收消息
  │
  ▼
加载上下文
  │
  ▼
意图识别（结合上下文）
  │
  ▼
合并槽位
  │
  ▼
槽位校验
  ├─ 缺槽位 ──▶ 自动追问 ──▶ 保存上下文 ──▶ 结束
  │
  └─ 槽位齐全 ──▶ Webhook ──▶ 回复客户 ──▶ 清空上下文 ──▶ 结束

上下文存储

新增 mci_conversation_context 表：

字段	说明
conversation_id	会话 ID
intent	当前意图
slots	JSON，已收集槽位
missing_slots	JSON，还缺哪些槽位
turn_count	当前轮次
status	collecting / complete / expired
expire_time	上下文过期时间
update_time	最后更新时间

超过一定时间（如 10 分钟）无新消息，上下文自动过期。

12. 系统管理模块详细设计

12.1 租户管理

列表字段

字段	说明
租户编码	`tenant_code`
租户名称	`tenant_name`
状态	启用 / 禁用
用户数量	该租户下用户总数
创建时间	`create_time`
操作	编辑 / 删除 / 启用禁用

平台管理员：可操作全部租户。
租户管理员：只能查看/编辑本租户，不可删除。

新增（仅平台管理员）

租户编码
租户名称
入站 Webhook URL
初始化管理员账号（默认 admin）
初始化管理员密码
状态

创建成功后自动创建该租户的第一个管理员用户。

编辑

租户名称
入站 Webhook URL
状态

默认租户（如 platform）不可删除。

12.2 用户管理

列表字段

字段	说明
用户名	`username`
真实姓名	`real_name`
手机号	`phone`
所属租户	`tenant_name`（平台管理员可见）
角色	角色名称，多个用逗号
状态	启用 / 禁用
创建时间	`create_time`
操作	编辑 / 重置密码 / 删除 / 启用禁用

新增

所属租户（平台管理员选择，租户管理员固定为本租户）
用户名
密码
真实姓名
手机号
角色（多选）
状态

编辑

可编辑：真实姓名、手机号、角色、状态。
不可编辑：用户名、所属租户。

12.3 角色权限

列表字段

字段	说明
角色编码	`role_code`
角色名称	`role_name`
权限数量	已配置的权限项数
状态	启用 / 禁用
操作	配置权限 / 启用禁用

首期固定角色：

角色编码	角色名称	默认权限
`platform_admin`	平台管理员	全部权限
`admin`	租户管理员	除租户创建外的全部权限
`operator`	运营人员	发送、查看记录、维护联系人/会话、配置渠道账号
`viewer`	只读用户	仅查看发送记录、统计、消息查询

权限配置

抽屉中展示权限树：

□ 全部
  □ 概览
    □ 查看
  □ 渠道接入
    □ 渠道主体（查看 / 新增 / 编辑 / 删除）
    □ 渠道账号（查看 / 新增 / 编辑 / 删除）
    □ 应用管理（查看 / 新增 / 编辑 / 删除）
  □ 客户关系
    □ 联系人（查看 / 新增 / 编辑 / 删除）
    □ 会话/群聊（查看 / 新增 / 编辑 / 删除）
    □ 标签体系（查看 / 新增 / 编辑 / 删除）
  □ 消息运营
    □ 发送记录（查看 / 取消）
    □ 测试发送
    □ 消息查询
  □ 流程编排
    □ 入站 Webhook（查看 / 编辑）
    □ 入站流程（查看 / 新增 / 编辑 / 删除 / 发布）
  □ 系统管理
    □ 租户管理（查看 / 新增 / 编辑 / 删除）
    □ 用户管理（查看 / 新增 / 编辑 / 删除 / 重置密码）
    □ 角色权限（查看 / 配置）

保存后同步到 mci_platform_role 表的 permissions JSON。

12.4 全局管理员登录

默认创建 platform 租户
通过 Flyway 初始化 admin 用户，角色 platform_admin
初始密码在配置文件中设置，首次登录强制修改

13. 数据模型补充

13.1 新增/调整字段

表	字段	类型	说明
`mci_person`	`department_path`	JSON	多个部门路径，如 `["销售中心/销售一部", "销售中心/华北组"]`
`mci_channel_subject_sync_task`	—	新表	记录各渠道主体同步任务
`mci_conversation_context`	—	新表	入站流程多轮会话上下文

13.2 同步任务日志表

mci_channel_subject_sync_task：

字段	说明
subject_id	渠道主体 ID
sync_type	employee / external_contact / group / session_archive
status	0待执行 1执行中 2成功 3失败
total_count	总数
success_count	成功数
fail_count	失败数
error_msg	错误信息
create_time / finish_time	时间

14. 不在本期范围内的功能

功能	原因
IVR 流程	属于 2092 IVR 语音配置需求
发送策略配置	本期失败固定重试 2 次，不开放前台配置
模板管理	中台不保存模板
业务触发规则	中台不承载业务系统触发规则
钉钉/飞书具体能力	仅保留入口

15. 实现要点

前端路由：按新菜单结构重排 admin-web/src/router/index.ts。
布局组件：Layout.vue 从平铺 el-menu-item 改为分组 el-sub-menu。
权限控制：菜单可见性通过 authStore.roleCodes 或后端返回的权限列表控制。
页面拆分与合并：
- 删除 ChannelAccountInit.vue 独立页面
- 删除独立的渠道身份、账号-会话绑定页面
- Conversation.vue 增强详情抽屉，包含绑定功能
- Person.vue 增强详情抽屉，包含渠道身份
消息查询：新增聊天界面组件。
入站流程：增强节点配置，新增上下文存储能力。
空状态处理：新增页面先实现最小可用版本。

16. 验收标准

左侧导航按新 6 大模块分组展示，无 IVR 流程、发送策略、账号初始化入口。
每个二级菜单有明确页面，无 404。
租户管理员、运营人员、平台管理员看到的菜单符合角色定义。
联系人、会话详情抽屉涵盖所有关联内容。
标签在列表和编辑表单中直接展示/编辑。
消息查询实现聊天界面。
入站流程支持多轮上下文与槽位收集。
现有功能在迁移后行为保持一致。

25 KiB Raw Blame History Unescape Escape

消息中台管理后台菜单重构与界面设计

1. 背景与问题

2. 设计目标

3. 设计决策

4. 角色定义

5. 菜单结构

5.1 一级菜单总览

5.2 概览

5.3 渠道接入

5.4 客户关系

5.5 消息运营

5.6 流程编排

5.7 系统管理

6. 现有菜单调整映射

7. 统一页面设计语言

7.1 列表页

7.2 新增

7.3 编辑/详情

8. 渠道接入模块详细设计

8.1 渠道主体

列表字段

新增/编辑

详情抽屉（企微能力区）

8.2 渠道账号

列表字段

企微内部账号

企微应用

pywechat 个人号

8.3 应用管理

列表字段

新增/编辑

操作

9. 客户关系模块详细设计

9.1 联系人

列表字段

新增

编辑/详情抽屉

9.2 会话/群聊

列表字段

新增

编辑/详情抽屉

9.3 标签体系

列表字段

新增/编辑

详情抽屉

10. 消息运营模块详细设计

10.1 发送记录

页面结构

列表字段

详情抽屉

10.2 测试发送

Tab 1：出站测试

Tab 2：入站模拟

10.3 消息查询

页面布局

左侧：会话列表

中间：聊天内容区

右侧：会话信息

11. 流程编排模块详细设计

11.1 入站 Webhook

页面内容

操作

11.2 入站流程

页面布局

流程节点

多轮流程示例

上下文存储

12. 系统管理模块详细设计

12.1 租户管理

列表字段

新增（仅平台管理员）

编辑

12.2 用户管理

列表字段

新增

编辑

12.3 角色权限

列表字段

权限配置

25 KiB

Raw Blame History