# Viazy.Abp.MircoService

**Repository Path**: ldaxian/viazyabp-mircoservice

## Basic Information

- **Project Name**: Viazy.Abp.MircoService
- **Description**: Abp vNext 微服务。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-02
- **Last Updated**: 2026-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Viazy.MircoService

## 项目介绍

Viazy.MircoService是一个基于ABP框架（ASP.NET Boilerplate）的微服务解决方案，采用领域驱动设计（DDD）实践构建。该项目提供了完整的分层架构，集成了多种实用功能模块，旨在快速构建企业级应用系统。

### 核心功能模块

- **业务审计（BusinessAuditing）**：提供详细的业务操作审计功能，记录操作日志和敏感数据保护
- **Excel服务（ExcelServer）**：支持Excel模板导出和批量数据导出
- **任务调度（Hangfire.EntityFrameworkCore）**：基于EF Core的后台任务调度系统
- **数据库分表（ShardingCore）**：支持数据库表的动态分表，提高大数据量场景下的性能
- **短信服务（SmsServer）**：集成短信验证码和通知功能
- **API文档（Swagger）**：自动生成API文档，方便前端开发和接口测试

### 技术栈

- **后端**：.NET 9.0+、ABP Framework
- **数据库**：支持多种数据库，集成了分表功能
- **前端**：基于ABP的前端框架
- **API**：RESTful API，集成Swagger文档

## 系统要求

- [.NET 9.0+ SDK](https://dotnet.microsoft.com/download/dotnet)
- [Node.js v18 或 20](https://nodejs.org/en)

## 项目结构

### 核心框架（framework/viazy.abp/）
- **Viazy.Abp.BusinessAuditing**：业务审计模块
- **Viazy.Abp.ExcelServer**：Excel服务模块
- **Viazy.Abp.Hangfire.EntityFrameworkCore**：任务调度模块
- **Viazy.Abp.EntityFrameworkCore.ShardingCore**：数据库分表模块
- **Viazy.Abp.SmsServer**：短信服务模块
- **Viazy.Abp.Swagger**：API文档模块

### 主机应用（hosts/）
- **Viazy.MircoService.Gateway.Host**：API网关主机

### 业务模块（modules/）
- **Viazy.Abp.BaseServer**：基础服务模块

## 快速开始

### 1. 安装依赖

在解决方案根目录执行以下命令安装客户端依赖：

```bash
abp install-libs
```

### 2. 数据库迁移

运行数据库迁移工具创建初始数据库：

```bash
# 运行数据库迁移工具
Viazy.MircoService.DbMigrator
```

### 3. 生成签名证书

在生产环境中，需要生成签名证书。使用以下命令生成：

```bash
dotnet dev-certs https -v -ep openiddict.pfx -p 800892a8-3d3f-4930-961f-2ec7a362ede3
```

> `800892a8-3d3f-4930-961f-2ec7a362ede3` 是证书密码，您可以更改为任意密码。

### 4. 运行应用

启动API网关主机：

```bash
# 在 hosts/Viazy.MircoService.Gateway.Host 目录执行
dotnet run
```

## 部署

部署ABP应用的过程与部署任何.NET或ASP.NET Core应用相同。有关详细指南，请参考ABP的[部署文档](https://abp.io/docs/latest/Deployment/Index)。

## 开发指南

### 代码结构

项目采用分层架构：
- **Domain**：领域层，包含实体、领域服务和仓储接口
- **Application**：应用层，包含应用服务和DTO
- **Infrastructure**：基础设施层，包含数据访问和外部服务集成
- **Presentation**：表示层，包含API控制器和前端界面

### 扩展模块

要添加新模块，请在 `modules` 目录下创建新的模块项目，并按照ABP的模块开发规范进行开发。

## 相关资源

- [ABP框架文档](https://abp.io/docs/latest/)
- [领域驱动设计指南](https://abp.io/docs/latest/framework/architecture/domain-driven-design)
- [Web应用开发教程](https://abp.io/docs/latest/tutorials/book-store/part-1)

## 许可证

本项目采用MIT许可证。

## 联系方式

如有问题或建议，请联系项目维护团队。