木木木头

【立项背景和目标】 中小团队做内部管理系统时，登录鉴权、角色权限、用户管理这些基础模块几乎每个项目都要重写一遍，既浪费时间，权限校验也容易写漏，留下越权漏洞。本项目目标是把这套通用底座做成可直接复用的脚手架：后端提供接口级强制权限校验，前端提供可复用的管理界面，新项目接入后只需专注业务模块，不必重复造轮子。 【核心功能模块】 1. 认证模块：JWT 令牌登录，密码使用 PBKDF2-HMAC-SHA256 加盐哈希（12 万次迭代），接口响应永不返回密码等敏感字段。 2. 权限模块（RBAC）：用户—角色—权限点三级模型，内置超级管理员、运营人员、只读访客三个角色，权限在后端强制拦截。 3. 用户管理模块：关键词模糊搜索，角色/状态/部门多条件筛选，分页（每页 10/20/50 可调），增删改查，启用禁用，重置密码，CSV 导出（带 UTF-8 BOM，Excel 打开中文不乱码）。 4. 数据看板模块：统计卡片、近 30 天注册趋势折线图、角色分布环形图、最近操作记录列表。 5. 审计模块：记录登录、登出、登录失败、增删改、导出等全部写操作，含操作人、IP、时间。 【业务流程和功能路径】 用户登录 → 后端校验账号密码并签发 JWT → 前端携带令牌请求接口 → 后端解析令牌、查库校验账号是否被禁用、再校验当前角色是否具备该接口所需权限点 → 通过则返回数据，否则返回 401 或 403 → 前端依据返回的权限列表决定展示哪些菜单与按钮 → 所有写操作同步写入审计日志 → 看板实时汇总统计。