-- v1.2.3_add_discount_to_products.sql
-- Запустити ВРУЧНУ на prod перед деплоєм v1.2.3!
ALTER TABLE Products ADD Discount DECIMAL(5,2) NULL;
ALTER TABLE Products ADD DiscountType NVARCHAR(20) NULL;
-- Якщо вже запускали раніше — закоментуйте ці рядки!

<!-- YourProject.csproj -->
<ItemGroup>
  <!-- EF Core для вашого провайдера -->
  <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="9.0.*" />

  <!-- АБО PostgreSQL: -->
  <!-- <PackageReference Include="Npgsql.EntityFrameworkCore.PostgreSQL" Version="9.0.*" /> -->

  <!-- Design-time пакет: ЛИШЕ для проєкту де є DbContext -->
  <!-- Потрібен для dotnet ef команд, не потрапляє в runtime -->
  <PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="9.0.*">
    <PrivateAssets>all</PrivateAssets>
    <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
  </PackageReference>
</ItemGroup>

public class Product
{
    public int     Id         { get; set; }
    public string  Name       { get; set; } = string.Empty;
    public decimal Price      { get; set; }
    public int     CategoryId { get; set; }
    public Category Category  { get; set; } = null!;
}

public class Category
{
    public int     Id       { get; set; }
    public string  Name     { get; set; } = string.Empty;
    public ICollection<Product> Products { get; set; } = new List<Product>();
}

public class AppDbContext : DbContext
{
    public DbSet<Product>  Products   => Set<Product>();
    public DbSet<Category> Categories => Set<Category>();

    protected override void OnConfiguring(DbContextOptionsBuilder options)
        => options.UseSqlServer("Server=.;Database=ShopDb;Trusted_Connection=True");
}

Migrations/
├── 20250329120000_InitialCreate.cs          ← файл міграції
├── 20250329120000_InitialCreate.Designer.cs ← метадані (не редагувати!)
└── AppDbContextModelSnapshot.cs             ← snapshot поточного стану моделі

// 20250329120000_InitialCreate.cs
using Microsoft.EntityFrameworkCore.Migrations;

#nullable disable

namespace YourApp.Migrations
{
    /// <inheritdoc />
    public partial class InitialCreate : Migration   // ← клас успадковує Migration
    {
        /// <inheritdoc />
        protected override void Up(MigrationBuilder migrationBuilder)  // Up: → нова версія
        {
            // CREATE TABLE Categories
            migrationBuilder.CreateTable(
                name: "Categories",
                columns: table => new
                {
                    Id   = table.Column<int>(type: "int", nullable: false)
                               .Annotation("SqlServer:Identity", "1, 1"),  // IDENTITY(1,1)
                    Name = table.Column<string>(type: "nvarchar(max)", nullable: false)
                },
                constraints: table =>
                {
                    table.PrimaryKey("PK_Categories", x => x.Id);
                });

            // CREATE TABLE Products (залежить від Categories — тому після!)
            migrationBuilder.CreateTable(
                name: "Products",
                columns: table => new
                {
                    Id         = table.Column<int>(type: "int", nullable: false)
                                     .Annotation("SqlServer:Identity", "1, 1"),
                    Name       = table.Column<string>(type: "nvarchar(max)", nullable: false),
                    Price      = table.Column<decimal>(type: "decimal(18,2)", nullable: false),
                    CategoryId = table.Column<int>(type: "int", nullable: false)
                },
                constraints: table =>
                {
                    table.PrimaryKey("PK_Products", x => x.Id);
                    table.ForeignKey(             // FOREIGN KEY
                        name:       "FK_Products_Categories_CategoryId",
                        column:     x => x.CategoryId,
                        principalTable: "Categories",
                        principalColumn: "Id",
                        onDelete:   ReferentialAction.Cascade);
                });

            // CREATE INDEX на FK стовпці (EF Core робить це автоматично)
            migrationBuilder.CreateIndex(
                name:    "IX_Products_CategoryId",
                table:   "Products",
                column:  "CategoryId");
        }

        /// <inheritdoc />
        protected override void Down(MigrationBuilder migrationBuilder)  // Down: ← попередня версія
        {
            // DROP TABLE у зворотному порядку (спочатку залежні!)
            migrationBuilder.DropTable(name: "Products");
            migrationBuilder.DropTable(name: "Categories");
        }
    }
}

// 20250329120000_InitialCreate.Designer.cs (фрагмент)
[DbContext(typeof(AppDbContext))]
[Migration("20250329120000_InitialCreate")]
partial class InitialCreate
{
    protected override void BuildTargetModel(ModelBuilder modelBuilder)
    {
        modelBuilder
            .HasAnnotation("ProductVersion", "9.0.3")
            .HasAnnotation("Relational:MaxIdentifierLength", 128);

        modelBuilder.Entity("YourApp.Category", b =>
        {
            b.Property<int>("Id").ValueGeneratedOnAdd()...;
            b.Property<string>("Name").IsRequired()...;
            b.HasKey("Id");
            b.ToTable("Categories");
        });

        // ... опис Products entity
    }
}

// AppDbContextModelSnapshot.cs
[DbContext(typeof(AppDbContext))]
partial class AppDbContextModelSnapshot : ModelSnapshot
{
    protected override void BuildModel(ModelBuilder modelBuilder)
    {
        // Повне описання ПОТОЧНОГО стану всієї моделі:
        // - всі entity
        // - всі властивості з типами
        // - всі зв'язки
        // - всі індекси
        // - всі обмеження
        // Це «фотографія» того, як EF Core розуміє вашу поточну схему БД
    }
}

Поточна C# модель (рефлексія)
        ↓
[EF Core Model Builder]
        ↓
Поточна EF модель (IMutableModel)
        ↓
[Порівняємо з]
        ↓
ModelSnapshot (попередній стан)
        ↓
[MigrationsModelDiffer]
        ↓
Список операцій: [AddColumn, CreateTable, CreateIndex, ...]
        ↓
[C# Code Generator]
        ↓
Файл міграції (Up + Down)
        Оновлений ModelSnapshot

# Застосувати до конкретної міграції (не обов'язково останньої)
dotnet ef database update AddDiscount

# Повернутись до конкретної міграції (виконає Down() для наступних)
dotnet ef database update InitialCreate

# Повністю скасувати всі міграції (виконає Down() для всіх)
dotnet ef database update 0

public class Product
{
    public int     Id          { get; set; }
    public string  Name        { get; set; } = string.Empty;
    public decimal Price       { get; set; }
    public int     CategoryId  { get; set; }
    public Category Category   { get; set; } = null!;

    // Нові поля:
    public decimal? Discount   { get; set; }   // nullable → NULL у БД
    public bool     IsActive   { get; set; } = true; // default value
    public DateTime CreatedAt  { get; set; }
}

protected override void Up(MigrationBuilder migrationBuilder)
{
    migrationBuilder.AddColumn<decimal>(
        name:      "Discount",
        table:     "Products",
        type:      "decimal(18,2)",
        nullable:  true);         // ← nullable: true, бо decimal?

    migrationBuilder.AddColumn<bool>(
        name:         "IsActive",
        table:        "Products",
        type:         "bit",
        nullable:     false,
        defaultValue: false);    // ← default false, EF Core додасть для існуючих рядків

    migrationBuilder.AddColumn<DateTime>(
        name:     "CreatedAt",
        table:    "Products",
        type:     "datetime2",
        nullable: false,
        defaultValue: new DateTime(1, 1, 1, 0, 0, 0, 0, DateTimeKind.Unspecified));
}

protected override void Down(MigrationBuilder migrationBuilder)
{
    migrationBuilder.DropColumn(name: "Discount",  table: "Products");
    migrationBuilder.DropColumn(name: "IsActive",  table: "Products");
    migrationBuilder.DropColumn(name: "CreatedAt", table: "Products");
}

# Повернутись до стану після InitialCreate (виконає Down() для AddProductFields)
dotnet ef database update InitialCreate

# 1. Відкотити БД до попередньої міграції
dotnet ef database update InitialCreate

# 2. Видалити файл міграції що не потрібен
dotnet ef migrations remove

# 3. Виправити модель і створити нову правильну міграцію
# ... (змінили C# клас) ...
dotnet ef migrations add AddProductFieldsFixed
dotnet ef database update

# Список всіх міграцій та їх статус (Applied/Pending)
dotnet ef migrations list