blazordevlab/cleanaspire-clientapp

CleanAspire - 现代.NET 9 Minimal API + Blazor WebAssembly PWA模板

https://github.com/neozhu/cleanaspire/actions/workflows/dotnet.yml/badge.svg](https://github.com/neozhu/cleanaspire/actions/workflows/dotnet.yml) https://github.com/neozhu/cleanaspire/actions/workflows/github-code-scanning/codeql/badge.svg](https://github.com/neozhu/cleanaspire/actions/workflows/github-code-scanning/codeql) https://github.com/neozhu/cleanaspire/actions/workflows/docker.yml/badge.svg](https://github.com/neozhu/cleanaspire/actions/workflows/docker.yml)

!https://github.com/user-attachments/assets/013b167b-59fa-42d7-a2f7-ffec301c4e11

概述

CleanAspire是一个前沿的开源项目，融合最新的.NET 9 Minimal API与Blazor WebAssembly，并遵循Clean Architecture原则构建。该模板旨在加速可扩展、易维护的渐进式Web应用（PWA）开发，同时保持代码库整洁、模块化且具有未来适应性。

核心功能

• .NET 9 Minimal API：轻量、高性能的后端服务框架。
• Blazor WebAssembly：现代、响应式的客户端PWA实现。
• Clean Architecture：促进关注点分离、可维护性和可扩展性的设计原则。
• 最少样板代码：让开发者无需重复配置即可快速启动项目。
• RESTful API：高效且易用的接口设计。
• 全链路强类型：充分发挥C#语言的类型安全优势。
• 多平台部署支持：可直接部署到Azure、AWS、Docker等云平台。

使用场景

• 快速构建企业级现代Web应用的开发团队。
• 需要开发跨平台渐进式Web应用（PWA）的项目。
• 遵循Clean Architecture规范的中大型应用开发。
• 原型验证与MVP（最小可行产品）快速迭代。

配置说明

Docker部署示例（docker-compose.yml）

yml
version: '3.8'
services:
  apiservice:
    image: blazordevlab/cleanaspire-api:0.0.31
    environment:
      - ASPNETCORE_ENVIRONMENT=Development
      - AllowedHosts=*
      - ASPNETCORE_URLS=http://+:80;https://+:443
      - ASPNETCORE_HTTP_PORTS=80
      - ASPNETCORE_HTTPS_PORTS=443
      - DatabaseSettings__DBProvider=sqlite
      - DatabaseSettings__ConnectionString=Data Source=CleanAspireDb.db
      - AllowedCorsOrigins=https://cleanaspire.blazorserver.com,https://localhost:7123
      - SendGrid__ApiKey=<你的API密钥>
      - SendGrid__DefaultFromEmail=<你的邮箱>
    ports:
      - "8019:80"
      - "8018:443"

  webfrontend:
    image: blazordevlab/cleanaspire-clientapp:0.0.31
    ports:
      - "8016:80"
      - "8017:443"

快速启动步骤

1. 克隆仓库：

   bash
   git clone https://github.com/neozhu/cleanaspire.git
   

2. 进入项目目录：

   bash
   cd CleanAspire
   

3. 运行应用：

   bash
   dotnet run
   

4. 访问应用： 打开浏览器并导航至https://localhost:5001，即可体验Blazor WebAssembly PWA。

架构结构

CleanAspire遵循Clean Architecture设计，将解决方案划分为多个独立层：

CleanAspire/
│
├── src/
│   ├── CleanAspire.Api/                # API层 - .NET Minimal API
│   ├── CleanAspire.Application/        # 应用层 - 业务逻辑
│   ├── CleanAspire.WebAssembly/        # UI层 - Blazor WebAssembly (PWA)
│   ├── CleanAspire.Infrastructure/     # 基础设施层 - 数据访问、外部服务
│   ├── CleanAspire.Domain/             # 领域层 - 核心实体（含EF实体）
│   ├── CleanAspire.AppHost/            # 宿主层 - 应用托管与配置
│   └── CleanAspire.ServiceDefaults/    # 服务默认配置 - 预定义服务配置
│
├── tests/
│   ├── CleanAspire.Application.Tests/  # 应用层单元测试
│   ├── CleanAspire.Api.Tests/          # API层集成测试
│   └── CleanAspire.WebAssembly.Tests/  # Blazor UI测试
│
├── README.md                           # 项目说明文档
├── LICENSE                             # 许可证信息
└── CleanAspire.sln                     # Visual Studio/VS Code解决方案文件

贡献指南

欢迎贡献！若您想添加功能、报告Bug或提出改进建议，请提交Issue或Pull Request。

许可证

本项目采用MIT许可证。

参与方式

• Star仓库：若您喜欢CleanAspire，请给它一个Star！🌟
• 关注项目：通过Watch仓库获取最新动态。
• 参与讨论：分享您的想法，共同完善CleanAspire。

联系我们

如有疑问或反馈，欢迎随时联系。让我们一起用CleanAspire构建优秀的应用！

OpenAPI文档

• [***]