app.MapPost("/v1/orders", 
    (OrderRequest? req, HttpContext ctx) =>
{
    // Крок 1: Формат
    if (req is null)
        return Results.BadRequest(new ApiError(
            Status: 400,
            Reason: "invalid_request_body",
            LocalizedMessage: "Не вдалося прочитати запит.",
            DeveloperMessage: "Request body is null or " +
                "invalid JSON",
            Details: null));

    // Крок 2: Аутентифікація
    if (!ctx.User.Identity?.IsAuthenticated ?? true)
        return Results.Json(new ApiError(
            Status: 401,
            Reason: "authentication_required",
            LocalizedMessage: "Увійдіть у систему.",
            DeveloperMessage: "Bearer token is missing " +
                "or invalid",
            Details: null), statusCode: 401);

    // Крок 3: Авторизація
    var tokenUserId = int.Parse(
        ctx.User.FindFirst("user_id")!.Value);
    if (tokenUserId != req.UserId)
        return Results.Json(new ApiError(
            Status: 403,
            Reason: "forbidden",
            LocalizedMessage: "У вас немає прав " + 
                "на цю операцію.",
            DeveloperMessage: "Token user_id does not " +
                "match request user_id",
            Details: null), statusCode: 403);

    // Крок 4: Існування ресурсів
    var machine = db.GetMachine(req.CoffeeMachineId);
    if (machine is null)
        return Results.NotFound(new ApiError(
            Status: 404,
            Reason: "machine_not_found",
            LocalizedMessage: "Кавова машина не знайдена.",
            DeveloperMessage: $"Coffee machine " +
                $"{req.CoffeeMachineId} not found",
            Details: null));

    // Крок 5: Передумова (ревізія)
    var ifMatch = ctx.Request.Headers
        .IfMatch.FirstOrDefault();
    if (ifMatch is null)
        return Results.Json(new ApiError(
            Status: 428,
            Reason: "precondition_required",
            LocalizedMessage: "Оновіть дані перед " +
                "створенням замовлення.",
            DeveloperMessage: "If-Match header required",
            Details: null), statusCode: 428);

    var currentRevision = db.GetOrdersRevision(
        req.UserId);
    if (ifMatch != $"\"{currentRevision}\"")
        return Results.Json(new ApiError(
            Status: 412,
            Reason: "revision_mismatch",
            LocalizedMessage: "Дані змінилися. " +
                "Оновіть список і спробуйте знову.",
            DeveloperMessage: $"Expected revision " +
                $"{ifMatch}, current is \"{currentRevision}\"",
            Details: new { 
                current_revision = currentRevision 
            }), statusCode: 412);

    // Крок 6: Валідація полів
    var errors = new List<ValidationError>();

    if (string.IsNullOrWhiteSpace(req.Recipe))
        errors.Add(new("recipe", "required", 
            "Recipe is required"));

    if (req.Volume is not null && req.Volume <= 0)
        errors.Add(new("volume", "constraint_violation",
            "Volume must be positive"));

    if (errors.Count > 0)
        return Results.BadRequest(new ApiError(
            Status: 400,
            Reason: "validation_failed",
            LocalizedMessage: "Перевірте правильність " +
                "введених даних.",
            DeveloperMessage: $"{errors.Count} validation " +
                "error(s) found",
            Details: new { checks_failed = errors }));

    // Крок 7: Бізнес-правила
    if (!machine.IsAvailable)
        return Results.Json(new ApiError(
            Status: 422,
            Reason: "machine_unavailable",
            LocalizedMessage: "Ця кавова машина " +
                "зараз недоступна.",
            DeveloperMessage: "Machine is offline " +
                "or under maintenance",
            Details: null), statusCode: 422);

    // ✅ Усі перевірки пройдені — створюємо!
    var order = db.CreateOrder(req);
    return Results.Created(
        $"/v1/orders/{order.Id}", order);
});

record OrderRequest(
    int UserId,
    string? Recipe, 
    int CoffeeMachineId, 
    int? Volume);

record ValidationError(
    string Field, 
    string ErrorType, 
    string Message);

{
  "type": "https://api.example.com/errors/validation",
  "title": "Validation failed",
  "status": 400,
  "detail": "One or more fields have invalid values",
  "instance": "/v1/orders"
}

{
  "status": 400,
  "reason": "wrong_parameter_value",
  "localized_message": "Перевірте правильність введених даних.",
  "developer_message": "Field 'recipe' has unknown value 'lngo'. Did you mean 'lungo'?",
  "details": {
    "checks_failed": [
      {
        "field": "recipe",
        "error_type": "wrong_value",
        "message": "Value 'lngo' unknown. Did you mean 'lungo'?"
      }
    ]
  }
}

record ApiError(
    int Status,
    string Reason,
    string LocalizedMessage,
    string DeveloperMessage,
    object? Details);

app.MapPost("/v1/orders", (OrderRequest? req) =>
{
    if (req is null)
        return Results.BadRequest(new ApiError(
            Status: 400,
            Reason: "invalid_request_body",
            LocalizedMessage: "Не вдалося обробити запит. " +
                "Спробуйте ще раз.",
            DeveloperMessage: "Request body is null or " +
                "contains invalid JSON",
            Details: null));

    // Збираємо ВСІ помилки одразу,
    // а не повертаємо після першої
    var errors = Validate(req);
    if (errors.Count > 0)
        return Results.BadRequest(new ApiError(
            Status: 400,
            Reason: "validation_failed",
            LocalizedMessage: "Перевірте правильність " +
                "введених даних.",
            DeveloperMessage: $"{errors.Count} validation " +
                "error(s) found",
            Details: new { checks_failed = errors }));

    var order = db.CreateOrder(req);
    return Results.Created(
        $"/v1/orders/{order.Id}", order);
});

app.Use(async (ctx, next) =>
{
    try
    {
        await next(ctx);
    }
    catch (TimeoutException ex)
    {
        // ✅ Повна інформація — тільки в логи
        logger.LogError(ex, 
            "Database timeout for {Path}", 
            ctx.Request.Path);

        // ✅ Клієнту — безпечна інструкція
        ctx.Response.StatusCode = 503;
        ctx.Response.Headers.RetryAfter = "5";
        await ctx.Response.WriteAsJsonAsync(
            new ApiError(
                Status: 503,
                Reason: "service_unavailable",
                LocalizedMessage: "Сервіс тимчасово " + 
                    "недоступний. Спробуйте через 5 секунд.",
                DeveloperMessage: "Upstream service timeout",
                Details: new { can_be_retried = true }));
    }
    catch (Exception ex)
    {
        // ❌ НЕ відправляємо ex.Message клієнту!
        logger.LogError(ex, "Unhandled exception");

        ctx.Response.StatusCode = 500;
        await ctx.Response.WriteAsJsonAsync(
            new ApiError(
                Status: 500,
                Reason: "internal_server_error",
                LocalizedMessage: "Внутрішня помилка " +
                    "сервера.",
                DeveloperMessage: "An unexpected error " +
                    "occurred",
                Details: null));
    }
});

var builder = WebApplication.CreateBuilder(args);

// .NET 7+ має вбудований rate limiter
builder.Services.AddRateLimiter(options =>
{
    // "Fixed window" — фіксоване вікно часу
    // 100 запитів за 1 хвилину
    options.AddFixedWindowLimiter("api", config =>
    {
        config.PermitLimit = 100;     // скільки дозволено
        config.Window = TimeSpan
            .FromMinutes(1);          // за який період
        config.QueueLimit = 0;        // без черги
    });

    // Що повертати при перевищенні ліміту
    options.OnRejected = async (context, token) =>
    {
        context.HttpContext.Response.StatusCode = 429;
        context.HttpContext.Response.Headers
            .RetryAfter = "60";
        
        await context.HttpContext.Response
            .WriteAsJsonAsync(new ApiError(
                Status: 429,
                Reason: "rate_limit_exceeded",
                LocalizedMessage: "Забагато запитів. " 
                    + "Спробуйте через хвилину.",
                DeveloperMessage: "Rate limit: " +
                    "100 req/min exceeded",
                Details: new 
                { 
                    limit = 100, 
                    window = "1m",
                    retry_after = 60 
                }), token);
    };
});

var app = builder.Build();
app.UseRateLimiter();

// Застосовуємо ліміт до ендпоінту
app.MapGet("/v1/orders", (int? limit, string? cursor) =>
{
    // Ліміт пагінації — клієнт не може запросити
    // більше 100 записів за раз
    var safeLimit = Math.Clamp(limit ?? 20, 1, 100);

    var orders = db.GetOrders(safeLimit, cursor);
    return Results.Ok(new
    {
        items = orders.Items,
        total = orders.Total,
        next_cursor = orders.NextCursor,
        limit = safeLimit
    });
}).RequireRateLimiting("api");

app.MapPost("/v1/auth/login", (LoginRequest req) =>
{
    var user = db.FindUser(req.Email);
    
    if (user is null)
    {
        // Моніторинг бачить: reason = "user_not_found"
        return Results.Json(
            new ApiError(403, "user_not_found", 
                "Невірний email або пароль.", 
                "User not found", null),
            statusCode: 403);
    }

    if (!VerifyPassword(req.Password, user.PasswordHash))
    {
        // Моніторинг бачить: reason = "wrong_password"
        // Аномальна кількість → можлива атака!
        return Results.Json(
            new ApiError(403, "wrong_password", 
                "Невірний email або пароль.", 
                "Invalid password", null),
            statusCode: 403);
    }

    var token = GenerateJwt(user);
    return Results.Ok(new { token });
});