基于 Hono v4 + React 19 + Semi Design v2 + Drizzle ORM 的全栈后台管理系统。涵盖认证授权、组织架构、权限控制、系统配置、通知中心（邮件 / 短信 / 站内信）、日志审计、在线会话、定时任务、文件存储、缓存管理、低代码工作流、规则引擎、智能助手（AI）、数据分析、报表中心（BI）、支付中心、会员体系（含 C 端门户）、公众号管理、开放平台、CMS 内容管理、服务器运维（Web 终端 / SSH / Docker）等完整业务场景，并内置可选的 多租户（Multi-Tenant） 支持。
项目采用 npm monorepo 结构：后端使用 Hono + PostgreSQL 提供 RESTful API，前端使用 React 19 + Vite + Semi Design v2 构建界面，shared 包统一维护前后端共享类型、常量与 Zod 校验 schema。
| 地址 | |
|---|---|
| 文档站 | https://iwangbowen.github.io/zenith-admin/ |
| 演示站 | https://iwangbowen.github.io/zenith-admin/demo/（账号 admin / 密码 123456，无需后端） |
| 层级 | 技术 |
|---|---|
| 后端框架 | Hono v4 + Node.js |
| 前端框架 | React 19 + Vite 6 |
| UI 组件库 | Semi Design v2 |
| 图标体系 | lucide-react |
| 数据库 ORM | Drizzle ORM + PostgreSQL |
| 会话 / 缓存 | Redis（ioredis） |
| 任务调度 | pg-boss（PostgreSQL 任务队列） |
| 前端路由 | React Router v7 |
| 参数验证 | Zod（前后端共享） |
| 认证方案 | JWT（Access + Refresh Token 自动续期）+ OAuth2 |
| 实时通信 | WebSocket |
| 流程 / 终端 | React Flow（@xyflow/react）+ xterm.js |
| 可观测性 | OpenTelemetry + Prometheus |
| 文件存储 | 本地 / 阿里云 OSS / 腾讯云 COS / 华为云 OBS / 七牛云 Kodo / 百度云 BOS / Azure Blob / S3 兼容 / SFTP |
| 桌面客户端 | Electron（Windows / macOS / Linux） |
| 包管理器 | npm（monorepo） |
- 登录注册：账号密码登录、图形验证码校验、注册开关全局控制、找回密码（邮箱重置）
- OAuth 第三方登录：支持 GitHub、钉钉、企业微信一键登录与账号绑定
- OAuth2 授权服务：内置 OAuth2 应用管理与标准授权端点，可作为第三方系统的统一登录中心
- JWT 鉴权：Access Token + Refresh Token 双 Token 机制，自动静默续期
- 密码策略：复杂度规则（最小长度、大写字母、特殊字符）+ 密码过期强制修改
- 登录安全：登录失败次数限制 + 账号自动锁定（基于 Redis 计数），管理员可解锁
- API Token：个人 API Token 创建与管理，用于第三方接口调用鉴权
- 用户管理：CRUD、启停用、角色/部门/岗位分配、批量操作、Excel 批量导入（含模板下载）、管理员重置密码、用户级直接菜单授权与有效权限预览
- 角色管理：CRUD、菜单权限树形分配（父子不联动精确授权，勾选页面自动带上「查询」权限点）
- 菜单管理：目录 / 菜单 / 按钮三级能力模型，显示与操作解耦——目录/菜单为纯显示资源，全部权限码（含查询）由按钮型权限点承载；虚拟化树形表格流畅维护近千节点
- 动态菜单路由：前端根据用户角色自动注册可访问页面，实现路由级权限隔离
- 按钮级权限：基于
usePermissionHook 的细粒度前端编程式权限控制 - 数据权限：全部 / 自定义 / 本部门 / 本部门及以下 / 仅本人五种数据范围
- 用户组：跨部门用户分组与成员分配，组绑定角色自动继承
- 部门管理：树形组织层级维护
- 岗位管理：岗位信息维护与用户关联
- 系统配置：验证码开关、密码策略、注册控制、登录失败锁定等核心行为动态配置
- IP 访问控制：白名单/黑名单双模式，支持 CIDR 网段，配置热更新缓存，附访问日志
- 数据脱敏：手机号 / 邮箱 / 身份证 / 姓名 / 银行卡 / 自定义规则的字段脱敏
- 接口限流：高危接口请求频率限制（基于 Redis 计数），规则可视化管理
- 维护模式：一键开启站点维护，支持白名单放行
- 标签管理：统一标签体系，供多业务对象复用
- 邮件 / OAuth 配置：SMTP 服务器、第三方登录 Client ID/Secret 配置与测试
- 数据字典：字典类型与字典项统一管理，前后端共用
- 通知公告：富文本（wangEditor）编辑、发布/草稿状态控制、已读记录管理、批量操作
- 多通道通知中心：邮件 / 短信 / 站内信三通道，统一模板（变量占位符）与发送记录
- 邮件：SMTP 配置、邮件模板、发送记录
- 短信：阿里云 / 腾讯云短信，配置、模板、发送记录
- 站内信：站内信模板、收件记录
- 实时推送：基于 WebSocket 的新通知实时推送，前端自动重连（指数退避）
- 消息中心（IM）：内置即时通讯，单聊/群聊、语音消息、投票、消息转发、卡片消息、未读计数、会话置顶与收藏、消息搜索
- Webhook 机器人：自定义入站 Webhook 机器人，接收并处理卡片消息
- 登录日志：记录登录行为（IP、浏览器、地理位置、状态），支持全局与个人视图及统计面板
- 操作日志：记录关键业务操作轨迹，支持变更前后字段 Diff 对比及统计面板
- 日志文件：服务端 Winston 日志文件在线查看与下载
- 在线会话：查看当前所有在线会话（Redis 持久化），支持强制下线并实时推送退出消息
- 文件管理：文件上传、列表查询、下载、删除及文件统计
- 可视化文件管理器：类资源管理器的目录浏览、上传进度、在线预览
- 多存储后端：本地、阿里云 OSS、腾讯云 COS、华为云 OBS、七牛云 Kodo、百度云 BOS、Azure Blob、S3 兼容、SFTP 共九种
- 默认存储切换：通过存储配置页面一键切换当前默认存储策略
- 定时任务：Cron 任务 CRUD、可视化 Cron 表达式构建器、手动立即执行、启停控制、执行历史日志（基于 pg-boss）
- 任务中心：统一异步任务框架（批量导入/导出、报表生成、静态化等长耗时操作），带进度推送、断点续跑、自动重试、取消与行级明细
- 数据库备份：基于 pg_dump 的手动备份，支持下载与删除，可结合定时任务自动化
- 数据库管理：在线 SQL 控制台、表数据编辑、ER 关系图、对象管理、运维面板（物化视图刷新、活动连接、表维护、索引健康、结构校验）
- 缓存管理：Redis 缓存可视化查看、按 Key 模式搜索、分类展示、支持单条/批量删除
- 系统监控：服务器实时状态（CPU、内存、Node.js 版本、运行时长）+ 历史趋势 + 温度传感器
- 监控告警：告警规则配置与告警记录
- 健康检查：
GET /api/health服务探活；内置 Prometheus 指标与 OpenTelemetry 链路追踪
- Web 终端：浏览器内 xterm.js 终端，多标签 / 分屏，主题可配
- SSH / SFTP：SSH 连接配置管理、远程 SFTP 文件浏览与权限修改
- 终端录屏 / 终端会话：会话录制回放与活动会话管理
- 进程 / 端口 / 服务：进程管理（工作目录、环境变量）、端口监听、systemd 服务管理
- Docker：容器 / 镜像查看与管理
- 网络诊断：Ping、DNS 查询、HTTP 探测等工具
- 日志查看器：服务端日志实时跟踪
运维能力依赖宿主机环境（node-pty、ssh2、dockerode 等），建议在受控的服务器环境启用。
- 流程定义：工作流 CRUD、分类管理、版本管理、草稿/发布/禁用、流程模板库
- 可视化设计器：基于节点（审批 / 条件 / 分支 / 抄送等）的流程设计器，支持条件编辑、操作与表单权限配置、节点监听器
- 表单设计器：拖拽式自定义表单（表单库 + 表单渲染）
- 流程办理：我的申请、待我审批、手写签名、抄送
- 审批代理：委托他人代为审批
- 流程自动化 / 事件订阅 / 触发器：基于事件总线的自动触发与执行记录
- 外部审批回调：对接外部系统的审批回调
- 流程监控：实例运行状态跟踪与流程分析
详见文档站：工作流引擎。
- 决策表 / 决策流：可视化规则编排与执行，支持决策执行记录追溯
- 名单库：黑白名单等名单集中管理，供风控与业务规则引用
- 智能对话：基于 Semi Design AIChat 的多会话对话，支持流式响应、Markdown 渲染、PDF 文档预览、消息导出、点赞/反馈闭环
- AI 服务商：多模型服务商配置与测试连接，支持用户级个性化配置
- 提示词模板：可复用提示词模板管理，对话中一键套用
- 用量统计：按模型 / 用户统计 Token 用量，支持日期范围查询
- AI 反馈：对话反馈收集与查看
- 行为分析：用户行为 / 事件埋点分析
- 数据管理：分析数据查询与维护
- 错误监控：前端错误上报与 SourceMap 堆栈还原
- 数据源 / 数据集：多数据源接入与数据集建模（可视化 SQL）
- 仪表盘：拖拽式仪表盘搭建、收藏、订阅推送与嵌入分享
- 打印报表 / 填报：打印模板设计、数据填报模板与填报记录
- 数据治理：指标中心、数据质量规则、数据预警、查询配额与 SLA、资源治理与资产目录
- 智能问数（ChatBI）：自然语言查询数据
- 支付渠道：微信支付、支付宝多支付方式（扫码 / JSAPI / H5、电脑 / 手机 / APP）渠道配置
- 支付订单：下单、支付状态机（待支付 → 支付中 → 成功 / 关闭 / 退款）、订单查询
- 退款 / 转账 / 预授权 / 签约代扣：完整资金操作与状态跟踪
- 资金治理：对账中心、资金台账、费率管理、结算管理、分账管理、财务报表
- 风控与接入：风控中心、交易投诉、支付链接、应用管理、Webhook 与回调日志（验签对账）
- 事件总线：支付成功事件订阅，供会员充值等业务异步入账
详见文档站：支付中心。
后台管理（会员中心）：
- 会员看板 / 会员管理 / 会员等级：会员概览、资料与等级体系维护
- 积分管理：积分账户与流水，事务 + 乐观锁原子记账
- 钱包管理：余额账户与流水、充值（对接支付中心）、退款，金额以分为单位
- 优惠券 / 领券记录：优惠券发放与会员领取记录
- 会员签到：签到规则、里程碑配置与签到记录
- 会员安全：会员登录日志与充值记录审计
前台会员门户（C 端独立 SPA）：
- 独立入口
member.html，移动优先，独立 JWT 与会话隔离 - 多方式登录：手机号 + 验证码 / 手机号 + 密码 / 邮箱 + 密码 / 用户名 + 密码
- 会员中心：等级、积分、钱包充值、优惠券、签到、登录历史、资料与密码管理
- 账号与粉丝：公众号账号接入、粉丝管理、标签管理
- 消息能力：消息管理、自动回复、模板消息、群发消息、多客服与会话工作台
- 菜单与素材：自定义菜单、个性化菜单、素材管理、图文草稿
- 运营工具：带参二维码、网页授权、数据统计
- 应用与凭证：开放应用管理、我的应用、API Scope 授权范围
- 调用治理：限流套餐、调用统计、签名验签
- 集成能力：Webhook 订阅、SDK 示例、API 调试台
- 多站点与站群：站点管理（父子层级、显式继承与覆盖）、栏目管理、发布通道、跨站内容分发
- 内容生产：内容管理与编辑、内容模型（自定义字段）、素材中心、标签 / 碎片 / 友情链接、采集中心、页面搭建（区块 ACL）
- 内容治理：敏感词库、易错词库、评论审核、SEO 管理、检索管理（全文搜索）
- 前台渲染：内置 React TSX 主题（
default企业门户 /docs文档站）服务端 SSR 渲染，支持动态 / 混合 / 全静态三种静态化模式 - 运营互动：广告管理、表单管理、互动问卷、会员订阅、访问统计、数据看板
- 发布中心：统一发布任务队列、逐路径产物与日志、失败重试与断点续跑
- 基本信息：修改头像、昵称、手机、邮箱等个人资料
- 修改密码：验证旧密码后更新
- 关联账号：查看已绑定的第三方 OAuth 账号，支持解绑
- API Token：个人 Token 自助管理
- 登录记录 / 操作记录：查看本账号历史行为日志
- 租户管理：CRUD、状态管理、有效期控制、最大用户数限制，仅平台超管可操作
- 租户套餐：菜单白名单圈定租户可用功能范围，租户绑定套餐生效
- 数据隔离：开启后各业务表自动按
tenant_id隔离，删除租户时级联清理 - 视角切换：平台超管可在顶栏一键切换至任意租户视角进行排查
- 单租户兼容：默认关闭，关闭时与普通单实例部署完全兼容
通过
MULTI_TENANT_MODE=true（后端）+VITE_MULTI_TENANT_MODE=true（前端）开启，详见多租户指南。
- 行政区划：国家级 → 省 → 市 → 区 → 街道 五级查询，
RegionSelect组件支持级联懒加载 - 仪表盘：用户总数、在线人数、今日登录/操作次数统计卡片 + 通知公告摘要
- Swagger UI：内置
/api/docs在线接口文档，支持 Bearer Token 授权调试 - OpenAPI JSON：
/api/openapi.json可直接导入 Postman / Apifox - Demo 模式：
VITE_DEMO_MODE=true开启 MSW Mock，无需后端即可完整预览所有页面 - 桌面客户端：基于 Electron 打包 Windows / macOS / Linux 桌面应用
Zenith Admin 专为 AI 辅助开发场景设计，让 GitHub Copilot、Claude、Cursor 等工具在生成代码时能精准理解项目约定。
| 文件 / 目录 | 用途 |
|---|---|
AGENTS.md |
AI 工具的"项目说明书"，包含架构约定、常用命令与注意事项 |
.agents/skills/zenith/ |
Zenith CRUD Skill：完整的模块开发工作流，一句话触发全流程自动化生成 |
在支持 Skills 的 AI 工具中描述需求，即可自动完成 Schema → 迁移 → 类型 → 路由 → 前端页面 → Mock 数据 的端到端生成。详见文档站：AI 辅助开发。
前置条件：Node.js >= 18、PostgreSQL、Redis
npm install在 packages/server/ 目录下创建 .env 文件（参考 packages/server/.env.example），最小配置如下：
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/zenith_admin
JWT_SECRET=your-secret-key
REDIS_URL=redis://127.0.0.1:6379前端默认请求 http://localhost:3300，如需修改，在 packages/web/ 下创建 .env 并设置 VITE_API_BASE_URL。
npm run db:migrate # 执行数据库迁移
npm run db:seed # 填充初始数据（创建默认 admin 账号）npm run dev # 同时启动前端 + 后端（推荐）
npm run dev:server # 仅启动后端
npm run dev:web # 仅启动前端默认账号：admin / 密码：123456
npm run build # 顺序构建：shared → server → web构建产物：后端 packages/server/dist/，前端 packages/web/dist/。
完整部署说明（Docker、Nginx 反代等）参见文档站：快速开始。
本项目采用 MIT License。