功能模块

管理端功能

系统总览

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

系统权限

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

用户管理

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

系统配置

• 渠道配置：存储（本地/阿里云 OSS/腾讯云 COS/七牛/MinIO）、短信（开发配置/签名/模板/发送记录）、微信（公众号/开放平台/小程序）、支付（微信支付/支付宝）；
• 平台配置：管理端 Logo 与系统名称（登录页/顶栏动态展示）、用户端默认昵称与头像（注册默认资料）、系统版本号只读展示。

系统维护

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

个人设置

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

文件上传与存储

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

用户端能力

• 会员注册与登录（验证码/密码），单会话令牌，详见登录鉴权与会员用户体系；
• 个人资料查询与维护（昵称、姓名、头像、账号、密码、手机号）；
• 登录后文件上传；
• 平台来源与版本号请求头随每个接口传递；
• 插件可通过用户端路由组提供公开或登录后接口（如新闻资讯阅读）。

服务基础能力

• Gin Logger、Recovery 与统一 CORS；
• MySQL、Redis 初始化、连接释放与健康检查；
• HTTP 超时控制（读/写/空闲/停机）与 SIGINT/SIGTERM 优雅停机；
• 启动自检：核心必需表、初始管理员数据、插件状态与迁移；
• 统一响应 {code, msg, data}（HTTP 恒为 200）、分页规范（list + total）、数据库错误转友好提示。