# WL.Think.Abp

**Repository Path**: chewel/wl.think.abp

## Basic Information

- **Project Name**: WL.Think.Abp
- **Description**: 基于 Abp VNext，扩展一些简化操作
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-01
- **Last Updated**: 2026-05-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# WL.Think.Abp

## 项目介绍

WL.Think.Abp 是一个基于 ABP 桌面应用开发框架的 .NET 开发模板，提供了多租户、权限管理、数据缓存、审计日志、自动化文档（Swagger）等常用功能的基础实现。

该模板支持模块化开发，提供了一个完整的开箱即用的架构，可用于快速搭建企业级应用。

## 主要功能

- 多租户支持
- OpenIddict 身份验证与授权
- 数据库迁移与种子数据初始化
- Swagger API 文档自动生成
- 异常处理与本地化
- 自动映射（AutoMapper）配置
- 健康检查（Health Checks）
- 通用基础类与方法（如分页、分类管理等）

## 模块组成

- **AppHost**: 主应用宿主模块，集成 ASP.NET Core 相关配置
- **Application.Contracts**: 应用服务契约定义
- **Application**: 应用服务实现
- **Core**: 核心业务逻辑与基础类
- **Domain.Shared**: 预共享的领域层配置
- **Domain**: �ublish 业务规则与仓储接口
- **EntityFrameworkCore**: EF Core 数据访问层
- **HttpApi**: Web API 控制器基础类与配置
- **DbMigrator**: 数据库迁移与初始化模块

## 安装与部署

### 本地开发环境

- .NET 9.0 SDK
- PostgreSQL 或其他支持的数据库
- Visual Studio 2022 或 Visual Studio Code
- Node.js (如果使用前端)

### 构建与运行

1. 克隆仓库
   ```bash
   git clone https://gitee.com/chewel/w.think.abp
   ```

2. 恢复依赖
   ```bash
   cd w.think.abp
   dotnet restore
   ```

3. 构建解决方案
   ```bash
   dotnet build WL.Think.Abp.sln
   ```

4. 运行数据库迁移
   ```bash
   dotnet run -p samples/WL.Think.Sample.DbMigrator
   ```

5. 运行主应用
   ```bash
   dotnet run -p samples/WL.Think.Sample.AppHost
   ```

## 使用说明

### API 调用

基础 API 控制器提供了标准的 RESTful 接口：
- `GET /api/sample/books` - 获取分页列表
- `GET /api/sample/books/{id}` - 获取单项详情
- `POST /api/sample/books` - 创建新项目
- `PUT /api/sample/books/{id}` - 更新项目
- `DELETE /api/sample/books/{id}` - 删除项目

### 数据迁移

使用 `ThinkDbMigrator` 模块可以进行数据库结构迁移与初始化数据部署。

### 多租户

通过 `ThinkConsts.EnabledTenancy` 静态字段控制多租户功能的启用状态。

## 许可证

本项目使用 [MIT 许可证](./LICENSE) 开源协议。