# Portal 用户手册

> 版本：v1.0 · 日期：2026-05-22  
> 面向角色：经理 / 审批人 / 业务用户

---

## 1. 产品定位

Portal 是业务用户的日常工作台。你不需要了解数据库、OData 或任何技术细节——Portal 把需要你处理的事情统一呈现在一个地方：待审批的操作、AI 推荐的建议、你有权使用的业务应用、系统通知。

**Portal 能做什么：**
- 查看并处理待审批的数据操作请求
- 确认或忽略 AI 推荐的操作建议
- 使用业务架构师发布的轻应用（催款管理、任务跟踪、客户分析……）
- 查看系统通知（审批结果、AI 建议到期提醒等）
- 浏览和安装应用模板

**你不需要做的事：**
- 不需要登录数据库
- 不需要了解 OData 是什么
- 不需要联系 IT 就能使用已发布的业务应用

---

## 1.1 Portal 与 Insight 的关系

Portal 是**运行平台**，Insight 是**配置平台**。你在 Portal 里看到的一切，都来自业务架构师在 Insight 中的配置：

| Portal 里你看到的 | 来自 Insight 的配置 |
|----------------|-------------------|
| 待办中心的审批任务 | Insight Action 的审批条件触发 |
| 待办中心的 AI 确认任务 | Insight AIP Logic 分析后生成的建议 |
| 通知中心的消息 | Insight Action / Automate 执行后的通知规则 |
| 我的应用中的 App | 业务架构师在 Insight Workshop 搭建并发布 |

如果某个功能不出现或行为异常，通常是 Insight 配置问题，可以联系你的业务架构师。

---

## 2. 界面概览

```
Portal 顶部导航
├── 待办中心   ← 所有需要你处理的事情
├── 我的应用   ← 你有权使用的业务应用
├── 通知中心   ← 系统发给你的消息
└── 应用市场   ← 浏览和安装应用模板（管理员）
```

顶部右侧的 **红色数字角标** 表示待处理事项数量。

---

## 3. 待办中心

> **入口**：Portal → 待办中心

待办中心聚合了三类需要你处理的事项：

| 类型 | 说明 | 来自 |
|------|------|------|
| **待审批** | 需要你审批的数据操作请求 | Studio 或 Insight Action 触发的高风险操作 |
| **AI 待确认** | AI 推荐的操作建议，等待你决定是否执行 | Insight AIP Logic 生成的建议 |
| **我的任务** | 分配给你的业务任务 | 业务应用中创建的任务 |

---

### 3.1 处理审批请求

当有人发起了一个需要审批的操作（如批量修改订单状态、删除客户记录），你作为审批人会收到通知，并在待办中心看到该请求。

**审批步骤：**

1. 待办中心 → 「待审批」标签
2. 选中一条审批请求，查看：
   - **申请人**：谁发起的操作
   - **操作内容**：要改什么、改成什么（Entity Edit Plan）
   - **影响范围**：影响几条记录、哪些字段
   - **数据样本**：前 5 条受影响记录的字段变化（旧值 → 新值）
   - **风险等级**：系统评定的风险级别
3. 做出决定：
   - 点击「**通过**」→ 填写审批意见（可选）→ 确认，系统立即自动执行该操作
   - 点击「**拒绝**」→ 填写拒绝原因 → 确认，申请人收到通知

> **重要**：你的审批决定会被记录在审计日志中（审批人、时间、意见）。审批通过后操作不可撤销，请仔细阅读 Entity Edit Plan 再决定。

**审批超时：** 如果审批请求长时间未处理，申请人可以选择撤回或重新提交。

---

### 3.2 处理 AI 建议（AI 待确认）

当 AI 分析了数据并推荐了操作，这些建议不会自动执行——它们进入你的待办中心，等你决定。

**AI 建议处理步骤：**

1. 待办中心 → 「AI 待确认」标签
2. 每条建议包含：
   - **AI 分析摘要**：AI 为什么推荐这个操作（用中文说明）
   - **推荐操作**：要执行的具体动作（如"创建催款任务 - 客户张三，金额 ¥52,000"）
   - **参数详情**：操作的具体参数
   - **到期时间**：AI 建议 24 小时内未处理自动过期
3. 做出决定：
   - 「**确认执行**」→ 操作进入执行流程（如需审批则继续走审批流）
   - 「**修改后执行**」→ 可调整 AI 建议的参数后再确认
   - 「**忽略**」→ 不执行，记录忽略原因

> **提示**：AI 建议到期后你会收到通知。如需重新获取建议，联系业务架构师手动重新触发 AI 分析。

---

### 3.3 我的任务

「我的任务」显示在业务应用中分配给你的任务（如催款跟进任务、数据核查任务等）。

1. 待办中心 → 「我的任务」
2. 点击任务卡片进入对应的业务应用
3. 在应用内完成任务（填写跟进记录、更新状态等）
4. 任务完成后状态自动更新

---

## 4. 我的应用

> **入口**：Portal → 我的应用

「我的应用」只显示你有权限访问的已发布应用。

**打开应用：**

点击应用卡片 → 应用在当前页内加载运行

**在应用内的典型操作：**

| 操作 | 说明 |
|------|------|
| 查看数据列表 | 按筛选条件浏览 Entity 数据 |
| 点击行查看详情 | 展开单个对象的完整信息和关联数据 |
| 点击操作按钮 | 触发 Action（如"创建任务"、"标记完成"）；高风险操作会进入审批流 |
| 填写表单 | 填写 Action 参数后提交，系统执行对应操作 |
| 查看 AI 建议 | AIPSuggestionCard 展示 AI 推荐的操作，逐条确认或忽略 |
| 拖动看板卡片 | 在 Kanban 视图中拖动任务卡片改变状态 |

**应用操作后的结果：**

- 操作成功 → 页面弹出绿色提示，相关数据刷新
- 操作进入审批 → 页面提示"已提交审批，等待审批人处理"，你的通知中心后续会收到审批结果
- 操作失败 → 页面显示错误原因

---

## 5. 通知中心

> **入口**：Portal → 通知中心（或顶部铃铛图标）

通知中心汇总了所有系统发给你的消息：

| 通知类型 | 触发时机 |
|---------|---------|
| 审批请求 | 有新的待审批操作需要你处理 |
| 审批通过 | 你发起的操作已被审批人通过，已自动执行 |
| 审批拒绝 | 你发起的操作被拒绝，附带拒绝原因 |
| AI 建议到来 | 有新的 AI 分析建议等待你确认 |
| AI 建议即将过期 | AI 建议将在 X 小时后过期（提醒你尽快处理）|
| 操作执行失败 | 你发起的操作在执行中出现错误 |

**操作：**
- 点击通知 → 跳转到对应的待办或应用页面
- 点击「全部标记已读」→ 清空未读标记

---

## 6. 应用市场（管理员）

> **入口**：Portal → 应用市场

应用市场提供预制的应用模板，管理员可以一键安装到自己的 Insight 工作区，作为起点快速搭建业务应用。

**安装模板：**

1. 浏览模板列表，点击模板卡片查看详情（功能说明、截图预览、所需 Entity）
2. 确认当前 Connection 中有模板所需的 Entity
3. 点击「安装」→ 按向导配置数据绑定 → 完成
4. 安装后模板作为草稿 App 出现在 Insight Workshop 中，业务架构师可进一步调整后发布

---

## 7. 常见问题

**Q：待办中心没有显示我的审批任务？**  
A：确认你的账号角色中包含对应 Entity 的审批人权限。联系 IT 管理员在 Studio IAM 中检查权限配置。

**Q：我确认了 AI 建议，但应用没有变化？**  
A：确认的 AI 建议会进入 Action Runtime 执行，如果该操作需要审批，会先进审批流。你可以在通知中心看到后续状态（审批通过后才执行）。

**Q：AI 建议过期了，怎么重新获取？**  
A：联系业务架构师（Insight 用户）在 AIP Logic 管理界面手动重新触发分析。

**Q：应用里点了按钮没反应？**  
A：可能是网络原因或操作权限不足。刷新页面再试；如仍有问题，联系业务架构师检查 Action 配置和你的角色权限。

**Q：看不到某个应用？**  
A：应用只展示给有权限的角色。联系业务架构师或 IT 管理员确认你的账号角色是否包含该应用的访问权限。

**Q：操作执行失败，怎么处理？**  
A：通知中心会显示失败原因。常见原因：① 数据源暂时不可用（联系 IT）；② 字段值不符合校验规则（检查填写内容）；③ 权限变更（联系管理员）。

---

## 8. Portal 平台功能说明

本章说明 Portal 各功能的来源，帮助你在遇到问题时找到正确的联系人。

| 功能 | 来源 / 配置方 | 遇到问题联系谁 |
|------|-------------|-------------|
| 待办中心 — 审批任务 | Insight Action 的审批条件 | 业务架构师（调整审批规则）/ IT 管理员（调整权限）|
| 待办中心 — AI 确认任务 | Insight AIP Logic 分析结果 | 业务架构师（调整 AI 分析逻辑或重新触发）|
| 通知中心消息 | Insight Action side_effects / Automate 通知配置 | 业务架构师（调整通知规则）|
| 我的应用 | Insight Workshop 发布的 App | 业务架构师（功能问题）/ IT 管理员（权限问题）|
| 应用市场模板 | 业务架构师发布的模板 | 业务架构师 |
| 账号和角色权限 | Studio IAM | IT 管理员 |

### Portal 不存储业务逻辑

Portal 本身不保存审批规则、AI 逻辑、应用定义——这些都在 Insight 中配置，Portal 只负责展示和执行。因此：

- **通知不来** → 检查 Insight 的通知配置，不是 Portal 的问题
- **App 功能不对** → 业务架构师需要在 Insight Workshop 修改并重新发布
- **AI 建议消失** → AI 建议 24 小时过期是设计行为，联系业务架构师重新触发分析