功能模块
本文基于当前代码实现整理，主要对照后端 18 个路由领域、共享层业务域、菜单种子、前端页面与 MSW Mock。专题文档可从 /rules/、/wiki/、/open-platform/、/workflow/、/payment/、/cms/ 等入口继续阅读。
模块全景
权限与组织（IAM）
专题文档：权限与组织
| 模块 | 当前能力 |
|---|---|
| 用户管理 | 用户 CRUD、启停、批量删除/启用/停用、重置密码、账号解锁、Excel 导入、角色/部门/岗位分配、直接授权、有效权限预览、在线状态展示与强制下线 |
| 角色管理 | 角色 CRUD、菜单权限分配、数据权限范围、角色状态管理 |
| 菜单管理 | 目录 / 菜单 / 按钮三级资源、动态路由、排序、可见性、按钮权限码 |
| 部门管理 | 树形组织、负责人、联系方式、部门状态 |
| 岗位管理 | 岗位 CRUD、排序、状态与批量操作 |
| 用户组 | 静态组与动态组、负责人/部门、成员维护、角色继承、批量成员操作 |
| 租户管理 | 租户状态、有效期、用户上限、套餐绑定、平台超管租户视角切换 |
| 租户套餐 | 基于菜单树圈定功能范围与席位配额 |
| License 授权 | License 信息查看与授权状态管理 |
| 账号安全 | JWT 双 Token、验证码、登录失败锁定、密码复杂度 / 过期、找回密码、API Token |
| 企业身份源 | OIDC、SAML、LDAP、AD 身份源配置与 JIT 建号 |
| 通讯录同步 | LDAP/AD、钉钉、企业微信、飞书同步源、同步记录、冲突处理与回调 |
系统配置与基础能力
| 模块 | 当前能力 |
|---|---|
| 系统配置 | 验证码、注册开关、密码策略、锁定策略、水印、运行开关等配置中心 |
| 数据字典 | 字典主表与字典项、树形结构、颜色标签、JSON 元数据、状态与排序 |
| 地区管理 | 省 / 市 / 区数据维护与选择组件支撑 |
| 标签管理 | 标签 CRUD、颜色、分组、批量操作 |
| 意见反馈 | 用户反馈收集、处理状态、回复与闭环 |
| 文件配置 | 多存储后端配置与默认存储切换 |
| 文件列表 | 上传、下载、预览、删除、批量下载、网格 / 列表视图、Magic Bytes 类型校验 |
| IP 访问控制 | 黑白名单、CIDR、黑名单优先、拦截日志 |
| 接口限流 | 限流规则、实时统计、拦截记录、解封 / 重置 |
| 数据脱敏 | 手机、邮箱、身份证、银行卡、自定义掩码，支持角色豁免、扫描与批量创建 |
| 维护模式 | 全局维护开关、公告文案与预计恢复时间 |
| 缓存管理 | Redis key 浏览、模式搜索、单键删除、分类清理、全量清理 |
文件与存储
专题文档：文件与存储
| 模块 | 当前能力 |
|---|---|
| 业务文件 | 通用文件上传、绑定业务对象、下载与删除 |
| 文件列表 | Magic Bytes 类型校验、列表 / 网格双视图、在线预览、批量下载、删除 |
| 存储配置 | local、oss、s3、cos、obs、kodo、bos、azure、sftp 九种后端，支持默认存储切换 |
通知与消息触达
专题文档：通知中心
| 模块 | 当前能力 |
|---|---|
| 通知公告 | 公告 CRUD、草稿 / 发布、已读记录、阅读统计、实时推送 |
| 我的消息 | 个人站内信收件箱、未读计数、标记已读、批量已读、删除 |
| 邮件管理 | SMTP 配置、模板、预览、测试发送、发送日志 |
| 短信管理 | 多服务商通道、模板变量、测试发送、发送日志 |
| 站内信管理 | 站内信模板、收件记录与状态追踪 |
| 通知策略 | 事件 × 渠道策略、租户 / 平台配置、免打扰、摘要与合规退订 |
| 消息频道 | 运营号、订阅 / 退订、富文本群发、草稿、定时、撤回、频道菜单、自动回复、订阅者 |
| 客服工作台 | 按用户聚合会话、双向消息、快捷回复、满意度、客服绩效 |
| Webhook 机器人 | 外部系统向 Chat 推送卡片消息，支持机器人令牌重置 |
审计日志与会话
| 模块 | 当前能力 |
|---|---|
| 登录日志 | 登录结果、IP、位置、设备信息、浏览器、GPU、CPU 核心、内存与趋势统计 |
| 操作日志 | 操作轨迹、请求信息、变更前后 Diff、全文筛选、统计分析 |
| 日志文件 | 服务端日志列表、查看、下载、删除、正则 / grep 搜索、实时追踪、告警联动 |
| 在线用户 | 在线会话查询、单会话 / 全部会话强制下线 |
| 个人中心 | 资料、头像、修改密码、第三方绑定、API Token、通知偏好、个人日志 |
| 多账号切换 | 活跃账号凭证独立槽位，最多 5 个账号停靠；切回时用 refresh token 换发；跨标签页广播并整页重载，退出全部账号可清空停靠区 |
运维与可观测性
专题文档：系统运维
| 模块 | 当前能力 |
|---|---|
| 仪表盘 | 用户、会话、登录 / 操作统计与通知摘要 |
| 服务监控 | CPU、内存、磁盘、网络、磁盘 IO、CPU 温度、Top 进程、SSE 实时监控、历史趋势分桶 |
| 监控告警 | 告警规则、事件、概览；覆盖基础设施、工作流、支付、开放平台指标；自动恢复、静默期、多通道触达、认领处理 |
| 定时任务 | Cron 任务、5/6 段表达式、启停、手动执行、执行记录、pg-boss 调度 |
| 系统调度 | 内置调度任务配置、手动触发、运行记录、失败告警确认、节点视图、记录清理 |
| 任务中心 | 统一异步任务，进度、结果、失败处理、重试、取消与行级明细 |
| 导出中心 | 各模块异步导出任务、状态查询、文件下载 |
| 数据保留 | 运行数据保留策略、试算预览与定时清理 |
| 数据库备份 | 备份创建、下载、删除，基于 pg_dump |
| 数据库管理 | SQL 控制台、只读查询、表数据浏览 / 编辑、ER 图、运维面板、查询收藏 |
| Web 终端 | WebSocket 终端、多标签 / 分屏、大小调整、实时输入输出 |
| SSH / SFTP | SSH Profile、密码 / 密钥 / Agent、远程文件浏览、上传下载、编辑、chmod |
| 终端录屏 | 录屏列表、筛选、回放、删除与清理 |
| 终端会话 | local / ssh / docker 会话快照、筛选与强制终止 |
| 服务器文件管理器 | 文件浏览、上传下载、新建、重命名/移动、复制、删除、文本编辑、权限、压缩/解压、搜索、校验和 |
| 进程 / 端口 | 进程列表、资源占用、结束进程、nice、端口监听、协议筛选、结束占用进程 |
| Docker 管理 | 容器、镜像、网络、卷管理，日志查看与 prune |
| 网络诊断 | ping、traceroute、DNS、PTR、HTTP(S) 探测、端口连通、本机网卡 |
| systemd 服务 | 服务列表、状态、启停、重启、自启、mask、失败筛选、实时日志 |
| 防火墙 / Nginx / SSL | 防火墙规则、Nginx 站点、SSL 证书管理 |
| 指标与链路 | GET /metrics Prometheus 指标与可选 OpenTelemetry tracing |
| 应用版本 | 客户端应用、版本、制品、发布/撤回、灰度比例、升级统计；支撑 Electron Web 热更新与壳全量更新 |
工作流引擎
专题文档：工作流
| 模块 | 当前能力 |
|---|---|
| 流程定义 | CRUD、复制、导入导出、发布、启停、版本历史、恢复、差异对比 |
| 流程分类 | 分类、颜色、排序与设计器侧栏集成 |
| 表单库 | 表单 CRUD、可视化表单设计、字段配置、内联渲染 |
| 业务表单接入 | 表单库表单、自定义业务表单、businessKey 外部业务实体三种接入 |
| 流程模板 | 模板维护、流程另存为模板、从模板创建流程 |
| 流程设计器 | 发起人、审批、办理、抄送、条件分支、路由网关、延迟器、触发器、子流程、表单权限、操作权限、撤销重做 |
| 流程仿真 | 复用真实 DAG 引擎 dry-run，支持表单输入、预设人工动作、断点、自动播放、路径与分支命中、健康问题、阻塞点、保存仿真用例 |
| 发起工作台 | 按分类浏览已发布流程并发起申请 |
| 我的申请 | 草稿、提交、进度、撤回、时间线 |
| 待我审批 | 通过、驳回、转办、委派、加签/减签、退回、催办、跳转、重派、撤回审批、手写签名 |
| 抄送我的 / 我已办 | 任务列表、详情与轨迹查看 |
| 审批代理 | 指定时间范围的代办规则与启停 |
| 定时发起 | Cron 自动发起流程实例 |
| 自动化 | 条件触发的数据操作自动执行 |
| 事件订阅 | Webhook 订阅、投递记录、触发器执行记录 |
| 连接器 / 远程数据源 | 外部系统连接器与表单远程选项数据源 |
| 外部审批 / 回调 | 外部审批配置与回调接口 |
| 健康巡检 | 积压、死信、失败率、卡死实例等检测并接入告警 |
| 移动审批 | approval.html 独立轻页 |
即时消息中心（Chat）
专题文档：即时通讯
| 模块 | 当前能力 |
|---|---|
| 会话管理 | 单聊 / 群聊、置顶、星标、免打扰、删除、在线与已读状态 |
| 群管理 | 成员、群主、群资料、公告 |
| 消息能力 | 文本、图片、文件、链接预览、投票、语音、回复、撤回、编辑、转发、@提及、表情回应、收藏、置顶 |
| 音视频通话 | WebRTC 1v1 / 群语音 / 视频通话与记录消息 |
| 草稿与状态 | 会话草稿、输入状态、失败重试、断线重连与补拉 |
| 媒体与搜索 | 历史图片 / 文件、灯箱预览、会话搜索、上下文定位、全局搜索 |
| 记录导出 | 聊天记录导出，受按钮权限控制 |
| 快捷聊天 | 浮动入口，在任意后台页面唤起 |
规则中心
专题文档：规则中心
| 模块 | 当前能力 |
|---|---|
| 决策表 | 输入 / 输出字段、命中策略（first / unique / priority / collect / any）、测试用例、版本历史、差异对比、影子运行 |
| 决策表灰度发布 | 发布时配置灰度百分比与主体表达式，按 FNV-1a 稳定分桶；支持灰度转正与放弃灰度 |
| 决策表批量仿真 | 粘贴 JSON Lines，单次最多 200 行，以编辑态求值，输出命中率、命中行分布与逐行结果 |
| 决策流 | 多步骤决策编排，逐步执行并输出各步轨迹；支持版本治理与回滚 |
| 评分卡 | 变量分段打分、权重、基础分、总分、等级 / 决策映射、发布快照、求值测试、版本治理与回滚 |
| 名单库 | 黑 / 白 / 灰名单、匹配模式、命中校验 |
| 统一求值 | decide() 门面运行决策表、决策流、评分卡、名单，业务方按 required / optional 语义接入 |
| 执行记录 | 资产类型、key、版本、调用方、业务关联对象、输入输出、命中行留痕 |
| 业务接入 | 支付风控、会员反滥用、工作流网关、开放平台、CMS 提交守卫、投诉分流等消费方 |
数据分析
专题文档：数据分析
| 模块 | 当前能力 |
|---|---|
| 行为分析 | PV / UV、停留、点击、设备、操作系统、时间范围筛选，配套 @zenith/analytics-sdk |
| 数据管理 | 分析数据请求历史与条件清理 |
| 前端错误监控 | JS 异常、Promise 拒绝、source map 堆栈还原、版本维度、页面与类型筛选 |
| Campaign / Experiment / Site | 站点、活动与实验等埋点治理数据结构与接口 |
报表中心
专题文档：报表中心
| 模块 | 当前能力 |
|---|---|
| 数据源 | API、内置只读主库、MySQL、PostgreSQL、SQL Server、静态数据、Excel / CSV；凭据加密、脱敏、连接测试 |
| 数据集 | 参数化 SQL、计算字段、缓存、物化快照、字段格式化、字典翻译、用户变量 |
| 仪表盘 | 拖拽设计器、图表组件、全局筛选、联动、钻取、条件格式、版本历史、收藏、PNG 导出 |
| 数据大屏 | 自由画布、等比缩放、深色皮肤、自动刷新、全屏展示 |
| 打印报表 | Univer 设计器、纵向扩展、聚合、套打、浏览器打印、Excel 导出 |
| 填报 | 填报模板、填报记录、数据回写 |
| 指标中心 | 指标定义、口径、生命周期，供报表复用 |
| 数据质量 | 质量规则、定时检测、异常记录处理 |
| 数据预警 | 聚合阈值监控、定时评估、邮件 / 站内信通知 |
| 治理与资产 | 环境、发布晋升、配额、SLA、资源治理、资产目录、资产模板 |
| 智能问数 | NL2SQL 与 ChatBI，会话式问数，敏感表 / 列屏蔽 |
| 分享订阅 | 公开分享链接、密码 / 过期、iframe 嵌入、订阅推送、评论批注 |
支付中心
专题文档：支付中心
| 模块 | 当前能力 |
|---|---|
| 支付渠道 / 方式 | 微信支付、支付宝等渠道，支付方式、启停、默认切换 |
| 支付应用 | 按应用隔离业务接入 |
| 订单 / 退款 | 订单列表、详情、关闭、退款、状态追踪、内置公开支付页 |
| 回调 / 事件 / Webhook | 回调日志、手动重放、支付事件 outbox、业务方 Webhook 投递 |
| 对账 / 台账 / 报表 | 渠道对账、差异处理、资金账户、流水、财务报表 |
| 费率 / 结算 / 分账 / 转账 | 资金分配与结算链路管理 |
| 预授权 / 签约代扣 / 支付链接 | 授权冻结、签约扣款、免开发收款链接 |
| 风控 / 投诉 | 风控规则、处置与交易投诉管理 |
会员中心
专题文档：会员中心
| 模块 | 当前能力 |
|---|---|
| 会员看板 | 会员规模、增长、经营与活跃统计 |
| 会员管理 | 会员 CRUD、状态、重置密码、标签、登录方式、来源、详情抽屉 |
| 等级体系 | 成长值阈值、折扣、权益、动态关联 |
| 积分 | 账户、流水、管理员调整、事务与乐观锁 |
| 钱包 | 余额、流水、充值、退款、调整、金额分处理与乐观锁 |
| 优惠券 | 券模板、满减 / 折扣、发券记录、领取与使用状态 |
| 签到 | 签到规则、记录、里程碑奖励、前台签到 |
| 安全审计 | 会员登录日志、充值记录 |
| 前台会员 SPA | member.html，手机号验证码、手机号 / 邮箱 / 用户名密码登录、资料、积分、钱包、卡券、签到 |
微信公众号
专题文档：微信公众号
| 模块 | 当前能力 |
|---|---|
| 公众号账号 | 多账号、凭据、加密模式、回调配置、连接测试、内容安全、关注建会员 |
| 粉丝 / 标签 | 粉丝同步、标签、黑名单、会员绑定、扫码送积分、VIP 优先接入 |
| 消息 / 自动回复 | 消息记录、客服消息、富媒体、正则匹配、转人工、热词收集 |
| 多客服 | 客服账号、会话状态机、转接、分配、满意度、报表、WebSocket 实时 |
| 菜单 | 自定义菜单、个性化菜单、规则匹配测试 |
| 素材 / 草稿 | 永久素材上传、图文草稿 |
| 运营触达 | 群发、模板消息、带参二维码 |
| 网页开发 | 网页授权 OAuth2、JS-SDK 签名 |
| 数据统计 | 用户、消息、图文、分享、接口分析与内容安全校验 |
CMS 内容管理
专题文档：CMS 内容管理
| 模块 | 当前能力 |
|---|---|
| 数据看板 | 站点、内容、访问与运营数据总览 |
| 站点 / 栏目 | 多站点、父子层级、栏目树、站群继承 |
| 内容 / 模型 | 内容 CRUD、独立编辑页、发布流转、自定义模型字段 |
| 素材 / 标签 / 友情链接 | 素材中心、内容标签、友情链接 |
| 页面搭建 / 页面部件 | 可视化页面搭建，可复用部件与独立编辑页 |
| 发布中心 | 动态 / 混合 / 全静态发布、任务队列、失败重试、断点续跑 |
| 检索 / SEO | 全文检索索引、SEO 配置 |
| 评论 / 广告 / 表单 / 问卷 | 评论审核、广告投放与事件统计、自定义表单、互动问卷 |
| 内容治理 | 敏感词库、易错词库、内容采集 |
| 访问统计 / 订阅 / 分发 | 访问统计、会员订阅、跨站内容分发 |
| 前台渲染 | CMS 前台路由与主题渲染，支持静态输出目录配置 |
知识中心（Wiki）
专题文档：知识中心
| 模块 | 当前能力 |
|---|---|
| 文档中心 | 空间内文档树、富文本编辑、发布态浏览、文档详情 |
| 文档编辑 / 版本 | 独立编辑页、版本历史、版本对比 |
| 知识空间 | 空间 CRUD、成员授权、可见性与排序 |
| 发布审核 | 文档发布审核流程与状态管理 |
| 文档模板 | 模板维护与复用 |
| 标签 / 评论 | Wiki 标签管理、文档评论管理 |
| 回收站 | 删除文档恢复与清理 |
| 知识统计 | 空间、文档、阅读与协作统计 |
| 知识库设置 | Wiki 运行配置 |
| 内容治理 | 内容治理规则与处理视图 |
| AI 联动 | 发布文档可同步到 AI 知识库供对话引用 |
开放平台
专题文档：开放平台
| 模块 | 当前能力 |
|---|---|
| 应用管理 | OAuth 2.1 授权码 + PKCE、客户端凭证、刷新令牌轮换、撤销/自省、IP 白名单、双密钥宽限轮换、应用审核 |
| 我的应用 | 开发者自助应用、凭据、生产 / 沙箱双环境 |
| API Scope | 开放接口权限范围定义与授权，含 rules:evaluate 等业务 scope |
| 限流套餐 | QPS、日、月配额，阈值告警与套餐分配 |
| 调用统计 | 开放 API 调用量、状态、耗时与导出 |
| 签名验签 | HMAC 签名网关与在线签名 / 验签工具 |
| Webhook 订阅 | 应用订阅、签名投递、失败重试、连续终态失败自动停用 |
| SDK 示例 | 接入示例代码与语言切换 |
| API 调试台 | 在线调试开放接口；本机网关地址可由 OPEN_API_INTERNAL_BASE_URL 覆盖 |
| 开放网关 | /api/open/v1/* 统一鉴权、scope、限流、签名与调用日志 |
AI 功能区
专题文档：AI 能力
| 模块 | 当前能力 |
|---|---|
| 智能对话 | SSE 流式输出、多会话、编辑重发、重新生成、分支切换、图片、语音输入 / 朗读、导出、公开分享、反馈 |
| 模型服务商 | 服务商、模型、API Key、端点、默认服务商、连接测试、个人 AI 配置 |
| 知识库 | 知识库、文档分块、PgVector 检索、URL 抓取、对话引用 |
| 智能体 | 自定义 Agent 配置并注册为 Mastra Agent |
| AI 工具 | HTTP 工具定义，供函数调用外部接口 |
| 模型评测 | 数据集、实验、异步评测、ground-truth 与 LLM-as-judge、多模型竞技场 |
| 提示词模板 | 系统级 / 用户私有模板、分类、排序、启停 |
| 用量统计 | Token、请求数、模型分布、用户用量 |
| 对话审计 / 反馈 | 管理端审计查询与点赞 / 点踩反馈处理 |
| Mastra Studio | /studio/ 静态控制台，数据面 /api/mastra，权限 ai:studio:access |
数据与业务示例
| 模块 | 当前能力 |
|---|---|
| 业务请假 | businessKey 接入工作流的最小示例，事件回调回写业务状态 |
| 支付接入示例 | 业务模块下单、支付、回调入账示例 |
| 异步任务示例 | 批量任务、进度上报、结果查询示例 |
界面与个性化
| 模块 | 当前能力 |
|---|---|
| 主题 | 亮色、暗色、跟随系统；侧边栏 / 顶部 / 主区深色层级；35 种主题色与自定义颜色 |
| 可访问性辅助 | 灰色模式、色弱模式、对比度优化 |
| 水印 | 页面水印，内容可回退为当前用户名 |
| 路由动画 | 无动画、淡入、上滑、左滑 |
| 偏好设置 | 拼音搜索设置项，导航、面包屑、侧边栏、表格、标签页等偏好 |
| 标签页 | 右键菜单、刷新、收藏、关闭、拖拽排序、超限驱逐、新标签位置、双击行为、最大数量 |
| 菜单收藏 / 最近访问 | 收藏入口、顶部快速访问、最近 20 条路由、清空 |
| 页面状态深链 | 页面级 Tab 与分栏选中项可按偏好同步到 URL |
| PWA | 可选 Service Worker 与 Manifest，静态资源预缓存，API 网络优先 |
| Electron 标题栏 | 自定义标题栏、窗口控制、最大化状态同步、在线升级入口 |
跨模块共性能力
权限与访问控制
- 管理员与会员是隔离的认证上下文、请求实例和会话语义。
- 菜单与按钮权限分离，动态菜单按用户权限加载。
- 数据权限由服务端执行，支持全部、自定义、本部门、本部门及以下、仅本人等范围。
- 多租户通过服务端
tenant_id隔离；平台超管可切换租户视角。
请求安全防护
- 接口限流使用 Redis。
- 幂等控制基于 Redis
SET NX EX，支持X-Idempotency-Key与自动指纹模式。 - CSRF 校验
Origin，生产通过ALLOWED_ORIGINS配置。 - 报表、AI、开放平台 Webhook 等出站请求具有私网 / 本机 allowlist 控制。
- 文件上传做 Magic Bytes 检测。
API 与数据规范
- 响应信封：
{ code, message, data }。 - 分页结构：
{ list, total, page, pageSize }。 - OpenAPI + Zod 校验，请求参数通过路由校验后进入 service。
- 时间字符串统一
YYYY-MM-DD HH:mm:ss。
多入口前端
index.html：后台管理。member.html：会员前台。approval.html：移动审批。- Electron 模式切换为
HashRouter。 - Demo 模式由 MSW 替换 API 边界。
实时与可观测
- WebSocket：通知、Chat、终端等实时通道。
- SSE：服务监控、AI 流式等场景。
- 健康检查：
GET /api/health。 - 指标采集：
GET /metrics。 - Trace：可选 OpenTelemetry OTLP 导出。
文档与调试
- Swagger UI：
/api/docs。 - OpenAPI JSON：
/api/openapi.json。 - Mastra Studio：
/studio/，生产需要登录与ai:studio:access。 - Demo 站：
/demo/，由 GitHub Pages 工作流从 MSW 构建产物合并发布。