From 9e9a41f9fce91e852d012b0db5f56c81c0fcc5ad Mon Sep 17 00:00:00 2001
From: feijie <feijie89@qq.com>
Date: Fri, 13 Dec 2024 21:14:59 +0800
Subject: [PATCH] =?UTF-8?q?=E2=9C=A8=20feat(README):=20=E6=96=B0=E5=A2=9E?=
 =?UTF-8?q?=20LINGYUN.Abp.Aliyun=20=E5=92=8C=20LINGYUN.Abp.Tencent=20?=
 =?UTF-8?q?=E6=A8=A1=E5=9D=97=E7=9A=84=E6=96=87=E6=A1=A3=E8=AF=B4=E6=98=8E?=
 =?UTF-8?q?=E4=B8=8E=E5=8A=9F=E8=83=BD=E6=A6=82=E8=BF=B0=E3=80=82=20?=
 =?UTF-8?q?=E2=9C=A8=20feat(README):=20=E6=96=B0=E5=A2=9E=20common=20?=
 =?UTF-8?q?=E6=A8=A1=E5=9D=97=E7=9A=84=E5=9F=BA=E7=A1=80=E4=BB=8B=E7=BB=8D?=
 =?UTF-8?q?=E4=B8=8E=E5=8C=85=E5=90=AB=E9=A1=B9=E7=9B=AE=E5=88=97=E8=A1=A8?=
 =?UTF-8?q?=E3=80=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 aspnet-core/framework/cloud-aliyun/README.md  | 33 +++++++++++
 aspnet-core/framework/cloud-tencent/README.md | 42 +++++++++++++
 aspnet-core/framework/common/README.md        | 59 +++++++++++++++++++
 3 files changed, 134 insertions(+)
 create mode 100644 aspnet-core/framework/cloud-aliyun/README.md
 create mode 100644 aspnet-core/framework/cloud-tencent/README.md
 create mode 100644 aspnet-core/framework/common/README.md

diff --git a/aspnet-core/framework/cloud-aliyun/README.md b/aspnet-core/framework/cloud-aliyun/README.md
new file mode 100644
index 000000000..bd5216537
--- /dev/null
+++ b/aspnet-core/framework/cloud-aliyun/README.md
@@ -0,0 +1,33 @@
+# LINGYUN.Abp.Aliyun 模块概述
+
+## 简介
+LINGYUN.Abp.Aliyun 模块集成了阿里云的 SDK，提供了对阿里云服务的全面支持，包括认证、短信服务和对象存储等功能。
+
+## 包含的项目列表
+- **LINGYUN.Abp.Aliyun**
+- **LINGYUN.Abp.Aliyun.Features**
+- **LINGYUN.Abp.Aliyun.SettingManagement**
+
+## 每个项目的主要功能概述
+
+### LINGYUN.Abp.Aliyun
+- 提供阿里云服务的基础 SDK 集成。
+- 支持阿里云 RAM 认证和 STS Token 访问。
+- 支持短信服务和对象存储。
+- 提供分布式缓存支持。
+
+### LINGYUN.Abp.Aliyun.Features
+- 提供阿里云服务的功能定义和管理。
+- 支持启用/禁用阿里云服务功能。
+- 与 ABP 功能管理系统集成。
+
+### LINGYUN.Abp.Aliyun.SettingManagement
+- 提供阿里云服务配置的查询接口。
+- 通过 API 接口获取阿里云配置信息。
+- 与 ABP 设置管理系统集成。
+
+## 模块的整体用途和重要性
+该模块为开发者提供了与阿里云服务的无缝集成，简化了云服务的使用和管理，提升了应用程序的灵活性和可扩展性。
+
+## 如何使用或集成该模块
+在项目中引用相应的模块，并根据需要配置阿里云的相关参数。确保与 ABP 框架的其他模块配合使用，以实现最佳效果。
diff --git a/aspnet-core/framework/cloud-tencent/README.md b/aspnet-core/framework/cloud-tencent/README.md
new file mode 100644
index 000000000..10b839f4b
--- /dev/null
+++ b/aspnet-core/framework/cloud-tencent/README.md
@@ -0,0 +1,42 @@
+# LINGYUN.Abp.Tencent 模块概述
+
+## 简介
+LINGYUN.Abp.Tencent 模块集成了腾讯云的各项服务，提供了对腾讯云服务的全面支持，包括对象存储、短信服务、QQ 互联和语音合成等功能。
+
+## 包含的项目列表
+- **LINGYUN.Abp.Tencent**
+- **LINGYUN.Abp.BlobStoring.Tencent**
+- **LINGYUN.Abp.Sms.Tencent**
+- **LINGYUN.Abp.Tencent.QQ**
+- **LINGYUN.Abp.Tencent.SettingManagement**
+- **LINGYUN.Abp.Tencent.TTS**
+
+## 每个项目的主要功能概述
+
+### LINGYUN.Abp.Tencent
+- 提供腾讯云 SDK 客户端工厂，支持动态创建腾讯云各项服务的客户端。
+- 支持多租户配置和多语言本地化。
+- 提供统一的腾讯云服务配置管理。
+
+### LINGYUN.Abp.BlobStoring.Tencent
+- 支持腾讯云对象存储服务，自动创建存储桶。
+- 支持多区域配置和文件大小限制。
+
+### LINGYUN.Abp.Sms.Tencent
+- 支持腾讯云短信服务的发送功能，支持多手机号批量发送。
+- 内置错误处理和日志记录。
+
+### LINGYUN.Abp.Tencent.QQ
+- 支持 QQ 互联快速登录，支持多租户配置。
+
+### LINGYUN.Abp.Tencent.SettingManagement
+- 提供腾讯云服务的配置管理界面，支持全局和租户级别的配置管理。
+
+### LINGYUN.Abp.Tencent.TTS
+- 支持腾讯云语音合成服务，提供 TTS 客户端工厂。
+
+## 模块的整体用途和重要性
+该模块为开发者提供了与腾讯云服务的无缝集成，简化了云服务的使用和管理，提升了应用程序的灵活性和可扩展性。
+
+## 如何使用或集成该模块
+在项目中引用相应的模块，并根据需要配置腾讯云的相关参数。确保与 ABP 框架的其他模块配合使用，以实现最佳效果。
diff --git a/aspnet-core/framework/common/README.md b/aspnet-core/framework/common/README.md
new file mode 100644
index 000000000..bbb1c7e35
--- /dev/null
+++ b/aspnet-core/framework/common/README.md
@@ -0,0 +1,59 @@
+# common 模块概述
+
+## 模块简介
+`common`模块是ABP框架的基础模块，提供了一系列通用功能和服务，旨在支持各种应用程序的开发和扩展。该模块包含多个子模块，每个子模块实现了特定的功能，帮助开发者快速构建高效的应用程序。
+
+## 包含的项目列表
+1. **LINGYUN.Abp.Aliyun.Authorization**
+   - 提供阿里云基础认证功能，支持AppKeyId和AccessKeySecret的配置。
+
+2. **LINGYUN.Abp.AspNetCore.HttpOverrides**
+   - 实现HTTP传输标头的重写，支持获取反向代理中的真实客户地址。
+
+3. **LINGYUN.Abp.AspNetCore.Mvc.Client**
+   - 提供可配置的用户配置缓存时间，支持多租户接口。
+
+4. **LINGYUN.Abp.BackgroundJobs.Hangfire**
+   - 基于Hangfire实现的后台作业模块，支持即时、延迟和周期性任务。
+
+5. **LINGYUN.Abp.ExceptionHandling**
+   - 提供统一的异常处理和通知机制，支持自定义异常处理程序。
+
+6. **LINGYUN.Abp.Location**
+   - 提供地理编码、反向地理编码和IP地理位置解析功能。
+
+7. **LINGYUN.Abp.IdGenerator**
+   - 实现分布式唯一ID生成器，支持雪花算法。
+
+8. **LINGYUN.Abp.Wrapper**
+   - 统一包装API返回结果和异常处理。
+
+## 每个项目的主要功能概述
+- **阿里云认证模块**: 提供阿里云的认证功能，简化了对阿里云服务的访问。
+- **HTTP重写模块**: 处理HTTP请求中的标头，确保获取真实的客户端地址。
+- **MVC客户端模块**: 提供用户配置缓存，支持多租户架构。
+- **后台作业模块**: 支持任务的调度和执行，确保后台任务的可靠性。
+- **异常处理模块**: 处理应用中的异常，提供统一的通知机制。
+- **位置服务模块**: 提供地理位置相关的功能，支持地址与坐标之间的转换。
+- **ID生成模块**: 生成分布式唯一ID，确保在高并发环境下的唯一性。
+- **包装器模块**: 统一处理API的返回结果和异常，提升API的可用性。
+
+## 模块的整体用途和重要性
+`common`模块为ABP框架提供了基础设施，支持开发者在构建应用时快速集成常用功能，减少重复工作，提高开发效率。通过这些模块，开发者能够更专注于业务逻辑的实现，而无需担心底层的实现细节。
+
+## 如何使用或集成该模块的简要说明
+在项目中使用`common`模块时，只需在模块类中添加相应的依赖项，并在`ConfigureServices`方法中进行必要的配置。例如：
+
+```csharp
+[DependsOn(typeof(LINGYUN.Abp.Aliyun.Authorization))]
+public class YourProjectModule : AbpModule
+{
+    public override void ConfigureServices(ServiceConfigurationContext context)
+    {
+        // 配置服务
+    }
+}
+```
+
+## 提示
+本项目中的README是由AI模型分析代码逻辑后自动生成的，如有误，请提issues或PR。