功能模块

管理端功能

系统总览

首页数据报表：用户总数、在线用户、角色数量、菜单/按钮数、部门数量、近 7 天登录趋势、各部门人数与最近登录记录，基于 ECharts 展示。

系统权限

模块	能力
菜单管理	菜单/页面/按钮三级结构，支持图标、排序、状态、备注；页面路径驱动前端动态路由，API 权限与菜单绑定
角色管理	角色 CRUD、树形层级、分配菜单权限、查看角色下管理员
人员管理	管理员增删改查、角色分配、重置密码（改密即踢下线）、强制下线；超级管理员受保护
部门管理	部门树 CRUD，支持负责人、排序、状态

用户管理

会员用户查询展示与账号启用/禁用，详见会员用户体系。

消息中心

站内消息与小程序订阅消息推送，接口详见管理端消息中心：

• 消息模板：维护站内标题/内容模板与微信、支付宝、百度、抖音、QQ、快手小程序订阅消息配置，支持 占位符、变量定义与启用渠道；
• 消息发送：按模板渲染变量发送或自定义内容发送，站内消息与小程序推送一次完成；会员未绑定小程序身份或配置未启用时逐渠道记录失败原因，不影响站内消息；
• 记录查询：站内消息记录（含接收会员信息与已读状态）与小程序推送记录（openid、模板数据快照、第三方消息ID、失败原因）分页查询。

系统配置

• 渠道配置：存储（本地/阿里云 OSS/腾讯云 COS/七牛/MinIO）、短信（阿里云/腾讯云/短信宝/SMS.cn/云片，含开发配置、签名、模板和发送记录）、微信（公众号/开放平台/小程序）、支付（微信支付/支付宝）；
• 平台配置：管理端 Logo 与系统名称（登录页/顶栏动态展示）、用户端默认昵称与头像（注册默认资料）、系统版本号只读展示。
• 定时任务：数据库配置秒级 Cron 任务，支持可视化组合周期、启停、立即执行和执行日志；后端通过安全处理器注册机制扩展，详见定时任务开发指南。

系统维护

• 日志维护：操作日志分页查询、删除、清空；查询日志本身不写日志；
• 插件管理：已安装插件、编译状态、版本对比、迁移记录、启用/停用。

个人设置

修改昵称、手机号、邮箱、头像与登录密码。

文件上传与存储

• 管理端与用户端各自提供统一上传接口（multipart，字段名 file，单文件 ≤ 50MB）；
• 上传记录保存于 sys_upload_file，同时保存相对路径与上传时的完整地址快照；
• 业务表只保存相对路径，访问地址按当前默认存储渠道动态补全——更换域名或存储渠道无需批量修改业务数据；
• 本地存储通过 /files/*filepath 访问；
• 远程文件抓取使用内置安全 HTTP 客户端（限制内网地址，防 SSRF）。

用户端能力

• 会员注册与登录（验证码/密码），单会话令牌，详见登录鉴权与会员用户体系；
• 个人资料查询与维护（昵称、姓名、头像、账号、密码、手机号）；
• 站内消息列表、未读统计、详情查看（自动标记已读）、单条/全部已读与删除清空，详见站内消息；
• 登录后文件上传；
• 平台来源与版本号请求头随每个接口传递；
• 插件可通过用户端路由组提供公开或登录后接口（如新闻资讯阅读）。

服务基础能力

• Gin Logger、Recovery 与统一 CORS；
• MySQL、Redis 初始化、连接释放与健康检查；
• HTTP 超时控制（读/写/空闲/停机）与 SIGINT/SIGTERM 优雅停机；
• 管理端启动时加载定时任务，多实例通过 MySQL 命名锁避免同一任务并发重复执行；
• 启动自检：核心必需表、初始管理员数据、插件状态与迁移；
• 统一响应 {code, msg, data}（HTTP 恒为 200）、分页规范（list + total）、数据库错误转友好提示。