门户设计 ★
一句话：后台首页「工作台」的搭建与发布——把待办、公告、指标卡、图表、快捷入口拖到一张画布上拼成一页门户，发布后登录后台首页就能切换使用；一个租户可以有多张门户，用「默认」和「可见范围」决定谁进来落在哪一页、能切到哪几页。
功能在哪
- 菜单路径：基础设施 → 在线开发 → 门户设计
- 地址栏路由：
/infra/online/portal - 门户设计器：列表行内「设计」进入，地址栏形如
/infra-portal/portal/editor?id={门户id}（隐藏路由，不在菜单里，只能从列表进） - 主要权限：
infra:portal:query（列表/版本）、:create（新增/复制）、:update（编辑/设计）、:publish（发布/下线）、:preview（预览）、:delete（删除）
界面认识
查询条件（名称与编码为模糊匹配）：
| 条件 | 可选项 |
|---|---|
| 门户名称 / 门户编码 | 模糊匹配，占位「请输入门户名称」「请输入门户编码」 |
| 状态 | 全部 / 草稿 / 已发布 / 已发布有改动 |
| 启用 | 全部 / 启用 / 停用 |
列表列：序号、门户名称、编码、类型、排序、状态、线上版本、默认（开关）、启用（开关）、更新时间、操作。
| 列 | 显示规则 |
|---|---|
| 类型 | 在线设计（蓝标签，有画布）/ 自定义（一条跳转地址，无画布）；创建后不可修改 |
| 状态 | 草稿（灰）/ 已发布（绿）/ 已发布有改动（橙）——与表单设计同一套三态 |
| 线上版本 | 发布过显示 vN，从未发布显示「-」 |
| 默认 | 开关，打开即「首页展示」；全租户同一时刻只有一个默认门户 |
| 启用 | 开关；停用后该门户从首页与切换器里消失 |
行内操作：设计、编辑、发布，其余折进「更多」下拉（版本、预览、下线、复制、删除，删除项上方有分隔线）。
两类门户、三种状态，按钮跟着变
- 自定义（外链）门户没有画布可言，因此**没有「设计」「版本」「预览」**三个按钮，发布也只是把这条跳转地址生效；
- 未发布的门户没有「下线」可执行；
- 「已发布有改动」= 草稿被改过、与线上版本不一致，重新发布才生效，橙色标签就是提醒。
常用操作
新建 / 编辑门户基本信息
工具栏「新增」或行内「编辑」→「编辑门户」对话框：
| 字段 | 说明 |
|---|---|
| 门户名称 | 必填 |
| 门户编码 | 必填；提示原文「仅允许字母、数字和下划线，发布后不可修改编码。」 |
| 门户类型 | 在线设计 / 自定义；提示原文「在线设计：拖拽组件设计门户页面；自定义：跳转到页面或外链。类型创建后不可修改。」 |
| 门户描述 | 选填，占位「请输入门户描述」 |
| 可见范围 | 所有人 / 指定角色 / 指定用户；提示原文「控制哪些用户可以在首页切换到该门户；超级管理员始终可见。」 |
| 排序 | 数字；提示原文「值越小越靠前，门户列表与首页门户切换均按此排序。」 |
| 默认门户 | 开关，标签「首页展示」；打开它会自动关掉原来的默认门户 |
| 启用状态 | 开关，标签「启用」 |
编码与类型都只有一次机会
编码发布后置灰、类型创建后锁定，两者都不能再改。起名前先想清楚：编码会被首页路由与接口引用，类型决定这张门户是「一块画布」还是「一条链接」。
在设计器里拼一页门户
行内「设计」进入设计器。顶栏从左到右：返回、门户名称、编码、状态标签、撤销 / 重做 / 清空画布 / 预览、控件计数、保存并发布 / 保存 / 关闭。
- 计数格式原文：
{n} / 50 个顶层控件 · {total} / 100 个控件——顶层最多 50 个、全部控件（含容器内的子控件）最多 100 个、嵌套最多 4 层，超了加不进去； - 画布是 24 栏网格：从左侧控件库把控件拖上画布，拖动搬位置、拖边角改大小；
- 点中画布上的控件 → 右侧属性面板，三个页签：布局（位置与尺寸）、组件（该控件自己的标题栏、字号、列数、静态条目等）、数据（数据源）；
- 顶栏「保存」只存草稿，「保存并发布」一步到位；「关闭」回到列表。
控件库共 4 组 23 个控件：
| 分组 | 控件（用途） |
|---|---|
| 布局控件 | 卡片面板（提供可配置标题栏和内容承载区域）、标签面板（使用多个标签页组织相关业务内容）——这两个是容器，别的控件可以拖进去 |
| 基础控件 | 文本（展示标题、说明或通知内容）、图片、轮播图、视频、网页（嵌入受信任的外部网页）、常用功能（用图标和文字组成常用业务入口） |
| 系统控件 | 我的待办（集中展示当前用户需要处理和关注的流程事项）、待办事项、在办事项、公告通知（展示系统公告和重要通知）、邮件消息 |
| 图表控件 | 数据面板（用指标卡片突出展示关键数据）、表格列表、柱状图、折线图、饼图、雷达图、排行榜、时间轴、地图、自定义 ECharts（使用 JSON 配置绘制自定义图表） |
数据源：静态手填，或挂一个只读接口
「数据」页签里每个取数控件都有两种模式：静态数据（在设计器里直接填条目，适合公告栏、快捷入口这类固定内容）与动态接口（下拉里列的是接口管理中已启用的只读接口）。选动态后可配参数设置（JSON）、字段映射（接口返回字段 → 控件字段）与自动刷新（10–86400 秒，默认 300 秒）。
看到「暂无数据」不是坏了
空控件会显示占位文案：「面板暂无内容」「标签页暂无内容」「暂无视频」「暂无数据」「暂无公告」。它们只是在说「还没喂数据」：静态控件去「组件」页签填条目，动态控件去「数据」页签选接口。
发布、下线、复制、删除
- 发布：行内「发布」。在线设计门户弹「发布门户」输入框，提示「请输入发布说明（可选）」；自定义门户直接确认框「确认发布门户“{名称}”吗？」；成功提示「发布成功」。发布后改草稿，状态即变「已发布有改动」，需再发布一次；
- 下线：确认框原文「确认下线门户“{名称}”吗？下线后首页将不再展示。」，成功提示「下线成功」。配置与版本历史都还在，随时可以再发布；
- 复制：确认框「确认复制门户“{名称}”吗？」→ 得到一条新草稿，名称带「（副本）」、编码带
_copy，不带版本历史； - 删除：标题「删除确认」，原文「确认删除门户“{名称}”吗？版本历史也会一并删除。」——不可恢复。
下线与删除是两回事
下线只是把门户从首页摘下来，草稿与版本历史完好；删除连版本历史一起清掉。想「暂时不用」请下线，别删除。
版本与回滚
「更多」→「版本」→ 右侧抽屉「版本历史 - {门户名称}」，顶部提示原文：「回滚只会覆盖当前草稿，不会修改线上版本；回滚后的内容需要重新发布才会生效。」
抽屉里是表格：版本（vN 标签）、发布说明、发布人、时间、操作（预览 / 回滚）。回滚二次确认标题「回滚确认」，原文「确认回滚到版本 v{N} 吗？回滚只覆盖当前草稿，需重新发布才会生效。」
预览与首页效果
- 「更多」→「预览」：弹窗「门户预览」，按当前登录身份取数渲染整页——「我的待办」显示你名下的真实计数，静态控件显示设计器里填的条目；
- 发布且启用后，登录后台首页即落在默认门户；顶部门户切换器列出可见范围内、已启用、已发布的所有门户。
门户只有一个运行时出口
门户运行时只服务于登录后的后台首页：不生成独立菜单、不对外网开放、匿名看不到。「可见范围」控制的是首页切换器里能出现哪几张门户；超级管理员不受可见范围限制，始终全部可见。
视角对照
| 视角 | 看到什么 |
|---|---|
超管 admin / 租户管理员 docadmin | 全部门户；可新增、编辑、设计、发布、回滚、下线、删除 |
只授 query 的角色 | 能看列表与版本历史，「新增」「编辑」「设计」「发布」按钮不显示 |
只授 preview 的角色 | 多一个「预览」按钮，仍不能发布 |
| 可见范围外的普通用户 | 与本页无关；首页切换器里看不到这张门户，但落地页（默认门户）仍按默认定 |
进阶
- 改完首页没变，先查三处：状态列是不是「已发布有改动」（是就重新发布）；「启用」开关是否开着；「默认」开关是否打在想展示的那张门户上——首页落地页跟的是默认门户；
- 开关的四个提示：默认开关切到「已设置为默认门户」/「已取消默认门户」，启用开关切到「已启用」/「已停用」；默认门户全租户唯一，设新的会自动取消旧的；
- 上限是硬约束：顶层 50、总计 100、嵌套 4 层。画布加不进去控件时先看顶栏计数，别怀疑浏览器；
- 撤销/重做只覆盖本次进入设计器之后的操作，「清空画布」会一次性移除画布上全部控件（含容器里的子控件）；
- 动态接口只认「已启用的只读接口」：写型接口、停用接口都不出现在下拉里；要换数据源先去接口管理把目标接口启用；
- 与表单设计是两套东西：门户拼的是「展示页」（待办、公告、图表），表单设计管的是「数据单据」（增删改查落库）；门户上的表格列表控件可以挂只读接口展示表单数据，但不能在门户里改数据。
常见问题
Q：发布成功了，首页为什么还是老样子？ A：按顺序查三处——状态列是否为「已发布有改动」（草稿没发布）；「启用」开关是否开着；「默认」开关是否打在这张门户上。首页落地页只认默认门户。
Q：为什么某一行没有「设计」按钮？ A：这张门户的类型是「自定义」，它只是一条跳转地址，没有画布；同理也没有「版本」和「预览」。类型创建后不可修改，需要画布请新建一张在线设计门户。
Q：控件拖上画布后显示「暂无数据」？ A：占位文案，不是故障。静态控件去「组件」页签填条目；动态控件去「数据」页签选一个已启用的只读接口并配好字段映射。
Q：回滚到 v1 了，首页还是 v3 的样子？ A：回滚只覆盖草稿，线上不变。回滚后再点一次「发布」，首页才切到回滚后的内容。
Q：能让不同部门看到不同门户吗？ A：落地页全租户只有一个（默认门户），但「可见范围」可以按角色/用户收窄：把某张门户设为指定角色可见，它就只出现在这些人的首页切换器里。超级管理员始终可见全部。
Q：门户能给外网或匿名访问吗？ A：不能。门户只在登录后的后台首页渲染，没有独立外链，匿名与未登录用户看不到任何内容。