下面列的都已经在 main 上。这张表和 README 的「功能一览」逐行对应;有专题页的领域在最后一列链过去,还没有专题页的写「—」。
| 领域 | 内容 | 专题页 |
|---|---|---|
| 权限与组织 | RBAC(菜单 / 按钮 / 数据范围)· 行级数据权限 · 部门树 · 用户与角色 | 用户 · 角色 · 部门 · 菜单 · 数据权限 |
| 导入导出 | 服务端导出 xlsx / csv(按当前筛选或勾选的行 · 大批量转后台、完成发站内消息 · 防公式注入)· 通用导入(带下拉的模板 · 预览校验 · 只新增 / 新增并更新 / 只更新 · 错误报告 · 全部成功才导入)· 一份文件建整棵部门树 | 导入导出 |
| 登录与安全 | 图形验证码 · 失败锁定 · 密码历史与过期 · 手机验证码登录 · 二次验证(TOTP + 恢复码)· OAuth2(GitHub / Google)· 会话管理(空闲超时 + 绝对上限 · 按端限制会话数 · 被踢下线说明原因 · 强制下线) | 登录与安全 |
| 工作区 | 可编辑布局的工作台(卡片按权限出现 · 布局按人存服务端)· 多页签(固定 / 拖拽 / 重新加载)· 命令面板 ⌘K · 快捷键 · 功能引导 · 列表列显隐与拖拽排序(写进地址栏)· 主题色 / 圆角 / 页签外观 · 每人自己的时区 · 中英双语 | 工作台与界面 · 多页签 |
| 文件与存储 | 文件管理器 + 在线预览(pdf / docx / xlsx / 图片 / 压缩包)· 本地 + S3 兼容存储 · 预签名直连下载 · 回收站 · 秒传 · 分片上传与断点续传 · 可嵌进任何页面的附件面板 | 文件与存储 |
| 审批流 | 表单设计器 · 流程树(审批 / 抄送 / 条件分支)· 同意 / 驳回 / 转交 / 退回 / 拿回 / 加签 · 超时提醒与自动处理 · 草稿 · 加急 · 离职交接 · AI 预审 / 帮填表单 / AI 审批节点 | 审批流 |
| AI 助手 | 整页对话 + 侧滑抽屉 · 受权限与数据范围约束的工具调用 · 写操作预演 + 确认 · 调用审计 · MCP 网关 | AI 助手 |
| 能力开放 | AK/SK 签名的开放接口 · scope / IP 白名单 / 防重放 / 限流 · 调用日志 · 增量同步 · Python / Node / Java SDK · Webhook 事件订阅(Standard Webhooks 签名 · 失败重试 · 投递记录 · 批量重发) | 能力开放 |
| 消息与通知 | 站内消息(实时推送)· 通知公告(富文本 + 附件 · 发布范围 · 定时发布 · 置顶 / 级别 / 有效期 · 登录后弹窗与必须确认 · 顶部横幅 · 登录页公告 · 阅读统计)· 通知渠道路由(邮件 / 短信 / 飞书·钉钉·企业微信群机器人 · 按事件配策略 · 投递记录)· 短信(阿里云 / 腾讯云) | 消息与通知 |
| 定时任务 | 在线调度 · cron 预览 · 执行记录 | 定时任务 |
| 运维 | 参数配置 · 数据字典 · 登录 / 操作日志(自动脱敏)· 数据变更记录(谁、什么时候、从哪来,把哪个字段从什么改成了什么 · 和操作日志互跳)· 服务器与 Redis 监控 · 发新版提示 · 给外部监控用的统一健康检查地址 | 日志与审计 · 监控与健康检查 · 参数配置与数据字典 |
| 多端 | Electron 桌面端(三平台安装包 · 静默打印 · 本地硬件 · 自动更新)· Expo 原生移动 App(不是 WebView 套壳) | 桌面端与移动端 |
| 开发者 | 组件沙箱(每个组件可调、可抄)· 调色盘 · 由 OpenAPI 生成的类型安全前后端契约 | 开发者工具 · 插件机制 |
| 数据库 | PostgreSQL · SQL Server · MySQL,同一套代码、同一条迁移链 | 数据库 |
每项功能在哪个菜单?手机上能用吗?
Section titled “每项功能在哪个菜单?手机上能用吗?”桌面端直接加载网页端的构建产物,网页端有的桌面端都有,所以下表只对比网页和手机 App。「插件」一列是 apps/api/backend/plugin/ 下的目录名,空着的是核心功能。菜单名是种子数据里的,部署方可以自己改。
| 功能 | 网页端菜单 | 插件 | 手机 App |
|---|---|---|---|
| 登录与安全 | 个人中心 · 系统监控 → 在线用户 · 系统管理 → 参数配置 | 手机验证码登录要 sms,第三方登录要 oauth2 | 密码 / 手机验证码登录,能输动态码;被强制开二次验证、还没绑定的人要先到网页端绑定 |
| 用户 · 角色 · 部门 · 菜单 | 系统管理 → 用户 / 角色 / 部门 / 菜单管理 | 用户列表 → 详情 → 删除(作为可照抄的范式) | |
| 数据权限 | 系统管理 → 数据权限 | 过滤在后端,App 调到的列表一样受约束 | |
| 多页签 · 工作台 | —(外壳)· 仪表盘 | 首页是固定的公告 + 我的审批 + 入口,不能编辑布局;没有多页签 | |
| 导入导出 | 各列表页的工具栏 | 无 | |
| 文件与存储 | 系统管理 → 文件管理 / 存储管理 | 只能看公告的附件 | |
| 审批流 | 审批 → 审批中心 / 流程定义 / 实例监控 | workflow | 待办、详情、发起 |
| 站内消息 · 通知公告 | 顶栏铃铛 · 系统管理 → 通知公告 | notification · notice | 能看,不实时(进入页面或下拉时刷新) |
| 通知渠道 · 短信 | 消息推送 → 通知策略 / 投递记录 · 短信 → 短信配置 / 发送日志 | notification · sms · email | 无 |
| AI 助手 | AI 助手 | ai | 无 |
| 能力开放 | 能力开放 → 应用管理 | open | 无 |
| 定时任务 | 定时任务 → 任务调度 / 执行记录 | 无 | |
| 参数配置 · 数据字典 | 系统管理 → 参数配置 · 数据字典 | config · dict | 无 |
| 日志与审计 | 日志管理 → 登录日志 / 操作日志 / 数据变更 | 无 | |
| 监控 | 系统监控 → 在线用户 / 服务器监控 / Redis 监控 | 服务器监控 |
手机 App 目前只在 Android 上手工验收过,范围和限制见桌面端与移动端。
工程规矩写在哪
Section titled “工程规矩写在哪”仓库把规矩和踩过的坑写在代码旁边:根目录的 CLAUDE.md 加 40 多份模块分册(AGENTS.md),按任务索引(「加列表页」「改权限模型」「写迁移」)。每条都是同一个格式——现象、原因、修法、证明它的实测或测试;CI 里跑 pnpm ctx:check,文档指向的文件、脚本或 testid 不存在了就报错。
不装能先试试吗
Section titled “不装能先试试吗”可以:登录在线演示,账号 admin / 123456。所有人共用这一个实例,数据可能随时被别人改掉,版本也可能比 main 落后一两个。