SA 会议系统：第三方日历集成 — 配置与交互
文档状态：V3.0（终版） 编写日期：2026-07-16 定位：第三方日历集成的管理后台配置页面设计，涵盖入口页面与三步向导的交互细节。
1. 页面入口
页面入口位于管理后台左侧 app-nav 图标栏。
此页面配置的是会议系统与第三方日历的集成，逻辑上应放在会议 App 导航中（与会议预约/我的会议/会议室管理同级）。app-nav 中仅为原型演示方便。
2. 入口页面：集成总开关
首次进入页面时，展示集成状态总览，决定是否启用三方日历集成。
2.1 未启用状态（首次进入）
+----------------------------------------------------+
| 第三方日历集成 |
| |
| 当前状态：未启用 |
| |
| 启用后，会议 App 的预定/查询/取消等操作将自动 |
| 同步至第三方日历（飞书或钉钉） |
| |
| [开启集成] |
+----------------------------------------------------+- "开启集成"→ 进入三步向导
2.2 已启用状态（配置完成后）
+----------------------------------------------------+
| 第三方日历集成 |
| |
| 当前状态：已启用 |
| 已对接平台：飞书-生产环境 |
| 最近导入：2026-07-16 14:30（5 间会议室） |
| |
| [重新配置] [停用集成] |
+----------------------------------------------------+- "重新配置"→ 进入三步向导，回填已有数据
- "停用集成"→ 关闭三方同步，保留配置数据
3. 三步设置向导
顶部步骤条指示当前进度，底部"上一步/下一步"按钮控制流转。
+------------------------------------------+
| 首页 / 第三方日历集成 |
| |
| +--------+ +--------+ +----------+ |
| | 1.选择 | -> | 2.认证 | -> | 3.导入 | |
| | 平台 | | 配置 | | 会议室 | |
| +--------+ +--------+ +----------+ |
| |
| +--------------------------------------+|
| | 各步骤内容区域 ||
| +--------------------------------------+|
| |
| [上一步] [下一步 ->] |
+------------------------------------------+已完成/当前步骤可回退修改，未到步骤不可跳转。每个步骤的数据在本步骤确认后持久化。
4. 步骤一：选择平台
单选，互斥。选择后"下一步"按钮启用。
+----------------------------------------------------+
| 1. 选择平台 |
| |
| +------------------------------------------------+ |
| | O 飞书 (Feishu) | |
| | 认证：AppID + AppSecret | |
| | 返回：会议室名、容量、设备、路径 | |
| +------------------------------------------------+ |
| +------------------------------------------------+ |
| | O 钉钉 (DingTalk) | |
| | 认证：AppKey + AppSecret | |
| | 返回：会议室名、容量 | |
| +------------------------------------------------+ |
| |
| [取消] [下一步 ->] |
+----------------------------------------------------+5. 步骤二：认证配置
根据上一步选择的平台，动态显示对应的认证表单。
+----------------------------------------------------+
| 2. 认证配置 - 飞书 |
| |
| -- 认证凭据 -- |
| App ID * [cli_a7f8e2________________] |
| App Secret * [********____________________] |
| |
| [测试连接] |
| -------------------------------------------------|
| + 连接成功！可查询到 5 间会议室资源 |
| |
| [上一步] [下一步 ->] |
+----------------------------------------------------+- 飞书显示 AppID + AppSecret，钉钉显示 AppKey + AppSecret
- "测试连接"成功后显示绿色提示
- "下一步"进入导入流程（自动触发拉取）
6. 步骤三：导入会议室
6.1 拉取中状态
+----------------------------------------------------+
| 3. 导入会议室 |
| |
| @ 正在从 飞书-生产环境 |
| 拉取会议室数据... |
| |
| [上一步] [取消] |
+----------------------------------------------------+6.2 预览与编辑
数据拉取完成后展示。
会议室列表：
| 平台会议室 | 平台路径(参考) | 容纳人数 | 设备 | 会议室名称(可编辑) | 空间关联(必选) |
|---|---|---|---|---|---|
| F1-02 金朵云 | 园区>A栋>5F>金朵云区 | 20人 | 投影仪,电视机.. | [可编辑] | [级联选择] |
| F3-01 路演厅 | 园区>A栋>3F>路演区 | 20人 | 投影仪,电话 | [可编辑] | [级联选择] |
- 平台路径： 第三方侧的房间层级，作为空间关联参考
- 空间关联： 级联选择器（园区>楼宇>楼层>房间），从物联平台空间树选择
- 已停用会议室： 自动过滤不展示
设备数据字典：
| # | 设备名称 | identifier | 排序 |
|---|---|---|---|
| 1 | 投影仪 | [Device_1] | 1 |
| 2 | 电视机 | [Device_2] | 2 |
| 3 | 音频设备 | [Device_3] | 3 |
- identifier 默认 Device_1, Device_2... 可编辑
- 钉钉不返回设备信息，此区域隐藏
6.3 平台差异
| 能力 | 飞书 | 钉钉 |
|---|---|---|
| 设备数据字典 | 提取+可编辑 identifier | 无设备数据，隐藏该区域 |
| 平台路径参考 | 显示路径列 | 无路径数据，隐藏该列 |
6.4 导入确认
未关联空间的会议室>0时弹出确认弹窗：
+------------------------------+
| (!) 确认导入 |
+------------------------------+
| 有 N 间会议室尚未关联空间 |
| 位置，确定要导入吗？ |
| |
| 未关联空间的会议室将无法 |
| 在智能体中被定位。 |
+------------------------------+
| [取消] [确认导入] |
+------------------------------+导入完成后回到入口页面，显示"已启用"状态。