C# Entities   →   EF Core   →   Migrations   →   Database Schema
  (джерело)     (трансляція)   (версіонування)     (результат)

Database Schema   →   scaffold-dbcontext   →   C# Entities + DbContext
   (джерело)           (генерація)               (результат)

await context.Database.EnsureCreatedAsync();
// Якщо БД не існує → CREATE DATABASE + створює всі таблиці
// Якщо БД існує → нічого не робить (навіть якщо схема застаріла!)

// ❌ Антипатерн у production:
await context.Database.EnsureCreatedAsync();
// Проблема 1: Якщо БД існує але застаріла — нічого не відбувається!
// Проблема 2: Таблиця __EFMigrationsHistory НЕ створюється
// Проблема 3: Перехід на Migrate потім неможливий без ручного втручання

// Ідіома для тестів: кожен тест-запуск — чиста база
public class TestDbFixture : IDisposable
{
    public AppDbContext Context { get; }

    public TestDbFixture()
    {
        var options = new DbContextOptionsBuilder<AppDbContext>()
            .UseNpgsql("Host=localhost;Database=shop_test;...")
            .Options;

        Context = new AppDbContext(options);

        // Скидаємо і відновлюємо схему
        Context.Database.EnsureDeleted();
        Context.Database.EnsureCreated();
    }

    public void Dispose() => Context.Dispose();
}

# Встановити design-time інструмент
dotnet tool restore  # або dotnet tool install --global dotnet-ef

# NuGet: обов'язково наявний Microsoft.EntityFrameworkCore.Design

dotnet ef dbcontext scaffold \
    "Server=.;Database=ShopDb;Trusted_Connection=True" \
    Microsoft.EntityFrameworkCore.SqlServer \
    --output-dir Models \
    --context-dir Data \
    --context AppDbContext

dotnet ef dbcontext scaffold [connection] [provider] [options]

[connection]  Connection string або ім'я з appsettings.json (--configuration ...)
[provider]    NuGet провайдер: Microsoft.EntityFrameworkCore.SqlServer
                               Npgsql.EntityFrameworkCore.PostgreSQL
                               Microsoft.EntityFrameworkCore.Sqlite

Options:
  -o, --output-dir      Директорія для entity класів (відносно проєкту)
  --context-dir         Директорія для DbContext файлу
  -c, --context         Ім'я DbContext класу
  --namespace           Namespace для entity
  --context-namespace   Namespace для DbContext
  -f, --force           Перезаписати наявні файли (для re-scaffolding)
  -t, --table           Scaffold лише вказані таблиці
  --schema              Scaffold лише вказану схему
  --no-onconfiguring    Не генерувати OnConfiguring (connection string не у класі)
  --no-pluralize        Не плюралізувати імена DbSet
  --use-database-names  Зберігати оригінальні імена таблиць/стовпців (не PascalCase)
  -d, --data-annotations Використовувати Data Annotations замість Fluent API

dotnet ef dbcontext scaffold \
    "Name=ConnectionStrings:DefaultConnection" \     # з appsettings.json
    Microsoft.EntityFrameworkCore.SqlServer \
    --output-dir Infrastructure/Entities \
    --context-dir Infrastructure \
    --context ShopDbContext \
    --namespace YourApp.Infrastructure.Entities \
    --context-namespace YourApp.Infrastructure \
    --no-onconfiguring \                             # connection string не у класі!
    --force                                          # перезаписати при re-scaffold

# Scaffold лише конкретних таблиць
dotnet ef dbcontext scaffold [connection] [provider] \
    --table Products \
    --table Categories \
    --table Orders

# Scaffold всіх таблиць конкретної схеми
dotnet ef dbcontext scaffold [connection] [provider] \
    --schema sales \
    --schema inventory

# Комбінація: схема + конкретні таблиці з іншої схемы
dotnet ef dbcontext scaffold [connection] [provider] \
    --schema sales \
    --table dbo.Products \
    --table dbo.Categories

CREATE TABLE Products (
    Id           INT           NOT NULL IDENTITY(1,1),
    Name         NVARCHAR(200) NOT NULL,
    Price        DECIMAL(10,2) NOT NULL,
    Description  NVARCHAR(MAX) NULL,
    IsActive     BIT           NOT NULL DEFAULT(1),
    CategoryId   INT           NOT NULL,
    CreatedAt    DATETIME2     NOT NULL DEFAULT(GETUTCDATE()),
    CONSTRAINT PK_Products PRIMARY KEY (Id),
    CONSTRAINT FK_Products_Categories FOREIGN KEY (CategoryId)
        REFERENCES Categories(Id),
    CONSTRAINT CK_Products_Price CHECK (Price >= 0)
);

CREATE INDEX IX_Products_CategoryId ON Products(CategoryId);
CREATE UNIQUE INDEX UX_Products_Name_CategoryId ON Products(Name, CategoryId);

// Models/Product.cs — згенерований EF Core scaffold
public partial class Product            // partial ← ключове слово!
{
    public int      Id          { get; set; }
    public string   Name        { get; set; } = null!;  // NOT NULL → = null!
    public decimal  Price       { get; set; }
    public string?  Description { get; set; }           // NULL → nullable string?
    public bool     IsActive    { get; set; }
    public int      CategoryId  { get; set; }
    public DateTime CreatedAt   { get; set; }

    // Навігаційна властивість (FK до Categories)
    public virtual Category Category { get; set; } = null!;

    // Зворотна навігація (якщо є зв'язки від Product до інших таблиць)
}

// AppDbContext.cs — згенерований
public partial class AppDbContext : DbContext
{
    public AppDbContext() { }

    public AppDbContext(DbContextOptions<AppDbContext> options)
        : base(options) { }

    public virtual DbSet<Category> Categories { get; set; }
    public virtual DbSet<Product>  Products   { get; set; }
    public virtual DbSet<Order>    Orders     { get; set; }

    // УВАГА: якщо не використовували --no-onconfiguring
    // connection string потрапить сюди (витік секретів у код!)
    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        if (!optionsBuilder.IsConfigured)
        {
            // ⚠️ НЕ хочемо щоб connection string був тут у production!
            optionsBuilder.UseSqlServer("Server=.;Database=ShopDb;...");
        }
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Product>(entity =>
        {
            entity.HasKey(e => e.Id);

            entity.HasIndex(e => e.CategoryId, "IX_Products_CategoryId");
            entity.HasIndex(e => new { e.Name, e.CategoryId }, "UX_Products_Name_CategoryId")
                  .IsUnique();

            entity.Property(e => e.Name).HasMaxLength(200);
            entity.Property(e => e.Price).HasPrecision(10, 2);
            entity.Property(e => e.IsActive).HasDefaultValue(true);
            entity.Property(e => e.CreatedAt)
                  .HasDefaultValueSql("getutcdate()");

            entity.HasCheckConstraint("CK_Products_Price", "[Price] >= 0");

            entity.HasOne(e => e.Category)
                  .WithMany(e => e.Products)
                  .HasForeignKey(e => e.CategoryId)
                  .OnDelete(DeleteBehavior.ClientSetNull)
                  .HasConstraintName("FK_Products_Categories");
        });

        // ... інші entity конфігурації
    }
}

dotnet ef dbcontext scaffold [connection] [provider] --data-annotations

// З --data-annotations: атрибути у entity
[Table("Products")]
public partial class Product
{
    [Key]
    public int Id { get; set; }

    [Required]
    [StringLength(200)]
    public string Name { get; set; } = null!;

    [Precision(10, 2)]
    public decimal Price { get; set; }

    // Навігаційна властивість залишається у Fluent API
    // (деякі конфігурації неможливо виразити через атрибути)
}

dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet ef dbcontext scaffold --help  # переконатись що tools встановлено

dotnet add package Microsoft.EntityFrameworkCore.Templates --version 9.0.*

# Генерує .t4 шаблони у поточній директорії для редагування
dotnet ef dbcontext scaffold --t4-templates
# АБО через спеціальну команду (залежить від версії tools):
dotnet ef dbcontext scaffold ... --use-t4

CodeTemplates/
└── EFCore/
    ├── DbContext.t4       ← шаблон для DbContext
    └── EntityType.t4      ← шаблон для entity class

<#@ template hostSpecific="true" #>
<#@ assembly name="Microsoft.EntityFrameworkCore.Design" #>
<#@ parameter name="Model" type="Microsoft.EntityFrameworkCore.Metadata.IEntityType" #>
<#@ parameter name="Options" type="Microsoft.EntityFrameworkCore.Scaffolding.ModelCodeGenerationOptions" #>
<#@ import namespace="System.Linq" #>
<#@ import namespace="Microsoft.EntityFrameworkCore" #>
<#@ import namespace="Microsoft.EntityFrameworkCore.Design" #>
<#
    // Логіка C# тут, у <# ... #> блоках
    var className = Model.GetTableName(); // отримати ім'я таблиці
#>
// <auto-generated />
namespace <#= Options.ModelNamespace #>;

/// <summary>
/// Represents the <#= Model.GetTableName() #> table.
/// </summary>
public partial class <#= Model.Name #> : IEntity<int>  // ← додаємо інтерфейс!
{
<# foreach (var property in Model.GetProperties()) { #>
    public <#= property.ClrType.Name #><#= ... #> <#= property.Name #> { get; set; }
<# } #>
}

// CodeTemplates/EFCore/EntityType.t4 (спрощено)
<#@ template hostSpecific="true" #>
<#@ output extension=".cs" #>
// <auto-generated> This file was auto-generated by EF Core scaffolding. </auto-generated>
// ⚠️ DO NOT EDIT DIRECTLY — use Partial Classes for extensions
using System.ComponentModel.DataAnnotations;
using YourApp.Core.Interfaces;

namespace <#= Options.ModelNamespace #>;

/// <summary>
/// Entity class for table [<#= schema #>].[<#= tableName #>].
/// Generated: <#= DateTime.UtcNow.ToString("yyyy-MM-dd") #>
/// </summary>
[Table("<#= tableName #>", Schema = "<#= schema #>")]
public partial class <#= entityName #>
<# if (hasAuditFields) { #>
    : IAuditableEntity
<# } #>
{
    // Generated properties...
<# foreach (var prop in properties) { #>
    /// <summary><#= prop.Comment ?? prop.Name #></summary>
    public <#= prop.TypeName #> <#= prop.Name #> { get; set; }<#= prop.DefaultInit #>
<# } #>

    // Navigation properties
<# foreach (var nav in navigations) { #>
    public virtual <#= nav.TypeName #> <#= nav.Name #> { get; set; } = null!;
<# } #>
}