GerbilManager/GerbilManagerWebAPI/Dtos/ApiDtos.cs

using GerbilManagerWebAPI.Models;

namespace GerbilManagerWebAPI.Dtos
{
    // Response DTOs ----------------------------------------------------------
    // Enums serialise as string names; JSON property names are camelCase (configured
    // globally in Program.cs). FK references are FLAT ids (no nested objects) per the
    // frontend contract (Kelly's pedigree + Oscar's filters depend on this).

    public record GerbilDto(
        Guid Id,
        string Name,
        Gender Gender,
        GerbilStatus Status,
        Guid? LitterId,
        Guid? OriginContactId,
        Guid? ReceiverContactId,
        Guid? EnclosureId,
        Guid? ColorVarietyId,
        DateOnly? DateOfBirth,
        DateOnly? DateOfDeath,
        string? CauseOfDeath,
        DateOnly? GoHomeDate,
        string? Genotype,
        string? SpottingType,
        string? Notes,
        string? ImportSource,
        string? ExternalRef,
        string? OriginBreeder,
        List<string> CharacterTraits,
        string? CharacterNote,
        bool? IsDeaf,
        bool IsResident,
        string? ProfilePhotoUrl,
        bool IsCastrated,
        string? Provenance);

    public record LitterDto(
        Guid Id,
        string Name,
        DateOnly? Date,
        int? TotalBorn,
        int? DeathsWithin8Weeks,
        Guid? FatherId,
        Guid? MotherId,
        DateOnly? ExpectedGoHomeDate,
        string? Notes);

    public record ContactDto(Guid Id, string Name, string? Email, string? Phone, string? Address, string? Notes, bool IsBreeder, bool IsReceiver, string? NameSuffix);

    public record EnclosureDto(Guid Id, string Name, string? Notes);

    public record ColorVarietyDto(Guid Id, string Name, string? CanonicalGenotype, int SortOrder);

    public record HealthRecordDto(
        Guid Id, Guid GerbilId, DateOnly Date, HealthRecordType Type,
        string Description, string? Veterinarian, DateTimeOffset CreatedAt);

    public record WeightRecordDto(
        Guid Id, Guid GerbilId, DateOnly Date, int WeightGrams, string? Notes);

    public record PhotoDto(Guid Id, string FileName, string? Caption, int SortOrder, string Url);

    // Request DTOs -----------------------------------------------------------

    public record GerbilInput(
        string? Name,
        Gender? Gender,
        GerbilStatus? Status,
        Guid? LitterId,
        Guid? OriginContactId,
        Guid? ReceiverContactId,
        Guid? EnclosureId,
        Guid? ColorVarietyId,
        DateOnly? DateOfBirth,
        DateOnly? DateOfDeath,
        string? CauseOfDeath,
        DateOnly? GoHomeDate,
        string? Genotype,
        string? SpottingType,
        string? Notes,
        string? ImportSource,
        string? ExternalRef,
        string? OriginBreeder,
        List<string>? CharacterTraits,
        string? CharacterNote,
        bool? IsDeaf,
        bool? IsResident,
        bool? IsCastrated);

    public record LitterInput(
        string Name,
        DateOnly? Date,
        int? TotalBorn,
        int? DeathsWithin8Weeks,
        Guid? FatherId,
        Guid? MotherId,
        DateOnly? ExpectedGoHomeDate,
        string? Notes);

    public record ContactInput(string Name, string? Email, string? Phone, string? Address, string? Notes, bool IsBreeder, bool IsReceiver, string? NameSuffix);

    public record EnclosureInput(string Name, string? Notes);

    public record ColorVarietyInput(string Name, string? CanonicalGenotype, int? SortOrder);

    public record HealthRecordInput(
        Guid GerbilId, DateOnly Date, HealthRecordType Type, string Description, string? Veterinarian);

    public record WeightRecordInput(Guid GerbilId, DateOnly Date, int WeightGrams, string? Notes);

    /// <summary>Hypothetical pairing request for POST /genetics/test-inbreeding.</summary>
    public record TestInbreedingDto(Guid? FatherId, Guid? MotherId);
}