From 36ea8be34b44808cd1c03cc0046425d2e8492553 Mon Sep 17 00:00:00 2001
From: feijie <feijie89@qq.com>
Date: Tue, 10 Dec 2024 20:04:23 +0800
Subject: [PATCH] =?UTF-8?q?feat(docs):=20=E6=B7=BB=E5=8A=A0=E7=BB=84?=
 =?UTF-8?q?=E7=BB=87=E5=8D=95=E5=85=83=E6=9D=83=E9=99=90=E9=AA=8C=E8=AF=81?=
 =?UTF-8?q?=E6=A8=A1=E5=9D=97=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../README.EN.md                              | 73 +++++++++++++++++++
 .../README.md                                 | 73 +++++++++++++++++++
 2 files changed, 146 insertions(+)
 create mode 100644 aspnet-core/framework/authorization/LINGYUN.Abp.Authorization.OrganizationUnits/README.EN.md
 create mode 100644 aspnet-core/framework/authorization/LINGYUN.Abp.Authorization.OrganizationUnits/README.md

diff --git a/aspnet-core/framework/authorization/LINGYUN.Abp.Authorization.OrganizationUnits/README.EN.md b/aspnet-core/framework/authorization/LINGYUN.Abp.Authorization.OrganizationUnits/README.EN.md
new file mode 100644
index 000000000..51f932d07
--- /dev/null
+++ b/aspnet-core/framework/authorization/LINGYUN.Abp.Authorization.OrganizationUnits/README.EN.md
@@ -0,0 +1,73 @@
+# LINGYUN.Abp.Authorization.OrganizationUnits
+
+Organization Unit Authorization Module, providing organization unit-based permission validation functionality.
+
+## Features
+
+* Support for organization unit-based permission validation
+* Provides Organization Unit Permission Value Provider (OrganizationUnitPermissionValueProvider)
+* Support for multiple organization unit permission validation
+* Integration with ABP permission system
+* Organization Unit Claim type extensions
+* Current user organization unit query extensions
+
+## Module Reference
+
+```csharp
+[DependsOn(typeof(AbpAuthorizationOrganizationUnitsModule))]
+public class YouProjectModule : AbpModule
+{
+  // other
+}
+```
+
+## Basic Usage
+
+1. Configure Permission Provider
+   ```csharp
+   public override void ConfigureServices(ServiceConfigurationContext context)
+   {
+       Configure<AbpPermissionOptions>(options =>
+       {
+           options.ValueProviders.Add<OrganizationUnitPermissionValueProvider>();
+       });
+   }
+   ```
+
+2. Get Current User's Organization Units
+   ```csharp
+   public class YourService
+   {
+       private readonly ICurrentUser _currentUser;
+
+       public YourService(ICurrentUser currentUser)
+       {
+           _currentUser = currentUser;
+       }
+
+       public void YourMethod()
+       {
+           var organizationUnits = _currentUser.FindOrganizationUnits();
+           // Process business logic with organization units
+       }
+   }
+   ```
+
+3. Get Organization Units from ClaimsPrincipal
+   ```csharp
+   public class YourService
+   {
+       public void YourMethod(ClaimsPrincipal principal)
+       {
+           var organizationUnits = principal.FindOrganizationUnits();
+           // Process business logic with organization units
+       }
+   }
+   ```
+
+## More Resources
+
+* [GitHub Repository](https://github.com/colinin/abp-next-admin)
+* [Sample Application](https://github.com/colinin/abp-next-admin/tree/master/aspnet-core/services/LY.MicroService.Applications.Single)
+
+[简体中文](./README.md)
diff --git a/aspnet-core/framework/authorization/LINGYUN.Abp.Authorization.OrganizationUnits/README.md b/aspnet-core/framework/authorization/LINGYUN.Abp.Authorization.OrganizationUnits/README.md
new file mode 100644
index 000000000..3ddc184c9
--- /dev/null
+++ b/aspnet-core/framework/authorization/LINGYUN.Abp.Authorization.OrganizationUnits/README.md
@@ -0,0 +1,73 @@
+# LINGYUN.Abp.Authorization.OrganizationUnits
+
+组织单元权限验证模块，提供基于组织单元的权限验证功能。
+
+## 功能特性
+
+* 支持基于组织单元的权限验证
+* 提供组织单元权限值提供者(OrganizationUnitPermissionValueProvider)
+* 支持多组织单元权限验证
+* 集成ABP权限系统
+* 提供组织单元Claim类型扩展
+* 支持当前用户组织单元查询扩展
+
+## 模块引用
+
+```csharp
+[DependsOn(typeof(AbpAuthorizationOrganizationUnitsModule))]
+public class YouProjectModule : AbpModule
+{
+  // other
+}
+```
+
+## 基本用法
+
+1. 配置权限提供者
+   ```csharp
+   public override void ConfigureServices(ServiceConfigurationContext context)
+   {
+       Configure<AbpPermissionOptions>(options =>
+       {
+           options.ValueProviders.Add<OrganizationUnitPermissionValueProvider>();
+       });
+   }
+   ```
+
+2. 获取当前用户的组织单元
+   ```csharp
+   public class YourService
+   {
+       private readonly ICurrentUser _currentUser;
+
+       public YourService(ICurrentUser currentUser)
+       {
+           _currentUser = currentUser;
+       }
+
+       public void YourMethod()
+       {
+           var organizationUnits = _currentUser.FindOrganizationUnits();
+           // 使用组织单元进行业务处理
+       }
+   }
+   ```
+
+3. 从ClaimsPrincipal获取组织单元
+   ```csharp
+   public class YourService
+   {
+       public void YourMethod(ClaimsPrincipal principal)
+       {
+           var organizationUnits = principal.FindOrganizationUnits();
+           // 使用组织单元进行业务处理
+       }
+   }
+   ```
+
+## 更多资源
+
+* [GitHub仓库](https://github.com/colinin/abp-next-admin)
+* [示例应用程序](https://github.com/colinin/abp-next-admin/tree/master/aspnet-core/services/LY.MicroService.Applications.Single)
+
+[English](./README.EN.md)