Dotnet Feature

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.