# ooad-rbac **Repository Path**: yiyanwuxiao/ooad-rbac ## Basic Information - **Project Name**: ooad-rbac - **Description**: 基于ooda的rabc项目检查 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-26 - **Last Updated**: 2026-10-28 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # OOAD RBAC 权限管理系统 面向集团/部门两级管理的 RBAC 权限中台,覆盖组织与人员、应用与功能目录、角色与授权范围、人员授权、管理员治理。 后端 Spring Boot 4 + Spring Data JPA + MySQL,管理端 Vue 3,线上以 Docker Swarm 部署在华为云。 ## 功能概览 | 模块 | 说明 | |---|---| | F01 认证与会话 | 工号/手机号 + 口令登录,JWT 会话;停用、撤权、改密立即失效 | | F02 组织与人员 | 组织树、人员查询与建号;姓名/手机号加密存储,接口返回脱敏值 | | F03 应用与功能目录 | 应用与权限点管理,应用/功能停用即时影响有效权限 | | F04 角色与授权范围 | 角色 CRUD、功能集合、范围(组织 + 是否含下级) | | F05 人员授权 | 按应用替换角色,查询有效权限及全部来源 | | F08 人员状态流转 | `ACTIVE` / `HANDOVER` / `DISABLED` | | F09 管理员治理 | 仅系统管理员可授予/撤销管理员,禁止自改与摘除最后一名 | | F10 审计日志 | 写操作审计(规划中) | 权限求值全部由视图 `v_rbac_effective_permission_source` 驱动:应用停用、功能停用、角色停用、范围不覆盖、人员非在职,任一变化即刻反映到有效权限。 ## 技术栈 | 层 | 选型 | |---|---| | 后端 | Java 21、Spring Boot 4.1、Spring Data JPA、Hibernate 7、MySQL 8 | | 前端 | Vue 3、TypeScript、Vue Router、Vite 6、Tailwind CSS 4 | | 数据库 | MySQL 8.0.16+(utf8mb4),15 张表 + 8 个视图 | | 部署 | Docker Swarm、华为云 SWR、Nginx | ## 项目结构 ```text . ├── api/ OpenAPI 3 接口契约 ├── core/ 公共模块(返回体、加密工具、分页) ├── database/ 建库脚本与演示数据 ├── docs/ 需求分析、详细设计、数据库设计、ER 图 ├── frontend/ Vue 管理端 └── RBAC_OOAD/ Spring Boot 后端 ``` ## 环境要求 - JDK 21 - Maven 3.9+ - Node.js 22 LTS+(仅前端) - MySQL 8.0.16+ ## 本地运行 ```bash # 1. 建库(创建 ooad_rbac_m45 并导入演示数据) mysql -u root -p --default-character-set=utf8mb4 \ --execute="source database/module4_5_test_setup.sql" # 2. 安装公共模块(RBAC_OOAD 依赖 core) mvn -f core/pom.xml install -DskipTests # 3. 启动后端(默认 8080,连接 127.0.0.1:3306/ooad_rbac_m45) mvn -f RBAC_OOAD/pom.xml spring-boot:run # 4. 启动前端(默认 4173,/api 代理到 8080) cd frontend && npm ci && npm run dev -- --port 4173 --strictPort ``` 后端地址 ,前端地址 。 ## 演示账号 口令统一 `Xinghai2026`。 | 工号 | 身份 | 说明 | |---|---|---| | SG000001 | 系统管理员 | 仅做 F09 管理员治理,对业务应用零特权 | | SG000002 | 集团管理员 | 组织维护岗,可见全组织树 | | SG000191 | 部门管理员 | 管理道路工程分公司子树 | | SG000065 | 部门管理员 | 管理财务部子树 | | SG000003 | 普通员工 | 无管理员资格,适合作为授权测试对象 | 越权访问统一返回 **404**(不泄露"存在但不可见"),这是有意设计。 ## 接口契约 - OpenAPI 3:`api/RBAC_OOAD 管理端 API.openapi.json` - 登录:`POST /api/sessions`,请求体 `{"identifier":"SG000001","password":"Xinghai2026"}` - 其余接口均需请求头 `Authorization: Bearer ` > 注意:文档中的 `GET /api/organizations/{org_id}` 与 `GET /api/organizations/{org_id}/move-impact` 尚未实现,调用会返回 405/404。 ## 部署 四节点 Docker Swarm(编译 / 管理 / 数据库 / 应用),镜像推送华为云 SWR: ```bash # 编译节点 mvn -f core/pom.xml install -DskipTests cd RBAC_OOAD && mvn clean package -Dmaven.test.skip=true docker build -t /rbac:0.0.1 . docker tag /rbac:0.0.1 swr.cn-north-4.myhuaweicloud.com//rbac:0.0.1 docker push swr.cn-north-4.myhuaweicloud.com//rbac:0.0.1 # 管理节点 docker service update --image swr.cn-north-4.myhuaweicloud.com//rbac:0.0.1 \ --with-registry-auth lab_rbac ``` 数据库以宿主机目录挂载(`/root/mysql/data`),服务重启不丢数据;应用会话存内存,重启后需重新登录。 ## 文档 | 文档 | 位置 | |---|---| | 需求规格说明书 V3.3 | [docs/需求分析](docs/需求分析) | | 详细设计(可读版 HTML / 源文件) | [docs/设计文档](docs/设计文档) | | 数据库设计(可读版 HTML / 源文件) | [docs/设计文档](docs/设计文档) | | API 设计(可读版 HTML / 源文件) | [docs/设计文档](docs/设计文档) | | 界面原型说明(含截图) | [docs/设计文档](docs/设计文档) | | ER 图:全量物理 / 核心授权 / 管理员与审计 | [docs/er](docs/er) |