Blogs
📆 2025-12-19 00:45

项目模板概述

Perigon.template是基于Aspire,ASP.NET CoreEntityFramework Core技术栈的框架模板,结合最佳实践,良好的开发规范,以及开发辅助工具Perigon.CLI,提供快速开发的能力,帮助开发者快速搭建结构清晰,易于维护的现代化Web应用服务。

以结果为导向,以实用为目标是我们设计该模板的核心理念。在架构设计上,我们主要遵循通用、简捷和灵活三个原则,致力于为开发者提供高效且易用的开发体验,三个原则的具体含义:

  • 通用:指尽可能使用主流的,官方的,已被大量采用或认可的技术栈和实现方式,以降低心智负担和学习成本。
  • 简捷:简单和快捷。保持清晰的代码结构,在使用上方便快捷,符合直觉。避免过度设计和不必要的抽象,专注于业务逻辑实现。
  • 灵活:不依赖任何一种设计模式或限定某种开发方式,而是提供约定和最佳实践,所有源码均可修改和扩展,允许开发者根据实际需求进行调整和优化。

Important

文档中最佳实践是一个技术表达用语,指经过实践后推荐的实现方式,并不意味最好的方式。每个人或团队都可以有自己的最佳实践。

目录结构

软件开发与交付,本质上是数字资产生产制造的过程。现实中很多生产,可以简单的概括为:设计->生产->交付,这同样适用于软件开发。

在软件开发中,我们可以将其简化为:定义->实现->服务,在此基础上,我们设计了如下的项目结构:

  • 定义,决定了要做什么,需要什么,提供什么。在模板中由Definition层来实现。
  • 实现,根据定义具体实现业务逻辑。在模板中通过Modules(多个模块)来实现。
  • 服务,将实现的业务逻辑通过接口对外提供服务。在模板中通过Services层来实现。

可以参考目录结构文档,了解各个目录和项目的详细说明。

AppHost

AppHostAspire的宿主项目,它负责启动和管理所有的服务实例。在模板中,AppHost项目是运行整个应用的入口点。

我们将通过代码的方式来定义应用需要的基础设施,你可以阅读使用AppHost配置开发环境来了解如何使用它.

内容大纲