小z

一.项目定位 本项目为单人独立开发的轻量化通用后台基座开源项目，基于FastAPI+Vue3前后端分离架构。V1.0版本仅保留所有业务系统必备核心能力，零冗余、高稳定、易扩展，主要用于个人技术沉淀、公众号/博客开源引流，以及快速承接定制化开发接单业务。所有非刚需工具类、可视化、复杂业务功能均后置迭代，首发版本只做基座闭环。 二、整体业务流程总览 1.管理员访问前端页面，输入账号密码+图形验证码完成登录，后端校验账号状态、密码、验证码，签发JWT令牌 2.前端携带Token请求后端接口，全局拦截器统一校验会话有效性 3.后端根据当前登录用户角色，动态分配菜单、按钮、接口权限 4.前端根据权限动态渲染侧边栏菜单、操作按钮，无权限内容自动隐藏 5.管理员可进行用户、角色、菜单、系统配置等基础操作 6.系统自动记录登录日志、操作日志、异常日志，完成全流程审计 7.所有业务操作复用全局分页、异常处理通用能力 三、核心功能开发需求 1.身份认证与安全体系 - 图形验证码登录：前端展示随机图形验证码，后端生成、校验、过期销毁，防止恶意请求 - 账号密码认证：密码加密存储，登录校验账号启用状态、密码正确性 - JWT会话管理：登录成功签发JWT令牌，设置过期时间，支持基础自动续期，退出登录销毁令牌 - 防暴力破解：限制单账号短时间登录失败次数，超限锁定登录权限 - 个人中心：支持查看个人信息、修改登录密码、编辑基础资料 - 账号状态管控：支持账号启用/禁用，禁用账号无法登录系统 2.RBAC五级权限体系 采用 用户-角色-菜单-按钮-接口 五级权限模型，实现权限闭环，杜绝越权操作。 四、项目核心功能 1. 权限管理模块（RBAC 完整体系） 用户管理：新增、编辑、删除、重置密码、分配角色 角色管理：新增、编辑、删除、分配菜单权限 菜单管理：动态菜单、路由权限、按钮权限控制 细粒度按钮权限控制（v-permission） 动态路由自动生成，切换用户自动刷新权限 2. 个人中心模块 个人资料查看与修改 个人密码修改（验证旧密码） 3. 全套日志审计系统（核心亮点） 登录日志：记录登录账号、IP、设备、登录状态、登录时间 异常日志：全局异常自动捕获、自动记录堆栈信息 所有日志支持：分页查询、条件筛选、时间范围筛选、一键清空 4. 系统特性 JWT 无状态登录、自动鉴权 全局异常统一处理 动态路由权限隔离 接口权限注解控制 项目采用前后端分离架构，实现了完整的 RBAC 权限体系、用户管理、角色管理、菜单管理以及日志审计功能，适合作为毕设、课程设计、二次开发基础后台框架使用。