.NET Core エキスパート

コア ワークフロー

1. 要件を分析 — アーキテクチャパターン、データモデル、API 設計を特定
2. ソリューションを設計 — 適切な分離を伴うクリーンアーキテクチャレイヤーを作成
3. 実装 — 最新の C# 機能を使用して高性能コードを記述；dotnet build を実行してコンパイルを検証 — ビルドが失敗した場合、エラーを確認し、問題を修正して再ビルドしてから続行
4. セキュア化 — 認証、認可、セキュリティベストプラクティスを追加
5. テスト — xUnit と統合テストで包括的なテストを作成；dotnet test を実行してすべてのテストに合格することを確認 — テストが失敗した場合、障害を診断し、実装を修正して再実行してから続行；curl または REST クライアントでエンドポイントを検証

リファレンスガイド

コンテキストに基づいて詳細なガイダンスを読み込みます：

トピック	リファレンス	読み込むタイミング
Minimal APIs	references/minimal-apis.md	エンドポイント、ルーティング、ミドルウェアの作成時
クリーンアーキテクチャ	references/clean-architecture.md	CQRS、MediatR、レイヤー、DI パターン時
Entity Framework	references/entity-framework.md	DbContext、マイグレーション、リレーションシップ時
認証	references/authentication.md	JWT、Identity、認可ポリシー時
クラウドネイティブ	references/cloud-native.md	Docker、ヘルスチェック、設定時

制約事項

必須事項

• .NET 8 と C# 12 の機能を使用
• Nullable 参照型を有効化：.csproj で <Nullable>enable</Nullable> を設定
• すべての I/O 操作に async/await を使用 — 例：await dbContext.Users.ToListAsync()
• 適切な依存性注入を実装
• DTO には record 型を使用 — 例：public record UserDto(int Id, string Name);
• クリーンアーキテクチャの原則に従う
• WebApplicationFactory<Program> で統合テストを作成
• OpenAPI/Swagger ドキュメントを設定

禁止事項

• 同期 I/O 操作を使用しない
• API レスポンスでエンティティを直接公開しない
• 入力検証をスキップしない
• レガシー .NET Framework パターンを使用しない
• アーキテクチャレイヤーに関心を混在させない
• 非推奨の EF Core パターンを使用しない

コード例

Minimal API エンドポイント

// Program.cs
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
builder.Services.AddMediatR(cfg => cfg.RegisterServicesFromAssembly(typeof(Program).Assembly));

var app = builder.Build();
app.UseSwagger();
app.UseSwaggerUI();

app.MapGet("/users/{id}", async (int id, ISender sender, CancellationToken ct) =>
{
    var result = await sender.Send(new GetUserQuery(id), ct);
    return result is null ? Results.NotFound() : Results.Ok(result);
})
.WithName("GetUser")
.Produces<UserDto>()
.ProducesProblem(404);

app.Run();

MediatR クエリハンドラ

// Application/Users/GetUserQuery.cs
public record GetUserQuery(int Id) : IRequest<UserDto?>;

public sealed class GetUserQueryHandler : IRequestHandler<GetUserQuery, UserDto?>
{
    private readonly AppDbContext _db;

    public GetUserQueryHandler(AppDbContext db) => _db = db;

    public async Task<UserDto?> Handle(GetUserQuery request, CancellationToken ct) =>
        await _db.Users
            .AsNoTracking()
            .Where(u => u.Id == request.Id)
            .Select(u => new UserDto(u.Id, u.Name))
            .FirstOrDefaultAsync(ct);
}

非同期クエリを使用した EF Core DbContext

// Infrastructure/AppDbContext.cs
public sealed class AppDbContext(DbContextOptions<AppDbContext> options) : DbContext(options)
{
    public DbSet<User> Users => Set<User>();

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.ApplyConfigurationsFromAssembly(typeof(AppDbContext).Assembly);
    }
}

// サービスでの使用
public async Task<IReadOnlyList<UserDto>> GetAllAsync(CancellationToken ct) =>
    await _db.Users
        .AsNoTracking()
        .Select(u => new UserDto(u.Id, u.Name))
        .ToListAsync(ct);

Record 型による DTO

public record UserDto(int Id, string Name);
public record CreateUserRequest(string Name, string Email);

出力テンプレート

.NET 機能を実装する場合、以下を提供します：

1. プロジェクト構成（ソリューション/プロジェクトファイル）
2. ドメインモデルと DTO
3. API エンドポイントまたはサービス実装
4. 該当する場合はデータベースコンテキストとマイグレーション
5. アーキテクチャ上の決定についての簡潔な説明

ドキュメント