Files

T

yeuimu 6c61a4e871 feat(deploy): production deployment setup and fixes

- Debian-based api image (bookworm-slim), docker/debian mirrors, prisma
  binaryTargets for openssl 3.0
- nginx: admin SPA under /admin, TLS via acme.sh (ZeroSSL) + auto-renewal
  cron, http->https redirect
- prisma: add origin_goods.delisted migration, sync missing schema
  (good_image/tag_font_color/good_tags), fix users.createdAt Timestamptz
- api: CORS wildcard reflection, helmet CORP cross-origin, price
  backfill in persistProductDetail, categoryIcon ancestor fallback,
  mediaByColor per-color gallery in public goods detail
- admin: /admin base path (vite + router)
- import-data.mjs: udt_name casting, serial sequence advance fix

2026-08-26 14:23:09 +08:00

22 KiB

Raw Blame History

Teable 权限矩阵 UI 交互说明

页面：https://teable.inkreach.cc/base/bseVtXyL4aojvUDwFhn/authority-matrix
梳理日期：2026-07-29
梳理方式：使用管理员账号在真实页面进行黑盒交互验证。未创建或保存测试角色，页面最终恢复为初始的“权限矩阵关闭”状态。

1. 页面定位与整体结构

权限矩阵用于为当前数据库配置基于角色的访问控制。页面主内容从上到下分为：

标题区：权限矩阵、总开关、顶部 添加角色。
管理员区：管理员规则说明、查看、添加用户、管理员用户列表。
自定义角色区：说明文案、默认角色 下拉框、角色列表或空状态。
角色编辑器：添加或编辑角色时替换权限矩阵主内容区，不以模态框呈现。

页面仍保留数据库左侧导航和右侧 AI 助手，因此权限矩阵主内容区不是全屏页面。

1.1 页面外壳布局

本次桌面端实测视口为 929 × 869 px，页面采用横向三段式应用外壳：

┌──────────────────────┬──────────────────────────────────────────────┬────┐
│ 数据库左侧导航       │ 权限矩阵主工作区                             │ AI │
│ 约 288 px            │ 自适应填充剩余宽度                           │栏  │
│                      │                                              │约  │
│ 空间名称、搜索       │ 权限矩阵主页 / 角色编辑器                    │40px│
│ 权限矩阵、邀请、更多 │                                              │    │
│ 创建、表格树         │                                              │    │
│                      │                                              │    │
│                      │                                              │    │
│ 当前用户、通知       │                                              │    │
└──────────────────────┴──────────────────────────────────────────────┴────┘

左侧数据库导航为固定宽度栏，与权限矩阵业务内容之间使用竖向分隔线。
主工作区占据中间剩余空间，是权限矩阵主页和角色编辑器共用的内容容器。
右侧 AI 助手在当前宽度下折叠为窄图标栏；此前更宽状态下可展开成完整对话面板。
页面外壳占满视口高度。左侧用户信息和通知入口固定在导航底部，不随中间内容滚动。
权限矩阵的浮层、下拉框和禁用确认框覆盖在主工作区上方，不改变三段式外壳宽度。

1.2 权限矩阵主页布局

主页采用单列内容流，主内容在工作区内保留约 32 px 左右内边距：

┌──────────────────────────────────────────────────────────────┐
│ 权限矩阵  [总开关]                         [+ 添加角色]       │
│                                                              │
│ 管理员                                                       │
│ 说明文字  查看                                               │
│ [添加用户] [管理员标签……]                                   │
│                                                              │
│ 自定义角色                         默认角色 [无权限       ▾] │
│ 说明文字                                                     │
│                                                              │
│                    空状态插图                                │
│                    尚未设置角色                              │
│                    辅助说明                                  │
│                    [+ 添加角色]                              │
└──────────────────────────────────────────────────────────────┘

顶部标题和总开关位于同一行左侧，主操作 添加角色 右对齐。
管理员 和 自定义角色 是纵向排列的两个业务区块，不使用独立卡片包裹，主要依靠标题、留白和对齐形成层级。
管理员说明、查看、添加用户按钮和用户标签组成紧凑信息组。
自定义角色区标题与说明靠左，默认角色 标签和下拉框在同一行靠右，形成左右对照布局。
无角色时，空状态在剩余内容区域水平居中；插图、标题、说明和按钮纵向居中排列。
空状态会占用大量垂直留白，使页面重点落在“创建第一个角色”操作上。

1.3 角色编辑器整体布局

点击 添加角色 后，左侧数据库导航和右侧 AI 栏保持不变，中间主页替换为角色编辑器：

┌──────────────────────────────────────────────────────────────┐
│ [返回] [角色名称输入框]                                      │
│        角色规则说明备注                                      │
│                                                              │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ 左侧表格导航             │ 右侧权限详情                 │ │
│ │ 搜索表格                 │ 表格权限                     │ │
│ │                          │ 视图权限                     │ │
│ │ 表格 / 分组树            │ 记录权限                     │ │
│ │ 权限摘要                 │ 字段权限矩阵                 │ │
│ │                          │ 导入 / 导出权限              │ │
│ ├──────────────────────────┴───────────────────────────────┤ │
│ │                         [取消] [保存] [保存并返回]        │ │
│ └──────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────┘

编辑器顶部是角色元信息区：返回图标和角色名称输入框横向排列，规则说明位于下一行。
权限编辑主体使用带边框和圆角的双栏容器。
在本次视口下，双栏容器宽约 536 px：左栏约 228 px，右栏约 308 px。尺寸为截图估算值，不代表实现中的固定像素约束。
左栏为表格导航，顶部固定搜索框，下方是可展开的表格树和当前权限摘要。
右栏为所选表格的权限详情。选择 无权限 时内容较短；选择 可编辑 后纵向展开多个权限分区。
左右栏之间使用竖向分隔线；各权限分区之间使用横向分隔线，形成清晰的二维结构。
底部操作栏横跨双栏，按钮整体右对齐，保存并返回 使用深色主按钮，取消 和 保存 使用次级按钮。

1.4 编辑器滚动与固定区域

编辑器外层高度受当前视口约束，不会随着字段数量无限向下撑开页面。
左侧表格树与右侧权限详情位于操作栏上方的可用高度内。
右侧权限详情为主要滚动区域。字段权限矩阵和导入/导出权限位于下方，需要在详情区内纵向滚动查看。
底部 取消 / 保存 / 保存并返回 操作栏保持可见，不随右侧权限内容滚走。
左侧表格导航在滚动右侧详情时保持位置，便于随时切换表格。
字段权限本身是四列矩阵。在较窄工作区中，字段名列与三个操作列必须保持清晰对应；若字段名过长，需要截断或提示策略，当前数据未触发明显横向溢出。

1.5 视觉层级与密度

页面以白色为主背景，左侧当前导航项、选中表格行使用浅灰底色强调。
深色填充只用于高优先级动作，例如顶部 添加角色、空状态 添加角色 和 保存并返回。
标题层级依次为页面标题、区块标题、权限分区标题和辅助标签；字号与字重的差异比颜色差异更明显。
主页密度较低，使用大面积留白突出空状态；角色编辑器密度明显提高，以分栏、分隔线、复选框和矩阵承载配置任务。
权限详情中的相关控件紧密分组，不同权限域之间通过更大的上下间距和分隔线区分。

1.6 状态变化对布局的影响

状态变化	布局变化
权限矩阵关闭 → 开启	管理员标签直接进入管理员区，`添加用户` 启用；页面整体结构不变
无角色 → 有角色	预计空状态区域替换为角色列表；本次未创建角色，因此列表布局待验证
主页 → 添加角色	中间工作区整体切换为角色编辑器，左右应用外壳不变
表格无权限 → 可编辑	右栏从单个权限区扩展为长内容区，并启用内部滚动
所有视图 → 特定视图	在当前视图单选项下方原位插入视图复选列表，后续区块整体下移
分组收起 → 展开	左栏在分组节点下原位插入二级子表，右栏当前选择不变
搜索表格	左栏树被过滤，右栏继续显示当前所选表格的权限
禁用权限矩阵	中央确认框覆盖主工作区，背景内容留在原位

1.7 响应式范围说明

以上布局基于 929 × 869 px 桌面视口实测。
当前宽度下右侧 AI 助手已经折叠，但左侧数据库导航仍完整保留，说明系统优先压缩辅助面板。
本次未切换到平板或手机宽度，因此尚不能确认左侧导航是否抽屉化、角色编辑双栏是否改为上下堆叠、字段矩阵是否启用横向滚动。
若复刻该页面，建议至少验证 1440 px、1024 px、768 px 和 375 px 四档宽度，重点检查双栏编辑器和字段权限矩阵。

2. 权限矩阵总开关

2.1 关闭状态

开关为关闭状态。
添加角色 仍可点击，允许提前定义角色规则。
添加用户 为禁用状态。
管理员列表不在主区域直接展示；查看 仍可展开管理员信息。
默认角色控件和已有角色配置仍可见。
当前无自定义角色时展示空状态：
- 插图替代文本：No roles available。
- 标题：尚未设置角色。
- 说明：创建你的第一个角色，开启灵活高效的权限管理。
- 空状态内提供第二个 添加角色 入口。

关闭权限矩阵的产品语义由确认弹窗明确说明：协作者将能够查看所有数据。

2.2 开启

点击关闭状态的开关后立即开启，没有二次确认。
开关开启后，管理员用户直接显示在管理员区。
添加用户 从禁用变为可用。
其余角色配置继续保留。

2.3 关闭

点击开启状态的开关不会立即关闭，而是显示确认弹窗：

标题：禁用权限矩阵。
风险提示：协作者将能够查看所有数据，是否继续？
操作：取消、确认、右上角 Close。
取消、Close 应关闭弹窗并维持开启状态。
确认 关闭权限矩阵，随后 添加用户 重新变为禁用。

因此，总开关存在有意的不对称交互：开启即时生效，关闭需要风险确认。

3. 管理员区

说明文案为：空间可管理角色的用户可以管理权限矩阵，且不受其限制。

这表示管理员是权限矩阵的豁免主体；角色规则不限制拥有空间角色管理能力的用户。

3.1 查看管理员

查看 是可展开按钮。
点击后在浮层中展示管理员头像和名称。
再次点击按钮或点击浮层外区域可收起。
本次环境只显示用户 2197651308。

3.2 添加用户

权限矩阵关闭时按钮禁用。
权限矩阵开启后按钮可用。
点击后打开用户选择浮层，并自动展开组合框。
选择源只包含可被加入管理员集合的现有用户。
当前没有候选用户时显示：没有用户可被选择。
Esc 可关闭浮层。

当前环境没有候选用户，因此未验证选择用户后的确认、去重和移除流程。

4. 默认角色

默认角色 使用单选下拉框。
当前没有自定义角色时，下拉框仅提供并选中 无权限。
合理推断：创建角色后，角色会成为默认角色的可选项；新加入且未被显式分配角色的协作者应使用该默认角色。此推断需要结合产品规则或创建角色后的实际行为再次确认。

5. 添加角色入口

存在两个等价入口：

页面标题右侧 添加角色。
无角色空状态中的 添加角色。

点击后，权限矩阵主页被角色编辑器替换。编辑器初始值为：

角色名：自定义角色。
角色说明：未填写时显示 角色规则说明备注。
所有普通表格：无权限。
表格分组：显示 自动隐藏，其子表分别配置权限。

6. 角色基本信息

6.1 返回按钮

编辑器左上角为仅图标返回按钮。未单独验证它与底部 取消 在存在未保存改动时是否完全一致。

6.2 角色名称

角色名称为单行文本框。
新建角色默认填入 自定义角色，可直接编辑。
本次未提交空名称、重复名称或超长名称，因此校验规则待确认。

6.3 规则说明备注

未聚焦时以可点击文本 角色规则说明备注 展示。
点击后原位切换成文本输入框。
输入框失焦后回到静态展示状态。

7. 表格导航与搜索

角色编辑器左栏是可展开的表格树，每项右侧显示权限摘要。

7.1 普通表格

普通表格直接作为一级节点，例如 自动推单表。
点击节点会选中该表格，并在右侧显示详细权限。
摘要随权限选择即时更新，例如从 无权限 变为 可编辑。

7.2 表格分组

分组节点例如 系统配置，初始摘要为 自动隐藏。
点击分组只展开或收起子表，不会把分组本身设为权限配置对象。
子表以二级节点出现，并各自显示 无权限 或 可编辑 摘要。
本次观察到的子表包括：RIIN 快递公司确定规则、RIIN 发货工厂确定规则、工厂发货地址、物流渠道、发货仓、判定规则、定时更新订单信息、定时推送订单、定时同步订单。

7.3 搜索表格

输入框占位符为 搜索表格。
输入内容后即时过滤表格树，无需回车。
搜索会保留匹配子表及其父分组。例如输入 RIIN 后，只显示 系统配置 及两个包含 RIIN 的子表。
当前选中项匹配时保持选中。
清空输入应恢复完整树；本次未发现独立清除按钮。

8. 表格权限

每张表的顶层权限是单选项：

可编辑
无权限

8.1 无权限

右侧只显示表格权限单选项。
视图、记录、字段、导入和导出等细粒度设置全部隐藏。
左侧表格摘要显示 无权限。

8.2 可编辑

左侧摘要立即变为 可编辑。
右侧展开全部细粒度设置。
新切换为可编辑时，默认允许绝大多数操作、所有记录、所有视图、全部字段操作以及导入导出。

由 UI 表现可见，可编辑 是详细权限编辑模式，并不等于所有子权限必须保持开启。

9. 视图权限

9.1 视图操作

使用独立复选框控制：

创建视图
删除视图
更新视图

复选框可单独开关。

9.2 可查看的视图

单选模式：

所有视图
特定视图

选择 特定视图 后，原位展开当前表的视图清单，每个视图使用独立复选框。自动推单表 当前展示：

明细表
待推送订单
已推送订单
手动推送订单
表格视图

切换到 特定视图 时，现有视图默认全部选中。本次观察中，切换后 创建视图 同时由选中变为未选中，体现“仅允许特定现有视图”与“允许创建新视图”之间的联动约束；建议实现或复刻时将该依赖作为明确规则并补充自动化测试。

10. 记录权限

10.1 记录操作