dotnet-feature

cwoodruff 的头像作者 cwoodruff

.NET 10 全栈开发专家技能。在实现新功能、垂直切片或修改 MoreSpeakers 应用程序中的现有逻辑时使用此功能。它涵盖域、数据(EF Core)、管理器和 Web(Razor Pages + HTMX)。

📖 中文导读:.NET 10 全栈开发专家技能。在实现新功能、垂直切片或修改 MoreSpeakers 应用程序中的现有逻辑时使用此功能。它涵盖域、数据(EF Core)、管理器和 Web(Razor Pages + HTMX)。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: dotnet-feature description: Expert .NET 10 Full-Stack Developer skill. Use this when implementing new features, vertical slices, or modifying existing logic in the MoreSpeakers application. It covers Domain, Data (EF Core), Managers, and Web (Razor Pages + HTMX).

.NET Feature Implementation Skill

Overview

This skill guides the implementation of features following the Clean Architecture pattern used in MoreSpeakers.com. It ensures consistency across the Domain, Data, Managers, and Web layers.

Architecture Flow

  1. Domain: Define Interfaces, Models, and Enums. (No dependencies)
  2. Data: Implement DataStores using EF Core. (Depends on Domain)
  3. Managers: Implement Business Logic. (Depends on Data + Domain)
  4. Web: Implement UI with Razor Pages and HTMX. (Depends on Managers)

Coding Standards

General C# Guidelines

  • Namespaces: ALWAYS use File-Scoped Namespaces (e.g., namespace MoreSpeakers.Web;).
  • Injection: ALWAYS inject Interfaces (IUserManager), never concrete types.
  • Async: ALWAYS use async/await throughout the stack.

1. Domain Layer (src/MoreSpeakers.Domain)

  • Models should be POCOs with DataAnnotations for validation.
  • Interfaces (IDataStore, IManager) should return Task<T>.

2. Data Layer (src/MoreSpeakers.Data)

  • Pattern: Repository/DataStore pattern.
  • Context: Use MoreSpeakersDbContext.
  • Mapping: Use AutoMapper to map between Entity and Domain models if they differ.
  • NO Migrations: Do not run EF migrations. Schema is handled by sql-schema skill.
public class SpeakerDataStore : ISpeakerDataStore
{
    private readonly MoreSpeakersDbContext _context;
    // ... constructor ...

    public async Task<Speaker?> GetAsync(Guid id)
    {
        // Use AsNoTracking for read-only operations
        var entity = await _context.Speakers.AsNoTracking().FirstOrDefaultAsync(x => x.Id == id);
        return _mapper.Map<Speaker>(entity);
    }
}

3. Manager Layer (src/MoreSpeakers.Managers)

  • Contains all business logic.
  • orchestrates calls between DataStores and external services (Email, etc.).

4. Web Layer (src/MoreSpeakers.Web)

  • Framework: Razor Pages.
  • Interactivity: HTMX and Hyperscript (Minimize custom JS).
  • Partials: Use Partial Views (_SpeakerGrid.cshtml) for HTMX targets.

HTMX Pattern

The Container (Parent Page):

<div id="list-container">
    <partial name="_ListPartial" model="Model.Items" />
</div>

<button hx-get="@Url.Page("Index", "LoadMore")"
        hx-target="#list-container"
        hx-swap="beforeend">
    Load More
</button>

The Handler (PageModel):

public async Task<IActionResult> OnGetLoadMoreAsync()
{
    var items = await _manager.GetNextBatchAsync();
    return Partial("_ListPartial", items);
}

Checklist for New Features

  1. Defined Model in Domain.
  2. Created IDataStore interface in Domain.
  3. Implemented DataStore in Data.
  4. Registered DataStore in Program.cs (Scoped).
  5. Created IManager interface in Domain.
  6. Implemented Manager in Managers.
  7. Registered Manager in Program.cs (Scoped).
  8. Created Razor Page + PageModel.
  9. Implemented HTMX interactions if dynamic updates are needed.