# right

**Repository Path**: ooderCN/right

## Basic Information

- **Project Name**: right
- **Description**: ooder  权限套件，支持RAD页面级授权。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-31
- **Last Updated**: 2026-01-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ooder-right

[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![Version](https://img.shields.io/badge/Version-0.5-blue.svg)](CHANGELOG.md)
[![Build Status](https://github.com/ooder/ooder-right/actions/workflows/build.yml/badge.svg)](https://github.com/ooder/ooder-right/actions)
[![Coverage Status](https://coveralls.io/repos/github/ooder/ooder-right/badge.svg?branch=main)](https://coveralls.io/github/ooder/ooder-right?branch=main)
[![Java Version](https://img.shields.io/badge/Java-1.8+-orange.svg)](https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html)

ooder-right是一个基于DDD领域驱动设计的全栈权限管理框架，构建了从"文档模型前置定义"到"代码DNA级植入"的全栈权限体系，解决AI时代权限管理的新痛点。基于"注解驱动+三层架构+四统一规范"，实现前后端强映射、四分离设计，支持视图层-服务层-仓库层的全栈权限校验。

## 功能特性

### 1. 核心权限管理
- ✅ 基于DDD领域驱动设计的模块化架构
- ✅ 从"文档模型前置定义"到"代码DNA级植入"的全栈权限体系
- ✅ 注解驱动+三层架构+四统一规范
- ✅ 前后端强映射、四分离设计
- ✅ 视图层-服务层-仓库层的全栈权限校验

### 2. 核心权限注解体系
- **@Aggregation**：服务聚合权限，确保"聚合调用的子服务权限统一"
- **@FieldAnnotation**：字段级权限控制，定义前端组件字段的属性和权限
- **@MethodChinaName**：方法中文名称注解，用于接口文档生成
- **@RequestMapping**：Spring MVC请求映射注解，定义API路径
- **@Controller**：Spring MVC控制器注解，标识控制器类

### 3. 权限领域模块
- **组件权限**：UI组件、表单、动作、工具栏、Tab、条件实例权限
- **模块权限**：模块和菜单权限
- **流程权限**：读者组、办理组、代办组权限
- **组织权限**：组织相关权限管理
- **页面权限**：页面级权限配置、属性权限配置

### 4. 技术特性
- ✅ Spring MVC框架
- ✅ Maven构建工具
- ✅ 支持表达式引擎
- ✅ 可视化配置界面
- ✅ RESTful API设计
- ✅ AI驱动的权限规则生成与校验
- ✅ 测试期表达式固化方案
- ✅ 标准化工具链
- ✅ MIT开源协议

## 快速开始

### 环境要求
- JDK 1.8+
- Maven 3.6+
- Spring Boot 2.x

### 安装

1. 克隆项目
```bash
git clone https://gitee.com/ooderCN/right.git
cd ooder-right
```

2. 构建项目
```bash
mvn clean install -DskipTests
```

3. 部署应用
将生成的jar包部署到Java应用服务器或直接运行：
```bash
java -jar target/ooder-right-0.5.jar
```

### 访问应用

应用启动后，通过以下地址访问：
- 应用地址：http://localhost:8080/right
- API文档：http://localhost:8080/right/swagger-ui.html
- 文档中心：项目根目录下的 `docs/` 文件夹包含完整的使用文档

### 开发文档

- [快速开始](docs/getting-started.md) - 快速上手 ooder-right 权限系统
- [权限模型](docs/permission-model.md) - 深入了解权限系统架构
- [注解参考](docs/annotations-reference.md) - 权限注解详细说明
- [表达式语言](docs/expression-language.md) - 权限表达式语法和函数
- [API文档](docs/api-documentation.md) - 完整的API接口文档

## 项目结构

```
ooder-right/
├── src/
│   ├── main/
│   │   ├── java/net/ooder/right/    # 主源码目录
│   │   │   ├── component/           # 组件权限领域
│   │   │   │   └── service/         # 组件权限服务实现
│   │   │   ├── module/              # 模块权限领域
│   │   │   ├── org/                 # 组织和流程权限领域
│   │   │   ├── page/                # 页面权限领域
│   │   │   └── RightIndex.java      # 应用入口
│   │   └── resources/               # 资源文件
│   └── test/                        # 测试代码
├── lib/                             # 本地依赖库
├── docs/                            # 项目文档
│   ├── getting-started.md           # 快速开始指南
│   ├── permission-model.md          # 权限模型文档
│   ├── annotations-reference.md     # 注解参考文档
│   ├── expression-language.md       # 表达式语言文档
│   └── api-documentation.md         # API文档
├── README.md                        # 项目说明文档
├── LICENSE                          # 开源协议
├── CONTRIBUTING.md                  # 贡献指南
├── CHANGELOG.md                     # 版本变更日志
└── pom.xml                          # Maven配置文件
```

## 领域模块与URL映射

| 领域名称 | 子模块 | URL路径 | 包路径 |
|---------|--------|--------|--------|
| 组件权限 | ui | /right/component/ui/ | net.ooder.right.component.service |
| 组件权限 | form | /right/component/form/ | net.ooder.right.component.service |
| 组件权限 | tab | /right/component/tab/ | net.ooder.right.component.service |
| 组件权限 | grid | /right/component/grid/ | net.ooder.right.component.service |
| 组件权限 | item | /right/component/item/ | net.ooder.right.component.service |
| 组件权限 | condition | /right/component/condition/ | net.ooder.right.component.service |
| 模块权限 | module | /right/module/module/ | net.ooder.right.module |
| 模块权限 | menu | /right/module/menu/ | net.ooder.right.module |
| 流程权限 | read | /right/bpm/read/ | net.ooder.right.org |
| 流程权限 | perform | /right/bpm/perform/ | net.ooder.right.org |
| 流程权限 | insteadsign | /right/bpm/insteadsign/ | net.ooder.right.org |
| 组织权限 | org | /right/org/org/ | net.ooder.right.org |
| 页面权限 | page | /right/page/ | net.ooder.right.page |

## 开发指南

### 编码规范
- 遵循Java编码规范
- 使用4个空格缩进
- 类名使用大驼峰命名法
- 方法名和变量名使用小驼峰命名法
- 常量名使用全大写，下划线分隔

### 提交规范
- 提交信息格式：`[类型] 描述`
- 类型包括：feat(新功能)、fix(修复)、docs(文档)、style(格式)、refactor(重构)、test(测试)、chore(构建)

### 测试要求
- 单元测试覆盖率不低于80%
- 新增功能必须添加相应的测试用例

## 贡献

欢迎大家参与贡献！请阅读[CONTRIBUTING.md](CONTRIBUTING.md)了解贡献流程。

## 版本说明

查看[CHANGELOG.md](CHANGELOG.md)了解版本变更历史。

## 许可证

ooder-right采用[MIT License](LICENSE)开源协议。

## 联系方式

- 项目地址：https://gitee.com/ooderCN/right
- 问题反馈：https://gitee.com/ooderCN/right/issues
- 邮件：18683731@qq.com

## 致谢

感谢所有为ooder-right项目做出贡献的开发者！