init push

internal/transport/http/dto/after_flight_inspection_dto.go

@@ -0,0 +1,67 @@
+package dto
+
+import responsedto "wucher/internal/transport/http/dto/response"
+
+type AfterFlightInspectionAttributes struct {
+	ID                        string                                   `json:"id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	FlightInspectionID        string                                   `json:"flight_inspection_id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	FlightInspection          *FlightInspectionResource                `json:"flight_inspection,omitempty"`
+	Helicopter                *responsedto.HelicopterResource          `json:"helicopter,omitempty"`
+	MissionCode               string                                   `json:"mission_code,omitempty" example:"M-2026-001"`
+	MissionType               []string                                 `json:"mission_type,omitempty"`
+	TotalFlight               int                                      `json:"total_flight" example:"3"`
+	FlightDataCount           int                                      `json:"flight_data_count" example:"2"`
+	FlightTimeSeconds         int64                                    `json:"flight_time_seconds" example:"9000"`
+	Route                     []string                                 `json:"route"`
+	OilEngineNR1Checked       *string                                  `json:"oil_engine_nr1_checked" example:"1"`
+	OilEngineNR2Checked       *string                                  `json:"oil_engine_nr2_checked" example:"1"`
+	HydraulicLHChecked        *string                                  `json:"hydraulic_lh_checked" example:"1"`
+	HydraulicRHChecked        *string                                  `json:"hydraulic_rh_checked" example:"1"`
+	OilTransmissionMGBChecked *string                                  `json:"oil_transmission_mgb_checked" example:"1"`
+	OilTransmissionIGBChecked *string                                  `json:"oil_transmission_igb_checked" example:"1"`
+	OilTransmissionTGBChecked *string                                  `json:"oil_transmission_tgb_checked" example:"1"`
+	Note                      *string                                  `json:"note" example:"All checks completed"`
+	Total                     int                                      `json:"total" example:"3"`
+	Completed                 int                                      `json:"completed" example:"1"`
+	DoneFileChecklist         []AfterFlightInspectionFileChecklistItem `json:"done_file_checklist,omitempty"`
+	FileChecklist             []AfterFlightInspectionFileChecklistItem `json:"file_checklist"`
+	CreatedAt                 string                                   `json:"created_at,omitempty" example:"2026-04-09T05:00:00Z"`
+	UpdatedAt                 string                                   `json:"updated_at,omitempty" example:"2026-04-09T05:00:00Z"`
+}
+
+type AfterFlightInspectionFileChecklistItem struct {
+	HelicopterFileID string `json:"helicopter_file_id" example:"019d7000-aaaa-7bbb-8ccc-111111111111"`
+	FileName         string `json:"file_name,omitempty" example:"After Flight Checklist.pdf"`
+	DownloadURL      string `json:"download_url,omitempty" example:"https://s3.localhost.localstack.cloud:4566/wucher-file-dev/files/2026/04/05/policy.pdf?X-Amz-Signature=..."`
+	IsDone           bool   `json:"is_done" example:"false"`
+}
+
+type AfterFlightInspectionResource struct {
+	Type       string                          `json:"type" example:"after_flight_inspection"`
+	ID         string                          `json:"id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	Attributes AfterFlightInspectionAttributes `json:"attributes"`
+}
+
+type AfterFlightInspectionResponse struct {
+	Data AfterFlightInspectionResource `json:"data"`
+}
+
+type AfterFlightInspectionUpsertAttributes struct {
+	OilEngineNR1Checked       *string `json:"oil_engine_nr1_checked,omitempty"`
+	OilEngineNR2Checked       *string `json:"oil_engine_nr2_checked,omitempty"`
+	HydraulicLHChecked        *string `json:"hydraulic_lh_checked,omitempty"`
+	HydraulicRHChecked        *string `json:"hydraulic_rh_checked,omitempty"`
+	OilTransmissionMGBChecked *string `json:"oil_transmission_mgb_checked,omitempty"`
+	OilTransmissionIGBChecked *string `json:"oil_transmission_igb_checked,omitempty"`
+	OilTransmissionTGBChecked *string `json:"oil_transmission_tgb_checked,omitempty"`
+	Note                      *string `json:"note,omitempty"`
+}
+
+type AfterFlightInspectionUpsertData struct {
+	Type       string                                `json:"type" validate:"required,oneof=after_flight_inspection_upsert after_flight_inspection"`
+	Attributes AfterFlightInspectionUpsertAttributes `json:"attributes" validate:"required"`
+}
+
+type AfterFlightInspectionUpsertRequest struct {
+	Data AfterFlightInspectionUpsertData `json:"data" validate:"required"`
+}

internal/transport/http/dto/audit_dto.go

@@ -0,0 +1,35 @@
+package dto
+
+// JSON:API Audit DTOs
+
+type AuditLogAttributes struct {
+	RequestID   string      `json:"request_id,omitempty" example:"req-12345"`
+	ActorUserID string      `json:"actor_user_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Layer       string      `json:"layer" example:"api"`
+	Module      string      `json:"module" example:"reserve_ac"`
+	Action      string      `json:"action" example:"http.request"`
+	Method      string      `json:"method,omitempty" example:"GET"`
+	Path        string      `json:"path,omitempty" example:"/api/v1/users/get-all"`
+	StatusCode  int         `json:"status_code,omitempty" example:"200"`
+	Success     bool        `json:"success" example:"true"`
+	IP          string      `json:"ip,omitempty" example:"127.0.0.1"`
+	UserAgent   string      `json:"user_agent,omitempty" example:"Mozilla/5.0"`
+	Message     string      `json:"message,omitempty" example:"HTTP 200"`
+	Metadata    interface{} `json:"metadata,omitempty"`
+	CreatedAt   string      `json:"created_at,omitempty" example:"2026-03-11T12:00:00Z"`
+}
+
+type AuditLogResource struct {
+	Type       string             `json:"type" example:"audit_log"`
+	ID         string             `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes AuditLogAttributes `json:"attributes"`
+}
+
+type AuditLogListResponse struct {
+	Data []AuditLogResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}

internal/transport/http/dto/auth_dto.go

@@ -0,0 +1,813 @@
+package dto
+
+import "encoding/json"
+
+// JSON:API Request/Response DTOs for Auth
+
+// Register
+type RegisterAttributes struct {
+	Email       string `json:"email" validate:"required,email" example:"user@example.com"`
+	Username    string `json:"username" validate:"required,min=3,max=100" example:"john.doe"`
+	Password    string `json:"password" validate:"required,min=8" example:"StrongP@ssw0rd"`
+	FirstName   string `json:"first_name" validate:"required" example:"John"`
+	LastName    string `json:"last_name" validate:"required" example:"Doe"`
+	MobilePhone string `json:"mobile_phone,omitempty" example:"+628123456789"`
+}
+
+type RegisterData struct {
+	Type       string             `json:"type" validate:"required,eq=auth_register" example:"auth_register"`
+	Attributes RegisterAttributes `json:"attributes" validate:"required"`
+}
+
+type RegisterRequest struct {
+	Data RegisterData `json:"data" validate:"required"`
+}
+
+// Invite user
+type InviteAttributes struct {
+	Email       string   `json:"email" validate:"required,email" example:"user@example.com"`
+	Username    string   `json:"username" validate:"required,min=3,max=100" example:"john.doe"`
+	FirstName   string   `json:"first_name" validate:"required" example:"John"`
+	LastName    string   `json:"last_name" validate:"required" example:"Doe"`
+	MobilePhone string   `json:"mobile_phone,omitempty" example:"+628123456789"`
+	RoleID      string   `json:"role_id" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	RoleIDs     []string `json:"role_ids,omitempty" example:"[\"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d\",\"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9e\"]"`
+}
+
+type InviteData struct {
+	Type       string           `json:"type" validate:"required,eq=auth_invite" example:"auth_invite"`
+	Attributes InviteAttributes `json:"attributes" validate:"required"`
+}
+
+type InviteRequest struct {
+	Data InviteData `json:"data" validate:"required"`
+}
+
+// Set password from invite token
+type SetPasswordAttributes struct {
+	Token    string `json:"token" validate:"required" example:"kP8k2..."`
+	Password string `json:"password" validate:"required,min=8" example:"StrongP@ssw0rd"`
+}
+
+type SetPasswordData struct {
+	Type       string                `json:"type" validate:"required,eq=auth_set_password" example:"auth_set_password"`
+	Attributes SetPasswordAttributes `json:"attributes" validate:"required"`
+}
+
+type SetPasswordRequest struct {
+	Data SetPasswordData `json:"data" validate:"required"`
+}
+
+// Resend set-password invite
+type ResendSetPasswordInviteAttributes struct {
+	UserID string `json:"user_id" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type ResendSetPasswordInviteData struct {
+	Type       string                            `json:"type" validate:"required,eq=auth_resend_set_password" example:"auth_resend_set_password"`
+	Attributes ResendSetPasswordInviteAttributes `json:"attributes" validate:"required"`
+}
+
+type ResendSetPasswordInviteRequest struct {
+	Data ResendSetPasswordInviteData `json:"data" validate:"required"`
+}
+
+// Forgot password
+type ForgotPasswordAttributes struct {
+	Email string `json:"email" validate:"required,email" example:"user@example.com"`
+}
+
+type ForgotPasswordData struct {
+	Type       string                   `json:"type" validate:"required,eq=auth_forgot_password" example:"auth_forgot_password"`
+	Attributes ForgotPasswordAttributes `json:"attributes" validate:"required"`
+}
+
+type ForgotPasswordRequest struct {
+	Data ForgotPasswordData `json:"data" validate:"required"`
+}
+
+// Reset password
+type ResetPasswordAttributes struct {
+	Token           string `json:"token" validate:"required" example:"kP8k2..."`
+	NewPassword     string `json:"new_password" validate:"required,min=8" example:"StrongP@ssw0rd!LongPassphrase"`
+	ConfirmPassword string `json:"confirm_password" validate:"required,min=8" example:"StrongP@ssw0rd!LongPassphrase"`
+}
+
+type ResetPasswordData struct {
+	Type       string                  `json:"type" validate:"required,eq=auth_reset_password" example:"auth_reset_password"`
+	Attributes ResetPasswordAttributes `json:"attributes" validate:"required"`
+}
+
+type ResetPasswordRequest struct {
+	Data ResetPasswordData `json:"data" validate:"required"`
+}
+
+// Setup security PIN
+type SecurityPINSetupAttributes struct {
+	PIN        string `json:"pin" validate:"required,len=6,numeric" example:"123456"`
+	ConfirmPIN string `json:"confirm_pin" validate:"required,len=6,numeric" example:"123456"`
+}
+
+type SecurityPINSetupData struct {
+	Type       string                     `json:"type" validate:"required,eq=auth_pin_setup" example:"auth_pin_setup"`
+	Attributes SecurityPINSetupAttributes `json:"attributes" validate:"required"`
+}
+
+type SecurityPINSetupRequest struct {
+	Data SecurityPINSetupData `json:"data" validate:"required"`
+}
+
+type SecurityPINSetupResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_pin_setup"`
+		Attributes struct {
+			Configured bool `json:"configured" example:"true"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+// Verify security PIN
+type SecurityPINVerifyAttributes struct {
+	PIN    string `json:"pin" validate:"required,len=6,numeric" example:"123456"`
+	Action string `json:"action" validate:"required,uuid4" example:"a546de2f-f1e6-4c2c-ab03-9b4bf39f4d74"`
+}
+
+type SecurityPINVerifyData struct {
+	Type       string                      `json:"type" validate:"required,eq=auth_pin_verify" example:"auth_pin_verify"`
+	Attributes SecurityPINVerifyAttributes `json:"attributes" validate:"required"`
+}
+
+type SecurityPINVerifyRequest struct {
+	Data SecurityPINVerifyData `json:"data" validate:"required"`
+}
+
+type SecurityPINVerifyResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_pin_verify"`
+		Attributes struct {
+			Verified         bool   `json:"verified" example:"true"`
+			ActionToken      string `json:"action_token" example:"pinv_1234567890abcdef"`
+			ActionTokenTTLMS int64  `json:"action_token_ttl_ms" example:"900000"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+// Change security PIN
+type SecurityPINChangeAttributes struct {
+	CurrentPIN string `json:"current_pin" validate:"required,len=6,numeric" example:"123456"`
+	NewPIN     string `json:"new_pin" validate:"required,len=6,numeric" example:"654321"`
+	ConfirmPIN string `json:"confirm_pin" validate:"required,len=6,numeric" example:"654321"`
+}
+
+type SecurityPINChangeData struct {
+	Type       string                      `json:"type" validate:"required,eq=auth_pin_change" example:"auth_pin_change"`
+	Attributes SecurityPINChangeAttributes `json:"attributes" validate:"required"`
+}
+
+type SecurityPINChangeRequest struct {
+	Data SecurityPINChangeData `json:"data" validate:"required"`
+}
+
+// Forgot security PIN
+type ForgotSecurityPINAttributes struct {
+	Email string `json:"email" validate:"required,email" example:"user@example.com"`
+}
+
+type ForgotSecurityPINData struct {
+	Type       string                      `json:"type" validate:"required,eq=auth_forgot_pin" example:"auth_forgot_pin"`
+	Attributes ForgotSecurityPINAttributes `json:"attributes" validate:"required"`
+}
+
+type ForgotSecurityPINRequest struct {
+	Data ForgotSecurityPINData `json:"data" validate:"required"`
+}
+
+// Request security PIN reset
+type RequestSecurityPINAttributes struct {
+	Method      string `json:"method,omitempty" example:"password"`
+	Password    string `json:"password,omitempty" example:"StrongP@ssw0rd"`
+	ReauthToken string `json:"reauth_token,omitempty" example:"sso_reauth_1234567890abcdef"`
+}
+
+type RequestSecurityPINData struct {
+	Type       string                       `json:"type" validate:"required,eq=auth_pin_request_reset" example:"auth_pin_request_reset"`
+	Attributes RequestSecurityPINAttributes `json:"attributes" validate:"required"`
+}
+
+type RequestSecurityPINRequest struct {
+	Data RequestSecurityPINData `json:"data" validate:"required"`
+}
+
+type RequestSecurityPINResetResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_pin_request_reset"`
+		Attributes struct {
+			Message string `json:"message" example:"If allowed, a security PIN reset link has been sent to your email."`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+// Reset security PIN
+type ResetSecurityPINAttributes struct {
+	Token       string `json:"token,omitempty" example:"kP8k2..."`
+	Method      string `json:"method,omitempty" example:"password"`
+	Password    string `json:"password,omitempty" example:"StrongP@ssw0rd"`
+	ReauthToken string `json:"reauth_token,omitempty" example:"sso_reauth_1234567890abcdef"`
+	NewPIN      string `json:"new_pin" validate:"required,len=6,numeric" example:"123456"`
+	ConfirmPIN  string `json:"confirm_pin" validate:"required,len=6,numeric" example:"123456"`
+}
+
+type ResetSecurityPINData struct {
+	Type       string                     `json:"type" validate:"required,eq=auth_reset_pin" example:"auth_reset_pin"`
+	Attributes ResetSecurityPINAttributes `json:"attributes" validate:"required"`
+}
+
+type ResetSecurityPINRequest struct {
+	Data ResetSecurityPINData `json:"data" validate:"required"`
+}
+
+// Login
+type LoginAttributes struct {
+	Email    string `json:"email" validate:"required,email" example:"user@example.com"`
+	Password string `json:"password" validate:"required" example:"StrongP@ssw0rd"`
+}
+
+type LoginData struct {
+	Type       string          `json:"type" validate:"required,eq=auth_login" example:"auth_login"`
+	Attributes LoginAttributes `json:"attributes" validate:"required"`
+}
+
+type LoginRequest struct {
+	Data LoginData `json:"data" validate:"required"`
+}
+
+// Exchange frontend Microsoft token result into backend session tokens
+type ExchangeIDTokenClaims struct {
+	Aud               string `json:"aud,omitempty" example:"12345678-1234-1234-1234-123456789012"`
+	Iss               string `json:"iss,omitempty" example:"https://login.microsoftonline.com/abc-tenant-id/v2.0"`
+	Iat               int64  `json:"iat,omitempty" example:"1715600000"`
+	Nbf               int64  `json:"nbf,omitempty" example:"1715600000"`
+	Exp               int64  `json:"exp,omitempty" example:"1715603600"`
+	Name              string `json:"name,omitempty" example:"Andrio Effendi"`
+	PreferredUsername string `json:"preferred_username,omitempty" example:"andrio@mybit-innovation.com"`
+	Email             string `json:"email,omitempty" example:"andrio@mybit-innovation.com"`
+	OID               string `json:"oid,omitempty" example:"00000000-0000-0000-1234-567890abcdef"`
+	Sub               string `json:"sub,omitempty" example:"AbCdEfGhIjKlMnOpQrStUvWxYz"`
+	TID               string `json:"tid,omitempty" example:"abc-tenant-id"`
+	Ver               string `json:"ver,omitempty" example:"2.0"`
+}
+
+type ExchangeAttributes struct {
+	AccessToken   string                `json:"access_token" validate:"required" example:"eyJ0eXAiOiJKV1Qi..."`
+	IDToken       string                `json:"id_token" validate:"required" example:"eyJ0eXAiOiJKV1Qi..."`
+	IDTokenClaims ExchangeIDTokenClaims `json:"id_token_claims"`
+}
+
+type ExchangeData struct {
+	Type       string             `json:"type" validate:"required,eq=auth_exchange" example:"auth_exchange"`
+	Attributes ExchangeAttributes `json:"attributes" validate:"required"`
+}
+
+type ExchangeRequest struct {
+	Data ExchangeData `json:"data" validate:"required"`
+}
+
+func (c ExchangeIDTokenClaims) ToMap() map[string]any {
+	out := map[string]any{}
+	if c.Aud != "" {
+		out["aud"] = c.Aud
+	}
+	if c.Iss != "" {
+		out["iss"] = c.Iss
+	}
+	if c.Iat > 0 {
+		out["iat"] = c.Iat
+	}
+	if c.Nbf > 0 {
+		out["nbf"] = c.Nbf
+	}
+	if c.Exp > 0 {
+		out["exp"] = c.Exp
+	}
+	if c.Name != "" {
+		out["name"] = c.Name
+	}
+	if c.PreferredUsername != "" {
+		out["preferred_username"] = c.PreferredUsername
+	}
+	if c.Email != "" {
+		out["email"] = c.Email
+	}
+	if c.OID != "" {
+		out["oid"] = c.OID
+	}
+	if c.Sub != "" {
+		out["sub"] = c.Sub
+	}
+	if c.TID != "" {
+		out["tid"] = c.TID
+	}
+	if c.Ver != "" {
+		out["ver"] = c.Ver
+	}
+	return out
+}
+
+// WebAuthn register begin
+type WebAuthnRegisterBeginData struct {
+	Type string `json:"type" validate:"required,eq=auth_webauthn_register_begin" example:"auth_webauthn_register_begin"`
+}
+
+type WebAuthnRegisterBeginRequest struct {
+	Data WebAuthnRegisterBeginData `json:"data" validate:"required"`
+}
+
+// WebAuthn register finish
+type WebAuthnRegisterFinishAttributes struct {
+	ChallengeToken string          `json:"challenge_token" validate:"required" example:"kP8k2..."`
+	Credential     json.RawMessage `json:"credential" validate:"required"`
+	Name           string          `json:"name,omitempty" validate:"omitempty,max=100" example:"MacBook Touch ID"`
+}
+
+type WebAuthnRegisterFinishData struct {
+	Type       string                           `json:"type" validate:"required,eq=auth_webauthn_register_finish" example:"auth_webauthn_register_finish"`
+	Attributes WebAuthnRegisterFinishAttributes `json:"attributes" validate:"required"`
+}
+
+type WebAuthnRegisterFinishRequest struct {
+	Data WebAuthnRegisterFinishData `json:"data" validate:"required"`
+}
+
+// WebAuthn login begin
+type WebAuthnLoginBeginAttributes struct {
+	Email string `json:"email" validate:"required,email" example:"user@example.com"`
+}
+
+type WebAuthnLoginBeginData struct {
+	Type       string                       `json:"type" validate:"required,eq=auth_webauthn_login_begin" example:"auth_webauthn_login_begin"`
+	Attributes WebAuthnLoginBeginAttributes `json:"attributes" validate:"required"`
+}
+
+type WebAuthnLoginBeginRequest struct {
+	Data WebAuthnLoginBeginData `json:"data" validate:"required"`
+}
+
+// WebAuthn login finish
+type WebAuthnLoginFinishAttributes struct {
+	ChallengeToken string          `json:"challenge_token" validate:"required" example:"kP8k2..."`
+	Credential     json.RawMessage `json:"credential" validate:"required"`
+}
+
+type WebAuthnLoginFinishData struct {
+	Type       string                        `json:"type" validate:"required,eq=auth_webauthn_login_finish" example:"auth_webauthn_login_finish"`
+	Attributes WebAuthnLoginFinishAttributes `json:"attributes" validate:"required"`
+}
+
+type WebAuthnLoginFinishRequest struct {
+	Data WebAuthnLoginFinishData `json:"data" validate:"required"`
+}
+
+// Sensitive-action re-auth attributes
+type ReauthAttributes struct {
+	Method   string `json:"method" validate:"required,oneof=pin password" example:"pin"`
+	Password string `json:"password,omitempty" validate:"omitempty,min=1" example:"StrongP@ssw0rd"`
+}
+
+// WebAuthn reset setup
+type WebAuthnResetSetupData struct {
+	Type       string           `json:"type" validate:"required,eq=auth_webauthn_reset_setup" example:"auth_webauthn_reset_setup"`
+	Attributes ReauthAttributes `json:"attributes" validate:"required"`
+}
+
+type WebAuthnResetSetupRequest struct {
+	Data WebAuthnResetSetupData `json:"data" validate:"required"`
+}
+
+type WebAuthnResetSetupResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_webauthn_reset_setup"`
+		Attributes struct {
+			Reset bool `json:"reset" example:"true"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+// Login response when TOTP required
+type LoginTOTPRequiredResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_totp_required"`
+		Attributes struct {
+			RequiresTOTP              bool   `json:"requires_totp" example:"true"`
+			ChallengeToken            string `json:"challenge_token" example:"kP8k2..."`
+			TOTPEnabled               bool   `json:"totp_enabled" example:"true"`
+			EmailOTPEnabled           bool   `json:"email_otp_enabled" example:"false"`
+			EmailOTPChallengeToken    string `json:"email_otp_challenge_token,omitempty" example:"qA9j1..."`
+			EmailOTPResendCooldownSec int    `json:"email_otp_resend_cooldown_seconds,omitempty" example:"60"`
+			EmailOTPMaxResendPerHour  int    `json:"email_otp_max_resend_per_hour,omitempty" example:"5"`
+			WebAuthnConfigured        bool   `json:"webauthn_configured" example:"false"`
+			LinkedSSO                 bool   `json:"linked_sso" example:"false"`
+			PINConfigured             bool   `json:"pin_configured" example:"false"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+type LoginEmailOTPRequiredResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_email_otp_required"`
+		Attributes struct {
+			RequiresEmailOTP      bool   `json:"requires_email_otp" example:"true"`
+			ChallengeToken        string `json:"challenge_token" example:"kP8k2..."`
+			ResendCooldownSeconds int    `json:"resend_cooldown_seconds" example:"60"`
+			MaxResendPerHour      int    `json:"max_resend_per_hour" example:"5"`
+			RequiresTOTPSetup     bool   `json:"requires_totp_setup" example:"true"`
+			WebAuthnConfigured    bool   `json:"webauthn_configured" example:"false"`
+			LinkedSSO             bool   `json:"linked_sso" example:"false"`
+			PINConfigured         bool   `json:"pin_configured" example:"false"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+type EmailOTPSendAttributes struct {
+	ChallengeToken string `json:"challenge_token" validate:"required" example:"kP8k2..."`
+}
+
+type EmailOTPSendData struct {
+	Type       string                 `json:"type" validate:"required,eq=auth_email_otp_send" example:"auth_email_otp_send"`
+	Attributes EmailOTPSendAttributes `json:"attributes" validate:"required"`
+}
+
+type EmailOTPSendRequest struct {
+	Data EmailOTPSendData `json:"data" validate:"required"`
+}
+
+type EmailOTPVerifyAttributes struct {
+	ChallengeToken string `json:"challenge_token" validate:"required" example:"kP8k2..."`
+	Code           string `json:"code" validate:"required,len=6,numeric" example:"123456"`
+}
+
+type EmailOTPVerifyData struct {
+	Type       string                   `json:"type" validate:"required,eq=auth_email_otp_verify" example:"auth_email_otp_verify"`
+	Attributes EmailOTPVerifyAttributes `json:"attributes" validate:"required"`
+}
+
+type EmailOTPVerifyRequest struct {
+	Data EmailOTPVerifyData `json:"data" validate:"required"`
+}
+
+type EmailOTPSendResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_email_otp_send"`
+		Attributes struct {
+			Sent bool `json:"sent" example:"true"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+type EmailOTPVerifyResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_email_otp_verify"`
+		Attributes struct {
+			Verified          bool `json:"verified" example:"true"`
+			RequiresTOTPSetup bool `json:"requires_totp_setup" example:"true"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+// Email verify response
+type VerifyEmailResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_verify_email"`
+		Attributes struct {
+			Verified bool `json:"verified" example:"true"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+// Microsoft login
+type MicrosoftLoginResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_microsoft_url"`
+		Attributes struct {
+			URL         string `json:"url" example:"https://login.microsoftonline.com/..."`
+			RedirectURL string `json:"redirect_url" example:"https://login.microsoftonline.com/..."`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+// Microsoft callback
+type MicrosoftCallbackResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_identity"`
+		ID         string `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+		Attributes struct {
+			Provider        string `json:"provider" example:"microsoft"`
+			ProviderSubject string `json:"provider_subject" example:"00000000-0000-0000-0000-000000000000"`
+			Email           string `json:"email" example:"user@example.com"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+type SSOLinkAttributes struct {
+	Provider string `json:"provider" validate:"required,eq=microsoft" example:"microsoft"`
+	Code     string `json:"code" validate:"required" example:"0.AXkA..."`
+}
+
+type SSOLinkData struct {
+	Type       string            `json:"type" validate:"required,eq=auth_sso_link" example:"auth_sso_link"`
+	Attributes SSOLinkAttributes `json:"attributes" validate:"required"`
+}
+
+type SSOLinkRequest struct {
+	Data SSOLinkData `json:"data" validate:"required"`
+}
+
+type SSOLinkResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_sso_link"`
+		Attributes struct {
+			Provider        string `json:"provider" example:"microsoft"`
+			ProviderSubject string `json:"provider_subject" example:"00000000-0000-0000-0000-000000000000"`
+			Email           string `json:"email" example:"user@example.com"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+type SSOUnlinkAttributes struct {
+	Provider string `json:"provider" validate:"required,eq=microsoft" example:"microsoft"`
+}
+
+type SSOUnlinkData struct {
+	Type       string              `json:"type" validate:"required,eq=auth_sso_unlink" example:"auth_sso_unlink"`
+	Attributes SSOUnlinkAttributes `json:"attributes" validate:"required"`
+}
+
+type SSOUnlinkRequest struct {
+	Data SSOUnlinkData `json:"data" validate:"required"`
+}
+
+type SSOUnlinkResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_sso_unlink"`
+		Attributes struct {
+			Provider string `json:"provider" example:"microsoft"`
+			Unlinked bool   `json:"unlinked" example:"true"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+// WebAuthn begin response
+type WebAuthnBeginResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_webauthn_register_options"`
+		Attributes struct {
+			ChallengeToken string                 `json:"challenge_token" example:"kP8k2..."`
+			ChallengeTTLMS int64                  `json:"challenge_ttl_ms" example:"300000"`
+			PublicKey      map[string]interface{} `json:"public_key"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+// TOTP setup
+type TOTPSetupAttributes struct {
+	UserID string `json:"user_id" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Email  string `json:"email" validate:"required,email" example:"user@example.com"`
+}
+
+type TOTPSetupData struct {
+	Type       string              `json:"type" validate:"required,eq=auth_totp_setup" example:"auth_totp_setup"`
+	Attributes TOTPSetupAttributes `json:"attributes" validate:"required"`
+}
+
+type TOTPSetupRequest struct {
+	Data TOTPSetupData `json:"data" validate:"required"`
+}
+
+type TOTPSetupResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_totp_setup"`
+		Attributes struct {
+			Secret     string `json:"secret" example:"JBSWY3DPEHPK3PXP"`
+			OtpauthURL string `json:"otpauth_url" example:"otpauth://totp/Wucher:user@example.com?..."`
+			Issuer     string `json:"issuer" example:"Wucher"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+// TOTP verify
+type TOTPVerifyAttributes struct {
+	ChallengeToken string `json:"challenge_token" validate:"required" example:"kP8k2..."`
+	Code           string `json:"code" validate:"required,len=6" example:"123456"`
+}
+
+type TOTPVerifyData struct {
+	Type       string               `json:"type" validate:"required,eq=auth_totp_verify" example:"auth_totp_verify"`
+	Attributes TOTPVerifyAttributes `json:"attributes" validate:"required"`
+}
+
+type TOTPVerifyRequest struct {
+	Data TOTPVerifyData `json:"data" validate:"required"`
+}
+
+// TOTP confirm (enable)
+type TOTPConfirmAttributes struct {
+	UserID string `json:"user_id" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Code   string `json:"code" validate:"required,len=6" example:"123456"`
+}
+
+type TOTPConfirmData struct {
+	Type       string                `json:"type" validate:"required,eq=auth_totp_confirm" example:"auth_totp_confirm"`
+	Attributes TOTPConfirmAttributes `json:"attributes" validate:"required"`
+}
+
+type TOTPConfirmRequest struct {
+	Data TOTPConfirmData `json:"data" validate:"required"`
+}
+
+// Disable TOTP
+type TOTPDisableAttributes struct {
+	UserID string `json:"user_id" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type TOTPDisableData struct {
+	Type       string                `json:"type" validate:"required,eq=auth_totp_disable" example:"auth_totp_disable"`
+	Attributes TOTPDisableAttributes `json:"attributes" validate:"required"`
+}
+
+type TOTPDisableRequest struct {
+	Data TOTPDisableData `json:"data" validate:"required"`
+}
+
+// TOTP reset setup
+type TOTPResetSetupData struct {
+	Type       string           `json:"type" validate:"required,eq=auth_totp_reset_setup" example:"auth_totp_reset_setup"`
+	Attributes ReauthAttributes `json:"attributes" validate:"required"`
+}
+
+type TOTPResetSetupRequest struct {
+	Data TOTPResetSetupData `json:"data" validate:"required"`
+}
+
+type TOTPResetSetupResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_totp_reset_setup"`
+		Attributes struct {
+			Reset bool `json:"reset" example:"true"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+type AuthSessionItem struct {
+	ID           string `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeviceName   string `json:"device_name" example:"Chrome on macOS"`
+	UserAgent    string `json:"user_agent,omitempty" example:"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) ..."`
+	IPAddress    string `json:"ip_address,omitempty" example:"127.0.0.1"`
+	CreatedAt    string `json:"created_at" example:"2026-03-13T12:00:00Z"`
+	LastActiveAt string `json:"last_active_at" example:"2026-03-13T12:10:00Z"`
+	ActiveNow    bool   `json:"active_now" example:"true"`
+}
+
+type AuthSessionsResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_sessions"`
+		Attributes struct {
+			Sessions []AuthSessionItem `json:"sessions"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+type AuthSessionDeleteResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_session_delete"`
+		Attributes struct {
+			Deleted bool `json:"deleted" example:"true"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+// Update timezone
+type TimezoneUpdateAttributes struct {
+	Timezone string `json:"timezone" validate:"required" example:"Asia/Jakarta"`
+}
+
+type TimezoneUpdateData struct {
+	Type       string                   `json:"type" validate:"required,eq=auth_timezone_update" example:"auth_timezone_update"`
+	Attributes TimezoneUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type TimezoneUpdateRequest struct {
+	Data TimezoneUpdateData `json:"data" validate:"required"`
+}
+
+// Token response
+type TokenResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"auth_tokens"`
+		Attributes struct {
+			AccessTokenExpiresIn  int64 `json:"access_expires_in" example:"900"`
+			RefreshTokenExpiresIn int64 `json:"refresh_expires_in" example:"2592000"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+// User response
+type UserAttributes struct {
+	Email                  string     `json:"email" example:"user@example.com"`
+	Username               string     `json:"username,omitempty" example:"john.doe"`
+	FirstName              string     `json:"first_name" example:"John"`
+	LastName               string     `json:"last_name" example:"Doe"`
+	MobilePhone            string     `json:"mobile_phone,omitempty" example:"+628123456789"`
+	Timezone               string     `json:"timezone" example:"Asia/Jakarta"`
+	ProfilePicture         *UserImage `json:"profile_picture,omitempty"`
+	RoleID                 string     `json:"role_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	RoleIDs                []string   `json:"role_ids,omitempty" example:"[\"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d\",\"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9e\"]"`
+	CreatedBy              string     `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	EmailVerifiedAt        string     `json:"email_verified_at,omitempty" example:"2026-02-05T10:00:00Z"`
+	TOTPEnabled            bool       `json:"totp_enabled" example:"false"`
+	IsPreviouslyConfigured bool       `json:"is_previously_configured" example:"false"`
+	WebAuthnConfigured     bool       `json:"webauthn_configured" example:"false"`
+	LinkedSSO              bool       `json:"linked_sso" example:"false"`
+	PINConfigured          bool       `json:"pin_configured" example:"false"`
+	Role                   RoleMini   `json:"role,omitempty"`
+	Roles                  []RoleMini `json:"roles,omitempty"`
+}
+
+type UserImage struct {
+	UUID                 string `json:"uuid,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9f"`
+	DownloadURL          string `json:"download_url,omitempty" example:"https://example.com/presigned-url"`
+	ThumbnailDownloadURL string `json:"thumbnail_download_url,omitempty" example:"https://example.com/presigned-thumb-url"`
+	OriginalSizeBytes    *int64 `json:"original_size_bytes,omitempty" example:"1024000"`
+}
+
+type UserFoto struct {
+	UUID                 string `json:"uuid,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9f"`
+	DownloadURL          string `json:"download_url,omitempty" example:"https://storage.example.com/base/lude.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=900&X-Amz-Signature=abc123"`
+	ThumbnailDownloadURL string `json:"thumbnail_download_url,omitempty" example:"https://storage.example.com/base/lude.thumb.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=900&X-Amz-Signature=abc123"`
+	OriginalSizeBytes    *int64 `json:"original_size_bytes,omitempty" example:"1024000"`
+}
+
+type RoleMini struct {
+	ID          string `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name        string `json:"name" example:"admin"`
+	Description string `json:"description,omitempty" example:"Full access to all resources."`
+}
+
+type PermissionMini struct {
+	ID          string `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9a"`
+	Name        string `json:"name" example:"View Users"`
+	Key         string `json:"key" example:"users.read"`
+	Description string `json:"description,omitempty" example:"Permission to view users."`
+	RequiresPIN bool   `json:"requires_pin" example:"false"`
+}
+
+// Auth current-user payload used by /auth/login and /auth/me endpoints.
+type AuthCurrentUserAttributes struct {
+	Email                  string                    `json:"email" example:"user@example.com"`
+	EmailSSO               string                    `json:"email_sso,omitempty" example:"user.sso@example.com"`
+	FirstName              string                    `json:"first_name" example:"John"`
+	LastName               string                    `json:"last_name" example:"Doe"`
+	MobilePhone            string                    `json:"mobile_phone,omitempty" example:"+628123456789"`
+	Timezone               string                    `json:"timezone" example:"Asia/Jakarta"`
+	Foto                   *UserFoto                 `json:"foto,omitempty"`
+	EmailVerifiedAt        string                    `json:"email_verified_at,omitempty" example:"2026-02-05T10:00:00Z"`
+	Roles                  []RoleMini                `json:"roles,omitempty"`
+	Permissions            []PermissionMini          `json:"permissions,omitempty"`
+	PermissionModules      []PermissionGroupResource `json:"permission_modules,omitempty"`
+	TOTPEnabled            bool                      `json:"totp_enabled" example:"false"`
+	IsPreviouslyConfigured bool                      `json:"is_previously_configured" example:"false"`
+	WebAuthnConfigured     bool                      `json:"webauthn_configured" example:"false"`
+	LinkedSSO              bool                      `json:"linked_sso" example:"false"`
+	PINConfigured          bool                      `json:"pin_configured" example:"false"`
+	PINBlocked             bool                      `json:"pin_blocked" example:"false"`
+	LoginMethod            string                    `json:"login_method,omitempty" example:"email"`
+	AuthProvider           string                    `json:"auth_provider,omitempty" example:"email"`
+	MicrosoftScope         string                    `json:"microsoft_scope,omitempty" example:"openid profile email offline_access User.Read"`
+	DULBases               []DULBase                 `json:"dul_bases,omitempty"`
+}
+
+type AuthCurrentUserResponse struct {
+	Data struct {
+		Type       string                    `json:"type" example:"user"`
+		ID         string                    `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+		Attributes AuthCurrentUserAttributes `json:"attributes"`
+	} `json:"data"`
+}
+
+type UserResponse struct {
+	Data struct {
+		Type       string         `json:"type" example:"user"`
+		ID         string         `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+		Attributes UserAttributes `json:"attributes"`
+	} `json:"data"`
+}
+
+// Error response for Swagger
+type ErrorResponse struct {
+	Errors []struct {
+		Status string `json:"status" example:"422"`
+		Title  string `json:"title" example:"Validation error"`
+		Detail string `json:"detail" example:"email is required"`
+		Source struct {
+			Pointer string `json:"pointer" example:"/data/attributes/email"`
+		} `json:"source"`
+	} `json:"errors"`
+}

internal/transport/http/dto/base_dto.go

@@ -0,0 +1,569 @@
+package dto
+
+import (
+	"context"
+	"strings"
+	"time"
+
+	"wucher/internal/domain/base"
+	"wucher/internal/shared/pkg/userctx"
+	"wucher/internal/shared/pkg/uuidv7"
+)
+
+// JSON:API Base DTOs
+
+type BaseAttributes struct {
+	BaseName                           string                     `json:"base" example:"Lude"`
+	BaseAbbreviation                   string                     `json:"base_abbreviation,omitempty" example:"LOIG"`
+	BaseCategory                       string                     `json:"base_category,omitempty" example:"regular" enums:"regular,hems"`
+	Address                            string                     `json:"address,omitempty" example:"Lude Airfield"`
+	Latitude                           float64                    `json:"latitude" example:"47.3769"`
+	Longitude                          float64                    `json:"longitude" example:"8.5417"`
+	LandlineNumber                     string                     `json:"landline_number,omitempty" example:"+62-21-1234"`
+	MobileNumber                       string                     `json:"mobile_number,omitempty" example:"+62-812-1234"`
+	Email                              string                     `json:"email,omitempty" example:"lude@wucher.local"`
+	SortKey                            *int                       `json:"sortkey" example:"1"`
+	SMSAlert                           bool                       `json:"sms_alert" example:"false"`
+	Checklist                          bool                       `json:"checklist" example:"false"`
+	LegTime                            string                     `json:"leg_time,omitempty" example:"00:20"`
+	DefaultStartTimeType               string                     `json:"default_start_time_type,omitempty" example:"FIXED" enums:"FIXED,BMCT,ECET"`
+	DefaultEndTimeType                 string                     `json:"default_end_time_type,omitempty" example:"FIXED" enums:"FIXED,BMCT,ECET"`
+	ShiftTime                          BaseShiftTime              `json:"shift_time"`
+	UTC                                string                     `json:"utc" example:"0"`
+	Foto                               *BaseFoto                  `json:"foto,omitempty"`
+	Dry                                bool                       `json:"dry" example:"false"`
+	ControlCenter                      bool                       `json:"control_center" example:"false"`
+	DUL                                bool                       `json:"dul" example:"false"`
+	Notes                              string                     `json:"notes,omitempty" example:"Main base"`
+	HEMSEDCContactIDs []string      `json:"hems_edc_contact_ids,omitempty"`
+	HEMSEDCs          []BaseContact `json:"hems_edc,omitempty"`
+	MedPaxContactIDs  []string      `json:"med_pax_contact_ids,omitempty"`
+	MedPax            []BaseContact `json:"med_pax,omitempty"`
+	ResponsiblePilotContactIDs         []string                   `json:"responsible_pilot_contact_ids,omitempty"`
+	ResponsiblePilots                  []BaseContact              `json:"responsible_pilots,omitempty"`
+	OperationalShiftTimes              []BaseOperationalShiftTime `json:"operational_shift_times,omitempty"`
+	IsActive                           bool                       `json:"is_active" example:"true"`
+	CreatedBy                          string                     `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedBy                          string                     `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CreatedAt                          string                     `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedAt                          string                     `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedAt                          string                     `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z" swaggerignore:"true"`
+	DeletedBy                          string                     `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d" swaggerignore:"true"`
+}
+
+type BaseContact struct {
+	ID        string `json:"id"`
+	FirstName string `json:"first_name,omitempty"`
+	LastName  string `json:"last_name,omitempty"`
+}
+
+type BaseShiftTime struct {
+	Start string `json:"start,omitempty" example:"06:00"`
+	End   string `json:"end,omitempty" example:"21:00"`
+}
+
+type BaseOperationalShiftTime struct {
+	DateStart     string        `json:"date_start" example:"2026-04-12"`
+	DateEnd       string        `json:"date_end" example:"2026-04-12"`
+	StartTimeType string        `json:"start_time_type,omitempty" example:"FIXED" enums:"FIXED,BMCT,ECET"`
+	EndTimeType   string        `json:"end_time_type,omitempty" example:"FIXED" enums:"FIXED,BMCT,ECET"`
+	ShiftTime     BaseShiftTime `json:"shift_time"`
+}
+
+type BaseFoto struct {
+	UUID                 string `json:"uuid" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DownloadURL          string `json:"download_url" example:"https://storage.example.com/base/lude.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=900&X-Amz-Signature=abc123"`
+	ThumbnailDownloadURL string `json:"thumbnail_download_url,omitempty" example:"https://storage.example.com/base/lude.thumb.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=900&X-Amz-Signature=abc123"`
+	OriginalSizeBytes    *int64 `json:"original_size_bytes,omitempty" example:"1024000"`
+}
+
+type BaseResource struct {
+	Type       string         `json:"type" example:"base"`
+	ID         string         `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes BaseAttributes `json:"attributes"`
+}
+
+type BaseResponse struct {
+	Data BaseResource `json:"data"`
+}
+
+type BaseListResponse struct {
+	Data []BaseResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type BaseDataTableResponse struct {
+	Data []BaseResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type BaseCreateAttributes struct {
+	BaseName                           string                     `json:"base" validate:"required" example:"Lude"`
+	BaseAbbreviation                   *string                    `json:"base_abbreviation,omitempty" example:"LOIG"`
+	BaseCategory                       *string                    `json:"base_category,omitempty" example:"regular" enums:"regular,hems"`
+	Address                            *string                    `json:"address,omitempty" example:"Lude Airfield"`
+	Latitude                           *float64                   `json:"latitude" validate:"required,gte=-90,lte=90" example:"47.3769"`
+	Longitude                          *float64                   `json:"longitude" validate:"required,gte=-180,lte=180" example:"8.5417"`
+	LandlineNumber                     *string                    `json:"landline_number,omitempty" example:"+62-21-1234"`
+	MobileNumber                       *string                    `json:"mobile_number,omitempty" example:"+62-812-1234"`
+	Email                              *string                    `json:"email,omitempty" example:"lude@wucher.local"`
+	SortKey                            *int                       `json:"sortkey" example:"1"`
+	SMSAlert                           *bool                      `json:"sms_alert,omitempty" example:"false"`
+	Checklist                          *bool                      `json:"checklist,omitempty" example:"false"`
+	LegTime                            *string                    `json:"leg_time,omitempty" example:"00:20"`
+	DefaultStartTimeType               *string                    `json:"default_start_time_type,omitempty" example:"FIXED" enums:"FIXED,BMCT,ECET"`
+	DefaultEndTimeType                 *string                    `json:"default_end_time_type,omitempty" example:"FIXED" enums:"FIXED,BMCT,ECET"`
+	ShiftTime                          *BaseShiftTime             `json:"shift_time,omitempty"`
+	DefaultShiftStart                  *string                    `json:"default_shift_start,omitempty" example:"06:00:00"`
+	DefaultShiftEnd                    *string                    `json:"default_shift_end,omitempty" example:"21:00:00"`
+	DefaultShiftTime                   *string                    `json:"default_shift_time,omitempty" example:"12:00"`
+	UTC                                *string                    `json:"utc,omitempty" example:"0"`
+	FileUUID                           *string                    `json:"file_uuid,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e90"`
+	Dry                                *bool                      `json:"dry,omitempty" example:"false"`
+	ControlCenter                      *bool                      `json:"control_center,omitempty" example:"false"`
+	DUL                                *bool                      `json:"dul,omitempty" example:"false"`
+	Notes                              *string                    `json:"notes,omitempty" example:"Main base"`
+	HEMSEDCContactIDs []string `json:"hems_edc_contact_ids,omitempty"`
+	MedPaxContactIDs  []string `json:"med_pax_contact_ids,omitempty"`
+	ResponsiblePilotContactIDs         []string                   `json:"responsible_pilot_contact_ids,omitempty"`
+	OperationalShiftTimes              []BaseOperationalShiftTime `json:"operational_shift_times,omitempty"`
+	IsActive                           *bool                      `json:"is_active,omitempty" example:"true"`
+	CreatedBy                          *string                    `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d" swaggerignore:"true"`
+	UpdatedBy                          *string                    `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d" swaggerignore:"true"`
+}
+
+type BaseCreateData struct {
+	Type       string               `json:"type" validate:"required,oneof=base_create base hems_base" enums:"base" example:"base"`
+	Attributes BaseCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type BaseCreateRequest struct {
+	Data BaseCreateData `json:"data" validate:"required"`
+}
+
+type BaseUpdateAttributes struct {
+	BaseName                           *string                    `json:"base,omitempty" example:"Lude"`
+	BaseAbbreviation                   *string                    `json:"base_abbreviation,omitempty" example:"LOIG"`
+	BaseCategory                       *string                    `json:"base_category,omitempty" example:"regular" enums:"regular,hems"`
+	Address                            *string                    `json:"address,omitempty" example:"Lude Airfield"`
+	Latitude                           *float64                   `json:"latitude,omitempty" validate:"omitempty,gte=-90,lte=90" example:"47.3769"`
+	Longitude                          *float64                   `json:"longitude,omitempty" validate:"omitempty,gte=-180,lte=180" example:"8.5417"`
+	LandlineNumber                     *string                    `json:"landline_number,omitempty" example:"+62-21-1234"`
+	MobileNumber                       *string                    `json:"mobile_number,omitempty" example:"+62-812-1234"`
+	Email                              *string                    `json:"email,omitempty" example:"lude@wucher.local"`
+	SortKey                            NullInt                    `json:"sortkey,omitempty" swaggertype:"integer" example:"1"`
+	SMSAlert                           *bool                      `json:"sms_alert,omitempty" example:"false"`
+	Checklist                          *bool                      `json:"checklist,omitempty" example:"false"`
+	LegTime                            *string                    `json:"leg_time,omitempty" example:"00:20"`
+	DefaultStartTimeType               *string                    `json:"default_start_time_type,omitempty" example:"FIXED" enums:"FIXED,BMCT,ECET"`
+	DefaultEndTimeType                 *string                    `json:"default_end_time_type,omitempty" example:"FIXED" enums:"FIXED,BMCT,ECET"`
+	DefaultShiftStart                  *string                    `json:"default_shift_start,omitempty" example:"06:00:00"`
+	DefaultShiftEnd                    *string                    `json:"default_shift_end,omitempty" example:"21:00:00"`
+	DefaultShiftTime                   *string                    `json:"default_shift_time,omitempty" example:"12:00"`
+	ShiftTime                          *BaseShiftTime             `json:"shift_time,omitempty"`
+	UTC                                *string                    `json:"utc,omitempty" example:"0"`
+	FileUUID                           *string                    `json:"file_uuid,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e90"`
+	Dry                                *bool                      `json:"dry,omitempty" example:"false"`
+	ControlCenter                      *bool                      `json:"control_center,omitempty" example:"false"`
+	DUL                                *bool                      `json:"dul,omitempty" example:"false"`
+	Notes                              *string                    `json:"notes,omitempty" example:"Main base"`
+	HEMSEDCContactIDs *[]string `json:"hems_edc_contact_ids,omitempty"`
+	MedPaxContactIDs  *[]string `json:"med_pax_contact_ids,omitempty"`
+	ResponsiblePilotContactIDs         *[]string                  `json:"responsible_pilot_contact_ids,omitempty"`
+	OperationalShiftTimes              []BaseOperationalShiftTime `json:"operational_shift_times,omitempty"`
+	IsActive                           *bool                      `json:"is_active,omitempty" example:"true"`
+	CreatedBy                          *string                    `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d" swaggerignore:"true"`
+	UpdatedBy                          *string                    `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d" swaggerignore:"true"`
+}
+
+type BaseUpdateData struct {
+	Type       string               `json:"type" validate:"required,oneof=base_update base hems_base" enums:"base_update" example:"base_update"`
+	ID         string               `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes BaseUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type BaseUpdateRequest struct {
+	Data BaseUpdateData `json:"data" validate:"required"`
+}
+
+type BaseDeleteAttributes struct {
+	Deleted bool `json:"deleted" example:"true"`
+}
+
+type BaseDeleteResource struct {
+	Type       string               `json:"type" example:"base_delete"`
+	ID         string               `json:"id" example:"019d6b10-a385-7e9e-a553-8e892bcec0ef"`
+	Attributes BaseDeleteAttributes `json:"attributes"`
+}
+
+type BaseDeleteResponse struct {
+	Data BaseDeleteResource `json:"data"`
+}
+
+type BaseResponseMappingInput struct {
+	ResourceType                       string
+	BaseCategory                       string
+	ID                                 string
+	DefaultStartTimeType               string
+	DefaultEndTimeType                 string
+	ShiftTime                          BaseShiftTime
+	Foto                               *BaseFoto
+	Latitude                           float64
+	Longitude                          float64
+	HEMSEDCContactIDs []string
+	HEMSEDCs          []BaseContact
+	MedPaxContactIDs  []string
+	MedPax            []BaseContact
+	ResponsiblePilotContactIDs         []string
+	ResponsiblePilots                  []BaseContact
+	OperationalShiftTimes              []BaseOperationalShiftTime
+}
+
+func MapBaseCreateAttributesToDomain(attrs BaseCreateAttributes) *base.Base {
+	row := &base.Base{}
+	row.BaseName = strings.TrimSpace(attrs.BaseName)
+	row.BaseAbbreviation = strings.TrimSpace(stringOrDefault(attrs.BaseAbbreviation, ""))
+	row.Address = strings.TrimSpace(stringOrDefault(attrs.Address, ""))
+	row.Latitude = floatOrDefault(attrs.Latitude, 0)
+	row.Longitude = floatOrDefault(attrs.Longitude, 0)
+	row.LandlineNumber = strings.TrimSpace(stringOrDefault(attrs.LandlineNumber, ""))
+	row.MobileNumber = strings.TrimSpace(stringOrDefault(attrs.MobileNumber, ""))
+	row.Email = strings.TrimSpace(stringOrDefault(attrs.Email, ""))
+	row.SortKey = cloneIntPtr(attrs.SortKey)
+	row.SMSAlert = boolOrDefault(attrs.SMSAlert, false)
+	row.Checklist = boolOrDefault(attrs.Checklist, false)
+	row.LegTime = strings.TrimSpace(stringOrDefault(attrs.LegTime, ""))
+	row.DefaultStartTimeType = normalizeShiftTimeType(stringOrDefault(attrs.DefaultStartTimeType, ""))
+	row.DefaultEndTimeType = normalizeShiftTimeType(stringOrDefault(attrs.DefaultEndTimeType, ""))
+	row.UTC = normalizeUTC(attrs.UTC)
+	row.Dry = boolOrDefault(attrs.Dry, false)
+	row.ControlCenter = boolOrDefault(attrs.ControlCenter, false)
+	row.DUL = boolOrDefault(attrs.DUL, false)
+	row.Notes = strings.TrimSpace(stringOrDefault(attrs.Notes, ""))
+	row.IsActive = boolOrDefault(attrs.IsActive, true)
+	row.OperationalShiftTimes = mapBaseOperationalShiftTimesToDomain(attrs.OperationalShiftTimes)
+	return row
+}
+
+func ApplyBaseUpdateAttributesToDomain(row *base.Base, attrs BaseUpdateAttributes) {
+	if attrs.BaseName != nil {
+		row.BaseName = strings.TrimSpace(*attrs.BaseName)
+	}
+	if attrs.BaseAbbreviation != nil {
+		row.BaseAbbreviation = strings.TrimSpace(*attrs.BaseAbbreviation)
+	}
+	if attrs.Address != nil {
+		row.Address = strings.TrimSpace(*attrs.Address)
+	}
+	if attrs.Latitude != nil {
+		row.Latitude = *attrs.Latitude
+	}
+	if attrs.Longitude != nil {
+		row.Longitude = *attrs.Longitude
+	}
+	if attrs.LandlineNumber != nil {
+		row.LandlineNumber = strings.TrimSpace(*attrs.LandlineNumber)
+	}
+	if attrs.MobileNumber != nil {
+		row.MobileNumber = strings.TrimSpace(*attrs.MobileNumber)
+	}
+	if attrs.Email != nil {
+		row.Email = strings.TrimSpace(*attrs.Email)
+	}
+	if attrs.SortKey.Set {
+		if attrs.SortKey.Valid {
+			v := attrs.SortKey.Value
+			row.SortKey = &v
+		} else {
+			row.SortKey = nil
+		}
+	}
+	if attrs.SMSAlert != nil {
+		row.SMSAlert = *attrs.SMSAlert
+	}
+	if attrs.Checklist != nil {
+		row.Checklist = *attrs.Checklist
+	}
+	if attrs.LegTime != nil {
+		row.LegTime = strings.TrimSpace(*attrs.LegTime)
+	}
+	if attrs.DefaultStartTimeType != nil {
+		row.DefaultStartTimeType = normalizeShiftTimeType(*attrs.DefaultStartTimeType)
+	}
+	if attrs.DefaultEndTimeType != nil {
+		row.DefaultEndTimeType = normalizeShiftTimeType(*attrs.DefaultEndTimeType)
+	}
+	if attrs.UTC != nil {
+		row.UTC = normalizeUTC(attrs.UTC)
+	}
+	if attrs.Dry != nil {
+		row.Dry = *attrs.Dry
+	}
+	if attrs.ControlCenter != nil {
+		row.ControlCenter = *attrs.ControlCenter
+	}
+	if attrs.DUL != nil {
+		row.DUL = *attrs.DUL
+	}
+	if attrs.Notes != nil {
+		row.Notes = strings.TrimSpace(*attrs.Notes)
+	}
+	if attrs.IsActive != nil {
+		row.IsActive = *attrs.IsActive
+	}
+}
+
+func mapBaseOperationalShiftTimesToDomain(items []BaseOperationalShiftTime) []base.BaseOperationalShiftTime {
+	if len(items) == 0 {
+		return nil
+	}
+	out := make([]base.BaseOperationalShiftTime, 0, len(items))
+	for i := range items {
+		dateStart := parseBaseOperationDatePtr(items[i].DateStart)
+		dateEnd := parseBaseOperationDatePtr(items[i].DateEnd)
+		out = append(out, base.BaseOperationalShiftTime{
+			DateStart:     dateStart,
+			DateEnd:       dateEnd,
+			StartTimeType: normalizeShiftTimeType(items[i].StartTimeType),
+			EndTimeType:   normalizeShiftTimeType(items[i].EndTimeType),
+			ShiftStart:    normalizeBaseClockValue(items[i].ShiftTime.Start),
+			ShiftEnd:      normalizeBaseClockValue(items[i].ShiftTime.End),
+		})
+	}
+	return out
+}
+
+func MapBaseOperationalShiftTimesToDTO(items []base.BaseOperationalShiftTime) []BaseOperationalShiftTime {
+	if len(items) == 0 {
+		return nil
+	}
+	out := make([]BaseOperationalShiftTime, 0, len(items))
+	for i := range items {
+		out = append(out, BaseOperationalShiftTime{
+			DateStart:     timePtrToDateString(items[i].DateStart),
+			DateEnd:       timePtrToDateString(items[i].DateEnd),
+			StartTimeType: normalizeShiftTimeType(items[i].StartTimeType),
+			EndTimeType:   normalizeShiftTimeType(items[i].EndTimeType),
+			ShiftTime: BaseShiftTime{
+				Start: DisplayBaseShiftValue(items[i].StartTimeType, items[i].ShiftStart),
+				End:   DisplayBaseShiftValue(items[i].EndTimeType, items[i].ShiftEnd),
+			},
+		})
+	}
+	return out
+}
+
+func parseBaseOperationDate(raw string) time.Time {
+	parsed, err := time.Parse("2006-01-02", strings.TrimSpace(raw))
+	if err != nil {
+		return time.Time{}
+	}
+	return parsed.UTC()
+}
+
+func parseBaseOperationDatePtr(raw string) *time.Time {
+	parsed := parseBaseOperationDate(raw)
+	if parsed.IsZero() {
+		return nil
+	}
+	return &parsed
+}
+
+func timePtrToDateString(v *time.Time) string {
+	if v == nil || v.IsZero() {
+		return ""
+	}
+	return v.UTC().Format("2006-01-02")
+}
+
+func normalizeBaseClockValue(raw string) string {
+	trimmed := strings.TrimSpace(raw)
+	if trimmed == "" {
+		return ""
+	}
+	if len(trimmed) == 5 {
+		trimmed += ":00"
+	}
+	parsed, err := time.Parse("15:04:05", trimmed)
+	if err != nil {
+		return ""
+	}
+	return parsed.UTC().Format("15:04:05")
+}
+
+func normalizeBaseShiftDisplay(raw string) string {
+	s := strings.TrimSpace(raw)
+	if s == "" {
+		return s
+	}
+	layouts := []string{
+		"15:04:05",
+		"15:04",
+		"2006-01-02 15:04:05",
+		"2006-01-02 15:04",
+		time.RFC3339,
+		time.RFC3339Nano,
+	}
+	for _, layout := range layouts {
+		if parsed, err := time.Parse(layout, s); err == nil {
+			return parsed.UTC().Format("15:04")
+		}
+	}
+	if len(s) >= 5 && isDigitBaseClock(s[0]) && isDigitBaseClock(s[1]) && s[2] == ':' && isDigitBaseClock(s[3]) && isDigitBaseClock(s[4]) {
+		return s[:5]
+	}
+	return s
+}
+
+// DisplayBaseShiftValue returns the user-facing representation for a shift value.
+// Fixed shifts are shown as HH:MM, while BMCT/ECET are shown as labels.
+func DisplayBaseShiftValue(timeType, raw string) string {
+	switch normalizeShiftTimeType(timeType) {
+	case "BMCT", "ECET":
+		return normalizeShiftTimeType(timeType)
+	default:
+		return normalizeBaseShiftDisplay(raw)
+	}
+}
+
+func normalizeShiftTimeType(raw string) string {
+	switch strings.ToUpper(strings.TrimSpace(raw)) {
+	case "", "FIXED":
+		return "FIXED"
+	case "BMCT":
+		return "BMCT"
+	case "ECET":
+		return "ECET"
+	default:
+		return strings.ToUpper(strings.TrimSpace(raw))
+	}
+}
+
+func isDigitBaseClock(b byte) bool {
+	return b >= '0' && b <= '9'
+}
+
+func MapBaseToResource(row *base.Base, in BaseResponseMappingInput) BaseResource {
+	if row == nil {
+		return BaseResource{
+			Type: in.ResourceType,
+			Attributes: BaseAttributes{
+				BaseCategory:          in.BaseCategory,
+				DefaultStartTimeType:  normalizeShiftTimeType(in.DefaultStartTimeType),
+				DefaultEndTimeType:    normalizeShiftTimeType(in.DefaultEndTimeType),
+				ShiftTime:             in.ShiftTime,
+				OperationalShiftTimes: in.OperationalShiftTimes,
+				Latitude:              in.Latitude,
+				Longitude:             in.Longitude,
+			},
+		}
+	}
+	return BaseResource{
+		Type: in.ResourceType,
+		ID:   in.ID,
+		Attributes: BaseAttributes{
+			BaseName:                           row.BaseName,
+			BaseAbbreviation:                   row.BaseAbbreviation,
+			BaseCategory:                       in.BaseCategory,
+			Address:                            row.Address,
+			Latitude:                           row.Latitude,
+			Longitude:                          row.Longitude,
+			LandlineNumber:                     row.LandlineNumber,
+			MobileNumber:                       row.MobileNumber,
+			Email:                              row.Email,
+			SortKey:                            cloneIntPtr(row.SortKey),
+			SMSAlert:                           row.SMSAlert,
+			Checklist:                          row.Checklist,
+			LegTime:                            row.LegTime,
+			DefaultStartTimeType:               normalizeShiftTimeType(row.DefaultStartTimeType),
+			DefaultEndTimeType:                 normalizeShiftTimeType(row.DefaultEndTimeType),
+			ShiftTime:                          in.ShiftTime,
+			UTC:                                row.UTC,
+			Foto:                               in.Foto,
+			Dry:                                row.Dry,
+			ControlCenter:                      row.ControlCenter,
+			DUL:                                row.DUL,
+			Notes:                              row.Notes,
+			HEMSEDCContactIDs: in.HEMSEDCContactIDs,
+			HEMSEDCs:          in.HEMSEDCs,
+			MedPaxContactIDs:  in.MedPaxContactIDs,
+			MedPax:            in.MedPax,
+			ResponsiblePilotContactIDs:         in.ResponsiblePilotContactIDs,
+			ResponsiblePilots:                  in.ResponsiblePilots,
+			OperationalShiftTimes:              in.OperationalShiftTimes,
+			IsActive:                           row.IsActive,
+			CreatedBy:                          bytesToUUID(row.CreatedBy),
+			UpdatedBy:                          bytesToUUID(row.UpdatedBy),
+			CreatedAt:                          row.CreatedAt.UTC().Format(time.RFC3339),
+			UpdatedAt:                          row.UpdatedAt.UTC().Format(time.RFC3339),
+			DeletedAt:                          timePtrToString(row.DeletedAt),
+			DeletedBy:                          bytesToUUID(row.DeletedBy),
+		},
+	}
+}
+
+func stringOrDefault(v *string, d string) string {
+	if v == nil {
+		return d
+	}
+	return *v
+}
+
+func boolOrDefault(v *bool, d bool) bool {
+	if v == nil {
+		return d
+	}
+	return *v
+}
+
+func normalizeUTC(v *string) string {
+	s := strings.TrimSpace(stringOrDefault(v, "0"))
+	if s == "" {
+		return "0"
+	}
+	return s
+}
+
+func floatOrDefault(v *float64, d float64) float64 {
+	if v == nil {
+		return d
+	}
+	return *v
+}
+
+func cloneIntPtr(v *int) *int {
+	if v == nil {
+		return nil
+	}
+	x := *v
+	return &x
+}
+
+func bytesToUUID(v []byte) string {
+	if len(v) == 0 {
+		return ""
+	}
+	if name := userctx.GetDisplayName(context.TODO(), v); name != "" {
+		return name
+	}
+	s, err := uuidv7.BytesToString(v)
+	if err != nil {
+		return ""
+	}
+	return s
+}
+
+func timePtrToString(v *time.Time) string {
+	if v == nil {
+		return ""
+	}
+	return v.UTC().Format(time.RFC3339)
+}

internal/transport/http/dto/before_flight_inspection_dto.go

@@ -0,0 +1,53 @@
+package dto
+
+type BeforeFlightInspectionAttributes struct {
+	ID                        string                    `json:"id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	FlightInspectionID        string                    `json:"flight_inspection_id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	FlightInspection          *FlightInspectionResource `json:"flight_inspection,omitempty"`
+	OilEngineNR1Checked       *bool                     `json:"oil_engine_nr1_checked,omitempty"`
+	OilEngineNR2Checked       *bool                     `json:"oil_engine_nr2_checked,omitempty"`
+	HydraulicLHChecked        *bool                     `json:"hydraulic_lh_checked,omitempty"`
+	HydraulicRHChecked        *bool                     `json:"hydraulic_rh_checked,omitempty"`
+	OilTransmissionMGBChecked *bool                     `json:"oil_transmission_mgb_checked,omitempty"`
+	OilTransmissionIGBChecked *bool                     `json:"oil_transmission_igb_checked,omitempty"`
+	OilTransmissionTGBChecked *bool                     `json:"oil_transmission_tgb_checked,omitempty"`
+	FuelAmount                *float64                  `json:"fuel_amount,omitempty" example:"500.5"`
+	FuelUnit                  string                    `json:"fuel_unit,omitempty" example:"LT"`
+	FuelAddedAmount           *float64                  `json:"fuel_added_amount,omitempty" example:"100.0"`
+	Note                      *string                   `json:"note,omitempty" example:"All checks completed"`
+	CreatedAt                 string                    `json:"created_at,omitempty" example:"2026-04-09T05:00:00Z"`
+	UpdatedAt                 string                    `json:"updated_at,omitempty" example:"2026-04-09T05:00:00Z"`
+}
+
+type BeforeFlightInspectionResource struct {
+	Type       string                           `json:"type" example:"before_flight_inspection"`
+	ID         string                           `json:"id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	Attributes BeforeFlightInspectionAttributes `json:"attributes"`
+}
+
+type BeforeFlightInspectionResponse struct {
+	Data BeforeFlightInspectionResource `json:"data"`
+}
+
+type BeforeFlightInspectionUpsertAttributes struct {
+	OilEngineNR1Checked       *bool    `json:"oil_engine_nr1_checked,omitempty"`
+	OilEngineNR2Checked       *bool    `json:"oil_engine_nr2_checked,omitempty"`
+	HydraulicLHChecked        *bool    `json:"hydraulic_lh_checked,omitempty"`
+	HydraulicRHChecked        *bool    `json:"hydraulic_rh_checked,omitempty"`
+	OilTransmissionMGBChecked *bool    `json:"oil_transmission_mgb_checked,omitempty"`
+	OilTransmissionIGBChecked *bool    `json:"oil_transmission_igb_checked,omitempty"`
+	OilTransmissionTGBChecked *bool    `json:"oil_transmission_tgb_checked,omitempty"`
+	FuelAmount                *float64 `json:"fuel_amount,omitempty" validate:"omitempty,gte=0"`
+	FuelUnit                  *string  `json:"fuel_unit,omitempty" validate:"omitempty,oneof=LT KG POUND"`
+	FuelAddedAmount           *float64 `json:"fuel_added_amount,omitempty" validate:"omitempty,gte=0"`
+	Note                      *string  `json:"note,omitempty"`
+}
+
+type BeforeFlightInspectionUpsertData struct {
+	Type       string                                 `json:"type" validate:"required,oneof=before_flight_inspection_upsert before_flight_inspection"`
+	Attributes BeforeFlightInspectionUpsertAttributes `json:"attributes" validate:"required"`
+}
+
+type BeforeFlightInspectionUpsertRequest struct {
+	Data BeforeFlightInspectionUpsertData `json:"data" validate:"required"`
+}

internal/transport/http/dto/contacts_dto.go

@@ -0,0 +1,423 @@
+package dto
+
+import "time"
+
+type ContactBaseAttributes struct {
+	Email       string `json:"email,omitempty" validate:"omitempty,email"`
+	SSOEmail    string `json:"sso_email,omitempty" validate:"omitempty,email"`
+	IsAdmin     *bool  `json:"is_admin,omitempty"`
+	Username    string `json:"username,omitempty" validate:"omitempty,max=100"`
+	FirstName   string `json:"first_name,omitempty" validate:"omitempty,max=100"`
+	LastName    string `json:"last_name,omitempty" validate:"omitempty,max=100"`
+	MobilePhone string `json:"mobile_phone,omitempty" validate:"omitempty,max=32"`
+	Timezone    string `json:"timezone,omitempty" validate:"omitempty,max=64"`
+	FileUUID    string `json:"file_uuid,omitempty" validate:"omitempty,max=64"`
+	SortKey     *int   `json:"sortkey"`
+	IsActive    *bool  `json:"is_active,omitempty"`
+}
+
+type PilotProfileAttributes struct {
+	PilotCategory           string     `json:"pilot_category,omitempty" validate:"omitempty,oneof=regular freelance dry_lease"`
+	ShortName               string     `json:"short_name,omitempty" validate:"omitempty,max=120"`
+	LicenseNo               string     `json:"license_no,omitempty" validate:"omitempty,max=120"`
+	LicenseIssuedAt         *time.Time `json:"license_issued_at,omitempty"`
+	LicenseExpiredAt        *time.Time `json:"license_expired_at,omitempty"`
+	TechnicianLicenseNo     string     `json:"technician_license_no,omitempty" validate:"omitempty,max=120"`
+	HasIFRQualification     *bool      `json:"has_ifr_qualification,omitempty"`
+	IsChiefPilot            *bool      `json:"is_chief_pilot,omitempty"`
+	DULBaseIDs              []string   `json:"dul_base_ids,omitempty" validate:"omitempty,dive,uuid" swaggerignore:"true"`
+	DULBase                 []DULBase  `json:"dul_base,omitempty"`
+	TotalFlightMinutes      *int       `json:"total_flight_minutes,omitempty"`
+	ResponsiblePilotMinutes *int       `json:"responsible_pilot_minutes,omitempty"`
+	SecondPilotMinutes      *int       `json:"second_pilot_minutes,omitempty"`
+	DoubleCommandMinutes    *int       `json:"double_command_minutes,omitempty"`
+	FlightInstructorMinutes *int       `json:"flight_instructor_minutes,omitempty"`
+	NightFlightMinutes      *int       `json:"night_flight_minutes,omitempty"`
+	IFRFlightMinutes        *int       `json:"ifr_flight_minutes,omitempty"`
+	Location                string     `json:"location,omitempty" validate:"omitempty,max=255"`
+	Postcode                string     `json:"postcode,omitempty" validate:"omitempty,max=32"`
+	StreetLine              string     `json:"street_line,omitempty" validate:"omitempty,max=255"`
+	Note                    string     `json:"note,omitempty"`
+	WeightKG                *float64   `json:"weight_kg,omitempty"`
+}
+
+type DULBase struct {
+	ID       string `json:"id" example:"0197f3b2-c4d8-4b12-a1f9-c1de23456789"`
+	Name     string `json:"name" example:"Halim Base"`
+	Category string `json:"category" example:"hems"`
+}
+
+type DoctorProfileAttributes struct {
+	ShortName         string `json:"short_name,omitempty" validate:"omitempty,max=120"`
+	Specialization    string `json:"specialization,omitempty" validate:"omitempty,max=120"`
+	SubSpecialization string `json:"sub_specialization,omitempty" validate:"omitempty,max=120"`
+	IsChiefPhysician  *bool  `json:"is_chief_physician,omitempty"`
+	Location          string `json:"location,omitempty" validate:"omitempty,max=255"`
+	Postcode          string `json:"postcode,omitempty" validate:"omitempty,max=32"`
+	StreetLine        string `json:"street_line,omitempty" validate:"omitempty,max=255"`
+	Note              string `json:"note,omitempty"`
+}
+
+type AirRescuerProfileAttributes struct {
+	ShortName                string `json:"short_name,omitempty" validate:"omitempty,max=120"`
+	ResponsibleFlightRescuer *bool  `json:"responsible_flight_rescuer,omitempty"`
+	Location                 string `json:"location,omitempty" validate:"omitempty,max=255"`
+	Postcode                 string `json:"postcode,omitempty" validate:"omitempty,max=32"`
+	StreetLine               string `json:"street_line,omitempty" validate:"omitempty,max=255"`
+	Note                     string `json:"note,omitempty"`
+}
+
+type TechnicianProfileAttributes struct {
+	ShortName               string `json:"short_name,omitempty" validate:"omitempty,max=120"`
+	LicenseNo               string `json:"license_no,omitempty" validate:"omitempty,max=120"`
+	IsChiefTechnician       *bool  `json:"is_chief_technician,omitempty"`
+	IsResponsibleComplaints *bool  `json:"is_responsible_complaints,omitempty"`
+	Location                string `json:"location,omitempty" validate:"omitempty,max=255"`
+	Postcode                string `json:"postcode,omitempty" validate:"omitempty,max=32"`
+	StreetLine              string `json:"street_line,omitempty" validate:"omitempty,max=255"`
+	Note                    string `json:"note,omitempty"`
+}
+
+type FlightAssistantProfileAttributes struct {
+	ShortName  string `json:"short_name,omitempty" validate:"omitempty,max=120"`
+	Location   string `json:"location,omitempty" validate:"omitempty,max=255"`
+	Postcode   string `json:"postcode,omitempty" validate:"omitempty,max=32"`
+	StreetLine string `json:"street_line,omitempty" validate:"omitempty,max=255"`
+	Note       string `json:"note,omitempty"`
+}
+
+type StaffProfileAttributes struct {
+	ShortName  string `json:"short_name,omitempty" validate:"omitempty,max=120"`
+	RoleLabel  string `json:"role_label,omitempty" validate:"omitempty,max=120"`
+	Location   string `json:"location,omitempty" validate:"omitempty,max=255"`
+	Postcode   string `json:"postcode,omitempty" validate:"omitempty,max=32"`
+	StreetLine string `json:"street_line,omitempty" validate:"omitempty,max=255"`
+	Note       string `json:"note,omitempty"`
+}
+
+type ContactCreateAttributes struct {
+	RoleID  string   `json:"role_id,omitempty" example:"0195f6f8-0f8d-7e3e-b8f2-8abff9b5c1d1"`
+	RoleIDs []string `json:"role_ids,omitempty" example:"0195f6f8-0f8d-7e3e-b8f2-8abff9b5c1d1,0195f6f8-0f8d-7e3e-b8f2-8abff9b5c1d2"`
+	ContactBaseAttributes
+	AirRescuer      *AirRescuerProfileAttributes      `json:"air_rescuer,omitempty"`
+	Doctor          *DoctorProfileAttributes          `json:"doctor,omitempty"`
+	FlightAssistant *FlightAssistantProfileAttributes `json:"flight_assistant,omitempty"`
+	Pilot           *PilotProfileAttributes           `json:"pilot,omitempty"`
+	Staff           *StaffProfileAttributes           `json:"staff,omitempty"`
+	Technician      *TechnicianProfileAttributes      `json:"technician,omitempty"`
+}
+
+type ContactCreateData struct {
+	Type       string                  `json:"type" validate:"required" example:"contact_create"`
+	Attributes ContactCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type ContactCreateRequest struct {
+	Data ContactCreateData `json:"data" validate:"required"`
+}
+
+type PilotProfileUpdateAttributes struct {
+	PilotCategory           *string    `json:"pilot_category,omitempty" validate:"omitempty,oneof=regular freelance dry_lease"`
+	ShortName               *string    `json:"short_name,omitempty" validate:"omitempty,max=120"`
+	LicenseNo               *string    `json:"license_no,omitempty" validate:"omitempty,max=120"`
+	LicenseIssuedAt         *time.Time `json:"license_issued_at,omitempty"`
+	LicenseExpiredAt        *time.Time `json:"license_expired_at,omitempty"`
+	TechnicianLicenseNo     *string    `json:"technician_license_no,omitempty" validate:"omitempty,max=120"`
+	HasIFRQualification     *bool      `json:"has_ifr_qualification,omitempty"`
+	IsChiefPilot            *bool      `json:"is_chief_pilot,omitempty"`
+	DULBaseIDs              []string   `json:"dul_base_ids,omitempty" validate:"omitempty,dive,uuid" swaggerignore:"true"`
+	DULBase                 []DULBase  `json:"dul_base,omitempty"`
+	TotalFlightMinutes      *int       `json:"total_flight_minutes,omitempty"`
+	ResponsiblePilotMinutes *int       `json:"responsible_pilot_minutes,omitempty"`
+	SecondPilotMinutes      *int       `json:"second_pilot_minutes,omitempty"`
+	DoubleCommandMinutes    *int       `json:"double_command_minutes,omitempty"`
+	FlightInstructorMinutes *int       `json:"flight_instructor_minutes,omitempty"`
+	NightFlightMinutes      *int       `json:"night_flight_minutes,omitempty"`
+	IFRFlightMinutes        *int       `json:"ifr_flight_minutes,omitempty"`
+	Location                *string    `json:"location,omitempty" validate:"omitempty,max=255"`
+	Postcode                *string    `json:"postcode,omitempty" validate:"omitempty,max=32"`
+	StreetLine              *string    `json:"street_line,omitempty" validate:"omitempty,max=255"`
+	Note                    *string    `json:"note,omitempty"`
+	WeightKG                *float64   `json:"weight_kg,omitempty"`
+}
+
+type DoctorProfileUpdateAttributes struct {
+	ShortName         *string `json:"short_name,omitempty" validate:"omitempty,max=120"`
+	Specialization    *string `json:"specialization,omitempty" validate:"omitempty,max=120"`
+	SubSpecialization *string `json:"sub_specialization,omitempty" validate:"omitempty,max=120"`
+	IsChiefPhysician  *bool   `json:"is_chief_physician,omitempty"`
+	Location          *string `json:"location,omitempty" validate:"omitempty,max=255"`
+	Postcode          *string `json:"postcode,omitempty" validate:"omitempty,max=32"`
+	StreetLine        *string `json:"street_line,omitempty" validate:"omitempty,max=255"`
+	Note              *string `json:"note,omitempty"`
+}
+
+type AirRescuerProfileUpdateAttributes struct {
+	ShortName                *string `json:"short_name,omitempty" validate:"omitempty,max=120"`
+	ResponsibleFlightRescuer *bool   `json:"responsible_flight_rescuer,omitempty"`
+	Location                 *string `json:"location,omitempty" validate:"omitempty,max=255"`
+	Postcode                 *string `json:"postcode,omitempty" validate:"omitempty,max=32"`
+	StreetLine               *string `json:"street_line,omitempty" validate:"omitempty,max=255"`
+	Note                     *string `json:"note,omitempty"`
+}
+
+type TechnicianProfileUpdateAttributes struct {
+	ShortName               *string `json:"short_name,omitempty" validate:"omitempty,max=120"`
+	LicenseNo               *string `json:"license_no,omitempty" validate:"omitempty,max=120"`
+	IsChiefTechnician       *bool   `json:"is_chief_technician,omitempty"`
+	IsResponsibleComplaints *bool   `json:"is_responsible_complaints,omitempty"`
+	Location                *string `json:"location,omitempty" validate:"omitempty,max=255"`
+	Postcode                *string `json:"postcode,omitempty" validate:"omitempty,max=32"`
+	StreetLine              *string `json:"street_line,omitempty" validate:"omitempty,max=255"`
+	Note                    *string `json:"note,omitempty"`
+}
+
+type FlightAssistantProfileUpdateAttributes struct {
+	ShortName  *string `json:"short_name,omitempty" validate:"omitempty,max=120"`
+	Location   *string `json:"location,omitempty" validate:"omitempty,max=255"`
+	Postcode   *string `json:"postcode,omitempty" validate:"omitempty,max=32"`
+	StreetLine *string `json:"street_line,omitempty" validate:"omitempty,max=255"`
+	Note       *string `json:"note,omitempty"`
+}
+
+type StaffProfileUpdateAttributes struct {
+	ShortName  *string `json:"short_name,omitempty" validate:"omitempty,max=120"`
+	RoleLabel  *string `json:"role_label,omitempty" validate:"omitempty,max=120"`
+	Location   *string `json:"location,omitempty" validate:"omitempty,max=255"`
+	Postcode   *string `json:"postcode,omitempty" validate:"omitempty,max=32"`
+	StreetLine *string `json:"street_line,omitempty" validate:"omitempty,max=255"`
+	Note       *string `json:"note,omitempty"`
+}
+
+type ContactUpdateAttributes struct {
+	RoleID          *string                                 `json:"role_id,omitempty" example:"0195f6f8-0f8d-7e3e-b8f2-8abff9b5c1d1"`
+	RoleIDs         []string                                `json:"role_ids,omitempty" example:"0195f6f8-0f8d-7e3e-b8f2-8abff9b5c1d1,0195f6f8-0f8d-7e3e-b8f2-8abff9b5c1d2"`
+	Email           *string                                 `json:"email,omitempty" validate:"omitempty,email"`
+	SSOEmail        *string                                 `json:"sso_email,omitempty" validate:"omitempty,email"`
+	IsAdmin         *bool                                   `json:"is_admin,omitempty"`
+	Username        *string                                 `json:"username,omitempty" validate:"omitempty,max=100"`
+	FirstName       *string                                 `json:"first_name,omitempty" validate:"omitempty,max=100"`
+	LastName        *string                                 `json:"last_name,omitempty" validate:"omitempty,max=100"`
+	MobilePhone     *string                                 `json:"mobile_phone,omitempty" validate:"omitempty,max=32"`
+	Timezone        *string                                 `json:"timezone,omitempty" validate:"omitempty,max=64"`
+	FileUUID        *string                                 `json:"file_uuid,omitempty" validate:"omitempty,max=64"`
+	SortKey         NullInt                                 `json:"sortkey,omitempty" swaggertype:"integer"`
+	IsActive        *bool                                   `json:"is_active,omitempty"`
+	AirRescuer      *AirRescuerProfileUpdateAttributes      `json:"air_rescuer,omitempty"`
+	Doctor          *DoctorProfileUpdateAttributes          `json:"doctor,omitempty"`
+	FlightAssistant *FlightAssistantProfileUpdateAttributes `json:"flight_assistant,omitempty"`
+	Pilot           *PilotProfileUpdateAttributes           `json:"pilot,omitempty"`
+	Staff           *StaffProfileUpdateAttributes           `json:"staff,omitempty"`
+	Technician      *TechnicianProfileUpdateAttributes      `json:"technician,omitempty"`
+}
+
+type ContactUpdateData struct {
+	Type       string                  `json:"type" validate:"required" example:"contact_update"`
+	Attributes ContactUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type ContactUpdateRequest struct {
+	Data ContactUpdateData `json:"data" validate:"required"`
+}
+
+type ContactListQuery struct {
+	Role          string `query:"role" validate:"omitempty,oneof=pilot doctor air_rescuer technician flight_assistant staff"`
+	PilotCategory string `query:"pilot_category" validate:"omitempty,oneof=regular freelance dry_lease"`
+	Search        string `query:"search"`
+	Sort          string `query:"sort"`
+	Limit         int    `query:"limit" validate:"omitempty,min=1,max=200"`
+	Offset        int    `query:"offset" validate:"omitempty,min=0"`
+}
+
+type ContactListItem struct {
+	ID            string `json:"id"`
+	CreatedBy     string `json:"created_by,omitempty"`
+	UpdatedBy     string `json:"updated_by,omitempty"`
+	CreatedAt     string `json:"created_at,omitempty"`
+	UpdatedAt     string `json:"updated_at,omitempty"`
+	RoleCode      string `json:"role_code"`
+	RoleName      string `json:"role_name"`
+	PilotCategory string `json:"pilot_category,omitempty"`
+	Username      string `json:"username,omitempty"`
+	Email         string `json:"email"`
+	IsAdmin       bool   `json:"is_admin"`
+	FirstName     string `json:"first_name"`
+	LastName      string `json:"last_name"`
+	ShortName     string `json:"short_name,omitempty"`
+	LicenseNo     string `json:"license_no,omitempty"`
+	Location      string `json:"location,omitempty"`
+	MobilePhone   string `json:"mobile_phone,omitempty"`
+	SortKey       *int   `json:"sortkey"`
+	Note          string `json:"note,omitempty"`
+	IsActive      bool   `json:"is_active"`
+	SetPassword   bool   `json:"set_password"`
+}
+
+type ContactBaseRole struct {
+	BaseID   string `json:"base_id"`
+	BaseName string `json:"base_name"`
+	RoleCode string `json:"role_code"`
+}
+
+type ContactRole struct {
+	ID       string `json:"id"`
+	RoleCode string `json:"role_code"`
+	RoleName string `json:"role_name"`
+}
+
+type ContactListAttributes struct {
+	Email           string                            `json:"email,omitempty"`
+	Username        string                            `json:"username,omitempty"`
+	FirstName       string                            `json:"first_name,omitempty"`
+	LastName        string                            `json:"last_name,omitempty"`
+	MobilePhone     string                            `json:"mobile_phone,omitempty"`
+	IsAdmin         bool                              `json:"is_admin"`
+	IsActive        bool                              `json:"is_active"`
+	SetPassword     bool                              `json:"set_password"`
+	SortKey         *int                              `json:"sortkey"`
+	SSOEmail        *string                           `json:"sso_email"`
+	CreatedAt       string                            `json:"created_at,omitempty"`
+	CreatedBy       string                            `json:"created_by,omitempty"`
+	UpdatedAt       string                            `json:"updated_at,omitempty"`
+	UpdatedBy       string                            `json:"updated_by,omitempty"`
+	BaseRoles       []ContactBaseRole                 `json:"base_roles"`
+	RoleCode        string                            `json:"role_code,omitempty"`
+	RoleName        string                            `json:"role_name,omitempty"`
+	Roles           []ContactRole                     `json:"roles"`
+	PilotCategory   string                            `json:"pilot_category,omitempty"`
+	ShortName       string                            `json:"short_name,omitempty"`
+	LicenseNo       string                            `json:"license_no,omitempty"`
+	Location        string                            `json:"location,omitempty"`
+	Note            string                            `json:"note,omitempty"`
+	Pilot           *PilotProfileAttributes           `json:"pilot,omitempty"`
+	Doctor          *DoctorProfileAttributes          `json:"doctor,omitempty"`
+	AirRescuer      *AirRescuerProfileAttributes      `json:"air_rescuer,omitempty"`
+	Technician      *TechnicianProfileAttributes      `json:"technician,omitempty"`
+	FlightAssistant *FlightAssistantProfileAttributes `json:"flight_assistant,omitempty"`
+	Staff           *StaffProfileAttributes           `json:"staff,omitempty"`
+}
+
+type ContactListResponse struct {
+	Data []struct {
+		Type       string                `json:"type" example:"contact"`
+		ID         string                `json:"id" example:"019dcce4-f15e-7685-8e4c-76f8ad20594b"`
+		Attributes ContactListAttributes `json:"attributes"`
+	} `json:"data"`
+	Meta struct {
+		Total  int64 `json:"total"`
+		Limit  int   `json:"limit"`
+		Offset int   `json:"offset"`
+	} `json:"meta"`
+}
+
+type ContactDataTableResponse struct {
+	Data []ContactListItem `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type SensitiveActionRequiredResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"pin_verification_required"`
+		Attributes struct {
+			Required bool   `json:"required" example:"true"`
+			Action   string `json:"action"`
+			Method   string `json:"method" example:"pin"`
+			Status   int    `json:"status" example:"202"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+type ContactStatusUpdateData struct {
+	Type       string `json:"type" validate:"required,eq=contact_status_update"`
+	Attributes struct {
+		IsActive bool `json:"is_active"`
+	} `json:"attributes" validate:"required"`
+}
+
+type ContactStatusUpdateRequest struct {
+	Data ContactStatusUpdateData `json:"data" validate:"required"`
+}
+
+type ContactRoleUpdateData struct {
+	Type       string `json:"type" validate:"required,eq=contact_role_update"`
+	Attributes struct {
+		RoleCode string `json:"role_code" validate:"required,oneof=pilot doctor air_rescuer technician flight_assistant staff"`
+	} `json:"attributes" validate:"required"`
+}
+
+type ContactRoleUpdateRequest struct {
+	Data ContactRoleUpdateData `json:"data" validate:"required"`
+}
+
+type ContactPilotCategoryUpdateData struct {
+	Type       string `json:"type" validate:"required,eq=contact_pilot_category_update"`
+	Attributes struct {
+		PilotCategory string `json:"pilot_category" validate:"required,oneof=regular freelance dry_lease"`
+	} `json:"attributes" validate:"required"`
+}
+
+type ContactPilotCategoryUpdateRequest struct {
+	Data ContactPilotCategoryUpdateData `json:"data" validate:"required"`
+}
+
+type ContactLicenseUpdateData struct {
+	Type       string `json:"type" validate:"required,eq=contact_license_update"`
+	Attributes struct {
+		LicenseNo *string `json:"license_no,omitempty"`
+	} `json:"attributes" validate:"required"`
+}
+
+type ContactLicenseUpdateRequest struct {
+	Data ContactLicenseUpdateData `json:"data" validate:"required"`
+}
+
+type ContactChiefFlagsUpdateData struct {
+	Type       string `json:"type" validate:"required,eq=contact_chief_flags_update"`
+	Attributes struct {
+		IsChiefPilot             *bool `json:"is_chief_pilot,omitempty"`
+		IsChiefPhysician  *bool `json:"is_chief_physician,omitempty"`
+		IsChiefTechnician *bool `json:"is_chief_technician,omitempty"`
+	} `json:"attributes" validate:"required"`
+}
+
+type ContactChiefFlagsUpdateRequest struct {
+	Data ContactChiefFlagsUpdateData `json:"data" validate:"required"`
+}
+
+type ContactResponsibleComplaintsData struct {
+	Type       string `json:"type" validate:"required,eq=contact_responsible_complaints_update"`
+	Attributes struct {
+		IsResponsibleComplaints bool `json:"is_responsible_complaints"`
+	} `json:"attributes" validate:"required"`
+}
+
+type ContactResponsibleComplaintsRequest struct {
+	Data ContactResponsibleComplaintsData `json:"data" validate:"required"`
+}
+
+type ContactBulkUpdateData struct {
+	Type       string `json:"type" validate:"required,eq=contact_bulk_update" example:"contact_bulk_update"`
+	Attributes struct {
+		UserIDs  []string `json:"user_ids" validate:"required,min=1,dive,required" example:"0195f6f8-0f8d-7e3e-b8f2-8abff9b5c1d1"`
+		IsActive bool     `json:"is_active" example:"true"`
+	} `json:"attributes" validate:"required"`
+}
+
+type ContactBulkUpdateRequest struct {
+	Data ContactBulkUpdateData `json:"data" validate:"required"`
+}
+
+type ContactSimpleSuccessResponse struct {
+	Data struct {
+		Type       string `json:"type"`
+		Attributes struct {
+			Updated bool  `json:"updated,omitempty"`
+			Deleted bool  `json:"deleted,omitempty"`
+			Count   int64 `json:"count,omitempty"`
+		} `json:"attributes"`
+	} `json:"data"`
+}

internal/transport/http/dto/delete_dto.go

@@ -0,0 +1,26 @@
+package dto
+
+// GenericDeleteResponse is a common success payload for DELETE endpoints.
+type GenericDeleteResponse struct {
+	Data GenericDeleteResponseData `json:"data"`
+}
+
+type GenericDeleteResponseData struct {
+	Type       string                  `json:"type" example:"delete_result"`
+	Attributes GenericDeleteAttributes `json:"attributes"`
+}
+
+type GenericDeleteAttributes struct {
+	Deleted bool `json:"deleted" example:"true"`
+}
+
+func NewGenericDeleteResponse(resourceType string) GenericDeleteResponse {
+	return GenericDeleteResponse{
+		Data: GenericDeleteResponseData{
+			Type: resourceType,
+			Attributes: GenericDeleteAttributes{
+				Deleted: true,
+			},
+		},
+	}
+}

internal/transport/http/dto/dul_request_dto.go

@@ -0,0 +1,38 @@
+package dto
+
+type DULCreateAttributes struct {
+	Name               string   `json:"name" validate:"required,max=128"`
+	Date               string   `json:"date" validate:"required" example:"2026-05-25"`
+	Info               *string  `json:"info,omitempty"`
+	BaseID             string   `json:"base_id" validate:"required" example:"019e3ec1-94f6-7b6b-9cc5-1b5d05f46d74"`
+	FileUUID           []string `json:"file_uuid,omitempty"`
+	ImageAttachmentIDs []string `json:"image_attachment_ids,omitempty" swaggerignore:"true"`
+}
+
+type DULCreateData struct {
+	Type       string              `json:"type" validate:"required,oneof=dul_create dul"`
+	Attributes DULCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type DULCreateRequest struct {
+	Data DULCreateData `json:"data" validate:"required"`
+}
+
+type DULUpdateAttributes struct {
+	Name               *string  `json:"name,omitempty"`
+	Date               *string  `json:"date,omitempty" example:"2026-05-25"`
+	Info               *string  `json:"info,omitempty"`
+	BaseID             *string  `json:"base_id,omitempty"`
+	FileUUID           []string `json:"file_uuid,omitempty"`
+	ImageAttachmentIDs []string `json:"image_attachment_ids,omitempty" swaggerignore:"true"`
+}
+
+type DULUpdateData struct {
+	Type       string              `json:"type" validate:"required,oneof=dul_update dul"`
+	ID         string              `json:"id" swaggerignore:"true"`
+	Attributes DULUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type DULUpdateRequest struct {
+	Data DULUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/dul_response_dto.go

@@ -0,0 +1,74 @@
+package dto
+
+type DULImage struct {
+	UUID                 string `json:"uuid"`
+	DownloadURL          string `json:"download_url,omitempty"`
+	OriginalSizeBytes    int64  `json:"original_size_bytes,omitempty"`
+	ThumbnailDownloadURL string `json:"thumbnail_download_url,omitempty"`
+}
+
+type DULAttributes struct {
+	No        uint64     `json:"no"`
+	Name      string     `json:"name"`
+	Date      string     `json:"date" example:"2026-05-25"`
+	Info      string     `json:"info,omitempty"`
+	Base      DULBaseRef `json:"base"`
+	Images    []DULImage `json:"images"`
+	CreatedAt string     `json:"created_at,omitempty"`
+	CreatedBy string     `json:"created_by,omitempty"`
+	UpdatedAt string     `json:"updated_at,omitempty"`
+	UpdatedBy string     `json:"updated_by,omitempty"`
+}
+
+type DULBaseRef struct {
+	ID       string `json:"id"`
+	Name     string `json:"name"`
+	Category string `json:"category,omitempty"`
+}
+
+type DULResource struct {
+	Type       string        `json:"type"`
+	ID         string        `json:"id"`
+	Attributes DULAttributes `json:"attributes"`
+}
+
+type DULResponse struct {
+	Data DULResource `json:"data"`
+}
+
+type DULDeleteResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"dul_delete"`
+		Attributes struct {
+			Deleted bool `json:"deleted" example:"true"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+type DULGroup struct {
+	Base DULBaseRef    `json:"base"`
+	DULs []DULResource `json:"duls"`
+}
+
+type DULListResponse struct {
+	Data []DULGroup `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+		TotalBases int   `json:"total_bases" example:"8"`
+	} `json:"meta"`
+}
+
+type DULDataTableResponse struct {
+	Data []DULGroup `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		PageNumber      int   `json:"page_number" example:"1"`
+		PageSize        int   `json:"page_size" example:"20"`
+		Total           int64 `json:"total" example:"120"`
+		TotalBases      int   `json:"total_bases" example:"8"`
+		RecordsTotal    int64 `json:"records_total,omitempty" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered,omitempty" example:"120"`
+	} `json:"meta"`
+}

internal/transport/http/dto/facility_dto.go

@@ -0,0 +1,99 @@
+package dto
+
+// JSON:API Facility DTOs
+
+type FacilityAttributes struct {
+	Category  string `json:"category" example:"heslo-rope-label"`
+	Name      string `json:"name" example:"Fuel Truck Rope Label"`
+	Type      string `json:"type" example:"Sling"`
+	SortKey   *int   `json:"sortkey" example:"1"`
+	Length    string `json:"length,omitempty" example:"10m"`
+	Weight    string `json:"weight,omitempty" example:"10kg"`
+	Electric  string `json:"electric" example:"available"`
+	Note      string `json:"note,omitempty" example:"Dry lease fuel truck"`
+	IsActive  bool   `json:"is_active" example:"true"`
+	CreatedBy string `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedBy string `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CreatedAt string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedAt string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+}
+
+type FacilityResource struct {
+	Type       string             `json:"type" example:"facility"`
+	ID         string             `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes FacilityAttributes `json:"attributes"`
+}
+
+type FacilityResponse struct {
+	Data FacilityResource `json:"data"`
+}
+
+type FacilityDeleteResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"facility_delete"`
+		Attributes struct {
+			Deleted bool `json:"deleted" example:"true"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+type FacilityListResponse struct {
+	Data []FacilityResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type FacilityDataTableResponse struct {
+	Data []FacilityResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type FacilityCreateAttributes struct {
+	Category string  `json:"category" validate:"required" example:"heslo-rope-label"`
+	Name     string  `json:"name" validate:"required" example:"Fuel Truck Rope Label"`
+	Type     string  `json:"type" example:"Sling"`
+	SortKey  *int    `json:"sortkey" example:"1"`
+	Length   *string `json:"length,omitempty" example:"10m"`
+	Weight   *string `json:"weight,omitempty" example:"10kg"`
+	Electric *string `json:"electric,omitempty" example:"available"`
+	Note     *string `json:"note,omitempty" example:"Dry lease fuel truck"`
+	IsActive *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type FacilityCreateData struct {
+	Type       string                   `json:"type" validate:"required,oneof=facility_create facility" example:"facility_create"`
+	Attributes FacilityCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FacilityCreateRequest struct {
+	Data FacilityCreateData `json:"data" validate:"required"`
+}
+
+type FacilityUpdateAttributes struct {
+	Category *string `json:"category,omitempty" example:"heslo-rope-label"`
+	Name     *string `json:"name,omitempty" example:"Fuel Truck Rope Label"`
+	Type     *string `json:"type,omitempty" example:"Sling"`
+	SortKey  NullInt `json:"sortkey,omitempty" swaggertype:"integer" example:"1"`
+	Length   *string `json:"length,omitempty" example:"10m"`
+	Weight   *string `json:"weight,omitempty" example:"10kg"`
+	Electric *string `json:"electric,omitempty" example:"available"`
+	Note     *string `json:"note,omitempty" example:"Dry lease fuel truck"`
+	IsActive *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type FacilityUpdateData struct {
+	Type       string                   `json:"type" validate:"required,oneof=facility_update facility" example:"facility_update"`
+	ID         string                   `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes FacilityUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type FacilityUpdateRequest struct {
+	Data FacilityUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/federal_state_dto.go

@@ -0,0 +1,91 @@
+package dto
+
+// JSON:API Federal State DTOs
+
+type FederalStateAttributes struct {
+	Name        string `json:"name" example:"Bayern"`
+	Note        string `json:"note,omitempty" example:"Central region"`
+	LandID      string `json:"land_id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	LandName    string `json:"land_name,omitempty" example:"Germany"`
+	LandISOCode string `json:"land_iso_code,omitempty" example:"DE"`
+	SortKey     *int   `json:"sortkey" example:"1"`
+	IsActive    bool   `json:"is_active" example:"true"`
+	CreatedAt   string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy   string `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt   string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy   string `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt   string `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy   string `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type FederalStateResource struct {
+	Type       string                 `json:"type" example:"federal_state"`
+	ID         string                 `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes FederalStateAttributes `json:"attributes"`
+}
+
+type FederalStateResponse struct {
+	Data FederalStateResource `json:"data"`
+}
+
+type FederalStateDeleteResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"federal_state_delete"`
+		Attributes struct {
+			Deleted bool `json:"deleted" example:"true"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+type FederalStateListResponse struct {
+	Data []FederalStateResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type FederalStateDataTableResponse struct {
+	Data []FederalStateResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type FederalStateCreateAttributes struct {
+	Name     string  `json:"name" validate:"required" example:"Bayern"`
+	Note     *string `json:"note,omitempty" example:"Central region"`
+	LandID   string  `json:"land_id" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	SortKey  *int    `json:"sortkey" example:"1"`
+	IsActive *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type FederalStateCreateData struct {
+	Type       string                       `json:"type" validate:"required,oneof=federal_state_create federal_state" example:"federal_state_create"`
+	Attributes FederalStateCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FederalStateCreateRequest struct {
+	Data FederalStateCreateData `json:"data" validate:"required"`
+}
+
+type FederalStateUpdateAttributes struct {
+	Name     *string `json:"name,omitempty" example:"Bayern"`
+	Note     *string `json:"note,omitempty" example:"Central region"`
+	LandID   *string `json:"land_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	SortKey  NullInt `json:"sortkey,omitempty" swaggertype:"integer" example:"1"`
+	IsActive *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type FederalStateUpdateData struct {
+	Type       string                       `json:"type" validate:"required,oneof=federal_state_update federal_state" example:"federal_state_update"`
+	ID         string                       `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes FederalStateUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type FederalStateUpdateRequest struct {
+	Data FederalStateUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/flight_inspection_dto.go

@@ -0,0 +1,57 @@
+package dto
+
+type FlightInspectionAttributes struct {
+	InspectionDate string `json:"inspection_date,omitempty" example:"2026-04-09"`
+	Status         string `json:"status,omitempty" example:"Draft"`
+	CreatedAt      string `json:"created_at,omitempty" example:"2026-04-09T05:00:00Z"`
+	CreatedBy      string `json:"created_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	UpdatedAt      string `json:"updated_at,omitempty" example:"2026-04-09T05:00:00Z"`
+	UpdatedBy      string `json:"updated_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+}
+
+type FlightInspectionResource struct {
+	Type       string                     `json:"type" example:"flight_inspection"`
+	ID         string                     `json:"id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	Attributes FlightInspectionAttributes `json:"attributes"`
+}
+
+type FlightInspectionResponse struct {
+	Data FlightInspectionResource `json:"data"`
+}
+
+type FlightInspectionListResponse struct {
+	Data []FlightInspectionResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"1"`
+	} `json:"meta"`
+}
+
+type FlightInspectionCreateAttributes struct {
+	InspectionDate string `json:"inspection_date" validate:"required" example:"2026-04-09"`
+}
+
+type FlightInspectionCreateData struct {
+	Type       string                           `json:"type" validate:"required,oneof=flight_inspection_create flight_inspection"`
+	Attributes FlightInspectionCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FlightInspectionCreateRequest struct {
+	Data FlightInspectionCreateData `json:"data" validate:"required"`
+}
+
+type FlightInspectionUpdateAttributes struct {
+	InspectionDate *string `json:"inspection_date,omitempty" example:"2026-04-09"`
+	Status         *string `json:"status,omitempty" example:"InProgress"`
+}
+
+type FlightInspectionUpdateData struct {
+	Type       string                           `json:"type" validate:"required,oneof=flight_inspection_update flight_inspection"`
+	ID         string                           `json:"id" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	Attributes FlightInspectionUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type FlightInspectionUpdateRequest struct {
+	Data FlightInspectionUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/flight_prep_check_dto.go

@@ -0,0 +1,73 @@
+package dto
+
+import (
+	"time"
+
+	flightprepcheck "wucher/internal/domain/flight_prep_check"
+	"wucher/internal/shared/pkg/uuidv7"
+)
+
+type FlightPrepCheckAttributes struct {
+	ID                    string `json:"id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	FlightInspectionID    string `json:"flight_inspection_id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	NotamBriefing         bool   `json:"notam_briefing" example:"true"`
+	WeatherBriefing       bool   `json:"weather_briefing" example:"false"`
+	OperationalFlightPlan bool   `json:"operational_flight_plan" example:"true"`
+	CreatedAt             string `json:"created_at,omitempty" example:"2026-04-09T05:00:00Z"`
+	UpdatedAt             string `json:"updated_at,omitempty" example:"2026-04-09T05:00:00Z"`
+}
+
+type FlightPrepCheckResource struct {
+	Type       string                    `json:"type" example:"flight_prep_check"`
+	ID         string                    `json:"id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	Attributes FlightPrepCheckAttributes `json:"attributes"`
+}
+
+type FlightPrepCheckResponse struct {
+	Data FlightPrepCheckResource `json:"data"`
+}
+
+type FlightPrepCheckUpsertRequest struct {
+	Data struct {
+		Type       string                          `json:"type" validate:"required,oneof=flight_prep_check_upsert flight_prep_check" example:"flight_prep_check_upsert"`
+		Attributes FlightPrepCheckUpsertAttributes `json:"attributes" validate:"required"`
+	} `json:"data" validate:"required"`
+}
+
+type FlightPrepCheckUpsertAttributes struct {
+	NotamBriefing         *bool `json:"notam_briefing,omitempty" example:"true"`
+	WeatherBriefing       *bool `json:"weather_briefing,omitempty" example:"true"`
+	OperationalFlightPlan *bool `json:"operational_flight_plan,omitempty" example:"false"`
+}
+
+func ToFlightPrepCheckDTO(check *flightprepcheck.FlightPrepCheck) *FlightPrepCheckResource {
+	if check == nil {
+		return nil
+	}
+
+	idStr, _ := uuidv7.BytesToString(check.ID)
+	flightInspectionIDStr, _ := uuidv7.BytesToString(check.FlightInspectionID)
+
+	createdAt := ""
+	updatedAt := ""
+	if !check.CreatedAt.IsZero() {
+		createdAt = check.CreatedAt.UTC().Format(time.RFC3339)
+	}
+	if !check.UpdatedAt.IsZero() {
+		updatedAt = check.UpdatedAt.UTC().Format(time.RFC3339)
+	}
+
+	return &FlightPrepCheckResource{
+		Type: "flight_prep_check",
+		ID:   idStr,
+		Attributes: FlightPrepCheckAttributes{
+			ID:                    idStr,
+			FlightInspectionID:    flightInspectionIDStr,
+			NotamBriefing:         check.NOTAMBriefing,
+			WeatherBriefing:       check.WeatherBriefing,
+			OperationalFlightPlan: check.OperationalFlightPlan,
+			CreatedAt:             createdAt,
+			UpdatedAt:             updatedAt,
+		},
+	}
+}

internal/transport/http/dto/fm_report_dto.go

@@ -0,0 +1,100 @@
+package dto
+
+import responsedto "wucher/internal/transport/http/dto/response"
+
+type FMReportAttributes struct {
+	ID                    string                             `json:"id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	ReportCode            *string                            `json:"report_code" example:"EC-135-1"`
+	TakeoverID            string                             `json:"takeover_id,omitempty" example:"019e8713-aa19-7fb7-a510-a0332dc69697"`
+	FlightID              string                             `json:"flight_id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	FlightInspectionID    string                             `json:"flight_inspection_id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	Engine1GpcN1          *string                            `json:"engine1_gpc_n1" example:"GPC/N1 63.2"`
+	Engine1PtcN2          *string                            `json:"engine1_ptc_n2" example:"PTC/N2 61.8"`
+	Engine2GpcN1          *string                            `json:"engine2_gpc_n1" example:"GPC/N1 62.9"`
+	Engine2PtcN2          *string                            `json:"engine2_ptc_n2" example:"PTC/N2 61.5"`
+	CompletedAt           string                             `json:"completed_at,omitempty" example:"2026-04-20T10:15:00Z"`
+	CompletedBy           string                             `json:"completed_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	PilotName             *string                            `json:"pilot_name,omitempty" example:"John Doe"`
+	HelicopterIdentifier  *string                            `json:"helicopter_identifier,omitempty" example:"OE-TEST"`
+	Flight                *responsedto.FlightResource        `json:"flight,omitempty"`
+	Missions              []responsedto.MissionResource      `json:"missions,omitempty"`
+	FlightInspection      *FlightInspectionResource          `json:"flight_inspection,omitempty"`
+	AfterFlightInspection *AfterFlightInspectionResource     `json:"after_flight_inspection,omitempty"`
+	FleetStatus           *responsedto.FleetStatusResource   `json:"fleet_status,omitempty"`
+	HelicopterUsage       *HelicopterUsageResource           `json:"helicopter_usage,omitempty"`
+	UsageBreakdown        *FMReportUsageBreakdown            `json:"usage_breakdown,omitempty"`
+	TakeoverFiles         []responsedto.TakeoverFileResource `json:"takeover_files,omitempty"`
+	FMReportAttachments   *FMReportAttachments               `json:"fm_report_attachments,omitempty"`
+	CreatedAt             string                             `json:"created_at,omitempty" example:"2026-04-20T08:00:00Z"`
+	UpdatedAt             string                             `json:"updated_at,omitempty" example:"2026-04-20T08:00:00Z"`
+}
+
+type FMReportAirframeValues struct {
+	Hours  float64 `json:"hours" example:"1523.5"`
+	Cycles float64 `json:"cycles" example:"320"`
+}
+
+type FMReportEngineValues struct {
+	Hours   float64 `json:"hours" example:"1523.5"`
+	GpcNgN1 float64 `json:"gpc_ng_n1" example:"63.2"`
+	PtcNfN2 float64 `json:"ptc_nf_n2" example:"61.8"`
+	Ccc     float64 `json:"ccc" example:"44"`
+}
+
+// FMReportCountersValues are the "Landings, Complaints & Sign-off" counters.
+type FMReportCountersValues struct {
+	Landings         float64 `json:"landings" example:"120"`
+	FlightReports    float64 `json:"flight_reports" example:"80"`
+	HookReleases     float64 `json:"hook_releases" example:"10"`
+	RotorBrakeCycles float64 `json:"rotor_brake_cycles" example:"8"`
+}
+
+// FMReportUsageSnapshot is one row of the breakdown table (all columns for a single
+// prev/today/total bucket). An absent engine (single-engine aircraft) stays zero-valued.
+type FMReportUsageSnapshot struct {
+	Airframe FMReportAirframeValues `json:"airframe"`
+	Engine1  FMReportEngineValues   `json:"engine_1"`
+	Engine2  FMReportEngineValues   `json:"engine_2"`
+	Counters FMReportCountersValues `json:"counters"`
+}
+
+// FMReportUsageBreakdown is the prev/today/total table shown on the FM report page,
+// grouped by row: prev = total - today (the prior-day cumulative), today = this flight's
+// contribution, total = the cumulative to date.
+type FMReportUsageBreakdown struct {
+	Prev  FMReportUsageSnapshot `json:"prev"`
+	Today FMReportUsageSnapshot `json:"today"`
+	Total FMReportUsageSnapshot `json:"total"`
+}
+
+type FMReportAttachments struct {
+	AdditionalFMReport []FMReportAttachmentItem `json:"additional_fm_report,omitempty"`
+	Briefing           []FMReportAttachmentItem `json:"briefing,omitempty"`
+	WeightBalance      []FMReportAttachmentItem `json:"weight_balance,omitempty"`
+	OFP                []FMReportAttachmentItem `json:"ofp,omitempty"`
+}
+
+type FMReportAttachmentItem struct {
+	ID          string  `json:"id"`
+	FileID      string  `json:"file_id"`
+	DownloadURL *string `json:"download_url,omitempty"`
+}
+
+type FMReportResource struct {
+	Type       string             `json:"type" example:"fm_report"`
+	ID         string             `json:"id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	Attributes FMReportAttributes `json:"attributes"`
+}
+
+type FMReportResponse struct {
+	Data FMReportResource `json:"data"`
+}
+
+type FMReportListResponse struct {
+	Data []FMReportResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"1"`
+	} `json:"meta"`
+}

internal/transport/http/dto/forces_present_dto.go

@@ -0,0 +1,77 @@
+package dto
+
+// JSON:API Forces Present DTOs
+
+type ForcesPresentAttributes struct {
+	Name      string `json:"name" example:"Firefighter Team A"`
+	SortKey   *int   `json:"sortkey" example:"1"`
+	Note      string `json:"note,omitempty" example:"On-site responders"`
+	IsActive  bool   `json:"is_active" example:"true"`
+	CreatedAt string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy string `json:"created_by" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy string `json:"updated_by" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt string `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy string `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type ForcesPresentResource struct {
+	Type       string                  `json:"type" example:"forces_present"`
+	ID         string                  `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes ForcesPresentAttributes `json:"attributes"`
+}
+
+type ForcesPresentResponse struct {
+	Data ForcesPresentResource `json:"data"`
+}
+
+type ForcesPresentListResponse struct {
+	Data []ForcesPresentResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type ForcesPresentDataTableResponse struct {
+	Data []ForcesPresentResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type ForcesPresentCreateAttributes struct {
+	Name     string  `json:"name" validate:"required" example:"Firefighter Team A"`
+	SortKey  *int    `json:"sortkey" example:"1"`
+	Note     *string `json:"note,omitempty" example:"On-site responders"`
+	IsActive *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type ForcesPresentCreateData struct {
+	Type       string                        `json:"type" validate:"required,oneof=forces_present_create forces_present" example:"forces_present_create"`
+	Attributes ForcesPresentCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type ForcesPresentCreateRequest struct {
+	Data ForcesPresentCreateData `json:"data" validate:"required"`
+}
+
+type ForcesPresentUpdateAttributes struct {
+	Name     *string `json:"name,omitempty" example:"Firefighter Team A"`
+	SortKey  NullInt `json:"sortkey,omitempty" swaggertype:"integer" example:"1"`
+	Note     *string `json:"note,omitempty" example:"On-site responders"`
+	IsActive *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type ForcesPresentUpdateData struct {
+	Type       string                        `json:"type" validate:"required,oneof=forces_present_update forces_present" example:"forces_present_update"`
+	ID         string                        `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes ForcesPresentUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type ForcesPresentUpdateRequest struct {
+	Data ForcesPresentUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/health_insurance_companies_dto.go

@@ -0,0 +1,96 @@
+package dto
+
+// JSON:API Health Insurance Companies DTOs
+
+type HealthInsuranceCompanyAttributes struct {
+	LandID         string `json:"land_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FederalStateID string `json:"federal_state_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FederalState   string `json:"federal_state,omitempty" example:"Bayern"`
+	LandName       string `json:"land_name" example:"Germany"`
+	LandISOCode    string `json:"land_iso_code,omitempty" example:"DE"`
+	Name           string `json:"name" example:"ABC Insurance"`
+	SortKey        *int   `json:"sortkey" example:"1"`
+	State          string `json:"state,omitempty" example:"Berlin"`
+	Address        string `json:"address,omitempty" example:"Main Street 10"`
+	MobileNumber   string `json:"mobile_number,omitempty" example:"+4912345678"`
+	Email          string `json:"email,omitempty" example:"info@abc-insurance.local"`
+	Note           string `json:"note,omitempty" example:"Preferred insurance provider"`
+	IsActive       bool   `json:"is_active" example:"true"`
+	CreatedAt      string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy      string `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt      string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy      string `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt      string `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy      string `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type HealthInsuranceCompanyResource struct {
+	Type       string                           `json:"type" example:"health_insurance_company"`
+	ID         string                           `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes HealthInsuranceCompanyAttributes `json:"attributes"`
+}
+
+type HealthInsuranceCompanyResponse struct {
+	Data HealthInsuranceCompanyResource `json:"data"`
+}
+
+type HealthInsuranceCompanyListResponse struct {
+	Data []HealthInsuranceCompanyResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type HealthInsuranceCompanyDataTableResponse struct {
+	Data []HealthInsuranceCompanyResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type HealthInsuranceCompanyCreateAttributes struct {
+	Name         string  `json:"name" validate:"required" example:"ABC Insurance"`
+	SortKey      *int    `json:"sortkey" example:"1"`
+	LandID       *string `json:"land_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	State        *string `json:"state,omitempty" example:"Berlin"`
+	Address      *string `json:"address,omitempty" example:"Main Street 10"`
+	MobileNumber *string `json:"mobile_number,omitempty" example:"+4912345678"`
+	Email        *string `json:"email,omitempty" example:"info@abc-insurance.local"`
+	Note         *string `json:"note,omitempty" example:"Preferred insurance provider"`
+	IsActive     *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type HealthInsuranceCompanyCreateData struct {
+	Type       string                                 `json:"type" validate:"required,oneof=health_insurance_company_create health_insurance_company" example:"health_insurance_company_create"`
+	Attributes HealthInsuranceCompanyCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type HealthInsuranceCompanyCreateRequest struct {
+	Data HealthInsuranceCompanyCreateData `json:"data" validate:"required"`
+}
+
+type HealthInsuranceCompanyUpdateAttributes struct {
+	Name         *string `json:"name,omitempty" example:"ABC Insurance"`
+	SortKey      NullInt `json:"sortkey,omitempty" swaggertype:"integer" example:"1"`
+	LandID       *string `json:"land_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	State        *string `json:"state,omitempty" example:"Berlin"`
+	Address      *string `json:"address,omitempty" example:"Main Street 10"`
+	MobileNumber *string `json:"mobile_number,omitempty" example:"+4912345678"`
+	Email        *string `json:"email,omitempty" example:"info@abc-insurance.local"`
+	Note         *string `json:"note,omitempty" example:"Preferred insurance provider"`
+	IsActive     *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type HealthInsuranceCompanyUpdateData struct {
+	Type       string                                 `json:"type" validate:"required,oneof=health_insurance_company_update health_insurance_company" example:"health_insurance_company_update"`
+	ID         string                                 `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes HealthInsuranceCompanyUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type HealthInsuranceCompanyUpdateRequest struct {
+	Data HealthInsuranceCompanyUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/helicopter_usage_dto.go

@@ -0,0 +1,101 @@
+package dto
+
+// JSON:API Helicopter Usage DTOs
+
+type HelicopterUsageAttributes struct {
+	HelicopterID         string  `json:"helicopter_id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	TotalLanding         float64     `json:"total_landing" example:"120"`
+	TotalAirframeHours   float64 `json:"total_airframe_hours" example:"1523.5"`
+	TotalAirframeCycles  float64     `json:"total_airframe_cycles" example:"320"`
+	TotalEngine1Hours    float64 `json:"total_engine_1_hours" example:"1523.5"`
+	TotalEngine1GpcNgN1  float64 `json:"total_engine_1_gpc_ng_n1" example:"98.7"`
+	TotalEngine1PtcNfN2  float64 `json:"total_engine_1_ptc_nf_n2" example:"97.2"`
+	TotalEngine1Ccc      float64     `json:"total_engine_1_ccc" example:"44"`
+	TotalEngine2Hours    float64 `json:"total_engine_2_hours" example:"1523.5"`
+	TotalEngine2GpcNgN1  float64 `json:"total_engine_2_gpc_ng_n1" example:"98.7"`
+	TotalEngine2PtcNfN2  float64 `json:"total_engine_2_ptc_nf_n2" example:"97.2"`
+	TotalEngine2Ccc      float64     `json:"total_engine_2_ccc" example:"44"`
+	TotalFlightReport    float64     `json:"total_flight_report" example:"80"`
+	TotalHookRelease     float64     `json:"total_hook_release" example:"10"`
+	TotalRotorBrakeCycle float64     `json:"total_rotor_brake_cycle" example:"8"`
+	CreatedAt            string  `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy            string  `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt            string  `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy            string  `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt            string  `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy            string  `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type HelicopterUsageResource struct {
+	Type       string                    `json:"type" example:"helicopter_usage"`
+	ID         string                    `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes HelicopterUsageAttributes `json:"attributes"`
+}
+
+type HelicopterUsageResponse struct {
+	Data HelicopterUsageResource `json:"data"`
+}
+
+type HelicopterUsageListResponse struct {
+	Data []HelicopterUsageResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type HelicopterUsageCreateAttributes struct {
+	HelicopterID         string   `json:"helicopter_id" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	TotalLanding         *float64     `json:"total_landing,omitempty" example:"120"`
+	TotalAirframeHours   *float64 `json:"total_airframe_hours,omitempty" example:"1523.5"`
+	TotalAirframeCycles  *float64     `json:"total_airframe_cycles,omitempty" example:"320"`
+	TotalEngine1Hours    *float64 `json:"total_engine_1_hours,omitempty" example:"1523.5"`
+	TotalEngine1GpcNgN1  *float64 `json:"total_engine_1_gpc_ng_n1,omitempty" example:"98.7"`
+	TotalEngine1PtcNfN2  *float64 `json:"total_engine_1_ptc_nf_n2,omitempty" example:"97.2"`
+	TotalEngine1Ccc      *float64     `json:"total_engine_1_ccc,omitempty" example:"44"`
+	TotalEngine2Hours    *float64 `json:"total_engine_2_hours,omitempty" example:"1523.5"`
+	TotalEngine2GpcNgN1  *float64 `json:"total_engine_2_gpc_ng_n1,omitempty" example:"98.7"`
+	TotalEngine2PtcNfN2  *float64 `json:"total_engine_2_ptc_nf_n2,omitempty" example:"97.2"`
+	TotalEngine2Ccc      *float64     `json:"total_engine_2_ccc,omitempty" example:"44"`
+	TotalFlightReport    *float64     `json:"total_flight_report,omitempty" example:"80"`
+	TotalHookRelease     *float64     `json:"total_hook_release,omitempty" example:"10"`
+	TotalRotorBrakeCycle *float64     `json:"total_rotor_brake_cycle,omitempty" example:"8"`
+}
+
+type HelicopterUsageCreateData struct {
+	Type       string                          `json:"type" validate:"required,oneof=helicopter_usage_create helicopter_usage" example:"helicopter_usage_create"`
+	Attributes HelicopterUsageCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type HelicopterUsageCreateRequest struct {
+	Data HelicopterUsageCreateData `json:"data" validate:"required"`
+}
+
+type HelicopterUsageUpdateAttributes struct {
+	HelicopterID         *string  `json:"helicopter_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	TotalLanding         *float64     `json:"total_landing,omitempty" example:"120"`
+	TotalAirframeHours   *float64 `json:"total_airframe_hours,omitempty" example:"1523.5"`
+	TotalAirframeCycles  *float64     `json:"total_airframe_cycles,omitempty" example:"320"`
+	TotalEngine1Hours    *float64 `json:"total_engine_1_hours,omitempty" example:"1523.5"`
+	TotalEngine1GpcNgN1  *float64 `json:"total_engine_1_gpc_ng_n1,omitempty" example:"98.7"`
+	TotalEngine1PtcNfN2  *float64 `json:"total_engine_1_ptc_nf_n2,omitempty" example:"97.2"`
+	TotalEngine1Ccc      *float64     `json:"total_engine_1_ccc,omitempty" example:"44"`
+	TotalEngine2Hours    *float64 `json:"total_engine_2_hours,omitempty" example:"1523.5"`
+	TotalEngine2GpcNgN1  *float64 `json:"total_engine_2_gpc_ng_n1,omitempty" example:"98.7"`
+	TotalEngine2PtcNfN2  *float64 `json:"total_engine_2_ptc_nf_n2,omitempty" example:"97.2"`
+	TotalEngine2Ccc      *float64     `json:"total_engine_2_ccc,omitempty" example:"44"`
+	TotalFlightReport    *float64     `json:"total_flight_report,omitempty" example:"80"`
+	TotalHookRelease     *float64     `json:"total_hook_release,omitempty" example:"10"`
+	TotalRotorBrakeCycle *float64     `json:"total_rotor_brake_cycle,omitempty" example:"8"`
+}
+
+type HelicopterUsageUpdateData struct {
+	Type       string                          `json:"type" validate:"required,oneof=helicopter_usage_update helicopter_usage" example:"helicopter_usage_update"`
+	ID         string                          `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes HelicopterUsageUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type HelicopterUsageUpdateRequest struct {
+	Data HelicopterUsageUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/hems_operation_category_dto.go

@@ -0,0 +1,70 @@
+package dto
+
+// JSON:API HEMS Operation Category DTOs
+
+type HEMSOperationCategoryAttributes struct {
+	Name      string `json:"name" example:"Firefighting"`
+	Type      string `json:"type" example:"first"`
+	CreatedAt string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy string `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy string `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt string `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy string `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type HEMSOperationCategoryResource struct {
+	Type       string                          `json:"type" example:"hems_operation_category"`
+	ID         string                          `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes HEMSOperationCategoryAttributes `json:"attributes"`
+}
+
+type HEMSOperationCategoryResponse struct {
+	Data HEMSOperationCategoryResource `json:"data"`
+}
+
+type HEMSOperationCategoryListResponse struct {
+	Data []HEMSOperationCategoryResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type HEMSOperationCategoryDataTableResponse struct {
+	Data []HEMSOperationCategoryResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type HEMSOperationCategoryCreateAttributes struct {
+	Name string `json:"name" validate:"required" example:"Firefighting"`
+	Type string `json:"type" validate:"required,oneof=first secondary misuse" example:"first"`
+}
+
+type HEMSOperationCategoryCreateData struct {
+	Type       string                                `json:"type" validate:"required,oneof=hems_operation_category_create hems_operation_category" example:"hems_operation_category_create"`
+	Attributes HEMSOperationCategoryCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type HEMSOperationCategoryCreateRequest struct {
+	Data HEMSOperationCategoryCreateData `json:"data" validate:"required"`
+}
+
+type HEMSOperationCategoryUpdateAttributes struct {
+	Name *string `json:"name,omitempty" example:"Firefighting"`
+	Type *string `json:"type,omitempty" validate:"omitempty,oneof=first secondary misuse" example:"first"`
+}
+
+type HEMSOperationCategoryUpdateData struct {
+	Type       string                                `json:"type" validate:"required,oneof=hems_operation_category_update hems_operation_category" example:"hems_operation_category_update"`
+	Attributes HEMSOperationCategoryUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type HEMSOperationCategoryUpdateRequest struct {
+	Data HEMSOperationCategoryUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/hems_operation_dto.go

@@ -0,0 +1,95 @@
+package dto
+
+// JSON:API HEMS Operation DTOs
+
+type HEMSOperationOperationalDataRef struct {
+	ID string `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type HEMSOperationCategoryRef struct {
+	ID   string `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name string `json:"name,omitempty" example:"Firefighting"`
+	Type string `json:"type,omitempty" example:"first"`
+}
+
+type HEMSOperationMissionRef struct {
+	ID       string `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FlightID string `json:"flight_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Type     string `json:"type,omitempty" example:"HEMS"`
+}
+
+type HEMSOperationAttributes struct {
+	Date                    string                           `json:"date" example:"2026-03-12T03:04:05Z"`
+	OperationalDataID       string                           `json:"operational_data_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	MissionID               string                           `json:"mission_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	HEMSOperationCategoryID string                           `json:"hems_operation_category_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	OperationalData         *HEMSOperationOperationalDataRef `json:"operational_data,omitempty"`
+	Mission                 *HEMSOperationMissionRef         `json:"mission,omitempty"`
+	HEMSOperationCategory   *HEMSOperationCategoryRef        `json:"hems_operation_category,omitempty"`
+	CreatedAt               string                           `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy               string                           `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt               string                           `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy               string                           `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt               string                           `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy               string                           `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type HEMSOperationResource struct {
+	Type       string                  `json:"type" example:"hems_operation"`
+	ID         string                  `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes HEMSOperationAttributes `json:"attributes"`
+}
+
+type HEMSOperationResponse struct {
+	Data HEMSOperationResource `json:"data"`
+}
+
+type HEMSOperationListResponse struct {
+	Data []HEMSOperationResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type HEMSOperationDataTableResponse struct {
+	Data []HEMSOperationResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type HEMSOperationCreateAttributes struct {
+	Date                    string  `json:"date" validate:"required" example:"2026-03-12T03:04:05Z"`
+	OperationalDataID       *string `json:"operational_data_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	MissionID               *string `json:"mission_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	HEMSOperationCategoryID *string `json:"hems_operation_category_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type HEMSOperationCreateData struct {
+	Type       string                        `json:"type" validate:"required,oneof=hems_operation_create hems_operation" example:"hems_operation_create"`
+	Attributes HEMSOperationCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type HEMSOperationCreateRequest struct {
+	Data HEMSOperationCreateData `json:"data" validate:"required"`
+}
+
+type HEMSOperationUpdateAttributes struct {
+	Date                    *string `json:"date,omitempty" example:"2026-03-12T03:04:05Z"`
+	OperationalDataID       *string `json:"operational_data_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	MissionID               *string `json:"mission_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	HEMSOperationCategoryID *string `json:"hems_operation_category_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type HEMSOperationUpdateData struct {
+	Type       string                        `json:"type" validate:"required,oneof=hems_operation_update hems_operation" example:"hems_operation_update"`
+	Attributes HEMSOperationUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type HEMSOperationUpdateRequest struct {
+	Data HEMSOperationUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/hems_operational_data_dto.go

@@ -0,0 +1,141 @@
+package dto
+
+// JSON:API HEMS Operational Data DTOs
+
+type HEMSOperationalDataFileAttributes struct {
+	ID               string `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FileAttachmentID string `json:"file_attachment_id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type HEMSOperationalDataAttributes struct {
+	Time              string                              `json:"time" example:"2026-03-12T03:04:05Z"`
+	LandID            string                              `json:"land_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	VocationID        string                              `json:"vocation_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	ForcePresentIDs   []string                            `json:"force_present_ids,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	StateID           string                              `json:"state_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Location          string                              `json:"location" example:"123 Main St, Anytown, USA"`
+	Postcode          string                              `json:"postcode,omitempty" example:"12345"`
+	Notes             string                              `json:"notes" example:"Notes about the operational data"`
+	Darkness          bool                                `json:"darkness"`
+	FalseInformation  bool                                `json:"false_information"`
+	Fog               bool                                `json:"fog"`
+	Precipitation     bool                                `json:"precipitation"`
+	MountainUse       bool                                `json:"mountain_use"`
+	Wind              bool                                `json:"wind"`
+	NFOSearch         bool                                `json:"nfo_search"`
+	LandingSiteSearch bool                                `json:"landing_site_search"`
+	Temperature       float64                             `json:"temperature" example:"23.5"`
+	Altitude          float64                             `json:"altitude" example:"5.2"`
+	TerrainIndex      string                              `json:"terrain_index" example:"Only helicopter landing"`
+	RopeRecovery      bool                                `json:"rope_recovery"`
+	NightFlight       bool                                `json:"night_flight"`
+	InstrumentFlight  bool                                `json:"instrument_flight"`
+	AdditionalInfo    string                              `json:"additional_info" example:"Additional information about the operational data"`
+	Files             []HEMSOperationalDataFileAttributes `json:"files,omitempty"`
+	CreatedAt         string                              `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy         string                              `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt         string                              `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy         string                              `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt         string                              `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy         string                              `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type HEMSOperationalDataResource struct {
+	Type       string                        `json:"type" example:"hems_operational_data"`
+	ID         string                        `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes HEMSOperationalDataAttributes `json:"attributes"`
+}
+
+type HEMSOperationalDataResponse struct {
+	Data HEMSOperationalDataResource `json:"data"`
+}
+
+type HEMSOperationalDataListResponse struct {
+	Data []HEMSOperationalDataResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type HEMSOperationalDataDataTableResponse struct {
+	Data []HEMSOperationalDataResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type HEMSOperationalDataCreateAttributes struct {
+	Time              string   `json:"time" validate:"required" example:"2026-03-12T03:04:05Z"`
+	LandID            *string  `json:"land_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	VocationID        *string  `json:"vocation_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	ForcePresentIDs   []string `json:"force_present_ids,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	StateID           *string  `json:"state_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Location          string   `json:"location" validate:"required" example:"123 Main St, Anytown, USA"`
+	Postcode          *string  `json:"postcode,omitempty" example:"12345"`
+	Notes             *string  `json:"notes,omitempty" example:"Notes about the operational data"`
+	Darkness          *bool    `json:"darkness,omitempty"`
+	FalseInformation  *bool    `json:"false_information,omitempty"`
+	Fog               *bool    `json:"fog,omitempty"`
+	Precipitation     *bool    `json:"precipitation,omitempty"`
+	MountainUse       *bool    `json:"mountain_use,omitempty"`
+	Wind              *bool    `json:"wind,omitempty"`
+	NFOSearch         *bool    `json:"nfo_search,omitempty"`
+	LandingSiteSearch *bool    `json:"landing_site_search,omitempty"`
+	Temperature       *float64 `json:"temperature,omitempty" example:"23.5"`
+	Altitude          *float64 `json:"altitude,omitempty" example:"5.2"`
+	TerrainIndex      *string  `json:"terrain_index,omitempty" example:"Only helicopter landing"`
+	RopeRecovery      *bool    `json:"rope_recovery,omitempty"`
+	NightFlight       *bool    `json:"night_flight,omitempty"`
+	InstrumentFlight  *bool    `json:"instrument_flight,omitempty"`
+	AdditionalInfo    *string  `json:"additional_info,omitempty" example:"Additional information about the operational data"`
+	FileAttachmentIDs []string `json:"file_attachment_ids,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type HEMSOperationalDataCreateData struct {
+	Type       string                              `json:"type" validate:"required,oneof=hems_operational_data_create hems_operational_data" example:"hems_operational_data_create"`
+	Attributes HEMSOperationalDataCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type HEMSOperationalDataCreateRequest struct {
+	Data HEMSOperationalDataCreateData `json:"data" validate:"required"`
+}
+
+type HEMSOperationalDataUpdateAttributes struct {
+	Time              *string   `json:"time,omitempty" example:"2026-03-12T03:04:05Z"`
+	LandID            *string   `json:"land_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	VocationID        *string   `json:"vocation_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	ForcePresentIDs   *[]string `json:"force_present_ids,omitempty"`
+	StateID           *string   `json:"state_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Location          *string   `json:"location,omitempty" example:"123 Main St, Anytown, USA"`
+	Postcode          *string   `json:"postcode,omitempty" example:"12345"`
+	Notes             *string   `json:"notes,omitempty" example:"Notes about the operational data"`
+	Darkness          *bool     `json:"darkness,omitempty"`
+	FalseInformation  *bool     `json:"false_information,omitempty"`
+	Fog               *bool     `json:"fog,omitempty"`
+	Precipitation     *bool     `json:"precipitation,omitempty"`
+	MountainUse       *bool     `json:"mountain_use,omitempty"`
+	Wind              *bool     `json:"wind,omitempty"`
+	NFOSearch         *bool     `json:"nfo_search,omitempty"`
+	LandingSiteSearch *bool     `json:"landing_site_search,omitempty"`
+	Temperature       *float64  `json:"temperature,omitempty" example:"23.5"`
+	Altitude          *float64  `json:"altitude,omitempty" example:"5.2"`
+	TerrainIndex      *string   `json:"terrain_index,omitempty" example:"Only helicopter landing"`
+	RopeRecovery      *bool     `json:"rope_recovery,omitempty"`
+	NightFlight       *bool     `json:"night_flight,omitempty"`
+	InstrumentFlight  *bool     `json:"instrument_flight,omitempty"`
+	AdditionalInfo    *string   `json:"additional_info,omitempty" example:"Additional information about the operational data"`
+	FileAttachmentIDs *[]string `json:"file_attachment_ids,omitempty"`
+}
+
+type HEMSOperationalDataUpdateData struct {
+	Type       string                              `json:"type" validate:"required,oneof=hems_operational_data_update hems_operational_data" example:"hems_operational_data_update"`
+	Attributes HEMSOperationalDataUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type HEMSOperationalDataUpdateRequest struct {
+	Data HEMSOperationalDataUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/hospital_dto.go

@@ -0,0 +1,89 @@
+package dto
+
+// JSON:API Hospital DTOs
+
+type HospitalAttributes struct {
+	Name           string `json:"name" example:"RSUD Kota"`
+	SortKey        *int   `json:"sortkey" example:"1"`
+	Address        string `json:"address,omitempty" example:"Jl. Merdeka No. 10"`
+	LandlineNumber string `json:"landline_number,omitempty" example:"0211234567"`
+	MobileNumber   string `json:"mobile_number,omitempty" example:"08123456789"`
+	Email          string `json:"email,omitempty" example:"info@hospital.local"`
+	Note           string `json:"note,omitempty" example:"Nearest trauma center"`
+	IsActive       bool   `json:"is_active" example:"true"`
+	CreatedAt      string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy      string `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt      string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy      string `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt      string `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy      string `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type HospitalResource struct {
+	Type       string             `json:"type" example:"hospital"`
+	ID         string             `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes HospitalAttributes `json:"attributes"`
+}
+
+type HospitalResponse struct {
+	Data HospitalResource `json:"data"`
+}
+
+type HospitalListResponse struct {
+	Data []HospitalResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type HospitalDataTableResponse struct {
+	Data []HospitalResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type HospitalCreateAttributes struct {
+	Name           string  `json:"name" validate:"required" example:"RSUD Kota"`
+	SortKey        *int    `json:"sortkey" example:"1"`
+	Address        *string `json:"address,omitempty" example:"Jl. Merdeka No. 10"`
+	LandlineNumber *string `json:"landline_number,omitempty" example:"0211234567"`
+	MobileNumber   *string `json:"mobile_number,omitempty" example:"08123456789"`
+	Email          *string `json:"email,omitempty" example:"info@hospital.local"`
+	Note           *string `json:"note,omitempty" example:"Nearest trauma center"`
+	IsActive       *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type HospitalCreateData struct {
+	Type       string                   `json:"type" validate:"required,oneof=hospital_create hospital" example:"hospital_create"`
+	Attributes HospitalCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type HospitalCreateRequest struct {
+	Data HospitalCreateData `json:"data" validate:"required"`
+}
+
+type HospitalUpdateAttributes struct {
+	Name           *string `json:"name,omitempty" example:"RSUD Kota"`
+	SortKey        NullInt `json:"sortkey,omitempty" swaggertype:"integer" example:"1"`
+	Address        *string `json:"address,omitempty" example:"Jl. Merdeka No. 10"`
+	LandlineNumber *string `json:"landline_number,omitempty" example:"0211234567"`
+	MobileNumber   *string `json:"mobile_number,omitempty" example:"08123456789"`
+	Email          *string `json:"email,omitempty" example:"info@hospital.local"`
+	Note           *string `json:"note,omitempty" example:"Nearest trauma center"`
+	IsActive       *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type HospitalUpdateData struct {
+	Type       string                   `json:"type" validate:"required,oneof=hospital_update hospital" example:"hospital_update"`
+	ID         string                   `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes HospitalUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type HospitalUpdateRequest struct {
+	Data HospitalUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/icao_dto.go

@@ -0,0 +1,101 @@
+package dto
+
+// JSON:API ICAO DTOs
+
+type ICAOAttributes struct {
+	LandID         string `json:"land_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FederalStateID string `json:"federal_state_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FederalState   string `json:"federal_state,omitempty" example:"Bayern"`
+	LandName       string `json:"land_name,omitempty" example:"Germany"`
+	LandISOCode    string `json:"land_iso_code,omitempty" example:"DE"`
+	ICAOCode       string `json:"icao_code" example:"EDDB"`
+	Name           string `json:"name,omitempty" example:"Berlin Base"`
+	SortKey        *int   `json:"sortkey" example:"1"`
+	Address        string `json:"address,omitempty" example:"Muehlenstrasse 1"`
+	LandlineNumber string `json:"landline_number,omitempty" example:"030123456"`
+	MobileNumber   string `json:"mobile_number,omitempty" example:"0170123456"`
+	Email          string `json:"email,omitempty" example:"ops@example.local"`
+	Note           string `json:"note,omitempty" example:"Night operations supported"`
+	IsActive       bool   `json:"is_active" example:"true"`
+	CreatedAt      string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy      string `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt      string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy      string `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt      string `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy      string `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type ICAOResource struct {
+	Type       string         `json:"type" example:"icao"`
+	ID         string         `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes ICAOAttributes `json:"attributes"`
+}
+
+type ICAOResponse struct {
+	Data ICAOResource `json:"data"`
+}
+
+type ICAOListResponse struct {
+	Data []ICAOResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type ICAODataTableResponse struct {
+	Data []ICAOResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type ICAOCreateAttributes struct {
+	LandID         *string `json:"land_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FederalStateID *string `json:"federal_state_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	ICAOCode       string  `json:"icao_code" validate:"required" example:"EDDB"`
+	Name           *string `json:"name,omitempty" example:"Berlin Base"`
+	SortKey        *int    `json:"sortkey" example:"1"`
+	Address        *string `json:"address,omitempty" example:"Muehlenstrasse 1"`
+	LandlineNumber *string `json:"landline_number,omitempty" example:"030123456"`
+	MobileNumber   *string `json:"mobile_number,omitempty" example:"0170123456"`
+	Email          *string `json:"email,omitempty" example:"ops@example.local"`
+	Note           *string `json:"note,omitempty" example:"Night operations supported"`
+	IsActive       *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type ICAOCreateData struct {
+	Type       string               `json:"type" validate:"required,oneof=icao_create icao" example:"icao_create"`
+	Attributes ICAOCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type ICAOCreateRequest struct {
+	Data ICAOCreateData `json:"data" validate:"required"`
+}
+
+type ICAOUpdateAttributes struct {
+	LandID         *string `json:"land_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FederalStateID *string `json:"federal_state_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	ICAOCode       *string `json:"icao_code,omitempty" example:"EDDB"`
+	Name           *string `json:"name,omitempty" example:"Berlin Base"`
+	SortKey        NullInt `json:"sortkey,omitempty" swaggertype:"integer" example:"1"`
+	Address        *string `json:"address,omitempty" example:"Muehlenstrasse 1"`
+	LandlineNumber *string `json:"landline_number,omitempty" example:"030123456"`
+	MobileNumber   *string `json:"mobile_number,omitempty" example:"0170123456"`
+	Email          *string `json:"email,omitempty" example:"ops@example.local"`
+	Note           *string `json:"note,omitempty" example:"Night operations supported"`
+	IsActive       *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type ICAOUpdateData struct {
+	Type       string               `json:"type" validate:"required,oneof=icao_update icao" example:"icao_update"`
+	ID         string               `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes ICAOUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type ICAOUpdateRequest struct {
+	Data ICAOUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/insurance_patient_data_dto.go

@@ -0,0 +1,87 @@
+package dto
+
+// JSON:API InsurancePatientData DTOs
+
+type InsurancePatientDataHealthInsuranceCompany struct {
+	ID           string `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name         string `json:"name,omitempty" example:"ABC Insurance"`
+	State        string `json:"state,omitempty" example:"Berlin"`
+	Address      string `json:"address,omitempty" example:"Main Street 10"`
+	MobileNumber string `json:"mobile_number,omitempty" example:"+4912345678"`
+	Email        string `json:"email,omitempty" example:"info@abc-insurance.local"`
+}
+
+type InsurancePatientDataFederalState struct {
+	ID   string `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name string `json:"name,omitempty" example:"Bayern"`
+}
+
+type InsurancePatientDataAttributes struct {
+	HealthInsuranceCompaniesId string                                      `json:"health_insurance_companies_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FederalStateId             string                                      `json:"federal_state_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	HealthInsuranceCompany     *InsurancePatientDataHealthInsuranceCompany `json:"health_insurance_company,omitempty"`
+	FederalState               *InsurancePatientDataFederalState           `json:"federal_state,omitempty"`
+	CreatedAt                  string                                      `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy                  string                                      `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt                  string                                      `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy                  string                                      `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt                  string                                      `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy                  string                                      `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type InsurancePatientDataResource struct {
+	Type       string                         `json:"type" example:"insurance_patient_data"`
+	ID         string                         `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes InsurancePatientDataAttributes `json:"attributes"`
+}
+
+type InsurancePatientDataResponse struct {
+	Data InsurancePatientDataResource `json:"data"`
+}
+
+type InsurancePatientDataListResponse struct {
+	Data []InsurancePatientDataResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type InsurancePatientDataDataTableResponse struct {
+	Data []InsurancePatientDataResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type InsurancePatientDataCreateAttributes struct {
+	HealthInsuranceCompaniesId string `json:"health_insurance_companies_id" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FederalStateId             string `json:"federal_state_id" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type InsurancePatientDataCreateData struct {
+	Type       string                               `json:"type" validate:"required,oneof=insurance_patient_data_create insurance_patient_data" example:"insurance_patient_data_create"`
+	Attributes InsurancePatientDataCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type InsurancePatientDataCreateRequest struct {
+	Data InsurancePatientDataCreateData `json:"data" validate:"required"`
+}
+
+type InsurancePatientDataUpdateAttributes struct {
+	HealthInsuranceCompaniesId *string `json:"health_insurance_companies_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FederalStateId             *string `json:"federal_state_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type InsurancePatientDataUpdateData struct {
+	Type       string                               `json:"type" validate:"required,oneof=insurance_patient_data_update insurance_patient_data" example:"insurance_patient_data_update"`
+	ID         string                               `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes InsurancePatientDataUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type InsurancePatientDataUpdateRequest struct {
+	Data InsurancePatientDataUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/land_dto.go

@@ -0,0 +1,103 @@
+package dto
+
+import "wucher/internal/domain/land"
+
+// JSON:API Land DTOs
+
+type LandAttributes struct {
+	Name              string                `json:"name" example:"Germany"`
+	Note              string                `json:"note,omitempty" example:"Central Europe"`
+	ISOCode           string                `json:"iso_code,omitempty" example:"DE"`
+	BMDExportID       *string               `json:"bmd_export_id,omitempty" example:"DE001"`
+	FederalStateTotal int                   `json:"federal_state_total" example:"2"`
+	FederalStateList  []LandFederalStateDTO `json:"federal_state_list,omitempty"`
+	SortKey           *int                  `json:"sortkey" example:"1"`
+	IsActive          bool                  `json:"is_active" example:"true"`
+	CreatedAt         string                `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy         string                `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt         string                `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy         string                `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt         string                `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy         string                `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type LandFederalStateDTO struct {
+	ID   string `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name string `json:"name" example:"Bayern"`
+}
+
+type LandFederalStateView struct {
+	ID   []byte
+	Name string
+}
+
+type LandView struct {
+	Row               land.Land
+	FederalStateTotal int
+	FederalStateList  []LandFederalStateView
+}
+
+type LandResource struct {
+	Type       string         `json:"type" example:"land"`
+	ID         string         `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes LandAttributes `json:"attributes"`
+}
+
+type LandResponse struct {
+	Data LandResource `json:"data"`
+}
+
+type LandListResponse struct {
+	Data []LandResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type LandDataTableResponse struct {
+	Data []LandResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type LandCreateAttributes struct {
+	Name        string  `json:"name" validate:"required" example:"Germany"`
+	Note        *string `json:"note,omitempty" example:"Central Europe"`
+	ISOCode     string  `json:"iso_code,omitempty" example:"DE"`
+	BMDExportID *string `json:"bmd_export_id,omitempty" example:"DE001"`
+	SortKey     *int    `json:"sortkey" example:"1"`
+	IsActive    *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type LandCreateData struct {
+	Type       string               `json:"type" validate:"required,oneof=land_create land" example:"land_create"`
+	Attributes LandCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type LandCreateRequest struct {
+	Data LandCreateData `json:"data" validate:"required"`
+}
+
+type LandUpdateAttributes struct {
+	Name        *string `json:"name,omitempty" example:"Germany"`
+	Note        *string `json:"note,omitempty" example:"Central Europe"`
+	ISOCode     *string `json:"iso_code,omitempty" example:"DE"`
+	BMDExportID *string `json:"bmd_export_id,omitempty" example:"DE001"`
+	SortKey     NullInt `json:"sortkey,omitempty" swaggertype:"integer" example:"1"`
+	IsActive    *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type LandUpdateData struct {
+	Type       string               `json:"type" validate:"required,oneof=land_update land" example:"land_update"`
+	ID         string               `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes LandUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type LandUpdateRequest struct {
+	Data LandUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/medicine_dto.go

@@ -0,0 +1,263 @@
+package dto
+
+import (
+	"bytes"
+	"encoding/json"
+)
+
+// JSON:API Medicine DTOs
+
+type MedicineAttributes struct {
+	Name             string                  `json:"name" example:"Paracetamol"`
+	SortKey          *int                    `json:"sortkey" example:"1"`
+	Note             string                  `json:"note,omitempty" example:"Main stock medicine"`
+	Pack             string                  `json:"pack,omitempty" example:"500mg"`
+	Unit             string                  `json:"unit,omitempty" example:"tablet"`
+	Column           int64                   `json:"column" example:"1"`
+	MedicineGroupID  string                  `json:"medicine_group_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	MotorReactionID  string                  `json:"motor_reaction_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	MotorReactionIDs []string                `json:"motor_reaction_ids,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	MedicineGroup    *MedicineGroupResource  `json:"medicine_group,omitempty"`
+	MotorReaction    *MotorReactionResource  `json:"motor_reaction,omitempty"`
+	MotorReactions   []MotorReactionResource `json:"motor_reactions,omitempty"`
+	IsActive         bool                    `json:"is_active" example:"true"`
+	CreatedAt        string                  `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy        string                  `json:"created_by" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt        string                  `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy        string                  `json:"updated_by" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt        string                  `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy        string                  `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type MedicineResource struct {
+	Type       string             `json:"type" example:"medicine"`
+	ID         string             `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes MedicineAttributes `json:"attributes"`
+}
+
+type MedicineResponse struct {
+	Data MedicineResource `json:"data"`
+}
+
+type MedicineListResponse struct {
+	Data []MedicineResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type MedicineDataTableResponse struct {
+	Data []MedicineResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type MedicineCreateAttributes struct {
+	Name             string   `json:"name" validate:"required" example:"Paracetamol"`
+	SortKey          *int     `json:"sortkey" example:"1"`
+	Note             *string  `json:"note,omitempty" example:"Main stock medicine"`
+	Pack             *string  `json:"pack,omitempty" example:"500mg"`
+	Unit             *string  `json:"unit,omitempty" validate:"omitempty,max=50" example:"tablet"`
+	Column           *int64   `json:"column,omitempty" example:"1"`
+	MedicineGroupID  *string  `json:"medicine_group_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	MotorReactionID  *string  `json:"motor_reaction_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	MotorReactionIDs []string `json:"motor_reaction_ids,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	IsActive         *bool    `json:"is_active,omitempty" example:"true"`
+}
+
+type MedicineCreateData struct {
+	Type       string                   `json:"type" validate:"required,oneof=medicine_create medicine" example:"medicine_create"`
+	Attributes MedicineCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type MedicineCreateRequest struct {
+	Data MedicineCreateData `json:"data" validate:"required"`
+}
+
+type MedicineUpdateAttributes struct {
+	Name             *string    `json:"name,omitempty" example:"Paracetamol"`
+	SortKey          NullInt    `json:"sortkey,omitempty" swaggertype:"integer" example:"1"`
+	Note             *string    `json:"note,omitempty" example:"Main stock medicine"`
+	Pack             *string    `json:"pack,omitempty" example:"500mg"`
+	Unit             *string    `json:"unit,omitempty" validate:"omitempty,max=50" example:"tablet"`
+	Column           *int64     `json:"column,omitempty" example:"1"`
+	MedicineGroupID  NullString `json:"medicine_group_id,omitempty" swaggertype:"string" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	MotorReactionID  NullString `json:"motor_reaction_id,omitempty" swaggertype:"string" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	MotorReactionIDs []string   `json:"motor_reaction_ids,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	IsActive         *bool      `json:"is_active,omitempty" example:"true"`
+}
+
+type MedicineUpdateData struct {
+	Type       string                   `json:"type" validate:"required,oneof=medicine_update medicine" example:"medicine_update"`
+	ID         string                   `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes MedicineUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type MedicineUpdateRequest struct {
+	Data MedicineUpdateData `json:"data" validate:"required"`
+}
+
+type MedicineGroupAttributes struct {
+	Name      string `json:"name" example:"Spritze"`
+	CreatedAt string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy string `json:"created_by" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy string `json:"updated_by" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt string `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy string `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type MedicineGroupResource struct {
+	Type       string                  `json:"type" example:"medicine_group"`
+	ID         string                  `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes MedicineGroupAttributes `json:"attributes"`
+}
+
+type MedicineGroupResponse struct {
+	Data MedicineGroupResource `json:"data"`
+}
+
+type MedicineGroupListResponse struct {
+	Data []MedicineGroupResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type MedicineGroupDataTableResponse struct {
+	Data []MedicineGroupResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type MedicineGroupCreateAttributes struct {
+	Name string `json:"name" validate:"required" example:"Spritze"`
+}
+
+type MedicineGroupCreateData struct {
+	Type       string                        `json:"type" validate:"required,oneof=medicine_group_create medicine_group" example:"medicine_group_create"`
+	Attributes MedicineGroupCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type MedicineGroupCreateRequest struct {
+	Data MedicineGroupCreateData `json:"data" validate:"required"`
+}
+
+type MedicineGroupUpdateAttributes struct {
+	Name *string `json:"name,omitempty" example:"Spritze"`
+}
+
+type MedicineGroupUpdateData struct {
+	Type       string                        `json:"type" validate:"required,oneof=medicine_group_update medicine_group" example:"medicine_group_update"`
+	ID         string                        `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes MedicineGroupUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type MedicineGroupUpdateRequest struct {
+	Data MedicineGroupUpdateData `json:"data" validate:"required"`
+}
+
+type MotorReactionAttributes struct {
+	Name      string `json:"name" example:"gezielt auf Schmerzreiz"`
+	Score     *int64 `json:"score" example:"5"`
+	CreatedAt string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy string `json:"created_by" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy string `json:"updated_by" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt string `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy string `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type MotorReactionResource struct {
+	Type       string                  `json:"type" example:"motor_reaction"`
+	ID         string                  `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes MotorReactionAttributes `json:"attributes"`
+}
+
+type MotorReactionResponse struct {
+	Data MotorReactionResource `json:"data"`
+}
+
+type MotorReactionListResponse struct {
+	Data []MotorReactionResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type MotorReactionDataTableResponse struct {
+	Data []MotorReactionResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type MotorReactionCreateAttributes struct {
+	Name  string `json:"name" validate:"required" example:"gezielt auf Schmerzreiz"`
+	Score *int64 `json:"score,omitempty" example:"5"`
+}
+
+type MotorReactionCreateData struct {
+	Type       string                        `json:"type" validate:"required,oneof=motor_reaction_create motor_reaction" example:"motor_reaction_create"`
+	Attributes MotorReactionCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type MotorReactionCreateRequest struct {
+	Data MotorReactionCreateData `json:"data" validate:"required"`
+}
+
+type MotorReactionUpdateAttributes struct {
+	Name  *string   `json:"name,omitempty" example:"gezielt auf Schmerzreiz"`
+	Score NullInt64 `json:"score,omitempty" swaggertype:"integer" example:"5"`
+}
+
+// NullInt64 allows PATCH semantics:
+// - field omitted  => Set=false (no change)
+// - value null     => Set=true, Valid=false (set DB NULL)
+// - value number   => Set=true, Valid=true, Value=<number>
+type NullInt64 struct {
+	Set   bool
+	Valid bool
+	Value int64
+}
+
+func (n *NullInt64) UnmarshalJSON(data []byte) error {
+	n.Set = true
+	trimmed := bytes.TrimSpace(data)
+	if bytes.Equal(trimmed, []byte("null")) {
+		n.Valid = false
+		n.Value = 0
+		return nil
+	}
+	var v int64
+	if err := json.Unmarshal(trimmed, &v); err != nil {
+		return err
+	}
+	n.Valid = true
+	n.Value = v
+	return nil
+}
+
+type MotorReactionUpdateData struct {
+	Type       string                        `json:"type" validate:"required,oneof=motor_reaction_update motor_reaction" example:"motor_reaction_update"`
+	ID         string                        `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes MotorReactionUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type MotorReactionUpdateRequest struct {
+	Data MotorReactionUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/null_int.go

@@ -0,0 +1,33 @@
+package dto
+
+import (
+	"bytes"
+	"encoding/json"
+)
+
+// NullInt allows PATCH semantics:
+// - field omitted  => Set=false (no change)
+// - value null     => Set=true, Valid=false (set DB NULL)
+// - value number   => Set=true, Valid=true, Value=<number>
+type NullInt struct {
+	Set   bool
+	Valid bool
+	Value int
+}
+
+func (n *NullInt) UnmarshalJSON(data []byte) error {
+	n.Set = true
+	trimmed := bytes.TrimSpace(data)
+	if bytes.Equal(trimmed, []byte("null")) {
+		n.Valid = false
+		n.Value = 0
+		return nil
+	}
+	var v int
+	if err := json.Unmarshal(trimmed, &v); err != nil {
+		return err
+	}
+	n.Valid = true
+	n.Value = v
+	return nil
+}

internal/transport/http/dto/opc_dto.go

@@ -0,0 +1,77 @@
+package dto
+
+// JSON:API OPC DTOs
+
+type OpcAttributes struct {
+	Title     string `json:"title" example:"Main OPC Base"`
+	SortKey   *int   `json:"sortkey" example:"1"`
+	Note      string `json:"note,omitempty" example:"Primary operation control center"`
+	IsActive  bool   `json:"is_active" example:"true"`
+	CreatedAt string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy string `json:"created_by" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy string `json:"updated_by" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt string `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy string `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type OpcResource struct {
+	Type       string        `json:"type" example:"opc"`
+	ID         string        `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes OpcAttributes `json:"attributes"`
+}
+
+type OpcResponse struct {
+	Data OpcResource `json:"data"`
+}
+
+type OpcListResponse struct {
+	Data []OpcResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type OpcDataTableResponse struct {
+	Data []OpcResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type OpcCreateAttributes struct {
+	Title    string  `json:"title" validate:"required" example:"Main OPC Base"`
+	SortKey  *int    `json:"sortkey" example:"1"`
+	Note     *string `json:"note,omitempty" example:"Primary operation control center"`
+	IsActive *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type OpcCreateData struct {
+	Type       string              `json:"type" validate:"required,oneof=opc_create opc" example:"opc_create"`
+	Attributes OpcCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type OpcCreateRequest struct {
+	Data OpcCreateData `json:"data" validate:"required"`
+}
+
+type OpcUpdateAttributes struct {
+	Title    *string `json:"title,omitempty" example:"Main OPC Base"`
+	SortKey  NullInt `json:"sortkey,omitempty" swaggertype:"integer" example:"1"`
+	Note     *string `json:"note,omitempty" example:"Primary operation control center"`
+	IsActive *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type OpcUpdateData struct {
+	Type       string              `json:"type" validate:"required,oneof=opc_update opc" example:"opc_update"`
+	ID         string              `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes OpcUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type OpcUpdateRequest struct {
+	Data OpcUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/patient_data_dto.go

@@ -0,0 +1,114 @@
+package dto
+
+// JSON:API PatientData DTOs
+
+type PatientDataOPC struct {
+	ID    string `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Title string `json:"title,omitempty" example:"Primary OPC"`
+}
+
+type PatientDataInsuranceDetail struct {
+	ID                       string                                      `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	HealthInsuranceCompanyID string                                      `json:"health_insurance_companies_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FederalStateID           string                                      `json:"federal_state_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	HealthInsuranceCompany   *InsurancePatientDataHealthInsuranceCompany `json:"health_insurance_company,omitempty"`
+	FederalState             *InsurancePatientDataFederalState           `json:"federal_state,omitempty"`
+}
+
+type PatientDataAttributes struct {
+	FamilyName             string                      `json:"family_name" example:"Muster"`
+	FirstName              string                      `json:"first_name" example:"Max"`
+	OPCId                  string                      `json:"opc_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	BirthDate              string                      `json:"birth_date,omitempty" example:"1990-01-15"`
+	Age                    *int                        `json:"age,omitempty" example:"35"`
+	Gender                 string                      `json:"gender" example:"male"`
+	Street                 string                      `json:"street,omitempty" example:"Hauptstraße 1"`
+	SVNR                   string                      `json:"svnr,omitempty" example:"1234150190"`
+	Email                  string                      `json:"email,omitempty" example:"max.muster@example.com"`
+	Phone                  string                      `json:"phone,omitempty" example:"+431234567"`
+	CoInsured              bool                        `json:"co_insured" example:"false"`
+	InsurancePatientDataId string                      `json:"insurance_patient_data_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	OPC                    *PatientDataOPC             `json:"opc,omitempty"`
+	InsurancePatientData   *PatientDataInsuranceDetail `json:"insurance_patient_data,omitempty"`
+	CreatedAt              string                      `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy              string                      `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt              string                      `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy              string                      `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt              string                      `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy              string                      `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type PatientDataResource struct {
+	Type       string                `json:"type" example:"patient_data"`
+	ID         string                `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes PatientDataAttributes `json:"attributes"`
+}
+
+type PatientDataResponse struct {
+	Data PatientDataResource `json:"data"`
+}
+
+type PatientDataListResponse struct {
+	Data []PatientDataResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type PatientDataDataTableResponse struct {
+	Data []PatientDataResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type PatientDataCreateAttributes struct {
+	FamilyName             string  `json:"family_name" validate:"required" example:"Muster"`
+	FirstName              string  `json:"first_name" validate:"required" example:"Max"`
+	OPCId                  *string `json:"opc_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	BirthDate              *string `json:"birth_date,omitempty" example:"1990-01-15"`
+	Gender                 string  `json:"gender" validate:"required,oneof=male female" example:"male"`
+	Street                 *string `json:"street,omitempty" example:"Hauptstraße 1"`
+	SVNR                   *string `json:"svnr,omitempty" example:"1234150190"`
+	Email                  *string `json:"email,omitempty" example:"max.muster@example.com"`
+	Phone                  *string `json:"phone,omitempty" example:"+431234567"`
+	CoInsured              *bool   `json:"co_insured,omitempty" example:"false"`
+	InsurancePatientDataId *string `json:"insurance_patient_data_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type PatientDataCreateData struct {
+	Type       string                      `json:"type" validate:"required,oneof=patient_data_create patient_data" example:"patient_data_create"`
+	Attributes PatientDataCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type PatientDataCreateRequest struct {
+	Data PatientDataCreateData `json:"data" validate:"required"`
+}
+
+type PatientDataUpdateAttributes struct {
+	FamilyName             *string `json:"family_name,omitempty" example:"Muster"`
+	FirstName              *string `json:"first_name,omitempty" example:"Max"`
+	OPCId                  *string `json:"opc_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	BirthDate              *string `json:"birth_date,omitempty" example:"1990-01-15"`
+	Gender                 *string `json:"gender,omitempty" example:"male"`
+	Street                 *string `json:"street,omitempty" example:"Hauptstraße 1"`
+	SVNR                   *string `json:"svnr,omitempty" example:"1234150190"`
+	Email                  *string `json:"email,omitempty" example:"max.muster@example.com"`
+	Phone                  *string `json:"phone,omitempty" example:"+431234567"`
+	CoInsured              *bool   `json:"co_insured,omitempty" example:"false"`
+	InsurancePatientDataId *string `json:"insurance_patient_data_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type PatientDataUpdateData struct {
+	Type       string                      `json:"type" validate:"required,oneof=patient_data_update patient_data" example:"patient_data_update"`
+	ID         string                      `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes PatientDataUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type PatientDataUpdateRequest struct {
+	Data PatientDataUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/action_signoff_request.go

@@ -0,0 +1,27 @@
+package request
+
+// ActionSignoffSignAttributes — optional fields for the sign-off.
+//   - ComplaintID: when set, the sign-off marks that complaint's corrective action as
+//     signed off (the complaint must already have action_taken recorded, else 422).
+//   - When ComplaintID is omitted it is a complaint-independent (fleet) sign-off, which
+//     still allows an EASA release.
+type ActionSignoffSignAttributes struct {
+	// Sign toggles the sign-off: true (or omitted) signs it, false unsigns (clears the
+	// signature). Combine with complaint_id to toggle a specific complaint's sign-off.
+	Sign        *bool   `json:"sign,omitempty" example:"true"`
+	ComplaintID *string `json:"complaint_id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	// FlightID — REQUIRED for the fleet (complaint-independent) sign-off; scopes it to a
+	// flight so it no longer leaks across takeovers of the same aircraft. Ignored when
+	// complaint_id is set (that sign-off is keyed by the complaint).
+	FlightID *string `json:"flight_id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+}
+
+type ActionSignoffSignData struct {
+	Type       string                      `json:"type,omitempty" example:"action_signoff"`
+	Attributes ActionSignoffSignAttributes `json:"attributes"`
+}
+
+// ActionSignoffSignRequest — body is OPTIONAL for the sign endpoint.
+type ActionSignoffSignRequest struct {
+	Data ActionSignoffSignData `json:"data"`
+}

internal/transport/http/dto/request/air_rescuer_checklist_request.go

@@ -0,0 +1,87 @@
+package request
+
+import shareddto "wucher/internal/transport/http/dto/shared"
+
+type AirRescuerChecklistCreateEntry struct {
+	ScopeCode string                                   `json:"scope_code" validate:"required" example:"MO"`
+	Title     string                                   `json:"title" validate:"required" example:"Monday Checklist"`
+	Position  *int                                     `json:"position,omitempty" example:"1"`
+	Items     []shareddto.AirRescuerChecklistItemInput `json:"items,omitempty" validate:"omitempty,dive"`
+}
+
+type AirRescuerChecklistCreateAttributes struct {
+	BaseID     string                           `json:"base_id" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Checklists []AirRescuerChecklistCreateEntry `json:"checklists" validate:"required,min=1,dive"`
+}
+
+type AirRescuerChecklistCreateData struct {
+	Type       string                              `json:"type" validate:"required,oneof=air_rescuer_checklist_create"`
+	Attributes AirRescuerChecklistCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type AirRescuerChecklistCreateRequest struct {
+	Data AirRescuerChecklistCreateData `json:"data" validate:"required"`
+}
+
+type AirRescuerChecklistUpdateAttributes struct {
+	ScopeCode *string                                  `json:"scope_code,omitempty" example:"MO"`
+	Title     *string                                  `json:"title,omitempty" example:"Monday Checklist Updated"`
+	Position  *int                                     `json:"position,omitempty" example:"1"`
+	NewItems  []shareddto.AirRescuerChecklistItemInput `json:"new_items,omitempty" validate:"omitempty,dive"`
+}
+
+type AirRescuerChecklistUpdateData struct {
+	Type       string                              `json:"type" validate:"required,oneof=air_rescuer_checklist_update"`
+	ID         string                              `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes AirRescuerChecklistUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type AirRescuerChecklistUpdateRequest struct {
+	Data AirRescuerChecklistUpdateData `json:"data" validate:"required"`
+}
+
+type AirRescuerChecklistItemCreateAttributes struct {
+	Items []shareddto.AirRescuerChecklistItemInput `json:"items" validate:"required,min=1,dive"`
+}
+
+type AirRescuerChecklistItemCreateData struct {
+	Type       string                                  `json:"type" validate:"required,oneof=air_rescuer_checklist_item_create"`
+	Attributes AirRescuerChecklistItemCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type AirRescuerChecklistItemCreateRequest struct {
+	Data AirRescuerChecklistItemCreateData `json:"data" validate:"required"`
+}
+
+type AirRescuerChecklistItemUpdateAttributes struct {
+	Name     *string `json:"name,omitempty" example:"Check radio"`
+	Position *int    `json:"position,omitempty" example:"2"`
+}
+
+type AirRescuerChecklistItemUpdateData struct {
+	Type       string                                  `json:"type" validate:"required,oneof=air_rescuer_checklist_item_update"`
+	ID         string                                  `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes AirRescuerChecklistItemUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type AirRescuerChecklistItemUpdateRequest struct {
+	Data AirRescuerChecklistItemUpdateData `json:"data" validate:"required"`
+}
+
+type AirRescuerChecklistItemReorderEntry struct {
+	ItemUUID string `json:"item_uuid" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Position *int   `json:"position" validate:"required" example:"2"`
+}
+
+type AirRescuerChecklistItemReorderAttributes struct {
+	Items []AirRescuerChecklistItemReorderEntry `json:"items" validate:"required,min=1,dive"`
+}
+
+type AirRescuerChecklistItemReorderData struct {
+	Type       string                                   `json:"type" validate:"required,oneof=air_rescuer_checklist_item_reorder"`
+	Attributes AirRescuerChecklistItemReorderAttributes `json:"attributes" validate:"required"`
+}
+
+type AirRescuerChecklistItemReorderRequest struct {
+	Data AirRescuerChecklistItemReorderData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/complaint_request.go

@@ -0,0 +1,82 @@
+package request
+
+type ComplaintCreateAttributes struct {
+	// HelicopterID — the helicopter this complaint is filed against. REQUIRED.
+	HelicopterID string `json:"helicopter_id" validate:"required,uuid" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	// FlightID — the flight/report this complaint was filed in (attribution). OPTIONAL;
+	// open-defect tracking stays per-helicopter so defects carry forward across flights.
+	FlightID string `json:"flight_id,omitempty" validate:"omitempty,uuid" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	// Description — the defect description. REQUIRED.
+	Description string `json:"description" validate:"required" example:"Engine 2 N2 vibration intermittent during cruise above 110 KIAS"`
+	// MELSeverity — MEL (Minimum Equipment List) classification. OPTIONAL at creation:
+	// omit it to file the complaint as "pending_mel" and classify later. It MUST be
+	// classified (via update) before recording action taken. A pending complaint does
+	// NOT ground the aircraft — grounding starts at classification. Values: 0 = NON-MEL
+	// (grounds immediately), 1 = A (grace 1 day), 2 = B (3 days), 3 = C (10 days), 4 = D (120 days).
+	MELSeverity *int8 `json:"mel_severity,omitempty" validate:"omitempty,oneof=0 1 2 3 4" enums:"0,1,2,3,4" example:"2"`
+	// AircraftHoursAtReport — OPTIONAL airframe hours recorded when the defect was reported.
+	AircraftHoursAtReport *string `json:"aircraft_hours_at_report,omitempty" example:"1245.3"`
+	// NSR is no longer set here — it is its own flow: POST /complaints/nsr/sign/{id}.
+}
+
+type ComplaintCreateData struct {
+	Type       string                    `json:"type" validate:"required,oneof=complaint_create complaint" example:"complaint_create"`
+	Attributes ComplaintCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type ComplaintCreateRequest struct {
+	Data ComplaintCreateData `json:"data" validate:"required"`
+}
+
+type ComplaintUpdateAttributes struct {
+	// Description — defect description.
+	Description *string `json:"description,omitempty" example:"Engine 2 vibration confirmed"`
+	// MELSeverity — MEL classification. 0 = NON-MEL (immediate AOG), 1 = A (1 day),
+	// 2 = B (3 days), 3 = C (10 days), 4 = D (120 days). AOG after grace passes.
+	MELSeverity *int8 `json:"mel_severity,omitempty" validate:"omitempty,oneof=0 1 2 3 4" enums:"0,1,2,3,4" example:"2"`
+	// AircraftHoursAtReport — airframe hours at report time.
+	AircraftHoursAtReport *string `json:"aircraft_hours_at_report,omitempty" example:"1245.3"`
+	// NSR is no longer set here — it is its own flow: POST /complaints/nsr/sign/{id}.
+}
+
+// ComplaintNSRSignAttributes carries the (optional) justification for a Non-Safety
+// Release decision. NSR is signed via its own endpoint, separate from complaint update.
+type ComplaintNSRSignAttributes struct {
+	// NSRReason — OPTIONAL free-text justification for the NSR (MEL deferral) decision.
+	NSRReason *string `json:"nsr_reason,omitempty" example:"Released under MEL A, defect deferred"`
+}
+
+type ComplaintNSRSignData struct {
+	Type       string                     `json:"type" validate:"omitempty,oneof=complaint_nsr_sign complaint_nsr" example:"complaint_nsr_sign"`
+	Attributes ComplaintNSRSignAttributes `json:"attributes"`
+}
+
+type ComplaintNSRSignRequest struct {
+	Data ComplaintNSRSignData `json:"data"`
+}
+
+type ComplaintUpdateData struct {
+	Type       string                    `json:"type" validate:"required,oneof=complaint_update complaint" example:"complaint_update"`
+	ID         string                    `json:"id" validate:"required" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Attributes ComplaintUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type ComplaintUpdateRequest struct {
+	Data ComplaintUpdateData `json:"data" validate:"required"`
+}
+
+type ComplaintActionTakenAttributes struct {
+	// ActionTaken — corrective action text. Required when recording (create); on update an
+	// empty value clears it (allowed only while the action has not been signed off).
+	ActionTaken        string  `json:"action_taken" example:"Tightened engine mount and rechecked torque"`
+	AircraftHoursAtFix *string `json:"aircraft_hours_at_fix,omitempty" example:"1250.1"`
+}
+
+type ComplaintActionTakenData struct {
+	Type       string                         `json:"type" validate:"required,oneof=complaint_action_taken complaint" example:"complaint_action_taken"`
+	Attributes ComplaintActionTakenAttributes `json:"attributes" validate:"required"`
+}
+
+type ComplaintActionTakenRequest struct {
+	Data ComplaintActionTakenData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/duty_roster_request.go

@@ -0,0 +1,143 @@
+package request
+
+type DutyRosterShiftTime struct {
+	ShiftStart string `json:"shift_start,omitempty" example:"06:00"`
+	ShiftEnd   string `json:"shift_end,omitempty" example:"21:00"`
+}
+
+type DutyRosterShiftDate struct {
+	DateStart string `json:"date_start,omitempty" example:"2026-03-16"`
+	DateEnd   string `json:"date_end,omitempty" example:"2026-03-16"`
+}
+
+type DutyRosterCrewInput struct {
+	ID        string               `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	ShiftDate *DutyRosterShiftDate `json:"shift_date,omitempty"`
+}
+
+type DutyRosterPilotCrewInput struct {
+	ID               string               `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	ShiftDate        *DutyRosterShiftDate `json:"shift_date,omitempty"`
+	FlightInstructor bool                 `json:"flight_instructor,omitempty"`
+	LineChecker      bool                 `json:"line_checker,omitempty"`
+	Supervisor       bool                 `json:"supervisor,omitempty"`
+	Examiner         bool                 `json:"examiner,omitempty"`
+	CoPilot          bool                 `json:"co_pilot,omitempty"`
+	CrewType         string               `json:"crew_type,omitempty" example:"main" enums:"main,additional"`
+}
+
+type DutyRosterOtherPersonInput struct {
+	// OtherPersonID — OPTIONAL master person id to reuse (from GET /contact/other).
+	// When set, name/mobile_phone/email are snapshotted from the master (may be omitted).
+	OtherPersonID string `json:"other_person_id,omitempty" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Name          string `json:"name,omitempty" example:"Guest Person"`
+	MobilePhone   string `json:"mobile_phone,omitempty" example:"+43-1234"`
+	Email         string `json:"email,omitempty" example:"guest@example.com"`
+}
+
+type DutyRosterDetailsInput struct {
+	Pilot       []DutyRosterPilotCrewInput   `json:"pilot"`
+	Doctor      []DutyRosterCrewInput        `json:"doctor"`
+	Rescuer     []DutyRosterCrewInput        `json:"rescuer"`
+	Helper      []DutyRosterCrewInput        `json:"helper"`
+	OtherPerson []DutyRosterOtherPersonInput `json:"other_person"`
+}
+
+type DutyRosterCreateAttributes struct {
+	BaseID    string                 `json:"base_id" validate:"required"`
+	DutyDate  string                 `json:"duty_date" validate:"required"`
+	ShiftTime DutyRosterShiftTime    `json:"shift_time"`
+	Detail    DutyRosterDetailsInput `json:"roster_detail"`
+}
+
+type DutyRosterCreateData struct {
+	Type       string                     `json:"type" validate:"required,oneof=duty_roster_create duty_roster"`
+	Attributes DutyRosterCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type DutyRosterCreateRequest struct {
+	Data DutyRosterCreateData `json:"data" validate:"required"`
+}
+
+type DutyRosterUpdateAttributes struct {
+	BaseID    *string                 `json:"base_id,omitempty"`
+	DutyDate  *string                 `json:"duty_date,omitempty"`
+	ShiftTime *DutyRosterShiftTime    `json:"shift_time,omitempty"`
+	Detail    *DutyRosterDetailsInput `json:"roster_detail,omitempty"`
+}
+
+type DutyRosterUpdateData struct {
+	Type       string                     `json:"type" validate:"required,oneof=duty_roster_update duty_roster"`
+	ID         string                     `json:"id"`
+	Attributes DutyRosterUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type DutyRosterUpdateRequest struct {
+	Data DutyRosterUpdateData `json:"data" validate:"required"`
+}
+
+type DutyRosterDeleteCrewAttributes struct {
+	Detail DutyRosterDetailsInput `json:"roster_detail"`
+}
+
+type DutyRosterDeleteCrewData struct {
+	Type       string                         `json:"type" validate:"required,oneof=duty_roster_crew_delete duty_roster_update duty_roster"`
+	Attributes DutyRosterDeleteCrewAttributes `json:"attributes" validate:"required"`
+}
+
+type DutyRosterDeleteCrewRequest struct {
+	Data DutyRosterDeleteCrewData `json:"data" validate:"required"`
+}
+
+type DutyRosterDeleteCrewByIDAttributes struct {
+	RosterID string `json:"roster_id" validate:"required"`
+	CrewID   string `json:"crew_id" validate:"required"`
+}
+
+type DutyRosterDeleteCrewByIDData struct {
+	Type       string                             `json:"type" validate:"required,oneof=duty_roster_crew_delete duty_roster_update duty_roster"`
+	Attributes DutyRosterDeleteCrewByIDAttributes `json:"attributes" validate:"required"`
+}
+
+type DutyRosterDeleteCrewByIDRequest struct {
+	Data DutyRosterDeleteCrewByIDData `json:"data" validate:"required"`
+}
+
+type DutyRosterAnyDeleteData struct {
+	ID string `json:"id" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type DutyRosterAnyDeleteRequest struct {
+	Data DutyRosterAnyDeleteData `json:"data" validate:"required"`
+}
+
+// DutyRosterAnyCreateRequestDoc is documentation-only schema for cleaner Swagger examples.
+type DutyRosterAnyCreateRequestDoc struct {
+	Data DutyRosterAnyCreateDataDoc `json:"data"`
+}
+
+type DutyRosterAnyCreateDataDoc struct {
+	Type       string                           `json:"type" example:"duty_roster_create" enums:"duty_roster_create,duty_roster"`
+	Attributes DutyRosterAnyCreateAttributesDoc `json:"attributes"`
+}
+
+type DutyRosterAnyCreateAttributesDoc struct {
+	BaseID    string                       `json:"base_id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DutyDate  string                       `json:"duty_date" example:"2026-03-16"`
+	ShiftTime DutyRosterShiftTime          `json:"shift_time"`
+	Detail    DutyRosterAnyCreateDetailDoc `json:"roster_detail"`
+}
+
+type DutyRosterAnyCreateDetailDoc struct {
+	Pilot       []DutyRosterPilotAdditionalExampleDoc `json:"pilot"`
+	Doctor      []DutyRosterCrewInput                 `json:"doctor"`
+	Rescuer     []DutyRosterCrewInput                 `json:"rescuer"`
+	Helper      []DutyRosterCrewInput                 `json:"helper"`
+	OtherPerson []DutyRosterOtherPersonInput          `json:"other_person"`
+}
+
+type DutyRosterPilotAdditionalExampleDoc struct {
+	ID               string `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CrewType         string `json:"crew_type" example:"additional" enums:"main,additional"`
+	FlightInstructor bool   `json:"flight_instructor" example:"true"`
+}

internal/transport/http/dto/request/easa_release_request.go

@@ -0,0 +1,53 @@
+package request
+
+type EASAReleaseCreateAttributes struct {
+	HelicopterID string `json:"helicopter_id" validate:"required,uuid" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	// ComplaintID — OPTIONAL complaint (UUIDv7) this release closes. Set it to scope the
+	// release to a specific defect; leave empty for a standalone (aircraft-clear) release.
+	ComplaintID string `json:"complaint_id,omitempty" validate:"omitempty,uuid" example:"019d6774-1111-7fba-9ef4-3795c0da8a13"`
+	// FlightID — OPTIONAL flight context. Used for the standalone (no-complaint) sign-off gate.
+	FlightID                   string  `json:"flight_id,omitempty" validate:"omitempty,uuid" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	EASADate                   *string `json:"easa_date,omitempty" example:"2026-06-16"`
+	EASAACHours                *string `json:"easa_ac_hours,omitempty" example:"1245.3"`
+	EASALocation               *string `json:"easa_location,omitempty" example:"LOWI"`
+	EASAWONo                   *string `json:"easa_wo_no,omitempty" example:"WO-2026-001"`
+	EASAMaintManualRevAirframe *string `json:"easa_maint_manual_rev_airframe,omitempty" example:"Rev 12"`
+	EASAMaintManualRevEngine   *string `json:"easa_maint_manual_rev_engine,omitempty" example:"Rev 8"`
+	// EASASignerID — OPTIONAL contact id (UUIDv7) of the signer/technician. Required only to sign.
+	EASASignerID *string `json:"easa_signer_id,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	EASAPermitNo *string `json:"easa_permit_no,omitempty" example:"145.A.50"`
+	// Sign, when true, signs the release immediately at creation. Requires all
+	// required fields to be present; otherwise the request is rejected.
+	Sign bool `json:"sign,omitempty" example:"false"`
+}
+
+type EASAReleaseCreateData struct {
+	Type       string                      `json:"type" validate:"required,oneof=easa_release_create easa_release" example:"easa_release_create"`
+	Attributes EASAReleaseCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type EASAReleaseCreateRequest struct {
+	Data EASAReleaseCreateData `json:"data" validate:"required"`
+}
+
+type EASAReleaseUpdateAttributes struct {
+	EASADate                   *string `json:"easa_date,omitempty" example:"2026-06-16"`
+	EASAACHours                *string `json:"easa_ac_hours,omitempty" example:"1245.3"`
+	EASALocation               *string `json:"easa_location,omitempty" example:"LOWI"`
+	EASAWONo                   *string `json:"easa_wo_no,omitempty" example:"WO-2026-001"`
+	EASAMaintManualRevAirframe *string `json:"easa_maint_manual_rev_airframe,omitempty" example:"Rev 12"`
+	EASAMaintManualRevEngine   *string `json:"easa_maint_manual_rev_engine,omitempty" example:"Rev 8"`
+	// EASASignerID — OPTIONAL contact id (UUIDv7) of the signer/technician. Required only to sign.
+	EASASignerID *string `json:"easa_signer_id,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	EASAPermitNo *string `json:"easa_permit_no,omitempty" example:"145.A.50"`
+}
+
+type EASAReleaseUpdateData struct {
+	Type       string                      `json:"type" validate:"required,oneof=easa_release_update easa_release" example:"easa_release_update"`
+	ID         string                      `json:"id" validate:"required" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Attributes EASAReleaseUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type EASAReleaseUpdateRequest struct {
+	Data EASAReleaseUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/file_manager_attachment_request.go

@@ -0,0 +1,19 @@
+package request
+
+type FileManagerAttachmentCreateAttributes struct {
+	FileID    string  `json:"file_id" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	RefType   string  `json:"ref_type" validate:"required" example:"helicopter"`
+	RefID     string  `json:"ref_id" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Category  *string `json:"category,omitempty" example:"document"`
+	SortOrder *int    `json:"sort_order,omitempty" example:"0"`
+	IsPrimary *bool   `json:"is_primary,omitempty" example:"false"`
+}
+
+type FileManagerAttachmentCreateData struct {
+	Type       string                                `json:"type" validate:"required,oneof=file_manager_attachment_create file_manager_attachment" example:"file_manager_attachment_create"`
+	Attributes FileManagerAttachmentCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FileManagerAttachmentCreateRequest struct {
+	Data FileManagerAttachmentCreateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/file_manager_file_request.go

@@ -0,0 +1,197 @@
+package request
+
+type FileManagerFileCreateAttributes struct {
+	UploadIntentUUID string  `json:"upload_intent_uuid" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FolderID         *string `json:"folder_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name             string  `json:"name" validate:"required" example:"policy-final.pdf"`
+}
+
+type FileManagerFileUploadIntentAttributes struct {
+	Name        string `json:"name" validate:"required" example:"policy-final.pdf"`
+	ContentType string `json:"content_type" validate:"required" example:"application/pdf"`
+	SizeBytes   int64  `json:"size_bytes" validate:"required,gte=0" example:"1024"`
+}
+
+type FileManagerFileUploadIntentData struct {
+	Type       string                                `json:"type" validate:"required,oneof=file_manager_file_upload_intent" example:"file_manager_file_upload_intent"`
+	Attributes FileManagerFileUploadIntentAttributes `json:"attributes" validate:"required"`
+}
+
+type FileManagerFileUploadIntentRequest struct {
+	Data FileManagerFileUploadIntentData `json:"data" validate:"required"`
+}
+
+type FileManagerFileUploadIntentBulkRequest struct {
+	Data []FileManagerFileUploadIntentData `json:"data" validate:"required,min=1"`
+}
+
+type FileManagerFileCancelUploadAttributes struct {
+	UploadIntentUUID string `json:"upload_intent_uuid" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type FileManagerFileCancelUploadData struct {
+	Type       string                                `json:"type" validate:"required,oneof=file_manager_file_cancel_upload" example:"file_manager_file_cancel_upload"`
+	Attributes FileManagerFileCancelUploadAttributes `json:"attributes" validate:"required"`
+}
+
+type FileManagerFileCancelUploadBulkRequest struct {
+	Data []FileManagerFileCancelUploadData `json:"data" validate:"required,min=1"`
+}
+
+type FileManagerFileUploadCompleteAttributes struct {
+	UploadIntentUUID string `json:"upload_intent_uuid" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type FileManagerFileUploadCompleteData struct {
+	Type       string                                  `json:"type" validate:"required,oneof=file_manager_file_upload_complete" example:"file_manager_file_upload_complete"`
+	Attributes FileManagerFileUploadCompleteAttributes `json:"attributes" validate:"required"`
+}
+
+type FileManagerFileUploadCompleteRequest struct {
+	Data FileManagerFileUploadCompleteData `json:"data" validate:"required"`
+}
+
+type FileManagerFileCreateData struct {
+	Type       string                          `json:"type" validate:"required,oneof=file_manager_file_create file_manager_file" example:"file_manager_file_create"`
+	Attributes FileManagerFileCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FileManagerFileCreateRequest struct {
+	Data FileManagerFileCreateData `json:"data" validate:"required"`
+}
+
+// FileManagerFileCreateFlexibleRequest is used for swagger documentation.
+// Runtime accepts:
+// - single: {"data": { ...FileManagerFileCreateData }}
+// - bulk:   {"data": [ ...FileManagerFileBulkCreateItem ]}
+type FileManagerFileCreateFlexibleRequest struct {
+	Data interface{} `json:"data"`
+}
+
+type FileManagerFileBulkCreateItem struct {
+	Type       string                          `json:"type" validate:"required,oneof=file_manager_file_create file_manager_file" example:"file_manager_file_create"`
+	Attributes FileManagerFileCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FileManagerFileBulkCreateRequest struct {
+	Data []FileManagerFileBulkCreateItem `json:"data" validate:"required,min=1"`
+}
+
+type FileManagerFileUserCreateAttributes struct {
+	UploadIntentUUID string `json:"upload_intent_uuid" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UserUUID         string `json:"user_uuid" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name             string `json:"name" validate:"required" example:"profile.jpg"`
+}
+
+type FileManagerFileUserBulkCreateItem struct {
+	Type       string                              `json:"type" validate:"required,oneof=file_manager_file_create file_manager_file" example:"file_manager_file_create"`
+	Attributes FileManagerFileUserCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FileManagerFileUserBulkCreateRequest struct {
+	Data []FileManagerFileUserBulkCreateItem `json:"data" validate:"required,min=1"`
+}
+
+type FileManagerFileAircraftCreateAttributes struct {
+	UploadIntentUUID string `json:"upload_intent_uuid" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	AircraftUUID     string `json:"aircraft_uuid" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name             string `json:"name" validate:"required" example:"aircraft.jpg"`
+}
+
+type FileManagerFileAircraftBulkCreateItem struct {
+	Type       string                                  `json:"type" validate:"required,oneof=file_manager_file_create file_manager_file" example:"file_manager_file_create"`
+	Attributes FileManagerFileAircraftCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FileManagerFileAircraftBulkCreateRequest struct {
+	Data []FileManagerFileAircraftBulkCreateItem `json:"data" validate:"required,min=1"`
+}
+
+type FileManagerFileBaseCreateAttributes struct {
+	UploadIntentUUID string `json:"upload_intent_uuid" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	BaseUUID         string `json:"base_uuid" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name             string `json:"name" validate:"required" example:"base.jpg"`
+}
+
+type FileManagerFileBaseBulkCreateItem struct {
+	Type       string                              `json:"type" validate:"required,oneof=file_manager_file_create file_manager_file" example:"file_manager_file_create"`
+	Attributes FileManagerFileBaseCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FileManagerFileBaseBulkCreateRequest struct {
+	Data []FileManagerFileBaseBulkCreateItem `json:"data" validate:"required,min=1"`
+}
+
+type FileManagerFileDULCreateAttributes struct {
+	UploadIntentUUID string `json:"upload_intent_uuid" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DULUUID          string `json:"dul_uuid,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name             string `json:"name" validate:"required" example:"dul.jpg"`
+}
+
+type FileManagerFileDULBulkCreateItem struct {
+	Type       string                             `json:"type" validate:"required,oneof=file_manager_file_create file_manager_file" example:"file_manager_file_create"`
+	Attributes FileManagerFileDULCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FileManagerFileDULBulkCreateRequest struct {
+	Data []FileManagerFileDULBulkCreateItem `json:"data" validate:"required,min=1"`
+}
+
+type FileManagerFileTakeoverCreateAttributes struct {
+	UploadIntentUUID string `json:"upload_intent_uuid" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	TakeoverUUID     string `json:"takeover_uuid,omitempty" example:"019e8713-aa19-7fb7-a510-a0332dc69697"`
+	Name             string `json:"name" validate:"required" example:"takeover-report.pdf"`
+}
+
+type FileManagerFileTakeoverBulkCreateItem struct {
+	Type       string                                  `json:"type" validate:"required,oneof=file_manager_file_create file_manager_file" example:"file_manager_file_create"`
+	Attributes FileManagerFileTakeoverCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FileManagerFileTakeoverBulkCreateRequest struct {
+	Data []FileManagerFileTakeoverBulkCreateItem `json:"data" validate:"required,min=1"`
+}
+
+type FileManagerFileTemplateCreateAttributes struct {
+	TemplateUUID string `json:"template_uuid" validate:"required" example:"019f0386-0a00-7a4a-a2d8-30afc0e0c3ad"`
+	HelicopterID string `json:"helicopter_id" validate:"required" example:"019e8713-aa19-7fb7-a510-a0332dc69697"`
+	TakeoverID   string `json:"takeover_id,omitempty" example:"019e8713-aa19-7fb7-a510-a0332dc69697"`
+	Name         string `json:"name" validate:"required" example:"collabora-draft.docx"`
+}
+
+type FileManagerFileTemplateCreateRequest struct {
+	Data struct {
+		Type       string                                  `json:"type" validate:"required,oneof=file_manager_file_create_from_template file_manager_file_create"`
+		Attributes FileManagerFileTemplateCreateAttributes `json:"attributes" validate:"required"`
+	} `json:"data" validate:"required"`
+}
+
+type FileManagerFileMissionCreateAttributes struct {
+	UploadIntentUUID string `json:"upload_intent_uuid" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	MissionUUID      string `json:"mission_uuid" validate:"required" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	Name             string `json:"name" validate:"required" example:"mission-brief.pdf"`
+}
+
+type FileManagerFileMissionBulkCreateItem struct {
+	Type       string                                 `json:"type" validate:"required,oneof=file_manager_file_create file_manager_file" example:"file_manager_file_create"`
+	Attributes FileManagerFileMissionCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FileManagerFileMissionBulkCreateRequest struct {
+	Data []FileManagerFileMissionBulkCreateItem `json:"data" validate:"required,min=1"`
+}
+
+type FileManagerFileUpdateAttributes struct {
+	FolderID *string `json:"folder_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name     *string `json:"name,omitempty" example:"policy-v2.pdf"`
+}
+
+type FileManagerFileUpdateData struct {
+	Type       string                          `json:"type" validate:"required,oneof=file_manager_file_update file_manager_file" example:"file_manager_file_update"`
+	ID         string                          `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes FileManagerFileUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type FileManagerFileUpdateRequest struct {
+	Data FileManagerFileUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/file_manager_folder_request.go

@@ -0,0 +1,47 @@
+package request
+
+type FileManagerFolderCreateAttributes struct {
+	ParentID *string `json:"parent_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name     string  `json:"name" validate:"required" example:"operations"`
+}
+
+type FileManagerFolderCreateData struct {
+	Type       string                            `json:"type" validate:"required,oneof=file_manager_folder_create file_manager_folder" example:"file_manager_folder_create"`
+	Attributes FileManagerFolderCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FileManagerFolderCreateRequest struct {
+	Data FileManagerFolderCreateData `json:"data" validate:"required"`
+}
+
+type FileManagerFolderUpdateAttributes struct {
+	Name     *string `json:"name,omitempty" example:"operations-updated"`
+	ParentID *string `json:"parent_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type FileManagerFolderUpdateData struct {
+	Type       string                            `json:"type" validate:"required,oneof=file_manager_folder_update file_manager_folder" example:"file_manager_folder_update"`
+	ID         string                            `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes FileManagerFolderUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type FileManagerFolderUpdateRequest struct {
+	Data FileManagerFolderUpdateData `json:"data" validate:"required"`
+}
+
+type FileManagerNodeMoveItem struct {
+	UUID                  string  `json:"uuid" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DestinationFolderUUID *string `json:"destination_folder_uuid" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type FileManagerNodeMoveBulkRequest struct {
+	Data []FileManagerNodeMoveItem `json:"data" validate:"required,min=1"`
+}
+
+type FileManagerNodePurgeItem struct {
+	UUID string `json:"uuid" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type FileManagerNodePurgeBulkRequest struct {
+	Data []FileManagerNodePurgeItem `json:"data" validate:"required,min=1"`
+}

internal/transport/http/dto/request/file_manager_restore_request.go

@@ -0,0 +1,13 @@
+package request
+
+type FileManagerRestoreTargetAttributes struct {
+	TargetFolderID *string `json:"target_folder_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type FileManagerRestoreTargetData struct {
+	Attributes FileManagerRestoreTargetAttributes `json:"attributes"`
+}
+
+type FileManagerRestoreTargetRequest struct {
+	Data *FileManagerRestoreTargetData `json:"data,omitempty"`
+}

internal/transport/http/dto/request/fleet_status_request.go

@@ -0,0 +1,70 @@
+package request
+
+import shared "wucher/internal/transport/http/dto/shared"
+
+type FleetStatusMarkServicedAttributes struct {
+	ServicedAt string `json:"serviced_at,omitempty" example:"2026-05-29T07:43:06Z"`
+}
+
+type FleetStatusMarkServicedData struct {
+	Type       string                            `json:"type" validate:"required,oneof=fleet_status_mark_serviced fleet_status" example:"fleet_status_mark_serviced"`
+	Attributes FleetStatusMarkServicedAttributes `json:"attributes"`
+}
+
+type FleetStatusMarkServicedRequest struct {
+	Data FleetStatusMarkServicedData `json:"data" validate:"required"`
+}
+
+type FleetStatusCreateAttributes struct {
+	HelicopterID         string                                 `json:"helicopter_id" validate:"required" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	MaintenanceSchedules []shared.MaintenanceScheduleAttributes `json:"maintenance_schedules" validate:"omitempty,dive"`
+	Files                []shared.FleetStatusFileAttributes     `json:"files"`
+}
+
+type FleetStatusCreateData struct {
+	Type       string                      `json:"type" validate:"required,oneof=fleet_status_create fleet_status" example:"fleet_status_create"`
+	Attributes FleetStatusCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FleetStatusCreateRequest struct {
+	Data FleetStatusCreateData `json:"data" validate:"required"`
+}
+
+type FleetStatusUpdateAttributes struct {
+	HelicopterID         *string                                `json:"helicopter_id,omitempty"`
+	MaintenanceSchedules []shared.MaintenanceScheduleAttributes `json:"maintenance_schedules" validate:"omitempty,dive"`
+	Files                []shared.FleetStatusFileAttributes     `json:"files"`
+	Summary              *FleetStatusSummaryUpdate              `json:"summary,omitempty"`
+}
+
+type FleetStatusSummaryUpdate struct {
+	Airframe         *FleetStatusSummaryAirframeUpdate `json:"airframe,omitempty"`
+	Engine1          *FleetStatusSummaryEngineUpdate   `json:"engine_1,omitempty"`
+	Engine2          *FleetStatusSummaryEngineUpdate   `json:"engine_2,omitempty"`
+	Landings         *float64                          `json:"landings,omitempty" example:"120"`
+	FlightReports    *float64                          `json:"flight_reports,omitempty" example:"80"`
+	RotorBrakeCycles *float64                          `json:"rotor_brake_cycles,omitempty" example:"8"`
+	HookReleases     *float64                          `json:"hook_releases,omitempty" example:"10"`
+}
+
+type FleetStatusSummaryAirframeUpdate struct {
+	Hours  *float64 `json:"hours,omitempty" example:"6610.5"`
+	Cycles *float64 `json:"cycles,omitempty" example:"320"`
+}
+
+type FleetStatusSummaryEngineUpdate struct {
+	Hours   *float64 `json:"hours,omitempty" example:"8001.7"`
+	GpcNgN1 *float64 `json:"gpc_ng_n1,omitempty" example:"98.7"`
+	PtcNfN2 *float64 `json:"ptc_nf_n2,omitempty" example:"97.2"`
+	Ccc     *float64 `json:"ccc,omitempty" example:"44"`
+}
+
+type FleetStatusUpdateData struct {
+	Type       string                      `json:"type" validate:"required,oneof=fleet_status_update fleet_status" example:"fleet_status_update"`
+	ID         string                      `json:"id" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	Attributes FleetStatusUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type FleetStatusUpdateRequest struct {
+	Data FleetStatusUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/flight_data_request.go

@@ -0,0 +1,135 @@
+package request
+
+type FlightDataCreateAttributes struct {
+	MissionID            string                                `json:"mission_id" validate:"required"`
+	CoPilotID            *string                               `json:"co_pilot_id,omitempty"`
+	FromICAOID           *string                               `json:"from_icao_id,omitempty"`
+	FromHospitalID       *string                               `json:"from_hospital_id,omitempty"`
+	ToICAOID             *string                               `json:"to_icao_id,omitempty"`
+	ToHospitalID         *string                               `json:"to_hospital_id,omitempty"`
+	FlightTakeOff        *string                               `json:"flight_take_off,omitempty"`
+	FlightLanding        *string                               `json:"flight_landing,omitempty"`
+	FlightDurationSecs   *int64                                `json:"flight_duration_seconds,omitempty"`
+	FlightREDSecs        *int64                                `json:"flight_red_seconds,omitempty"`
+	MaxN1                *float64                              `json:"max_n1,omitempty"`
+	MaxN2                *float64                              `json:"max_n2,omitempty"`
+	PaxCount             *int                                  `json:"pax_count,omitempty"`
+	LandingCount         *int                                  `json:"landing_count,omitempty"`
+	RotorBrakeCycle      *int                                  `json:"rotor_brake_cycle,omitempty"`
+	HookReleases         *int                                  `json:"hook_releases,omitempty"`
+	TicketNo             *string                               `json:"ticket_no,omitempty"`
+	Engine               *string                               `json:"engine,omitempty"`
+	DeliveryNoteNumber   *string                               `json:"delivery_note_number,omitempty"`
+	CustomerName         *string                               `json:"customer_name,omitempty"`
+	FlightPlanDistance   *float64                              `json:"flight_plan_distance,omitempty"`
+	FlightPlanTimeSecs   *int64                                `json:"flight_plan_time_seconds,omitempty"`
+	FlightPlanTrueCourse *float64                              `json:"flight_plan_true_course,omitempty"`
+	FuelBeforeFlight     *float64                              `json:"fuel_before_flight,omitempty"`
+	FuelUpload           *float64                              `json:"fuel_upload,omitempty"`
+	FuelAfterFlight      *float64                              `json:"fuel_after_flight,omitempty"`
+	FuelPlanning         *float64                              `json:"fuel_planning,omitempty"`
+	FlightPositioning    *bool                                 `json:"flight_positioning,omitempty" example:"false"`
+	HESLO                *FlightDataCreateSPOHESLOAttributes   `json:"heslo,omitempty"`
+	Logging              *FlightDataCreateSPOLoggingAttributes `json:"logging,omitempty"`
+	HEC                  *FlightDataCreateSPOHECAttributes     `json:"hec,omitempty"`
+	OtherInformation     *string                               `json:"other_information,omitempty"`
+}
+
+type FlightDataCreateSPOHESLOAttributes struct {
+	Flights []FlightDataCreateSPOHESLOFlight `json:"flights,omitempty"`
+}
+
+type FlightDataCreateSPOHESLOFlight struct {
+	ROT int `json:"rot" example:"0"`
+	// Facility category: heslo-rope-label.
+	HESLORopeLabelID   string `json:"heslo_rope_label_id,omitempty" example:"string"`
+	HESLORopeLabelName string `json:"heslo_rope_label_name,omitempty" example:"string"`
+	// Facility category: heslo-rope-length.
+	Slings []FlightDataCreateSPOHESLOSling `json:"slings,omitempty"`
+}
+
+type FlightDataCreateSPOHESLOSling struct {
+	// Facility category: heslo-rope-length.
+	SlingID   string `json:"sling_id,omitempty" example:"string"`
+	SlingName string `json:"sling_name,omitempty" example:"string"`
+}
+
+type FlightDataCreateSPOLoggingAttributes struct {
+	Slings []FlightDataCreateSPOLoggingSling `json:"slings,omitempty"`
+}
+
+type FlightDataCreateSPOLoggingSling struct {
+	// Facility category: heslo-hook.
+	SlingID   string `json:"sling_id,omitempty" example:"string"`
+	SlingName string `json:"sling_name,omitempty" example:"string"`
+}
+
+type FlightDataCreateSPOHECAttributes struct {
+	Flights []FlightDataCreateSPOHECFlight `json:"flights,omitempty"`
+	Loads   []FlightDataCreateSPOHECLoad   `json:"loads,omitempty"`
+	Slings  []FlightDataCreateSPOHECSling  `json:"slings,omitempty"`
+}
+
+type FlightDataCreateSPOHECFlight struct {
+	// Facility category: hec-rope-label.
+	EquipmentID   string `json:"equipment_id,omitempty" example:"string"`
+	EquipmentName string `json:"equipment_name,omitempty" example:"string"`
+	HECCycle      int    `json:"hec_cycle" example:"0"`
+	ROT           int    `json:"rot" example:"0"`
+}
+
+type FlightDataCreateSPOHECLoad struct {
+	// Weight band for the HEC load, e.g. "bis 199 kg", "200-600 kg", "600-800 kg", "800-1000 kg".
+	LoadCategory string `json:"load_category,omitempty" example:"200-600 kg"`
+	Quantity     int    `json:"quantity" example:"3"`
+}
+
+type FlightDataCreateSPOHECSling struct {
+	// Facility category: hec-rope-length.
+	SlingID   string `json:"sling_id,omitempty" example:"string"`
+	SlingName string `json:"sling_name,omitempty" example:"string"`
+}
+
+type FlightDataCreateData struct {
+	Type       string                     `json:"type" validate:"required,oneof=flight_data_create flight_data" example:"flight_data_create"`
+	Attributes FlightDataCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FlightDataCreateRequest struct {
+	Data FlightDataCreateData `json:"data" validate:"required"`
+}
+
+type FlightDataUpdateData struct {
+	Type       string                     `json:"type" validate:"required,oneof=flight_data_update" example:"flight_data_update"`
+	Attributes FlightDataCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FlightDataUpdateRequest struct {
+	Data FlightDataUpdateData `json:"data" validate:"required"`
+}
+
+// FlightDataCreateSPOExampleRequest is used only for Swagger examples.
+// Runtime parsing still uses FlightDataCreateRequest.
+type FlightDataCreateSPOExampleRequest struct {
+	Data FlightDataCreateSPOExampleData `json:"data"`
+}
+
+type FlightDataCreateSPOExampleData struct {
+	Type       string                               `json:"type" example:"flight_data_create"`
+	Attributes FlightDataCreateSPOExampleAttributes `json:"attributes"`
+}
+
+type FlightDataCreateSPOExampleAttributes struct {
+	MissionID          string `json:"mission_id" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	CoPilotID          string `json:"co_pilot_id,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	FlightTakeOff      string `json:"flight_take_off,omitempty" example:"2026-04-20T08:00:00Z"`
+	FlightLanding      string `json:"flight_landing,omitempty" example:"2026-04-20T09:15:00Z"`
+	FromICAOID         string `json:"from_icao_id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	ToICAOID           string `json:"to_icao_id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	HookReleases       int    `json:"hook_releases,omitempty" example:"0"`
+	TicketNo           string `json:"ticket_no,omitempty" example:"SPO-001"`
+	Engine             string `json:"engine,omitempty" example:"AIRBUS H145"`
+	DeliveryNoteNumber string `json:"delivery_note_number,omitempty" example:"DN-2026-0001"`
+	CustomerName       string `json:"customer_name,omitempty" example:"Patient Transfer"`
+	OtherInformation   string `json:"other_information,omitempty" example:"SPO mission sample"`
+}

internal/transport/http/dto/request/flight_inspection_file_checklist_request.go

@@ -0,0 +1,32 @@
+package request
+
+type FlightInspectionFileChecklistCreateAttributes struct {
+	IsDone             *bool  `json:"is_done,omitempty" example:"false"`
+	HelicopterFileID   string `json:"helicopter_file_id" validate:"required" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	FlightInspectionID string `json:"flight_inspection_id" validate:"required" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+}
+
+type FlightInspectionFileChecklistCreateData struct {
+	Type       string                                        `json:"type" validate:"required,oneof=flight_inspection_file_checklist_create flight_inspection_file_checklist" example:"flight_inspection_file_checklist_create"`
+	Attributes FlightInspectionFileChecklistCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FlightInspectionFileChecklistCreateRequest struct {
+	Data FlightInspectionFileChecklistCreateData `json:"data" validate:"required"`
+}
+
+type FlightInspectionFileChecklistUpdateAttributes struct {
+	IsDone             *bool   `json:"is_done,omitempty" example:"true"`
+	HelicopterFileID   *string `json:"helicopter_file_id,omitempty" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	FlightInspectionID *string `json:"flight_inspection_id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+}
+
+type FlightInspectionFileChecklistUpdateData struct {
+	Type       string                                        `json:"type" validate:"required,oneof=flight_inspection_file_checklist_update flight_inspection_file_checklist" example:"flight_inspection_file_checklist_update"`
+	ID         string                                        `json:"id" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	Attributes FlightInspectionFileChecklistUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type FlightInspectionFileChecklistUpdateRequest struct {
+	Data FlightInspectionFileChecklistUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/flight_request.go

@@ -0,0 +1,32 @@
+package request
+
+type FlightCreateAttributes struct {
+	Date         string  `json:"date" validate:"required" example:"2026-04-14"`
+	DutyRosterID *string `json:"duty_roster_id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	ReserveAcID  *string `json:"reserve_ac_id,omitempty" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+}
+
+type FlightCreateData struct {
+	Type       string                 `json:"type" validate:"required,oneof=flight_create flight" example:"flight_create"`
+	Attributes FlightCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type FlightCreateRequest struct {
+	Data FlightCreateData `json:"data" validate:"required"`
+}
+
+type FlightUpdateAttributes struct {
+	Date         *string `json:"date,omitempty" example:"2026-04-14"`
+	DutyRosterID *string `json:"duty_roster_id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	ReserveAcID  *string `json:"reserve_ac_id,omitempty" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+}
+
+type FlightUpdateData struct {
+	Type       string                 `json:"type" validate:"required,oneof=flight_update flight" example:"flight_update"`
+	ID         string                 `json:"id" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	Attributes FlightUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type FlightUpdateRequest struct {
+	Data FlightUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/fm_report_request.go

@@ -0,0 +1,21 @@
+package request
+
+type FMReportUpdateAttributes struct {
+	// Engine1GpcN1 - GPC/N1 value for engine 1. Optional.
+	Engine1GpcN1 *string `json:"engine1_gpc_n1,omitempty" example:"GPC/N1 63.2"`
+	// Engine1PtcN2 - PTC/N2 value for engine 1. Optional.
+	Engine1PtcN2 *string `json:"engine1_ptc_n2,omitempty" example:"PTC/N2 61.8"`
+	// Engine2GpcN1 - GPC/N1 value for engine 2. Optional.
+	Engine2GpcN1 *string `json:"engine2_gpc_n1,omitempty" example:"GPC/N1 63.2"`
+	// Engine2PtcN2 - PTC/N2 value for engine 2. Optional.
+	Engine2PtcN2 *string `json:"engine2_ptc_n2,omitempty" example:"PTC/N2 61.8"`
+}
+
+type FMReportUpdateData struct {
+	Type       string                   `json:"type" validate:"required,oneof=fm_report_update fm_report" example:"fm_report_update"`
+	Attributes FMReportUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type FMReportUpdateRequest struct {
+	Data FMReportUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/helicopter_file_request.go

@@ -0,0 +1,87 @@
+package request
+
+type HelicopterFileCreateAttributes struct {
+	Section          string  `json:"section" validate:"required,oneof=bfi fpwb afi" enums:"bfi,fpwb,afi" example:"bfi"`
+	Position         *int    `json:"position,omitempty" example:"1"`
+	IsMandatory     *bool   `json:"is_mandatory,omitempty" example:"true"`
+	HelicopterID     string  `json:"helicopter_id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	UploadIntentUUID string  `json:"upload_intent_uuid" validate:"required" example:"019d6d0d-2de2-7db1-80a2-2862d43af620"`
+	FileName         string  `json:"file_name" validate:"required" example:"Before Flight Checklist.pdf"`
+	FolderUUID       *string `json:"folder_uuid,omitempty" example:"019d6d0d-8c24-72e3-9f58-c9ea0fbf0bb1"`
+}
+
+type HelicopterFileUploadAttributes struct {
+	Name        string `json:"name" validate:"required" example:"Before Flight Checklist.pdf"`
+	ContentType string `json:"content_type" validate:"required" example:"application/pdf"`
+	SizeBytes   int64  `json:"size_bytes" validate:"required,gte=0" example:"1024"`
+}
+
+type HelicopterFileUploadData struct {
+	Type       string                         `json:"type" validate:"required,oneof=helicopter_file_upload" example:"helicopter_file_upload"`
+	Attributes HelicopterFileUploadAttributes `json:"attributes" validate:"required"`
+}
+
+type HelicopterFileUploadRequest struct {
+	Data HelicopterFileUploadData `json:"data" validate:"required"`
+}
+
+type HelicopterFileUploadBulkRequest struct {
+	Data []HelicopterFileUploadData `json:"data" validate:"required,min=1"`
+}
+
+type HelicopterFileCancelUploadAttributes struct {
+	UploadIntentUUID string `json:"upload_intent_uuid" validate:"required" example:"019d6d0d-2de2-7db1-80a2-2862d43af620"`
+}
+
+type HelicopterFileCancelUploadData struct {
+	Type       string                               `json:"type" validate:"required,oneof=helicopter_file_cancel_upload" example:"helicopter_file_cancel_upload"`
+	Attributes HelicopterFileCancelUploadAttributes `json:"attributes" validate:"required"`
+}
+
+type HelicopterFileCancelUploadBulkRequest struct {
+	Data []HelicopterFileCancelUploadData `json:"data" validate:"required,min=1"`
+}
+
+type HelicopterFileCreateData struct {
+	Type       string                         `json:"type" validate:"required,oneof=helicopter_file_create helicopter_file" example:"helicopter_file_create"`
+	Attributes HelicopterFileCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type HelicopterFileCreateRequest struct {
+	Data HelicopterFileCreateData `json:"data" validate:"required"`
+}
+
+type HelicopterFileCreateBulkRequest struct {
+	Data []HelicopterFileCreateData `json:"data" validate:"required,min=1"`
+}
+
+type HelicopterFileUpdateAttributes struct {
+	Section      *string `json:"section,omitempty" validate:"omitempty,oneof=bfi fpwb afi" enums:"bfi,fpwb,afi" example:"fpwb"`
+	Position     *int    `json:"position,omitempty" example:"1"`
+	IsMandatory *bool   `json:"is_mandatory,omitempty" example:"true"`
+	HelicopterID *string `json:"helicopter_id,omitempty" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	FileName     *string `json:"file_name,omitempty" example:"Before Flight Checklist v2.pdf"`
+}
+
+type HelicopterFileUpdateData struct {
+	Type       string                         `json:"type" validate:"required,oneof=helicopter_file_update helicopter_file" example:"helicopter_file_update"`
+	ID         string                         `json:"id" validate:"required" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	Attributes HelicopterFileUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type HelicopterFileUpdateRequest struct {
+	Data HelicopterFileUpdateData `json:"data" validate:"required"`
+}
+
+type HelicopterFileUpdateBulkRequest struct {
+	Data []HelicopterFileUpdateData `json:"data" validate:"required,min=1"`
+}
+
+type HelicopterFileDeleteData struct {
+	Type string `json:"type" validate:"required,oneof=helicopter_file_delete helicopter_file" example:"helicopter_file_delete"`
+	ID   string `json:"id" validate:"required" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+}
+
+type HelicopterFileDeleteRequest struct {
+	Data HelicopterFileDeleteData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/helicopter_request.go

@@ -0,0 +1,70 @@
+package request
+
+import "wucher/internal/transport/http/dto"
+
+type HelicopterCreateAttributes struct {
+	Designation string   `json:"designation" validate:"required" example:"OE-XHZ"`
+	Identifier  string   `json:"identifier" validate:"required" example:"ABC"`
+	Type        string   `json:"type" validate:"required" example:"EC-135"`
+	SortKey     *int     `json:"sortkey" example:"10"`
+	Engine1     *string  `json:"engine_1,omitempty" example:"TM"`
+	Engine2     *string  `json:"engine_2,omitempty" example:"TM"`
+	Consumption *float64 `json:"consumption_lt_min,omitempty" example:"4.1"`
+	NR1         *bool    `json:"nr1,omitempty" example:"true"`
+	NR2         *bool    `json:"nr2,omitempty" example:"true"`
+	LH          *bool    `json:"lh,omitempty" example:"true"`
+	RH          *bool    `json:"rh,omitempty" example:"true"`
+	MGB         *bool    `json:"mgb,omitempty" example:"true"`
+	IGB         *bool    `json:"igb,omitempty" example:"false"`
+	TGB         *bool    `json:"tgb,omitempty" example:"true"`
+	UTCOffset   *int     `json:"utc_offset,omitempty" example:"-1"`
+	FileUUID    *string  `json:"file_uuid,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e90"`
+	Dry         *bool    `json:"dry,omitempty" example:"false"`
+	AOG         *bool    `json:"aog,omitempty" example:"false"`
+	AOGReason   *string  `json:"aog_reason,omitempty" example:"Main rotor gearbox fault"`
+	Note        *string  `json:"note,omitempty" example:"Primary HEMS helicopter"`
+	IsActive    *bool    `json:"is_active,omitempty" example:"true"`
+}
+
+type HelicopterCreateData struct {
+	Type       string                     `json:"type" validate:"required,oneof=helicopter_create helicopter" example:"helicopter_create"`
+	Attributes HelicopterCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type HelicopterCreateRequest struct {
+	Data HelicopterCreateData `json:"data" validate:"required"`
+}
+
+type HelicopterUpdateAttributes struct {
+	Designation *string     `json:"designation,omitempty" example:"OE-XHZ"`
+	Identifier  *string     `json:"identifier,omitempty" example:"ABC"`
+	Type        *string     `json:"type,omitempty" example:"EC-135"`
+	SortKey     dto.NullInt `json:"sortkey,omitempty" swaggertype:"integer" example:"10"`
+	Engine1     *string     `json:"engine_1,omitempty" example:"TM"`
+	Engine2     *string     `json:"engine_2,omitempty" example:"TM"`
+	Consumption *float64    `json:"consumption_lt_min,omitempty" example:"4.1"`
+	NR1         *bool       `json:"nr1,omitempty" example:"true"`
+	NR2         *bool       `json:"nr2,omitempty" example:"true"`
+	LH          *bool       `json:"lh,omitempty" example:"true"`
+	RH          *bool       `json:"rh,omitempty" example:"true"`
+	MGB         *bool       `json:"mgb,omitempty" example:"true"`
+	IGB         *bool       `json:"igb,omitempty" example:"false"`
+	TGB         *bool       `json:"tgb,omitempty" example:"true"`
+	UTCOffset   *int        `json:"utc_offset,omitempty" example:"-1"`
+	FileUUID    *string     `json:"file_uuid,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e90"`
+	Dry         *bool       `json:"dry,omitempty" example:"false"`
+	AOG         *bool       `json:"aog,omitempty" example:"false"`
+	AOGReason   *string     `json:"aog_reason,omitempty" example:"Main rotor gearbox fault"`
+	Note        *string     `json:"note,omitempty" example:"Primary HEMS helicopter"`
+	IsActive    *bool       `json:"is_active,omitempty" example:"true"`
+}
+
+type HelicopterUpdateData struct {
+	Type       string                     `json:"type" validate:"required,oneof=helicopter_update helicopter" example:"helicopter_update"`
+	ID         string                     `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes HelicopterUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type HelicopterUpdateRequest struct {
+	Data HelicopterUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/master_settings_microsoft_entra_request.go

@@ -0,0 +1,19 @@
+package request
+
+type MasterSettingsMicrosoftEntraUpsertAttributes struct {
+	TenantID     string `json:"MS_ENTRA_TENANT_ID" validate:"required" example:"your-tenant-id"`
+	ClientID     string `json:"MS_ENTRA_CLIENT_ID" validate:"required" example:"your-client-id"`
+	ClientSecret string `json:"MS_ENTRA_CLIENT_SECRET" example:"********"`
+	RedirectURL  string `json:"MS_ENTRA_REDIRECT_URL" validate:"required" example:"https://example.com/api/v1/auth/microsoft/callback"`
+	Authority    string `json:"MS_ENTRA_AUTHORITY" validate:"required" example:"https://login.microsoftonline.com/"`
+	Scopes       string `json:"MS_ENTRA_SCOPES" validate:"required" example:"openid,profile,email"`
+}
+
+type MasterSettingsMicrosoftEntraUpsertData struct {
+	Type       string                                       `json:"type" validate:"required,oneof=master_settings_microsoft_entra_upsert master_settings" example:"master_settings_microsoft_entra_upsert"`
+	Attributes MasterSettingsMicrosoftEntraUpsertAttributes `json:"attributes" validate:"required"`
+}
+
+type MasterSettingsMicrosoftEntraUpsertRequest struct {
+	Data MasterSettingsMicrosoftEntraUpsertData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/master_settings_request.go

@@ -0,0 +1,36 @@
+package request
+
+type MasterSettingsCreateAttributes struct {
+	CompanyName   string  `json:"company_name" validate:"required" example:"Wucher"`
+	Title         *string `json:"title,omitempty" example:"Welcome to Wucher"`
+	Subtitle      *string `json:"subtitle,omitempty" example:"Flight operations platform"`
+	LogoFileUUID  *string `json:"logo_file_uuid,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CoverFileUUID *string `json:"cover_file_uuid,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type MasterSettingsCreateData struct {
+	Type       string                         `json:"type" validate:"required,oneof=master_settings_create master_settings" example:"master_settings_create"`
+	Attributes MasterSettingsCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type MasterSettingsCreateRequest struct {
+	Data MasterSettingsCreateData `json:"data" validate:"required"`
+}
+
+type MasterSettingsUpdateAttributes struct {
+	CompanyName   *string `json:"company_name,omitempty" example:"Wucher"`
+	Title         *string `json:"title,omitempty" example:"Welcome to Wucher"`
+	Subtitle      *string `json:"subtitle,omitempty" example:"Flight operations platform"`
+	LogoFileUUID  *string `json:"logo_file_uuid,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CoverFileUUID *string `json:"cover_file_uuid,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type MasterSettingsUpdateData struct {
+	Type       string                         `json:"type" validate:"required,oneof=master_settings_update master_settings" example:"master_settings_update"`
+	ID         string                         `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes MasterSettingsUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type MasterSettingsUpdateRequest struct {
+	Data MasterSettingsUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/mcf_request.go

@@ -0,0 +1,52 @@
+package request
+
+// MCFSetAttributes toggles a helicopter's MCF (Yes/No) and is the DRAFT work endpoint.
+// active=true (or omitted) ACTIVATES it — creates the draft MCF if none is open, or
+// UPDATES the open draft with the provided check-flight fields (all optional; partial
+// edits allowed). Finalize it later via POST /mcf/sign (sign:true).
+// active=false DEACTIVATES it — cancels the open draft ("tidak jadi") and releases the
+// MCF status; the cancelled record stays in the list. A signed MCF is a real event and
+// is not cancelled by this.
+type MCFSetAttributes struct {
+	Active *bool `json:"active,omitempty" example:"true"`
+	// FlightID — OPTIONAL flight this check flight is performed on (on activate).
+	FlightID     string  `json:"flight_id,omitempty" validate:"omitempty,uuid" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	AFHours      string  `json:"af_hours,omitempty" example:"1245.3"`
+	LandingCount *int    `json:"landing_count,omitempty" example:"3"`
+	UTCTime      string  `json:"utc_time,omitempty" example:"2026-06-17T08:30:00Z"`
+	Date         string  `json:"date,omitempty" example:"2026-06-17"`
+	Result       string  `json:"result,omitempty" validate:"omitempty,oneof=passed failed" enums:"passed,failed" example:"passed"`
+	Notes        *string `json:"notes,omitempty" example:"MCF required after engine mount work"`
+}
+
+type MCFSetData struct {
+	Type       string           `json:"type" validate:"required,oneof=mcf_set mcf" example:"mcf_set"`
+	Attributes MCFSetAttributes `json:"attributes" validate:"required"`
+}
+
+type MCFSetRequest struct {
+	Data MCFSetData `json:"data" validate:"required"`
+}
+
+// MCFCompleteAttributes signs (completes) or unsigns an MCF. sign toggles the state:
+//   - sign=true (or omitted) SIGNS it — af_hours, landing_count, utc_time, date and
+//     result are required. "passed" clears the aircraft; "failed" keeps it grounded.
+//   - sign=false UNSIGNS it — reverts the MCF to a draft (the fields below are ignored).
+type MCFCompleteAttributes struct {
+	Sign         *bool   `json:"sign,omitempty" example:"true"`
+	AFHours      string  `json:"af_hours,omitempty" example:"1245.3"`
+	LandingCount *int    `json:"landing_count,omitempty" example:"3"`
+	UTCTime      string  `json:"utc_time,omitempty" example:"2026-06-17T08:30:00Z"`
+	Date         string  `json:"date,omitempty" example:"2026-06-17"`
+	Result       string  `json:"result,omitempty" validate:"omitempty,oneof=passed failed" enums:"passed,failed" example:"passed"`
+	Notes        *string `json:"notes,omitempty" example:"Vibration within limits after check flight"`
+}
+
+type MCFCompleteData struct {
+	Type       string                `json:"type" validate:"required,oneof=mcf_complete mcf_sign mcf" example:"mcf_sign"`
+	Attributes MCFCompleteAttributes `json:"attributes" validate:"required"`
+}
+
+type MCFCompleteRequest struct {
+	Data MCFCompleteData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/mission_request.go

@@ -0,0 +1,53 @@
+package request
+
+type MissionFileInput struct {
+	UploadIntentUUID string `json:"upload_intent_uuid" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name             string `json:"name" example:"mission-brief.pdf"`
+}
+
+type MissionCreateAttributes struct {
+	FlightID  string             `json:"flight_id" validate:"required" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	Type      string             `json:"type" validate:"required" example:"HEMS"`
+	SubtypeID string             `json:"subtype_id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a99"`
+	Note      string             `json:"note,omitempty" example:"Mission note"`
+	Files     []MissionFileInput `json:"files,omitempty"`
+}
+
+type MissionCreateData struct {
+	Type       string                  `json:"type" validate:"required,oneof=mission_create mission" example:"mission_create"`
+	Attributes MissionCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type MissionCreateRequest struct {
+	Data MissionCreateData `json:"data" validate:"required"`
+}
+
+type MissionUpdateAttributes struct {
+	Type      string             `json:"type" validate:"required" example:"SPO"`
+	SubtypeID string             `json:"subtype_id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a99"`
+	Note      string             `json:"note,omitempty" example:"Mission note"`
+	Files     []MissionFileInput `json:"files,omitempty"`
+}
+
+type MissionUpdateData struct {
+	Type       string                  `json:"type" validate:"required,oneof=mission_update mission" example:"mission_update"`
+	Attributes MissionUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type MissionUpdateRequest struct {
+	Data MissionUpdateData `json:"data" validate:"required"`
+}
+
+type MissionTypeCreateAttributes struct {
+	CodeType string `json:"code_type" validate:"required" example:"HEMS"`
+	TypeName string `json:"name" validate:"required" example:"HEMS"`
+}
+
+type MissionTypeCreateData struct {
+	Type       string                      `json:"type" validate:"required,oneof=mission_type_create mission_type" example:"mission_type_create"`
+	Attributes MissionTypeCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type MissionTypeCreateRequest struct {
+	Data MissionTypeCreateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/request/other_person_request.go

@@ -0,0 +1,18 @@
+package request
+
+// OtherPersonAttributesInput carries the editable fields of a reusable non-staff person.
+type OtherPersonAttributesInput struct {
+	Name        string `json:"name" example:"Guest Person"`
+	MobilePhone string `json:"mobile_phone,omitempty" example:"+43-1234"`
+	Email       string `json:"email,omitempty" example:"guest@example.com"`
+}
+
+type OtherPersonRequestData struct {
+	Type       string                     `json:"type,omitempty" example:"other_person"`
+	Attributes OtherPersonAttributesInput `json:"attributes"`
+}
+
+// OtherPersonRequest is the JSON:API body for create/update of the other-people master.
+type OtherPersonRequest struct {
+	Data OtherPersonRequestData `json:"data"`
+}

internal/transport/http/dto/request/reserve_ac_request.go

@@ -0,0 +1,249 @@
+package request
+
+import "encoding/json"
+
+type ReserveAcCreateAttributes struct {
+	AircraftID string                              `json:"helicopter_id" validate:"required" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	FlightID   string                              `json:"flight_id" validate:"required" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	Inspection ReserveAcInspectionCreateAttributes `json:"inspection" validate:"required"`
+}
+
+type ReserveAcInspectionCreateAttributes struct {
+	InspectionDate  string                               `json:"inspection_date" validate:"required" example:"2026-04-15"`
+	Before          ReserveAcBeforeInspectionAttributes  `json:"before" validate:"required"`
+	Prepare         ReserveAcPrepareInspectionAttributes `json:"prepare" validate:"required"`
+	FleetStatusFile ReserveAcFleetStatusFileAttributes   `json:"fleet_status_file,omitempty"`
+}
+
+type ReserveAcBeforeInspectionAttributes struct {
+	OilEngineNR1Checked       *bool                        `json:"oil_engine_nr1_checked,omitempty"`
+	OilEngineNR2Checked       *bool                        `json:"oil_engine_nr2_checked,omitempty"`
+	HydraulicLHChecked        *bool                        `json:"hydraulic_lh_checked,omitempty"`
+	HydraulicRHChecked        *bool                        `json:"hydraulic_rh_checked,omitempty"`
+	OilTransmissionMGBChecked *bool                        `json:"oil_transmission_mgb_checked,omitempty"`
+	OilTransmissionIGBChecked *bool                        `json:"oil_transmission_igb_checked,omitempty"`
+	OilTransmissionTGBChecked *bool                        `json:"oil_transmission_tgb_checked,omitempty"`
+	FuelAmount                *float64                     `json:"fuel_amount,omitempty"`
+	FuelUnit                  *string                      `json:"fuel_unit,omitempty"`
+	FuelAddedAmount           *float64                     `json:"fuel_added_amount,omitempty"`
+	Note                      *string                      `json:"note,omitempty"`
+	FileChecklist             []ReserveAcFileChecklistItem `json:"file_checklist,omitempty"`
+}
+
+type ReserveAcFileChecklistItem struct {
+	HelicopterFileID string `json:"helicopter_file_id" validate:"required" example:"019d7000-aaaa-7bbb-8ccc-111111111111"`
+	IsDone           bool   `json:"is_done" example:"true"`
+}
+
+type ReserveAcPrepareInspectionAttributes struct {
+	NotamBriefing         *bool                        `json:"notam_briefing,omitempty"`
+	WeatherBriefing       *bool                        `json:"weather_briefing,omitempty"`
+	OperationalFlightPlan *bool                        `json:"operational_flight_plan,omitempty"`
+	FileChecklist         []ReserveAcFileChecklistItem `json:"file_checklist,omitempty"`
+}
+
+type ReserveAcFleetStatusFileAttributes struct {
+	FileChecklist []ReserveAcFileChecklistItem `json:"file_checklist,omitempty"`
+}
+
+type ReserveAcAfterFlightInspectionAttributes struct {
+	OilEngineNR1Checked       *string                      `json:"oil_engine_nr1_checked,omitempty"`
+	OilEngineNR2Checked       *string                      `json:"oil_engine_nr2_checked,omitempty"`
+	HydraulicLHChecked        *string                      `json:"hydraulic_lh_checked,omitempty"`
+	HydraulicRHChecked        *string                      `json:"hydraulic_rh_checked,omitempty"`
+	OilTransmissionMGBChecked *string                      `json:"oil_transmission_mgb_checked,omitempty"`
+	OilTransmissionIGBChecked *string                      `json:"oil_transmission_igb_checked,omitempty"`
+	OilTransmissionTGBChecked *string                      `json:"oil_transmission_tgb_checked,omitempty"`
+	Note                      *string                      `json:"note,omitempty"`
+	FileChecklist             []ReserveAcFileChecklistItem `json:"file_checklist,omitempty"`
+}
+
+type ReserveAcAfterFlightInspectionUpsertData struct {
+	Type       string                                   `json:"type" validate:"required,oneof=after_flight_inspection_upsert after_flight_inspection"`
+	Attributes ReserveAcAfterFlightInspectionAttributes `json:"attributes" validate:"required"`
+}
+
+type ReserveAcAfterFlightInspectionUpsertRequest struct {
+	Data ReserveAcAfterFlightInspectionUpsertData `json:"data" validate:"required"`
+}
+
+type LastFlightsInspectionUpsertAttributes struct {
+	FlightInspectionID string `json:"flight_inspection_id" validate:"required"`
+	ReserveAcAfterFlightInspectionAttributes
+}
+
+type LastFlightsInspectionCreateData struct {
+	Type       string                                `json:"type" validate:"required,oneof=last_flights_inspection_create last_flights_inspection"`
+	Attributes LastFlightsInspectionUpsertAttributes `json:"attributes" validate:"required"`
+}
+
+type LastFlightsInspectionCreateRequest struct {
+	Data LastFlightsInspectionCreateData `json:"data" validate:"required"`
+}
+
+type LastFlightsInspectionUpdateData struct {
+	Type       string                                `json:"type" validate:"required,oneof=last_flights_inspection_update last_flights_inspection"`
+	Attributes LastFlightsInspectionUpsertAttributes `json:"attributes" validate:"required"`
+}
+
+type LastFlightsInspectionUpdateRequest struct {
+	Data LastFlightsInspectionUpdateData `json:"data" validate:"required"`
+}
+
+type LastFlightsInspectionDeleteAttributes struct {
+	FlightInspectionID string `json:"flight_inspection_id" validate:"required"`
+}
+
+type LastFlightsInspectionDeleteData struct {
+	Type       string                                `json:"type" validate:"required,oneof=last_flights_inspection_delete last_flights_inspection"`
+	Attributes LastFlightsInspectionDeleteAttributes `json:"attributes" validate:"required"`
+}
+
+type LastFlightsInspectionDeleteRequest struct {
+	Data LastFlightsInspectionDeleteData `json:"data" validate:"required"`
+}
+
+type ReserveAcCreateData struct {
+	Type       string                    `json:"type" validate:"required,oneof=reserve_ac_create reserve_ac" example:"reserve_ac_create"`
+	Attributes ReserveAcCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type ReserveAcCreateRequest struct {
+	Data ReserveAcCreateData `json:"data" validate:"required"`
+}
+
+type ReserveAcUpdateAttributes struct {
+	AircraftID *string                              `json:"helicopter_id,omitempty" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	FlightID   *string                              `json:"flight_id,omitempty" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	Inspection *ReserveAcInspectionUpdateAttributes `json:"inspection,omitempty"`
+}
+
+type ReserveAcInspectionUpdateAttributes struct {
+	InspectionDate *string                               `json:"inspection_date,omitempty" example:"2026-04-15"`
+	Before         *ReserveAcBeforeInspectionAttributes  `json:"before,omitempty"`
+	Prepare        *ReserveAcPrepareInspectionAttributes `json:"prepare,omitempty"`
+}
+
+type ReserveAcUpdateData struct {
+	Type       string                    `json:"type" validate:"required,oneof=reserve_ac_update reserve_ac" example:"reserve_ac_update"`
+	ID         string                    `json:"id" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	Attributes ReserveAcUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type ReserveAcUpdateRequest struct {
+	Data ReserveAcUpdateData `json:"data" validate:"required"`
+}
+
+type ReserveAcDeleteData struct {
+	ID string `json:"id" validate:"required" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+}
+
+type ReserveAcDeleteRequest struct {
+	Data ReserveAcDeleteData `json:"data" validate:"required"`
+}
+
+type TakeoverCreateAttributes struct {
+	BaseID                *string                              `json:"base_id,omitempty"`
+	DutyDate              string                               `json:"duty_date" validate:"required"`
+	Notes                 *string                              `json:"notes,omitempty"`
+	Detail                *TakeoverRosterDetailsInput          `json:"roster_detail,omitempty"`
+	AircraftID            *string                              `json:"helicopter_id,omitempty"`
+	Inspection            *ReserveAcInspectionCreateAttributes `json:"inspection,omitempty"`
+	Files                 []TakeoverCreateFileInput            `json:"files,omitempty" validate:"omitempty,dive"`
+	EditedTemplateFileIDs []string                             `json:"edited_template_file_ids,omitempty" validate:"omitempty,dive,uuid"`
+}
+
+type TakeoverCreateData struct {
+	Type       string                   `json:"type" validate:"required,oneof=takeover_create takeover"`
+	Attributes TakeoverCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type TakeoverCreateRequest struct {
+	Data TakeoverCreateData `json:"data" validate:"required"`
+}
+
+type TakeoverCreateFileInput struct {
+	FileID           string `json:"file_id,omitempty" validate:"omitempty,uuid" example:"019e8713-aa19-7fb7-a510-a0332dc69697"`
+	UploadIntentUUID string `json:"upload_intent_uuid,omitempty" validate:"omitempty,uuid" example:"019e8713-aa19-7fb7-a510-a0332dc69697"`
+	Name             string `json:"name,omitempty" example:"takeover-report.pdf"`
+}
+
+type TakeoverUpdateAttributes struct {
+	BaseID       *string                              `json:"base_id,omitempty"`
+	Bases        *TakeoverBaseRef                     `json:"bases,omitempty"`
+	DutyDate     *string                              `json:"duty_date,omitempty"`
+	Notes        *string                              `json:"notes,omitempty"`
+	Detail       *TakeoverRosterDetailsInput          `json:"roster_detail,omitempty"`
+	RosterDetail *TakeoverRosterDetailsInput          `json:"roster_details,omitempty"`
+	AircraftID   *string                              `json:"helicopter_id,omitempty"`
+	Inspection   *ReserveAcInspectionCreateAttributes `json:"inspection,omitempty"`
+	Files        []TakeoverCreateFileInput            `json:"files,omitempty" validate:"omitempty,dive"`
+	FilesAdd     []TakeoverCreateFileInput            `json:"files_add,omitempty" validate:"omitempty,dive"`
+	FilesRemove  []string                             `json:"files_remove,omitempty" validate:"omitempty,dive,uuid"`
+	FilesReplace []TakeoverCreateFileInput            `json:"files_replace,omitempty" validate:"omitempty,dive"`
+}
+
+type TakeoverUpdateData struct {
+	Type       string                   `json:"type" validate:"required,oneof=takeover_update takeover"`
+	ID         string                   `json:"id"`
+	Attributes TakeoverUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type TakeoverUpdateRequest struct {
+	Data TakeoverUpdateData `json:"data" validate:"required"`
+}
+
+func (a *TakeoverUpdateAttributes) UnmarshalJSON(data []byte) error {
+	type alias TakeoverUpdateAttributes
+	var raw struct {
+		alias
+		Bases        *TakeoverBaseRef            `json:"bases,omitempty"`
+		RosterDetail *TakeoverRosterDetailsInput `json:"roster_details,omitempty"`
+	}
+	if err := json.Unmarshal(data, &raw); err != nil {
+		return err
+	}
+	*a = TakeoverUpdateAttributes(raw.alias)
+	if a.BaseID == nil && raw.Bases != nil && raw.Bases.ID != "" {
+		id := raw.Bases.ID
+		a.BaseID = &id
+	}
+	if a.Detail == nil && raw.RosterDetail != nil {
+		a.Detail = raw.RosterDetail
+	}
+	return nil
+}
+
+type TakeoverBaseRef struct {
+	ID string `json:"id,omitempty"`
+}
+
+type TakeoverRosterCrewInput struct {
+	ID string `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type TakeoverRosterPilotInput struct {
+	ID               string `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FlightInstructor bool   `json:"flight_instructor,omitempty"`
+	LineChecker      bool   `json:"line_checker,omitempty"`
+	Supervisor       bool   `json:"supervisor,omitempty"`
+	Examiner         bool   `json:"examiner,omitempty"`
+	CoPilot          bool   `json:"co_pilot,omitempty"`
+	CrewType         string `json:"crew_type,omitempty" example:"main" enums:"main,additional"`
+}
+
+type TakeoverRosterOtherPersonInput struct {
+	// OtherPersonID — OPTIONAL master person id to reuse (from GET /contact/other).
+	OtherPersonID string `json:"other_person_id,omitempty" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Name          string `json:"name,omitempty" example:"Guest Person"`
+	MobilePhone   string `json:"mobile_phone,omitempty" example:"+43-1234"`
+	Email         string `json:"email,omitempty" example:"guest@example.com"`
+}
+
+type TakeoverRosterDetailsInput struct {
+	Pilot       []TakeoverRosterPilotInput       `json:"pilot"`
+	Doctor      []TakeoverRosterCrewInput        `json:"doctor"`
+	Rescuer     []TakeoverRosterCrewInput        `json:"rescuer"`
+	Helper      []TakeoverRosterCrewInput        `json:"helper"`
+	OtherPerson []TakeoverRosterOtherPersonInput `json:"other_person"`
+}

internal/transport/http/dto/response/action_signoff_response.go

@@ -0,0 +1,26 @@
+package response
+
+type ActionSignoffAttributes struct {
+	HelicopterID string `json:"helicopter_id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	FlightID     string `json:"flight_id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	// Signed — true once checked; gates the maintenance release form.
+	Signed bool `json:"signed" example:"false"`
+	// SignedAt / SignedBy — when/who signed; empty until signed.
+	SignedAt *string `json:"signed_at,omitempty" example:"2026-06-16T03:04:05Z"`
+	SignedBy string  `json:"signed_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	// SignedByName / SignedByShort — resolved display name + 3-letter short of the signer.
+	SignedByName  *string `json:"signed_by_name,omitempty" example:"John Doe"`
+	SignedByShort *string `json:"signed_by_short,omitempty" example:"JDO"`
+	CreatedAt     string  `json:"created_at,omitempty" example:"2026-06-16T03:04:05Z"`
+	UpdatedAt    string  `json:"updated_at,omitempty" example:"2026-06-16T03:04:05Z"`
+}
+
+type ActionSignoffResource struct {
+	Type       string                  `json:"type" example:"action_signoff"`
+	ID         string                  `json:"id,omitempty" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Attributes ActionSignoffAttributes `json:"attributes"`
+}
+
+type ActionSignoffResponse struct {
+	Data ActionSignoffResource `json:"data"`
+}

internal/transport/http/dto/response/air_rescuer_checklist_response.go

@@ -0,0 +1,124 @@
+package response
+
+import shareddto "wucher/internal/transport/http/dto/shared"
+
+type AirRescuerChecklistItemResource struct {
+	ID        string `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name      string `json:"name,omitempty" example:"Oxygen supply check"`
+	Position  int    `json:"position,omitempty" example:"1"`
+	CreatedBy string `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CreatedAt string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedAt string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+}
+
+type AirRescuerChecklistAttributes struct {
+	Bases       shareddto.AirRescuerChecklistBaseInfo `json:"bases"`
+	ScopeCode   string                                `json:"scope_code,omitempty" example:"TU"`
+	ScopeCodeDe string                                `json:"scope_code_de,omitempty" example:"DI"`
+	Title       string                                `json:"title,omitempty" example:"Monday Checklist"`
+	Position    int                                   `json:"position,omitempty" example:"1"`
+	Items       []AirRescuerChecklistItemResource     `json:"items"`
+	CreatedBy   string                                `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CreatedAt   string                                `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedAt   string                                `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+}
+
+type AirRescuerChecklistResource struct {
+	Type       string                        `json:"type" example:"air_rescuer_checklist"`
+	ID         string                        `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes AirRescuerChecklistAttributes `json:"attributes"`
+}
+
+type AirRescuerChecklistResponse struct {
+	Data AirRescuerChecklistResource `json:"data"`
+}
+
+type AirRescuerChecklistBulkResponse struct {
+	Data []AirRescuerChecklistResource `json:"data"`
+}
+
+type AirRescuerChecklistItemAttributes struct {
+	ChecklistID string `json:"checklist_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name        string `json:"name,omitempty" example:"Check radio"`
+	Position    int    `json:"position,omitempty" example:"1"`
+	CreatedBy   string `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CreatedAt   string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedAt   string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+}
+
+type AirRescuerChecklistItemData struct {
+	Type       string                            `json:"type" example:"air_rescuer_checklist_item"`
+	ID         string                            `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes AirRescuerChecklistItemAttributes `json:"attributes"`
+}
+
+type AirRescuerChecklistItemResponse struct {
+	Data AirRescuerChecklistItemData `json:"data"`
+}
+
+type AirRescuerChecklistItemBulkResponse struct {
+	Data []AirRescuerChecklistItemData `json:"data"`
+}
+
+type AirRescuerChecklistCATChecklistSummary struct {
+	ID        string `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Title     string `json:"title,omitempty" example:"Cockpit Flugretter"`
+	Position  int    `json:"position,omitempty" example:"1"`
+	CreatedBy string `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CreatedAt string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedAt string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+}
+
+type AirRescuerChecklistCATGroup struct {
+	ScopeCode       string                                   `json:"scope_code,omitempty" example:"DA"`
+	ScopeCodeDe     string                                   `json:"scope_code_de,omitempty" example:"TA"`
+	ScopeCodeName   string                                   `json:"scope_code_name,omitempty" example:"Daily"`
+	ScopeCodeNameDe string                                   `json:"scope_code_name_de,omitempty" example:"Taeglich"`
+	Checklists      []AirRescuerChecklistCATChecklistSummary `json:"checklists"`
+}
+
+type AirRescuerChecklistTabChecklistDetail struct {
+	ID             string                            `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Title          string                            `json:"title,omitempty" example:"Monday Checklist"`
+	Position       int                               `json:"position,omitempty" example:"1"`
+	ChecklistItems []AirRescuerChecklistItemResource `json:"checklist_items"`
+	CreatedBy      string                            `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CreatedAt      string                            `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedAt      string                            `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+}
+
+type AirRescuerChecklistTabResource struct {
+	ScopeCode       string                                   `json:"scope_code,omitempty" example:"DA"`
+	ScopeCodeDe     string                                   `json:"scope_code_de,omitempty" example:"TA"`
+	ScopeCodeName   string                                   `json:"scope_code_name,omitempty" example:"Daily"`
+	ScopeCodeNameDe string                                   `json:"scope_code_name_de,omitempty" example:"Taeglich"`
+	Groups          []AirRescuerChecklistCATGroup            `json:"groups,omitempty"`
+	Checklists      *[]AirRescuerChecklistTabChecklistDetail `json:"checklists,omitempty"`
+}
+
+type AirRescuerChecklistBaseGroupAttributes struct {
+	Bases shareddto.AirRescuerChecklistBaseInfo `json:"bases"`
+	Tabs  []AirRescuerChecklistTabResource      `json:"tabs"`
+}
+
+type AirRescuerChecklistBaseGroupResource struct {
+	Type       string                                 `json:"type" example:"air_rescuer_checklist_group"`
+	ID         string                                 `json:"id,omitempty" example:"base-018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes AirRescuerChecklistBaseGroupAttributes `json:"attributes"`
+}
+
+type AirRescuerChecklistGroupedListResponse struct {
+	Data []AirRescuerChecklistBaseGroupResource `json:"data"`
+	Meta struct {
+		TotalBases int `json:"total_bases" example:"8"`
+	} `json:"meta"`
+}
+
+type AirRescuerChecklistGroupedDataTableResponse struct {
+	Data []AirRescuerChecklistBaseGroupResource `json:"data"`
+	Meta struct {
+		Draw            int `json:"draw" example:"1"`
+		RecordsTotal    int `json:"records_total" example:"8"`
+		RecordsFiltered int `json:"records_filtered" example:"8"`
+	} `json:"meta"`
+}

internal/transport/http/dto/response/complaint_response.go

@@ -0,0 +1,98 @@
+package response
+
+import shareddto "wucher/internal/transport/http/dto/shared"
+
+// ComplaintMEL groups the MEL deferral attributes. All fields are always present
+// (null when not set) so the response shape is predictable for clients.
+type ComplaintMEL struct {
+	// Severity — MEL class: 0=NON-MEL, 1=A, 2=B, 3=C, 4=D. Always set (classification is required at creation).
+	Severity int8 `json:"severity" example:"2" enums:"0,1,2,3,4"`
+	// SeverityLabel — human label of the severity (NON-MEL/A/B/C/D).
+	SeverityLabel *string `json:"severity_label" example:"B"`
+	// ClassifiedAt / ClassifiedByName / ClassifiedByShort — when/who classified the MEL.
+	ClassifiedAt      *string `json:"classified_at" example:"2026-06-15T03:04:05Z"`
+	ClassifiedByName  *string `json:"classified_by_name" example:"John Doe"`
+	ClassifiedByShort *string `json:"classified_by_short" example:"JDO"`
+	// Deadline — grace deadline; after this the aircraft is AOG. null for NON-MEL.
+	Deadline *string `json:"deadline" example:"2026-06-18T03:04:05Z"`
+}
+
+type ComplaintNSR struct {
+	// IsNSR — Non-Safety Release: true = aircraft released to fly despite the open defect.
+	IsNSR bool `json:"is_nsr" example:"false"`
+	// Reason — optional justification for the NSR decision.
+	Reason *string `json:"reason" example:"not required"`
+	// DecidedAt / DecidedByName / DecidedByShort — when/who decided NSR (may differ from the reporter).
+	DecidedAt      *string `json:"decided_at" example:"2026-06-15T03:04:05Z"`
+	DecidedByName  *string `json:"decided_by_name" example:"John Doe"`
+	DecidedByShort *string `json:"decided_by_short" example:"JDO"`
+}
+
+type ComplaintAttributes struct {
+	HelicopterID          string                           `json:"helicopter_id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	FlightID              string                           `json:"flight_id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	Description           string                           `json:"description" example:"Engine 2 N2 vibration intermittent during cruise above 110 KIAS"`
+	Helicopter            *shareddto.FleetStatusHelicopter `json:"helicopter,omitempty"`
+	ReportedBy            string                           `json:"reported_by" example:"John Doe"`
+	ReportedByShort       string                           `json:"reported_by_short,omitempty" example:"JDO"`
+	ReportedAt            string                           `json:"reported_at" example:"2026-06-15T03:04:05Z"`
+	AircraftHoursAtReport *string                          `json:"aircraft_hours_at_report" example:"1245.3"`
+	MEL                   ComplaintMEL                     `json:"mel"`
+	NSR                   ComplaintNSR                     `json:"nsr"`
+	ActionSigned          bool                             `json:"action_signed" example:"true"`
+	ActionTaken           *string                          `json:"action_taken" example:"tightened mount"`
+	ActionSignedAt        *string                          `json:"action_signed_at" example:"2026-06-15T03:04:05Z"`
+	ActionSignedByName    *string                          `json:"action_signed_by_name" example:"John Doe"`
+	ActionSignedByShort   *string                          `json:"action_signed_by_short" example:"JDO"`
+	AircraftHoursAtFix    *string                          `json:"aircraft_hours_at_fix" example:"1250.1"`
+	Status                string                           `json:"status" example:"active_mel" enums:"active_non_mel,active_mel,serviced"`
+	CreatedAt             string                           `json:"created_at" example:"2026-06-15T03:04:05Z"`
+	UpdatedAt             string                           `json:"updated_at" example:"2026-06-15T03:04:05Z"`
+}
+
+type ComplaintResource struct {
+	Type       string              `json:"type" example:"complaint"`
+	ID         string              `json:"id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Attributes ComplaintAttributes `json:"attributes"`
+}
+
+type ComplaintResponse struct {
+	Data ComplaintResource `json:"data"`
+}
+
+type ComplaintListResponse struct {
+	Data []ComplaintResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"1"`
+	} `json:"meta"`
+}
+
+type ComplaintHelicopterGroupAttributes struct {
+	Helicopter *shareddto.FleetStatusHelicopter `json:"helicopter"`
+	Complaints []ComplaintResource              `json:"complaints"`
+}
+
+type ComplaintHelicopterGroupResource struct {
+	Type       string                             `json:"type" example:"complaint_helicopter_group"`
+	Attributes ComplaintHelicopterGroupAttributes `json:"attributes"`
+}
+
+type ComplaintGroupedListResponse struct {
+	Data []ComplaintHelicopterGroupResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"1"`
+	} `json:"meta"`
+}
+
+type ComplaintGroupedDataTableResponse struct {
+	Data []ComplaintHelicopterGroupResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"1"`
+		RecordsFiltered int64 `json:"records_filtered" example:"1"`
+	} `json:"meta"`
+}

internal/transport/http/dto/response/duty_roster_response.go

@@ -0,0 +1,227 @@
+package response
+
+type DutyRosterShiftTime struct {
+	ShiftStart string `json:"shift_start,omitempty" example:"06:00"`
+	ShiftEnd   string `json:"shift_end,omitempty" example:"21:00"`
+}
+
+type DutyRosterShiftDate struct {
+	DateStart string `json:"date_start,omitempty" example:"2026-03-16"`
+	DateEnd   string `json:"date_end,omitempty" example:"2026-03-16"`
+}
+
+type DutyRosterCrew struct {
+	ID          string               `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name        string               `json:"name,omitempty" example:"Hunter Wolfgang"`
+	Role        string               `json:"role,omitempty" example:"doctor"`
+	MobilePhone string               `json:"mobile_phone,omitempty" example:"+43-1234"`
+	Email       string               `json:"email,omitempty" example:"doctor@example.com"`
+	ShiftDate   *DutyRosterShiftDate `json:"shift_date,omitempty"`
+	ShiftTime   *DutyRosterShiftTime `json:"shift_time,omitempty"`
+}
+
+type DutyRosterPilotCrew struct {
+	ID               string               `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name             string               `json:"name,omitempty" example:"Hunter Wolfgang"`
+	Role             string               `json:"role,omitempty" example:"pilot"`
+	MobilePhone      string               `json:"mobile_phone,omitempty" example:"+43-1234"`
+	Email            string               `json:"email,omitempty" example:"pilot@example.com"`
+	ShiftDate        *DutyRosterShiftDate `json:"shift_date,omitempty"`
+	CrewType         string               `json:"crew_type,omitempty" example:"main"`
+	FlightInstructor *bool                `json:"flight_instructor,omitempty"`
+	LineChecker      *bool                `json:"line_checker,omitempty"`
+	Supervisor       *bool                `json:"supervisor,omitempty"`
+	Examiner         *bool                `json:"examiner,omitempty"`
+	CoPilot          *bool                `json:"co_pilot,omitempty"`
+}
+
+type DutyRosterDetailsResponse struct {
+	Pilot       []DutyRosterPilotCrew `json:"pilot"`
+	Doctor      []DutyRosterCrew      `json:"doctor"`
+	Rescuer     []DutyRosterCrew      `json:"rescuer"`
+	Helper      []DutyRosterCrew      `json:"helper"`
+	OtherPerson []DutyRosterCrew      `json:"other_person"`
+}
+
+type DutyRosterBaseInfo struct {
+	ID               string              `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Type             string              `json:"type,omitempty" example:"hems"`
+	BaseName         string              `json:"base_name,omitempty" example:"Gallus 1 - Zurs Lech"`
+	BaseAbbreviation string              `json:"base_abbreviation,omitempty" example:"G1"`
+	ShiftTime        DutyRosterShiftTime `json:"shift_time,omitempty"`
+}
+
+type DutyRosterHelicopterSummary struct {
+	ID          string `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Designation string `json:"designation" example:"OE-XHZ"`
+	Identifier  string `json:"identifier" example:"1234"`
+	Type        string `json:"type" example:"EC-135"`
+}
+
+type DutyRosterAttributes struct {
+	Bases      DutyRosterBaseInfo          `json:"bases"`
+	FlightID   string                      `json:"flight_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Helicopter DutyRosterHelicopterSummary `json:"helicopter"`
+	DutyDate   string                      `json:"duty_date,omitempty" example:"2026-03-16"`
+	ShiftTime  DutyRosterShiftTime         `json:"shift_time"`
+	Detail     DutyRosterDetailsResponse   `json:"roster_detail"`
+	CreatedBy  string                      `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CreatedAt  string                      `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedAt  string                      `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+}
+
+type DutyRosterResource struct {
+	Type       string               `json:"type" example:"duty_roster"`
+	ID         string               `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes DutyRosterAttributes `json:"attributes"`
+}
+
+type DutyRosterResponse struct {
+	Data DutyRosterResource `json:"data"`
+}
+
+type DutyRosterListResponse struct {
+	Data []DutyRosterResource `json:"data"`
+	Meta struct {
+		Total int `json:"total" example:"31"`
+	} `json:"meta"`
+}
+
+type DutyRosterGetAllMeta struct {
+	PageNumber      int    `json:"page_number"`
+	PageSize        int    `json:"page_size"`
+	RecordsTotal    int    `json:"records_total"`
+	RecordsFiltered int    `json:"records_filtered"`
+	From            string `json:"from"`
+	To              string `json:"to"`
+	Timezone        string `json:"timezone"`
+	Total           int    `json:"total"`
+}
+
+type DutyRosterGetAllData struct {
+	HEMS []DutyRosterBaseGroupResource `json:"hems_base"`
+	Base []DutyRosterBaseGroupResource `json:"base"`
+}
+
+type DutyRosterGetAllResponse struct {
+	Data DutyRosterGetAllData `json:"data"`
+	Meta DutyRosterGetAllMeta `json:"meta"`
+}
+
+type DutyRosterAnyResource struct {
+	Type       string         `json:"type"`
+	ID         string         `json:"id,omitempty"`
+	Attributes map[string]any `json:"attributes"`
+}
+
+type DutyRosterAnyResponse struct {
+	Data DutyRosterAnyResource `json:"data"`
+}
+
+type DutyRosterAnyListResponse struct {
+	Data []DutyRosterAnyResource `json:"data"`
+	Meta struct {
+		Total int `json:"total" example:"31"`
+	} `json:"meta"`
+}
+
+type DutyRosterAnyDeleteResponse struct {
+	Data DutyRosterAnyDeleteResource `json:"data"`
+}
+
+type DutyRosterAnyDeleteResource struct {
+	Type       string                        `json:"type" example:"duty_roster_delete"`
+	Attributes DutyRosterAnyDeleteAttributes `json:"attributes"`
+}
+
+type DutyRosterAnyDeleteAttributes struct {
+	Deleted bool               `json:"deleted" example:"true"`
+	ID      string             `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Base    DutyRosterBaseInfo `json:"base"`
+}
+
+type DutyRosterUnifiedDataTableResponse struct {
+	Data DutyRosterGetAllData           `json:"data"`
+	Meta DutyRosterUnifiedDataTableMeta `json:"meta"`
+}
+
+type DutyRosterUnifiedDataTableMeta struct {
+	Draw            int    `json:"draw" example:"1"`
+	RecordsTotal    int    `json:"records_total" example:"20"`
+	RecordsFiltered int    `json:"records_filtered" example:"20"`
+	PageNumber      int    `json:"page_number" example:"1"`
+	PageSize        int    `json:"page_size" example:"20"`
+	From            string `json:"from" example:"2026-03-01"`
+	To              string `json:"to" example:"2026-03-31"`
+	Timezone        string `json:"timezone" example:"UTC"`
+	Total           int    `json:"total" example:"20"`
+	TotalGroups     int    `json:"total_groups" example:"20"`
+	TotalRosters    int    `json:"total_rosters" example:"45"`
+	NonEmptyGroups  int    `json:"non_empty_groups" example:"18"`
+}
+
+type DutyRosterGroupRoster struct {
+	ID         string                      `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FlightID   string                      `json:"flight_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DutyDate   string                      `json:"duty_date,omitempty" example:"2026-03-16"`
+	ShiftTime  DutyRosterShiftTime         `json:"shift_time"`
+	Helicopter DutyRosterHelicopterSummary `json:"helicopter"`
+	Detail     DutyRosterDetailsResponse   `json:"roster_detail"`
+	CreatedBy  string                      `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CreatedAt  string                      `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedAt  string                      `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+}
+
+type DutyRosterBaseGroupAttributes struct {
+	Bases   DutyRosterBaseInfo      `json:"bases"`
+	Rosters []DutyRosterGroupRoster `json:"rosters"`
+}
+
+type DutyRosterBaseGroupResource struct {
+	Type       string                        `json:"type" example:"hems_base_roster_group"`
+	Attributes DutyRosterBaseGroupAttributes `json:"attributes"`
+}
+
+type DutyRosterGroupedListResponse struct {
+	Data []DutyRosterBaseGroupResource `json:"data"`
+	Meta struct {
+		From       string `json:"from,omitempty" example:"2026-03-16"`
+		To         string `json:"to,omitempty" example:"2026-04-15"`
+		TotalBases int    `json:"total_bases" example:"8"`
+	} `json:"meta"`
+}
+
+type DutyRosterGroupedDataTableResponse struct {
+	Data []DutyRosterBaseGroupResource `json:"data"`
+	Meta struct {
+		Draw            int `json:"draw" example:"1"`
+		RecordsTotal    int `json:"records_total" example:"8"`
+		RecordsFiltered int `json:"records_filtered" example:"8"`
+	} `json:"meta"`
+}
+
+type DutyRosterDeletedCrewItem struct {
+	ID        string `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	RosterID  string `json:"roster_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UserID    string `json:"user_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name      string `json:"name,omitempty" example:"Pilot One"`
+	RoleCode  string `json:"role_code,omitempty" example:"pilot"`
+	CrewType  string `json:"crew_type,omitempty" example:"main"`
+	DateStart string `json:"date_start,omitempty" example:"2026-03-20"`
+	DateEnd   string `json:"date_end,omitempty" example:"2026-03-22"`
+}
+
+type DutyRosterCrewDeleteAttributes struct {
+	Deleted      bool                        `json:"deleted" example:"true"`
+	DeletedCount int                         `json:"deleted_count" example:"1"`
+	DeletedItems []DutyRosterDeletedCrewItem `json:"deleted_items"`
+}
+
+type DutyRosterCrewDeleteResource struct {
+	Type       string                         `json:"type" example:"duty_roster_crew_delete"`
+	Attributes DutyRosterCrewDeleteAttributes `json:"attributes"`
+}
+
+type DutyRosterCrewDeleteResponse struct {
+	Data DutyRosterCrewDeleteResource `json:"data"`
+}

internal/transport/http/dto/response/easa_release_response.go

@@ -0,0 +1,55 @@
+package response
+
+type EASAReleaseAttributes struct {
+	HelicopterID               string  `json:"helicopter_id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	ComplaintID                string  `json:"complaint_id,omitempty" example:"019d6774-1111-7fba-9ef4-3795c0da8a13"`
+	FlightID                   string  `json:"flight_id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	EASADate                   *string `json:"easa_date,omitempty" example:"2026-06-16"`
+	EASAACHours                *string `json:"easa_ac_hours,omitempty" example:"1245.3"`
+	EASALocation               *string `json:"easa_location,omitempty" example:"LOWI"`
+	EASAWONo                   *string `json:"easa_wo_no,omitempty" example:"WO-2026-001"`
+	EASAMaintManualRevAirframe *string `json:"easa_maint_manual_rev_airframe,omitempty" example:"Rev 12"`
+	EASAMaintManualRevEngine   *string `json:"easa_maint_manual_rev_engine,omitempty" example:"Rev 8"`
+	// EASASignerID — contact id (UUIDv7) of the signer/technician.
+	EASASignerID *string `json:"easa_signer_id,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	// EASASignerName / EASASignerShort — resolved display name + 3-letter short of the signer contact.
+	EASASignerName  *string `json:"easa_signer_name,omitempty" example:"John Doe"`
+	EASASignerShort *string `json:"easa_signer_short,omitempty" example:"JDO"`
+	EASAPermitNo    *string `json:"easa_permit_no,omitempty" example:"145.A.50"`
+	// IsSigned — true once the release is signed (Release to Service); then the complaint becomes fixed.
+	IsSigned bool `json:"is_signed" example:"false"`
+	// SignedAt / SignedBy — when/who signed; empty until signed.
+	SignedAt *string `json:"signed_at,omitempty" example:"2026-06-16T03:04:05Z"`
+	SignedBy string  `json:"signed_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	// MissingSignFields — required fields still empty; must all be filled before it can be signed.
+	MissingSignFields []string `json:"missing_sign_fields,omitempty"`
+	CreatedAt         string   `json:"created_at" example:"2026-06-16T03:04:05Z"`
+	UpdatedAt         string   `json:"updated_at" example:"2026-06-16T03:04:05Z"`
+}
+
+type EASAReleaseResource struct {
+	Type       string                `json:"type" example:"easa_release"`
+	ID         string                `json:"id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Attributes EASAReleaseAttributes `json:"attributes"`
+}
+
+type EASAReleaseResponse struct {
+	Data EASAReleaseResource `json:"data"`
+}
+
+// EASAReleaseDeleteResponse is the ack returned when an EASA release is voided/deleted.
+type EASAReleaseDeleteResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"easa_release_delete"`
+		Attributes struct {
+			Deleted bool `json:"deleted" example:"true"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+type EASAReleaseListResponse struct {
+	Data []EASAReleaseResource `json:"data"`
+	Meta struct {
+		Total int64 `json:"total" example:"1"`
+	} `json:"meta"`
+}

internal/transport/http/dto/response/file_manager_action_response.go

@@ -0,0 +1,85 @@
+package response
+
+type FileManagerActionLocation struct {
+	FolderID string `json:"folder_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type FileManagerActionResultAttributes struct {
+	Status   string                     `json:"status" example:"trashed"`
+	Location *FileManagerActionLocation `json:"location,omitempty"`
+}
+
+type FileManagerActionResultResource struct {
+	Type       string                            `json:"type" example:"file_manager_delete_result"`
+	ID         string                            `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes FileManagerActionResultAttributes `json:"attributes"`
+}
+
+type FileManagerActionResultResponse struct {
+	Data FileManagerActionResultResource `json:"data"`
+}
+
+type FileManagerMoveNodeResultAttributes struct {
+	NodeType string                     `json:"node_type" example:"folder"`
+	Status   string                     `json:"status" example:"moved"`
+	Location *FileManagerActionLocation `json:"location,omitempty"`
+}
+
+type FileManagerMoveNodeResultResource struct {
+	Type       string                              `json:"type" example:"file_manager_move_result"`
+	ID         string                              `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes FileManagerMoveNodeResultAttributes `json:"attributes"`
+}
+
+type FileManagerActionBulkError struct {
+	Status    int    `json:"status" example:"422"`
+	Code      string `json:"code,omitempty" example:"FILE_MANAGER_VALIDATION_FAILED"`
+	ErrorCode string `json:"error_code,omitempty" example:"4222111"`
+	Title     string `json:"title" example:"Validation error"`
+	Detail    string `json:"detail" example:"duplicate name in target folder"`
+}
+
+type FileManagerMoveNodeBulkItem struct {
+	Index    int                                `json:"index" example:"0"`
+	Success  bool                               `json:"success" example:"true"`
+	Resource *FileManagerMoveNodeResultResource `json:"resource,omitempty"`
+	Error    *FileManagerActionBulkError        `json:"error,omitempty"`
+}
+
+type FileManagerMoveNodeBulkResponse struct {
+	Data []FileManagerMoveNodeBulkItem `json:"data"`
+	Meta struct {
+		Total          int  `json:"total" example:"3"`
+		Success        int  `json:"success" example:"2"`
+		Failed         int  `json:"failed" example:"1"`
+		PartialSuccess bool `json:"partial_success" example:"true"`
+	} `json:"meta"`
+}
+
+type FileManagerPurgeNodeResultAttributes struct {
+	NodeType string `json:"node_type" example:"folder"`
+	Status   string `json:"status" example:"purged"`
+}
+
+type FileManagerPurgeNodeResultResource struct {
+	Type       string                               `json:"type" example:"file_manager_purge_result"`
+	ID         string                               `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes FileManagerPurgeNodeResultAttributes `json:"attributes"`
+}
+
+type FileManagerPurgeNodeBulkItem struct {
+	Index    int                                 `json:"index" example:"0"`
+	Success  bool                                `json:"success" example:"true"`
+	Resource *FileManagerPurgeNodeResultResource `json:"resource,omitempty"`
+	Error    *FileManagerActionBulkError         `json:"error,omitempty"`
+}
+
+type FileManagerPurgeNodeBulkResponse struct {
+	Data []FileManagerPurgeNodeBulkItem `json:"data"`
+	Meta struct {
+		Total          int  `json:"total" example:"3"`
+		Success        int  `json:"success" example:"2"`
+		Failed         int  `json:"failed" example:"1"`
+		PartialSuccess bool `json:"partial_success" example:"true"`
+	} `json:"meta"`
+}

internal/transport/http/dto/response/file_manager_attachment_response.go

@@ -0,0 +1,22 @@
+package response
+
+import shareddto "wucher/internal/transport/http/dto/shared"
+
+type FileManagerAttachmentResource struct {
+	Type       string                                    `json:"type" example:"file_manager_attachment"`
+	ID         string                                    `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes shareddto.FileManagerAttachmentAttributes `json:"attributes"`
+}
+
+type FileManagerAttachmentResponse struct {
+	Data FileManagerAttachmentResource `json:"data"`
+}
+
+type FileManagerAttachmentListResponse struct {
+	Data []FileManagerAttachmentResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}

internal/transport/http/dto/response/file_manager_event_sse_dto.go

@@ -0,0 +1,10 @@
+package response
+
+type FileManagerFileUpdatedSSEPayload struct {
+	FileID    string  `json:"file_id"`
+	Status    string  `json:"status"`
+	FolderID  *string `json:"folder_id"`
+	Name      string  `json:"name"`
+	MimeType  string  `json:"mime_type"`
+	UpdatedAt string  `json:"updated_at"`
+}

internal/transport/http/dto/response/file_manager_file_response.go

@@ -0,0 +1,145 @@
+package response
+
+import shareddto "wucher/internal/transport/http/dto/shared"
+
+type FileManagerFileResource struct {
+	Type       string                              `json:"type" example:"file_manager_file"`
+	ID         string                              `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes shareddto.FileManagerFileAttributes `json:"attributes"`
+}
+
+type FileManagerFileListResource struct {
+	Type       string                                  `json:"type" example:"file_manager_file"`
+	ID         string                                  `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes shareddto.FileManagerFileListAttributes `json:"attributes"`
+}
+
+type FileManagerFileResponse struct {
+	Data struct {
+		Type       string                              `json:"type" example:"file_manager_file"`
+		ID         string                              `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+		Attributes shareddto.FileManagerFileAttributes `json:"attributes"`
+	} `json:"data"`
+}
+
+type FileManagerFileDetailResource struct {
+	Type       string                                    `json:"type" example:"file_manager_file"`
+	ID         string                                    `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes shareddto.FileManagerFileDetailAttributes `json:"attributes"`
+}
+
+type FileManagerFileDetailResponse struct {
+	Data FileManagerFileDetailResource `json:"data"`
+}
+
+type FileManagerFileListResponse struct {
+	Data []FileManagerFileListResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type FileManagerFileDownloadURLResponse struct {
+	Data struct {
+		Type       string                                      `json:"type" example:"file_manager_file_download"`
+		ID         string                                      `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+		Attributes shareddto.FileManagerFileDownloadAttributes `json:"attributes"`
+	} `json:"data"`
+}
+
+type FileManagerFileUploadIntentResponse struct {
+	Data struct {
+		Type       string                                          `json:"type" example:"file_manager_file_upload_intent"`
+		ID         string                                          `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+		Attributes shareddto.FileManagerFileUploadIntentAttributes `json:"attributes"`
+	} `json:"data"`
+}
+
+type FileManagerFileUploadIntentResource struct {
+	Type       string                                          `json:"type" example:"file_manager_file_upload_intent"`
+	ID         string                                          `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes shareddto.FileManagerFileUploadIntentAttributes `json:"attributes"`
+}
+
+type FileManagerFileWOPISessionData struct {
+	FileID          string `json:"file_id" example:"019f0386-0a00-7a4a-a2d8-30afc0e0c3ad"`
+	CollaboraAction string `json:"collabora_action" example:"https://collabora.example.com/browser/123?WOPISrc=..."`
+	AccessToken     string `json:"access_token" example:"eyJhbGciOiJIUzI1NiIs..."`
+	// AccessTokenTTL is the access token's absolute expiry time, in epoch
+	// milliseconds (equal to the JWT exp claim), as required by WOPI/Collabora.
+	AccessTokenTTL  int64  `json:"access_token_ttl" example:"1782971996000"`
+}
+
+type FileManagerFileWOPISessionResponse struct {
+	Data FileManagerFileWOPISessionData `json:"data"`
+}
+
+type FileManagerFileBulkError struct {
+	Status    int    `json:"status" example:"422"`
+	Code      string `json:"code,omitempty" example:"FILE_MANAGER_VALIDATION_FAILED"`
+	ErrorCode string `json:"error_code,omitempty" example:"4222111"`
+	Title     string `json:"title" example:"Validation error"`
+	Detail    string `json:"detail" example:"duplicate name in target folder"`
+}
+
+type FileManagerFileBulkItem struct {
+	Index    int                       `json:"index" example:"0"`
+	Success  bool                      `json:"success" example:"true"`
+	Message  string                    `json:"message,omitempty" example:"created"`
+	Resource *FileManagerFileResource  `json:"resource,omitempty"`
+	Error    *FileManagerFileBulkError `json:"error,omitempty"`
+}
+
+type FileManagerFileBulkResponse struct {
+	Data []FileManagerFileBulkItem `json:"data"`
+	Meta struct {
+		Total          int  `json:"total" example:"3"`
+		Success        int  `json:"success" example:"2"`
+		Failed         int  `json:"failed" example:"1"`
+		PartialSuccess bool `json:"partial_success" example:"true"`
+	} `json:"meta"`
+}
+
+type FileManagerFileUploadIntentBulkItem struct {
+	Index    int                                  `json:"index" example:"0"`
+	Success  bool                                 `json:"success" example:"true"`
+	Resource *FileManagerFileUploadIntentResource `json:"resource,omitempty"`
+	Error    *FileManagerFileBulkError            `json:"error,omitempty"`
+}
+
+type FileManagerFileUploadIntentBulkResponse struct {
+	Data []FileManagerFileUploadIntentBulkItem `json:"data"`
+	Meta struct {
+		Total          int  `json:"total" example:"3"`
+		Success        int  `json:"success" example:"2"`
+		Failed         int  `json:"failed" example:"1"`
+		PartialSuccess bool `json:"partial_success" example:"true"`
+	} `json:"meta"`
+}
+
+type FileManagerFileCancelUploadResource struct {
+	Type       string `json:"type" example:"file_manager_file_cancel_upload_result"`
+	ID         string `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes struct {
+		Status string `json:"status" example:"canceled"`
+	} `json:"attributes"`
+}
+
+type FileManagerFileCancelUploadBulkItem struct {
+	Index    int                                  `json:"index" example:"0"`
+	Success  bool                                 `json:"success" example:"true"`
+	Resource *FileManagerFileCancelUploadResource `json:"resource,omitempty"`
+	Error    *FileManagerFileBulkError            `json:"error,omitempty"`
+}
+
+type FileManagerFileCancelUploadBulkResponse struct {
+	Data []FileManagerFileCancelUploadBulkItem `json:"data"`
+	Meta struct {
+		Total          int  `json:"total" example:"3"`
+		Success        int  `json:"success" example:"2"`
+		Failed         int  `json:"failed" example:"1"`
+		PartialSuccess bool `json:"partial_success" example:"true"`
+	} `json:"meta"`
+}

internal/transport/http/dto/response/file_manager_folder_response.go

@@ -0,0 +1,99 @@
+package response
+
+import shareddto "wucher/internal/transport/http/dto/shared"
+
+type FileManagerFolderResource struct {
+	Type       string                                `json:"type" example:"file_manager_folder"`
+	ID         string                                `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes shareddto.FileManagerFolderAttributes `json:"attributes"`
+}
+
+type FileManagerFolderResponse struct {
+	Data FileManagerFolderResource `json:"data"`
+}
+
+type FileManagerFolderDetailResource struct {
+	Type       string                                      `json:"type" example:"file_manager_folder"`
+	ID         string                                      `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes shareddto.FileManagerFolderDetailAttributes `json:"attributes"`
+}
+
+type FileManagerFolderDetailResponse struct {
+	Data FileManagerFolderDetailResource `json:"data"`
+}
+
+type FileManagerFolderListResponse struct {
+	Data []FileManagerFolderResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type FileManagerNodeAttributes struct {
+	NodeType    string  `json:"node_type" example:"folder"`
+	ParentID    *string `json:"parent_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name        string  `json:"name" example:"operations"`
+	Extension   string  `json:"extension,omitempty" example:"pdf"`
+	SizeBytes   int64   `json:"size_bytes,omitempty" example:"1024"`
+	MimeType    string  `json:"mime_type,omitempty" example:"application/pdf"`
+	DownloadURL string  `json:"download_url,omitempty" example:"https://s3.localhost.localstack.cloud:4566/wucher-file-dev/files/2026/04/05/policy.pdf?X-Amz-Signature=..."`
+	Status      string  `json:"status" example:"ready"`
+	PathCache   string  `json:"path_cache,omitempty" example:"/root/operations"`
+	CreatedAt   string  `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedAt   string  `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+}
+
+type FileManagerNodeResource struct {
+	Type       string                    `json:"type" example:"file_manager_node"`
+	ID         string                    `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes FileManagerNodeAttributes `json:"attributes"`
+}
+
+type FileManagerNodeListResponse struct {
+	Data []FileManagerNodeResource `json:"data"`
+	Meta struct {
+		ParentUUID *string                     `json:"parent_uuid,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+		Breadcrumb []FileManagerBreadcrumbItem `json:"breadcrumb,omitempty"`
+		IsRoot     bool                        `json:"is_root" example:"true"`
+		Folders    int                         `json:"folders" example:"4"`
+		Files      int                         `json:"files" example:"8"`
+		Total      int                         `json:"total" example:"12"`
+	} `json:"meta"`
+}
+
+type FileManagerBreadcrumbItem struct {
+	ID   string `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name string `json:"name" example:"operations"`
+}
+
+type FileManagerTrashNodeAttributes struct {
+	NodeType    string `json:"node_type" example:"folder"`
+	Name        string `json:"name" example:"Documents"`
+	Extension   string `json:"extension,omitempty" example:"pdf"`
+	SizeBytes   int64  `json:"size_bytes,omitempty" example:"123456"`
+	MimeType    string `json:"mime_type,omitempty" example:"application/pdf"`
+	DownloadURL string `json:"download_url,omitempty" example:"https://s3.localhost.localstack.cloud:4566/wucher-file-dev/files/2026/04/05/policy.pdf?X-Amz-Signature=..."`
+	PathCache   string `json:"path_cache,omitempty" example:"/Documents"`
+	TrashedAt   string `json:"trashed_at" example:"2026-04-01T10:00:00Z"`
+	CreatedAt   string `json:"created_at,omitempty" example:"2026-03-31T08:52:03Z"`
+	UpdatedAt   string `json:"updated_at,omitempty" example:"2026-03-31T08:52:03Z"`
+}
+
+type FileManagerTrashNodeResource struct {
+	Type       string                         `json:"type" example:"file_manager_trash_node"`
+	ID         string                         `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes FileManagerTrashNodeAttributes `json:"attributes"`
+}
+
+type FileManagerTrashListResponse struct {
+	Data []FileManagerTrashNodeResource `json:"data"`
+	Meta struct {
+		PageNumber int `json:"page_number" example:"1"`
+		PageSize   int `json:"page_size" example:"20"`
+		Total      int `json:"total" example:"120"`
+		Folders    int `json:"folders" example:"50"`
+		Files      int `json:"files" example:"70"`
+	} `json:"meta"`
+}

internal/transport/http/dto/response/fleet_history_response.go

@@ -0,0 +1,22 @@
+package response
+
+// FleetHistoryEntry is one event in a helicopter's unified timeline (complaint /
+// MEL / NSR / action / MCF / EASA / AOG events plus maintenance servicing).
+type FleetHistoryEntry struct {
+	At         string `json:"at" example:"2026-06-17T10:15:00Z"`
+	EntityType string `json:"entity_type" example:"easa_release"`
+	EntityID   string `json:"entity_id,omitempty" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Action     string `json:"action" example:"easa_signed"`
+	Message    string `json:"message" example:"Release to Service (EASA signed)"`
+	Actor      string `json:"actor,omitempty" example:"019e91e6-2908-7f37-93e6-015ed1b7587d"`
+	ActorName  string `json:"actor_name,omitempty" example:"John Doe"`
+}
+
+type FleetHistoryListResponse struct {
+	Data []FleetHistoryEntry `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"1"`
+	} `json:"meta"`
+}

internal/transport/http/dto/response/fleet_status_response.go

@@ -0,0 +1,107 @@
+package response
+
+import shareddto "wucher/internal/transport/http/dto/shared"
+
+type FleetStatusAttributes struct {
+	Helicopter           *shareddto.FleetStatusHelicopter          `json:"helicopter,omitempty"`
+	Status               string                                    `json:"status" example:"active" enums:"active,serviced"`
+	ServicedAt           string                                    `json:"serviced_at,omitempty" example:"2026-05-29T07:43:06Z"`
+	MaintenanceSchedules []shareddto.MaintenanceScheduleAttributes `json:"maintenance_schedules"`
+	Files                []FleetStatusFile                         `json:"files"`
+	Summary              shareddto.FleetStatusSummary              `json:"summary"`
+	MCF                  *shareddto.FleetStatusMCF                 `json:"mcf,omitempty"`
+	Complaints           []shareddto.FleetStatusComplaint          `json:"complaints,omitempty"`
+	EASARelease          *shareddto.FleetStatusEASARelease         `json:"easa_release,omitempty"`
+	CreatedAt            string                                    `json:"created_at,omitempty" example:"2026-05-29T07:43:06Z"`
+	CreatedBy            string                                    `json:"created_by,omitempty" example:"John Doe"`
+	UpdatedAt            string                                    `json:"updated_at,omitempty" example:"2026-05-29T07:43:06Z"`
+	UpdatedBy            string                                    `json:"updated_by,omitempty" example:"John Doe"`
+}
+
+type FleetStatusFile struct {
+	ID                   string `json:"id,omitempty" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	FileAttachmentID     string `json:"file_attachment_id" example:"019d7000-aaaa-7bbb-8ccc-111111111111"`
+	Category             string `json:"category" example:"wb"`
+	IsMandatory          bool   `json:"is_mandatory" example:"true"`
+	Name                 string `json:"name,omitempty" example:"weight_balance.pdf"`
+	DownloadURL          string `json:"download_url,omitempty" example:"https://storage.example.com/fleet/wb.pdf?X-Amz-Signature=abc123"`
+	ThumbnailDownloadURL string `json:"thumbnail_download_url,omitempty" example:"https://storage.example.com/fleet/wb.thumb.jpg?X-Amz-Signature=abc123"`
+	SizeBytes            *int64 `json:"size_bytes,omitempty" example:"1024000"`
+}
+
+type FleetStatusResource struct {
+	Type       string                `json:"type" example:"fleet_status"`
+	ID         string                `json:"id" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	Attributes FleetStatusAttributes `json:"attributes"`
+}
+
+type FleetStatusResponse struct {
+	Data FleetStatusResource `json:"data"`
+}
+
+type FleetStatusListResponse struct {
+	Data []FleetStatusResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"100"`
+	} `json:"meta"`
+}
+
+type FleetStatusDataTableResponse struct {
+	Data []FleetStatusResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"100"`
+		RecordsFiltered int64 `json:"records_filtered" example:"20"`
+	} `json:"meta"`
+}
+
+// FleetStatusDeleteResponse is the ack returned when a fleet status is deleted.
+type FleetStatusDeleteResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"fleet_status_delete"`
+		Attributes struct {
+			Deleted bool `json:"deleted" example:"true"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+// FleetStatusMarkServicedResponse is the ack returned when a fleet status is marked serviced.
+type FleetStatusMarkServicedResponse struct {
+	Data struct {
+		Type       string `json:"type" example:"fleet_status_mark_serviced"`
+		Attributes struct {
+			Serviced bool `json:"serviced" example:"true"`
+		} `json:"attributes"`
+	} `json:"data"`
+}
+
+type FleetStatusServiceLogAttributes struct {
+	FleetStatusID     string                           `json:"fleet_status_id" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	HelicopterID      string                           `json:"helicopter_id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Helicopter        *shareddto.FleetStatusHelicopter `json:"helicopter,omitempty"`
+	FleetStatusStatus string                           `json:"fleet_status_status,omitempty" example:"serviced"`
+	InspectionType    string                           `json:"inspection_type" example:"A/F"`
+	Type              string                           `json:"type" example:"100H"`
+	Due               string                           `json:"due" example:"1200 FH"`
+	Ext               string                           `json:"ext" example:"1300 FH"`
+	ServicedAt        string                           `json:"serviced_at" example:"2026-05-29T07:43:06Z"`
+	CreatedAt         string                           `json:"created_at" example:"2026-05-29T07:43:06Z"`
+	CreatedBy         string                           `json:"created_by" example:"John Doe"`
+}
+
+type FleetStatusServiceLogResource struct {
+	Type       string                          `json:"type" example:"fleet_status_service_log"`
+	ID         string                          `json:"id" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	Attributes FleetStatusServiceLogAttributes `json:"attributes"`
+}
+
+type FleetStatusServiceLogListResponse struct {
+	Data []FleetStatusServiceLogResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"100"`
+	} `json:"meta"`
+}

internal/transport/http/dto/response/flight_data_response.go

@@ -0,0 +1,139 @@
+package response
+
+type FlightDataAttributes struct {
+	Status                string                             `json:"status" example:"in_progress"`
+	Mission               *FlightDataMissionRef              `json:"mission,omitempty"`
+	RosterDetails         *TakeoverDutyRosterDetailsResponse `json:"roster_details,omitempty"`
+	HESLO                 *FlightDataSPOHESLODetails         `json:"heslo,omitempty" extensions:"x-note=Only returned for SPO missions"`
+	Logging               *FlightDataSPOLoggingDetails       `json:"logging,omitempty" extensions:"x-note=Only returned for SPO missions"`
+	HEC                   *FlightDataSPOHECDetails           `json:"hec,omitempty" extensions:"x-note=Only returned for SPO missions"`
+	CoPilot               *FlightDataCoPilotRef              `json:"co_pilot,omitempty"`
+	From                  *FlightDataLocationRef             `json:"from,omitempty"`
+	To                    *FlightDataLocationRef             `json:"to,omitempty"`
+	FlightTakeOff         string                             `json:"flight_take_off,omitempty" example:"2026-04-20T08:00:00Z"`
+	FlightLanding         string                             `json:"flight_landing,omitempty" example:"2026-04-20T09:15:00Z"`
+	FlightDuration        int64                              `json:"flight_duration_seconds" example:"4500"`
+	FlightRED             int64                              `json:"flight_red_seconds" example:"300"`
+	MaxN1                 float64                            `json:"max_n1" example:"97.5"`
+	MaxN2                 float64                            `json:"max_n2" example:"98.1"`
+	PaxCount              int                                `json:"pax_count" example:"4"`
+	LandingCount          int                                `json:"landing_count" example:"1"`
+	RotorBrakeCycle       int                                `json:"rotor_brake_cycle" example:"1"`
+	HookReleases          int                                `json:"hook_releases" example:"0"`
+	TicketNo              string                             `json:"ticket_no,omitempty" example:"TKT-001"`
+	Engine                string                             `json:"engine,omitempty" example:"PW207D1"`
+	DeliveryNoteNumber    string                             `json:"delivery_note_number,omitempty" example:"DN-1001"`
+	CustomerName          string                             `json:"customer_name,omitempty" example:"Air Service"`
+	FlightPlanDistance    float64                            `json:"flight_plan_distance" example:"120.5"`
+	FlightPlanTimeSeconds int64                              `json:"flight_plan_time_seconds" example:"4200"`
+	FlightPlanTrueCourse  float64                            `json:"flight_plan_true_course" example:"182.3"`
+	FuelBeforeFlight      float64                            `json:"fuel_before_flight" example:"420"`
+	FuelUpload            float64                            `json:"fuel_upload" example:"100"`
+	FuelAfterFlight       float64                            `json:"fuel_after_flight" example:"280"`
+	FuelPlanning          float64                            `json:"fuel_planning" example:"390"`
+	FlightPositioning     bool                               `json:"flight_positioning" example:"false"`
+	OtherInformation      string                             `json:"other_information,omitempty"`
+	CreatedAt             string                             `json:"created_at,omitempty" example:"2026-04-20T08:00:00Z"`
+	CreatedBy             string                             `json:"created_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	UpdatedAt             string                             `json:"updated_at,omitempty" example:"2026-04-20T08:00:00Z"`
+	UpdatedBy             string                             `json:"updated_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+}
+
+type FlightDataSPOHESLODetails struct {
+	Flights []FlightDataSPOHESLOFlight `json:"flights"`
+}
+
+type FlightDataSPOHESLOFlight struct {
+	ID  string `json:"id"`
+	ROT int    `json:"rot"`
+	// Facility category: heslo-rope-label.
+	HESLORopeLabelID   string                    `json:"heslo_rope_label_id,omitempty"`
+	HESLORopeLabelName string                    `json:"heslo_rope_label_name,omitempty"`
+	Slings             []FlightDataSPOHESLOSling `json:"slings"`
+}
+
+type FlightDataSPOHESLOSling struct {
+	ID string `json:"id"`
+	// Facility category: heslo-rope-length.
+	SlingID   string `json:"sling_id,omitempty"`
+	SlingName string `json:"sling_name,omitempty"`
+}
+
+type FlightDataSPOLoggingDetails struct {
+	Slings []FlightDataSPOLoggingSling `json:"slings"`
+}
+
+type FlightDataSPOLoggingSling struct {
+	ID string `json:"id"`
+	// Facility category: heslo-hook.
+	SlingID   string `json:"sling_id,omitempty"`
+	SlingName string `json:"sling_name,omitempty"`
+}
+
+type FlightDataSPOHECDetails struct {
+	Flights []FlightDataSPOHECFlight `json:"flights"`
+	Slings  []FlightDataSPOHECSling  `json:"slings"`
+	Loads   []FlightDataSPOHECLoad   `json:"loads"`
+}
+
+type FlightDataSPOHECFlight struct {
+	ID       string `json:"id"`
+	ROT      int    `json:"rot"`
+	HECCycle int    `json:"hec_cycle"`
+	// Facility category: hec-rope-label.
+	EquipmentID   string `json:"equipment_id,omitempty"`
+	EquipmentName string `json:"equipment_name,omitempty"`
+}
+
+type FlightDataSPOHECSling struct {
+	ID string `json:"id"`
+	// Facility category: hec-rope-length.
+	SlingID   string `json:"sling_id,omitempty"`
+	SlingName string `json:"sling_name,omitempty"`
+}
+
+type FlightDataSPOHECLoad struct {
+	ID string `json:"id"`
+	// Weight band for the HEC load, e.g. "bis 199 kg", "200-600 kg", "600-800 kg", "800-1000 kg".
+	LoadCategory string `json:"load_category,omitempty" example:"200-600 kg"`
+	Quantity     int    `json:"quantity" example:"3"`
+}
+
+type FlightDataMissionRef struct {
+	ID   string `json:"id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	Type string `json:"type,omitempty" example:"HEMS"`
+}
+
+type FlightDataCoPilotRef struct {
+	ID        string `json:"id,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	FirstName string `json:"first_name,omitempty" example:"John"`
+	LastName  string `json:"last_name,omitempty" example:"Doe"`
+	Email     string `json:"email,omitempty" example:"john.doe@example.com"`
+}
+
+type FlightDataLocationRef struct {
+	Type  string `json:"type,omitempty" example:"icao"`
+	ID    string `json:"id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	Code  string `json:"code,omitempty" example:"WIII"`
+	Name  string `json:"name,omitempty" example:"General Hospital"`
+	Label string `json:"label,omitempty" example:"WIII"`
+}
+
+type FlightDataResource struct {
+	Type       string               `json:"type" example:"flight_data"`
+	ID         string               `json:"id" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	Attributes FlightDataAttributes `json:"attributes"`
+}
+
+type FlightDataResponse struct {
+	Data FlightDataResource `json:"data"`
+}
+
+type FlightDataListResponse struct {
+	Data []FlightDataResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"1"`
+	} `json:"meta"`
+}

internal/transport/http/dto/response/flight_inspection_file_checklist_response.go

@@ -0,0 +1,22 @@
+package response
+
+import shareddto "wucher/internal/transport/http/dto/shared"
+
+type FlightInspectionFileChecklistResource struct {
+	Type       string                                            `json:"type" example:"flight_inspection_file_checklist"`
+	ID         string                                            `json:"id" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	Attributes shareddto.FlightInspectionFileChecklistAttributes `json:"attributes"`
+}
+
+type FlightInspectionFileChecklistResponse struct {
+	Data FlightInspectionFileChecklistResource `json:"data"`
+}
+
+type FlightInspectionFileChecklistListResponse struct {
+	Data []FlightInspectionFileChecklistResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"1"`
+	} `json:"meta"`
+}

internal/transport/http/dto/response/flight_response.go

@@ -0,0 +1,91 @@
+package response
+
+type FlightAttributes struct {
+	Status     string                 `json:"status" example:"draft"`
+	MissionID  string                 `json:"mission_id,omitempty" example:"019e9640-f7af-7940-80e8-1e9a83013afb"`
+	Code       string                 `json:"code" example:"M-062226-001"`
+	Date       string                 `json:"date" example:"2026-04-14"`
+	TotalDraft int                    `json:"total_draft" example:"6"`
+	Takeover   *FlightTakeoverSummary `json:"takeover,omitempty"`
+	Steps      []FlightStepItem       `json:"steps"`
+	Draft      []FlightDraftGroup     `json:"draft,omitempty"`
+	CreatedAt  string                 `json:"created_at,omitempty" example:"2026-04-14T08:00:00Z"`
+	CreatedBy  *UserRef               `json:"created_by,omitempty"`
+	UpdatedAt  string                 `json:"updated_at,omitempty" example:"2026-04-14T08:00:00Z"`
+	UpdatedBy  *UserRef               `json:"updated_by,omitempty"`
+	DeletedAt  string                 `json:"deleted_at,omitempty" example:"2026-04-14T08:00:00Z"`
+	DeletedBy  *UserRef               `json:"deleted_by,omitempty"`
+}
+
+type FlightStepItem struct {
+	Phase       string                     `json:"phase" example:"duty_roster"`
+	Position    string                     `json:"position,omitempty" example:"takeover"`
+	Step        int                        `json:"step,omitempty" example:"1"`
+	Complete    bool                       `json:"complete" example:"true"`
+	ID          string                     `json:"id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	Status      string                     `json:"status" example:"completed"`
+	MissionType []FlightMissionTypeSummary `json:"mission_type,omitempty"`
+	CompletedAt string                     `json:"completed_at" example:"2026-04-14T08:00:00Z"`
+	CompletedBy string                     `json:"completed_by" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+}
+
+type FlightHelicopterSummary struct {
+	AOG         bool   `json:"aog" example:"false"`
+	Designation string `json:"designation" example:"AIRBUS H145"`
+	ID          string `json:"id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Identifier  string `json:"identifier" example:"D-HYAR"`
+	IsActive    bool   `json:"is_active" example:"true"`
+	Type        string `json:"type" example:"H145"`
+}
+
+type FlightTakeoverSummary struct {
+	ID              string                             `json:"id,omitempty" example:"019e8713-aa19-7fb7-a510-a0332dc69697"`
+	Helicopter      *FlightHelicopterSummary           `json:"helicopter,omitempty"`
+	DailyInspection *FlightDailyInspectionSummary      `json:"daily_inspection,omitempty"`
+	RosterDetail    *TakeoverDutyRosterDetailsResponse `json:"roster_detail,omitempty"`
+}
+
+type FlightDailyInspectionSummary struct {
+	ID        string `json:"id" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	Name      string `json:"name" example:"Ganahl Stefan"`
+	ShortName string `json:"short_name" example:"GAN"`
+	Date      string `json:"date" example:"17.04.2026"`
+	UTCTime   string `json:"utc_time" example:"10:57"`
+}
+
+type FlightDraftItem struct {
+	ID           string `json:"id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	Type         string `json:"type" example:"HEMS"`
+	Status       string `json:"status" example:"draft"`
+	FlightDataID string `json:"flight_data_id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a55"`
+}
+
+type FlightDraftGroup struct {
+	Type  string            `json:"type" example:"HEMS"`
+	Items []FlightDraftItem `json:"items"`
+}
+
+type FlightMissionTypeSummary struct {
+	Type      string `json:"type" example:"HEMS"`
+	Draft     int    `json:"draft" example:"5"`
+	Completed int    `json:"completed" example:"0"`
+}
+
+type FlightResource struct {
+	Type       string           `json:"type" example:"flight"`
+	ID         string           `json:"id" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	Attributes FlightAttributes `json:"attributes"`
+}
+
+type FlightResponse struct {
+	Data FlightResource `json:"data"`
+}
+
+type FlightListResponse struct {
+	Data []FlightResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"1"`
+	} `json:"meta"`
+}

internal/transport/http/dto/response/helicopter_file_response.go

@@ -0,0 +1,170 @@
+package response
+
+import (
+	shareddto "wucher/internal/transport/http/dto/shared"
+	"wucher/internal/transport/http/jsonapi"
+)
+
+type HelicopterFileResource struct {
+	Type       string                             `json:"type" example:"helicopter_file"`
+	ID         string                             `json:"id" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	Attributes shareddto.HelicopterFileAttributes `json:"attributes"`
+}
+
+type HelicopterFileResponse struct {
+	Data HelicopterFileResource `json:"data"`
+}
+
+type HelicopterFileListResponse struct {
+	Data []HelicopterFileResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"1"`
+	} `json:"meta"`
+}
+
+type HelicopterFileCollectionHelicopter struct {
+	ID   string `json:"id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Name string `json:"name" example:"AIRBUS H145"`
+}
+
+type HelicopterFileCollectionAttachment struct {
+	ID          string `json:"id" example:"019d6771-6c8e-7a2d-a7b8-03bcb65fcb3e"`
+	FileName    string `json:"file_name" example:"Before Flight Checklist.pdf"`
+	DownloadURL string `json:"download_url" example:"https://s3.localhost.localstack.cloud:4566/wucher-file-dev/files/2026/04/05/policy.pdf?X-Amz-Signature=..."`
+}
+
+type HelicopterFileCollectionItem struct {
+	HelicopterFileID  string                             `json:"helicopter_file_id" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	Section           string                             `json:"section" example:"bfi"`
+	Position          int                                `json:"position" example:"1"`
+	IsMandatory       bool                               `json:"is_mandatory" example:"true"`
+	IsTemplate        bool                               `json:"is_template" example:"true"`
+	AttachmentPending bool                               `json:"attachment_pending" example:"true"`
+	Attachment        HelicopterFileCollectionAttachment `json:"attachment"`
+	CreatedAt         string                             `json:"created_at" example:"2026-04-14T08:00:00Z"`
+	CreatedBy         string                             `json:"created_by" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	UpdatedAt         string                             `json:"updated_at" example:"2026-04-14T08:00:00Z"`
+	UpdatedBy         string                             `json:"updated_by" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+}
+
+type HelicopterFileCollectionSections struct {
+	Before  []HelicopterFileCollectionItem `json:"before"`
+	Prepare []HelicopterFileCollectionItem `json:"prepare"`
+	After   []HelicopterFileCollectionItem `json:"after"`
+}
+
+type HelicopterFileCollectionAttributes struct {
+	Helicopter HelicopterFileCollectionHelicopter `json:"helicopter"`
+	Files      HelicopterFileCollectionSections   `json:"files"`
+}
+
+type HelicopterFileCollectionResponse struct {
+	Type       string                             `json:"type" example:"helicopter_file_collection"`
+	Attributes HelicopterFileCollectionAttributes `json:"attributes"`
+}
+
+type HelicopterFileCollectionListResponse struct {
+	Data []HelicopterFileCollectionResponse `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"1"`
+	} `json:"meta"`
+}
+
+type HelicopterFileDeleteAttributes struct {
+	Deleted bool `json:"deleted" example:"true"`
+}
+
+type HelicopterFileDeleteResource struct {
+	Type       string                         `json:"type" example:"helicopter_file_delete"`
+	Attributes HelicopterFileDeleteAttributes `json:"attributes"`
+}
+
+type HelicopterFileDeleteResponse struct {
+	Data HelicopterFileDeleteResource `json:"data"`
+}
+
+type HelicopterFileUploadIntentResource struct {
+	Type       string                                          `json:"type" example:"helicopter_file_upload_intent"`
+	ID         string                                          `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes shareddto.FileManagerFileUploadIntentAttributes `json:"attributes"`
+}
+
+type HelicopterFileUploadIntentResponse struct {
+	Data HelicopterFileUploadIntentResource `json:"data"`
+}
+
+type HelicopterFileBulkError struct {
+	Status    int    `json:"status" example:"422"`
+	Code      string `json:"code,omitempty" example:"HELICOPTER_FILE_INVALID_PAYLOAD"`
+	ErrorCode string `json:"error_code,omitempty" example:"4220318"`
+	Title     string `json:"title" example:"Validation error"`
+	Detail    string `json:"detail" example:"helicopter_id is invalid UUID"`
+}
+
+type HelicopterFileUploadIntentBulkItem struct {
+	Index    int                                 `json:"index" example:"0"`
+	Success  bool                                `json:"success" example:"true"`
+	Resource *HelicopterFileUploadIntentResource `json:"resource,omitempty"`
+	Error    *HelicopterFileBulkError            `json:"error,omitempty"`
+}
+
+type HelicopterFileUploadIntentBulkResponse struct {
+	Data []HelicopterFileUploadIntentBulkItem `json:"data"`
+	Meta struct {
+		Total          int  `json:"total" example:"3"`
+		Success        int  `json:"success" example:"2"`
+		Failed         int  `json:"failed" example:"1"`
+		PartialSuccess bool `json:"partial_success" example:"true"`
+	} `json:"meta"`
+}
+
+type HelicopterFileCreateBulkItem struct {
+	Index    int                      `json:"index" example:"0"`
+	Success  bool                     `json:"success" example:"true"`
+	Resource *jsonapi.Resource        `json:"resource,omitempty"`
+	Error    *HelicopterFileBulkError `json:"error,omitempty"`
+}
+
+type HelicopterFileCreateBulkResponse struct {
+	Data []HelicopterFileCreateBulkItem `json:"data"`
+	Meta struct {
+		Total          int  `json:"total" example:"3"`
+		Success        int  `json:"success" example:"2"`
+		Failed         int  `json:"failed" example:"1"`
+		PartialSuccess bool `json:"partial_success" example:"true"`
+	} `json:"meta"`
+}
+
+type HelicopterFileUpdateBulkItem struct {
+	Index    int                      `json:"index" example:"0"`
+	Success  bool                     `json:"success" example:"true"`
+	Resource *jsonapi.Resource        `json:"resource,omitempty"`
+	Error    *HelicopterFileBulkError `json:"error,omitempty"`
+}
+
+type HelicopterFileUpdateBulkResponse struct {
+	Data []HelicopterFileUpdateBulkItem `json:"data"`
+	Meta struct {
+		Total          int  `json:"total" example:"3"`
+		Success        int  `json:"success" example:"2"`
+		Failed         int  `json:"failed" example:"1"`
+		PartialSuccess bool `json:"partial_success" example:"true"`
+	} `json:"meta"`
+}
+
+type HelicopterFileCreatedSSEPayload struct {
+	HelicopterID      string `json:"helicopter_id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	HelicopterFileID  string `json:"helicopter_file_id" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	FileID            string `json:"file_id" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	Section           string `json:"section" example:"fpwb"`
+	Position          int    `json:"position" example:"1"`
+	IsMandatory       bool   `json:"is_mandatory" example:"true"`
+	AttachmentPending bool   `json:"attachment_pending" example:"true"`
+	Name              string `json:"name" example:"Before Flight Checklist.pdf"`
+	MimeType          string `json:"mime_type,omitempty" example:"application/pdf"`
+	UpdatedAt         string `json:"updated_at" example:"2026-07-01T06:00:00Z"`
+}

internal/transport/http/dto/response/helicopter_response.go

@@ -0,0 +1,88 @@
+package response
+
+import shareddto "wucher/internal/transport/http/dto/shared"
+
+// JSON:API Helicopter response DTOs
+
+type HelicopterAttributes struct {
+	Designation string                    `json:"designation" example:"OE-XHZ"`
+	Identifier  string                    `json:"identifier" example:"ABC-0001"`
+	Type        string                    `json:"type" example:"EC-135"`
+	SortKey     *int                      `json:"sortkey" example:"10"`
+	Engine1     string                    `json:"engine_1,omitempty" example:"TM"`
+	Engine2     string                    `json:"engine_2,omitempty" example:"TM"`
+	Consumption float64                   `json:"consumption_lt_min" example:"4.1"`
+	NR1         bool                      `json:"nr1" example:"true"`
+	NR2         bool                      `json:"nr2" example:"true"`
+	LH          bool                      `json:"lh" example:"true"`
+	RH          bool                      `json:"rh" example:"true"`
+	MGB         bool                      `json:"mgb" example:"true"`
+	IGB         bool                      `json:"igb" example:"false"`
+	TGB         bool                      `json:"tgb" example:"true"`
+	UTCOffset   int                       `json:"utc_offset" example:"-1"`
+	Foto        *shareddto.HelicopterFoto `json:"foto,omitempty"`
+	Dry         bool                      `json:"dry" example:"false"`
+	AOG         bool                      `json:"aog" example:"false"`
+	IsInUse     bool                      `json:"is_in_use" example:"false"`
+	// Status is the operational status of the helicopter (read-time derived).
+	// Values: "available", "booked", "aog", "mcf". Precedence: mcf > aog > booked > available.
+	// "booked" = active flight assignment; "aog" = air_on_ground flag OR an open complaint
+	// grounding it (non-MEL, or MEL past its grace deadline); "mcf" = a pending maintenance
+	// check flight (MCF created, not yet passed).
+	Status              string                                   `json:"status" example:"available" enums:"available,booked,aog,mcf"`
+	AOGReason           string                                   `json:"aog_reason,omitempty" example:"Main rotor gearbox fault"`
+	Note                string                                   `json:"note,omitempty" example:"Primary HEMS helicopter"`
+	IsActive            bool                                     `json:"is_active" example:"true"`
+	CreatedBy           *shareddto.HelicopterAuditUser           `json:"created_by,omitempty"`
+	CreatedAt           string                                   `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy           *shareddto.HelicopterAuditUser           `json:"updated_by,omitempty"`
+	UpdatedAt           string                                   `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	LastDailyInspection *shareddto.HelicopterLastDailyInspection `json:"last_daily_inspection"`
+	// MaintenanceSchedules mirrors the helicopter's latest fleet status. It
+	// always lists every inspection type; entries without data are empty.
+	MaintenanceSchedules []shareddto.MaintenanceScheduleAttributes `json:"maintenance_schedules"`
+}
+
+type HelicopterResource struct {
+	Type       string               `json:"type" example:"helicopter"`
+	ID         string               `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes HelicopterAttributes `json:"attributes"`
+}
+
+type HelicopterResponse struct {
+	Data HelicopterResource `json:"data"`
+}
+
+type HelicopterListResponse struct {
+	Data []HelicopterResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type HelicopterDataTableResponse struct {
+	Data []HelicopterResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type HelicopterNextReportNumberAttributes struct {
+	Identifier   string `json:"identifier" example:"ABC"`
+	Sequence     int    `json:"sequence" example:"1"`
+	ReportNumber string `json:"report_number" example:"ABC-0001"`
+}
+
+type HelicopterNextReportNumberResource struct {
+	Type       string                               `json:"type" example:"helicopter_report_number"`
+	ID         string                               `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes HelicopterNextReportNumberAttributes `json:"attributes"`
+}
+
+type HelicopterNextReportNumberResponse struct {
+	Data HelicopterNextReportNumberResource `json:"data"`
+}

internal/transport/http/dto/response/master_settings_microsoft_entra_response.go

@@ -0,0 +1,19 @@
+package response
+
+type MasterSettingsMicrosoftEntraAttributes struct {
+	TenantID           string `json:"MS_ENTRA_TENANT_ID" example:"your-tenant-id"`
+	ClientID           string `json:"MS_ENTRA_CLIENT_ID" example:"your-client-id"`
+	ClientSecretMasked string `json:"MS_ENTRA_CLIENT_SECRET" example:"********"`
+	RedirectURL        string `json:"MS_ENTRA_REDIRECT_URL" example:"https://example.com/api/v1/auth/microsoft/callback"`
+	Authority          string `json:"MS_ENTRA_AUTHORITY" example:"https://login.microsoftonline.com/"`
+	Scopes             string `json:"MS_ENTRA_SCOPES" example:"openid,profile,email"`
+}
+
+type MasterSettingsMicrosoftEntraResource struct {
+	Type       string                                 `json:"type" example:"master_settings_microsoft_entra_sso"`
+	Attributes MasterSettingsMicrosoftEntraAttributes `json:"attributes"`
+}
+
+type MasterSettingsMicrosoftEntraResponse struct {
+	Data MasterSettingsMicrosoftEntraResource `json:"data"`
+}

internal/transport/http/dto/response/master_settings_response.go

@@ -0,0 +1,49 @@
+package response
+
+type MasterSettingsAttributes struct {
+	CompanyName    string  `json:"company_name" example:"Wucher"`
+	Title          string  `json:"title,omitempty" example:"Welcome to Wucher"`
+	Subtitle       string  `json:"subtitle,omitempty" example:"Flight operations platform"`
+	LogoFileUUID   *string `json:"logo_file_uuid" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	LogoURL        *string `json:"logo_url" example:"https://cdn.example.com/logo.png"`
+	LogoThumbURL   *string `json:"logo_thumbnail_url,omitempty" example:"https://cdn.example.com/logo.thumb.png"`
+	LogoSizeBytes  *int64  `json:"logo_original_size_bytes,omitempty" example:"1024000"`
+	CoverFileUUID  *string `json:"cover_file_uuid" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CoverURL       *string `json:"cover_url" example:"https://cdn.example.com/cover.png"`
+	CoverThumbURL  *string `json:"cover_thumbnail_url,omitempty" example:"https://cdn.example.com/cover.thumb.png"`
+	CoverSizeBytes *int64  `json:"cover_original_size_bytes,omitempty" example:"2048000"`
+	CreatedAt      string  `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy      string  `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt      string  `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy      string  `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt      string  `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy      string  `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type MasterSettingsResource struct {
+	Type       string                   `json:"type" example:"master_settings"`
+	ID         string                   `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes MasterSettingsAttributes `json:"attributes"`
+}
+
+type MasterSettingsResponse struct {
+	Data MasterSettingsResource `json:"data"`
+}
+
+type MasterSettingsListResponse struct {
+	Data []MasterSettingsResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type MasterSettingsDataTableResponse struct {
+	Data []MasterSettingsResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}

internal/transport/http/dto/response/mcf_response.go

@@ -0,0 +1,40 @@
+package response
+
+type MCFAttributes struct {
+	HelicopterID string  `json:"helicopter_id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	FlightID     string  `json:"flight_id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	Date         string  `json:"date" example:"2026-06-17"`
+	AFHours      string  `json:"af_hours,omitempty" example:"1245.3"`
+	LandingCount int     `json:"landing_count" example:"3"`
+	UTCTime      *string `json:"utc_time,omitempty" example:"2026-06-17T08:30:00Z"`
+	DecidedBy    string  `json:"decided_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	DecidedAt    *string `json:"decided_at,omitempty" example:"2026-06-16T03:04:05Z"`
+	Result       *string `json:"result,omitempty" example:"passed" enums:"passed,failed"`
+
+	Notes       *string `json:"notes,omitempty" example:"Vibration within limits"`
+	CompletedBy string  `json:"completed_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	CompletedAt *string `json:"completed_at,omitempty" example:"2026-06-16T03:04:05Z"`
+
+	IsComplete bool   `json:"is_complete" example:"false"`
+	IsCleared  bool   `json:"is_cleared" example:"false"`
+	IsPending  bool   `json:"is_pending" example:"true"`
+	CreatedAt  string `json:"created_at,omitempty" example:"2026-06-16T03:04:05Z"`
+	UpdatedAt  string `json:"updated_at,omitempty" example:"2026-06-16T03:04:05Z"`
+}
+
+type MCFResource struct {
+	Type       string        `json:"type" example:"mcf"`
+	ID         string        `json:"id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Attributes MCFAttributes `json:"attributes"`
+}
+
+type MCFResponse struct {
+	Data MCFResource `json:"data"`
+}
+
+type MCFListResponse struct {
+	Data []MCFResource `json:"data"`
+	Meta struct {
+		Total int64 `json:"total" example:"1"`
+	} `json:"meta"`
+}

internal/transport/http/dto/response/mission_response.go

@@ -0,0 +1,93 @@
+package response
+
+type MissionAttributes struct {
+	Flight      *MissionFlightRef  `json:"flight,omitempty"`
+	Type        string             `json:"type" example:"HEMS"`
+	MissionCode string             `json:"mission_code" example:"HEMS-26-1"`
+	Subtypes    *MissionSubtypeRef `json:"subtypes,omitempty"`
+	Note        string             `json:"note,omitempty" example:"Mission note"`
+	StartTime   string             `json:"start_time,omitempty" example:"04:49"`
+	EndTime     string             `json:"end_time,omitempty" example:"22:05"`
+	Status      string             `json:"status" example:"completed"`
+	Forms       *MissionForms      `json:"forms,omitempty"`
+	Files       []MissionFileItem  `json:"files,omitempty"`
+	CreatedAt   string             `json:"created_at,omitempty" example:"2026-04-20T08:00:00Z"`
+	CreatedBy   string             `json:"created_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	UpdatedAt   string             `json:"updated_at,omitempty" example:"2026-04-20T08:00:00Z"`
+	UpdatedBy   string             `json:"updated_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+}
+
+type MissionForms struct {
+	FlightData []FlightDataResource `json:"flight_data,omitempty"`
+}
+
+type MissionFileItem struct {
+	ID           string `json:"id" example:"019d6771-6c8e-7a2d-a7b8-03bcb65fcb3e"`
+	AttachmentID string `json:"attachment_id,omitempty" example:"019d6771-6c8e-7a2d-a7b8-03bcb65fcb3e"`
+	FileName     string `json:"file_name,omitempty" example:"mission-brief.pdf"`
+	DownloadURL  string `json:"download_url,omitempty" example:"https://s3.localhost.localstack.cloud:4566/wucher-file-dev/files/2026/04/05/brief.pdf?X-Amz-Signature=..."`
+	ThumbnailURL string `json:"thumbnail_url,omitempty" example:"https://s3.localhost.localstack.cloud:4566/wucher-file-dev/thumbnails/2026/04/05/brief.png?X-Amz-Signature=..."`
+}
+
+type MissionFlightRef struct {
+	ID   string `json:"id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	Code string `json:"code,omitempty" example:"M-062226-001"`
+	Date string `json:"date,omitempty" example:"2026-04-20"`
+}
+
+type MissionSubtypeRef struct {
+	ID          string `json:"id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a99"`
+	Subtype     string `json:"subtype,omitempty" example:"PRIM"`
+	SubtypeName string `json:"subtype_name,omitempty" example:"Nicht transportfaehig"`
+}
+
+type MissionResource struct {
+	Type       string            `json:"type" example:"mission"`
+	ID         string            `json:"id" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	Attributes MissionAttributes `json:"attributes"`
+}
+
+type MissionResponse struct {
+	Data MissionResource `json:"data"`
+}
+
+type MissionListResponse struct {
+	Data []MissionResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type MissionDataTableResponse struct {
+	Data []MissionResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"42"`
+	} `json:"meta"`
+}
+
+type MissionTypeSubtypeItem struct {
+	ID       string `json:"id" example:"019d6774-98e8-7fba-9ef4-3795c0da8a99"`
+	Code     string `json:"code" example:"PRIM"`
+	Name     string `json:"name" example:"Primary"`
+	TaskName string `json:"task_name" example:"Nicht transportfaehig"`
+}
+
+type MissionTypeAttributes struct {
+	Code     string                   `json:"code" example:"HEMS"`
+	Name     string                   `json:"name" example:"HEMS"`
+	Subtypes []MissionTypeSubtypeItem `json:"subtypes,omitempty"`
+}
+
+type MissionTypeResource struct {
+	Type       string                `json:"type" example:"mission_type"`
+	ID         string                `json:"id" example:"019d6774-98e8-7fba-9ef4-3795c0da8a77"`
+	Attributes MissionTypeAttributes `json:"attributes"`
+}
+
+type MissionTypeListResponse struct {
+	Data []MissionTypeResource `json:"data"`
+}

internal/transport/http/dto/response/other_person_response.go

@@ -0,0 +1,24 @@
+package response
+
+type OtherPersonAttributes struct {
+	Name        string `json:"name" example:"Guest Person"`
+	MobilePhone string `json:"mobile_phone,omitempty" example:"+43-1234"`
+	Email       string `json:"email,omitempty" example:"guest@example.com"`
+}
+
+type OtherPersonResource struct {
+	Type       string                `json:"type" example:"other_person"`
+	ID         string                `json:"id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Attributes OtherPersonAttributes `json:"attributes"`
+}
+
+type OtherPersonListResponse struct {
+	Data []OtherPersonResource `json:"data"`
+	Meta struct {
+		Total int64 `json:"total" example:"1"`
+	} `json:"meta"`
+}
+
+type OtherPersonResponse struct {
+	Data OtherPersonResource `json:"data"`
+}

internal/transport/http/dto/response/reserve_ac_response.go

@@ -0,0 +1,98 @@
+package response
+
+import shareddto "wucher/internal/transport/http/dto/shared"
+
+type ReserveAcResource struct {
+	Type       string                        `json:"type" example:"reserve_ac"`
+	ID         string                        `json:"id" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	Attributes shareddto.ReserveAcAttributes `json:"attributes"`
+}
+
+type ReserveAcResponse struct {
+	Data ReserveAcResource `json:"data"`
+}
+
+type ReserveAcListResponse struct {
+	Data []ReserveAcResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"1"`
+	} `json:"meta"`
+}
+
+type ReserveAcHelicopterGroupResource struct {
+	Type       string                             `json:"type"`
+	Attributes ReserveAcHelicopterGroupAttributes `json:"attributes"`
+}
+
+type ReserveAcHelicopterGroupAttributes struct {
+	Helicopter          ReserveAcHelicopterIdentity     `json:"helicopter"`
+	LastDailyInspection ReserveAcLastDailyInspectionDTO `json:"last_daily_inspection"`
+	BFI                 ReserveAcBFISection             `json:"bfi"`
+	FPWB                ReserveAcFPWBSection            `json:"fpwb"`
+}
+
+type ReserveAcHelicopterIdentity struct {
+	ID             string                      `json:"id"`
+	Designation    string                      `json:"designation"`
+	Identifier     string                      `json:"identifier"`
+	Type           string                      `json:"type"`
+	Status         string                      `json:"status"`
+	BookingDetails *ReserveAcBookingDetailsDTO `json:"booking_details,omitempty"`
+}
+
+type ReserveAcLastDailyInspectionDTO struct {
+	ID           any                          `json:"id"`
+	InspectionBy ReserveAcInspectionBySummary `json:"inspection_by"`
+	InspectionAt any                          `json:"inspection_at"`
+}
+
+type ReserveAcInspectionBySummary struct {
+	ID        any    `json:"id"`
+	Name      string `json:"name"`
+	ShortName string `json:"short_name"`
+}
+
+type ReserveAcBookingDetailsDTO struct {
+	ReserveAcID any            `json:"reserve_ac_id,omitempty"`
+	FlightID    any            `json:"flight_id,omitempty"`
+	MissionCode any            `json:"mission_code,omitempty"`
+	DutyDate    any            `json:"duty_date,omitempty"`
+	BookedAt    any            `json:"booked_at,omitempty"`
+	BookedBy    map[string]any `json:"booked_by,omitempty"`
+}
+
+type ReserveAcHelicopterFileItem struct {
+	ID         string `json:"id"`
+	FileName   string `json:"file_name"`
+	URL        string `json:"url"`
+	UploadedAt string `json:"uploaded_at"`
+	UploadedBy string `json:"uploaded_by"`
+}
+
+type ReserveAcHelicopterFileSection struct {
+	Files []ReserveAcHelicopterFileItem `json:"files"`
+}
+
+type ReserveAcBFISection struct {
+	FuelAddedAmount           *float64                      `json:"fuel_added_amount,omitempty"`
+	FuelAmount                *float64                      `json:"fuel_amount,omitempty"`
+	FuelUnit                  string                        `json:"fuel_unit,omitempty"`
+	HydraulicLHChecked        *bool                         `json:"hydraulic_lh_checked,omitempty"`
+	HydraulicRHChecked        *bool                         `json:"hydraulic_rh_checked,omitempty"`
+	Note                      *string                       `json:"note,omitempty"`
+	OilEngineNR1Checked       *bool                         `json:"oil_engine_nr1_checked,omitempty"`
+	OilEngineNR2Checked       *bool                         `json:"oil_engine_nr2_checked,omitempty"`
+	OilTransmissionIGBChecked *bool                         `json:"oil_transmission_igb_checked,omitempty"`
+	OilTransmissionMGBChecked *bool                         `json:"oil_transmission_mgb_checked,omitempty"`
+	OilTransmissionTGBChecked *bool                         `json:"oil_transmission_tgb_checked,omitempty"`
+	Files                     []ReserveAcHelicopterFileItem `json:"files"`
+}
+
+type ReserveAcFPWBSection struct {
+	NotamBriefing         *bool                         `json:"notam_briefing,omitempty"`
+	WeatherBriefing       *bool                         `json:"weather_briefing,omitempty"`
+	OperationalFlightPlan *bool                         `json:"operational_flight_plan,omitempty"`
+	Files                 []ReserveAcHelicopterFileItem `json:"files"`
+}

internal/transport/http/dto/response/takeover_response.go

@@ -0,0 +1,112 @@
+package response
+
+import (
+	shareddto "wucher/internal/transport/http/dto/shared"
+)
+
+type TakeoverResponseAttributes struct {
+	ID                 string                               `json:"id,omitempty"`
+	FlightID           string                               `json:"flight_id,omitempty"`
+	ReserveAcID        string                               `json:"reserve_ac_id,omitempty"`
+	FlightInspectionID string                               `json:"flight_inspection_id,omitempty"`
+	ShiftStart         string                               `json:"shift_start,omitempty"`
+	ShiftEnd           string                               `json:"shift_end,omitempty"`
+	BaseID             string                               `json:"base_id,omitempty"`
+	Base               *DutyRosterBaseInfo                  `json:"base,omitempty"`
+	DutyDate           string                               `json:"duty_date,omitempty"`
+	HelicopterID       string                               `json:"helicopter_id,omitempty"`
+	Helicopter         *TakeoverHelicopter                  `json:"helicopter,omitempty"`
+	Notes              *string                              `json:"notes,omitempty"`
+	CreatedBy          string                               `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedBy          string                               `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CreatedAt          string                               `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedAt          string                               `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	RosterDetail       TakeoverDutyRosterDetailsResponse    `json:"roster_detail"`
+	Inspection         shareddto.ReserveAcInspectionSummary `json:"inspection"`
+	Files              []TakeoverFileResource               `json:"files,omitempty"`
+}
+
+// TakeoverHelicopter is the selected helicopter shown on a takeover, enriched
+// with its last daily inspection and its maintenance schedule (the "next due"
+// per inspection type) from the helicopter's latest fleet status.
+type TakeoverHelicopter struct {
+	ID                   string                                    `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Designation          string                                    `json:"designation" example:"OE-XHZ"`
+	Identifier           string                                    `json:"identifier" example:"1234"`
+	Type                 string                                    `json:"type" example:"EC-135"`
+	LastDailyInspection  *shareddto.HelicopterLastDailyInspection  `json:"last_daily_inspection"`
+	MaintenanceSchedules []shareddto.MaintenanceScheduleAttributes `json:"maintenance_schedules"`
+}
+
+type TakeoverDutyRosterAttributes struct {
+	Bases      DutyRosterBaseInfo                `json:"bases"`
+	FlightID   string                            `json:"flight_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Helicopter DutyRosterHelicopterSummary       `json:"helicopter"`
+	DutyDate   string                            `json:"duty_date,omitempty" example:"2026-03-16"`
+	Detail     TakeoverDutyRosterDetailsResponse `json:"roster_detail"`
+	CreatedBy  string                            `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CreatedAt  string                            `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedAt  string                            `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+}
+
+type TakeoverDutyRosterResource struct {
+	Type       string                       `json:"type" example:"duty_roster"`
+	ID         string                       `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes TakeoverDutyRosterAttributes `json:"attributes"`
+}
+
+type TakeoverDutyRosterCrew struct {
+	ID          string `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name        string `json:"name,omitempty" example:"Hunter Wolfgang"`
+	Role        string `json:"role,omitempty" example:"doctor"`
+	MobilePhone string `json:"mobile_phone,omitempty" example:"+43-1234"`
+	Email       string `json:"email,omitempty" example:"doctor@example.com"`
+}
+
+type TakeoverDutyRosterPilotCrew struct {
+	ID               string `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name             string `json:"name,omitempty" example:"Hunter Wolfgang"`
+	Role             string `json:"role,omitempty" example:"pilot"`
+	MobilePhone      string `json:"mobile_phone,omitempty" example:"+43-1234"`
+	Email            string `json:"email,omitempty" example:"pilot@example.com"`
+	CrewType         string `json:"crew_type,omitempty" example:"main"`
+	FlightInstructor *bool  `json:"flight_instructor,omitempty"`
+	LineChecker      *bool  `json:"line_checker,omitempty"`
+	Supervisor       *bool  `json:"supervisor,omitempty"`
+	Examiner         *bool  `json:"examiner,omitempty"`
+	CoPilot          *bool  `json:"co_pilot,omitempty"`
+}
+
+type TakeoverDutyRosterDetailsResponse struct {
+	Pilot       []TakeoverDutyRosterPilotCrew `json:"pilot"`
+	Doctor      []TakeoverDutyRosterCrew      `json:"doctor"`
+	Rescuer     []TakeoverDutyRosterCrew      `json:"rescuer"`
+	Helper      []TakeoverDutyRosterCrew      `json:"helper"`
+	OtherPerson []TakeoverDutyRosterCrew      `json:"other_person"`
+}
+
+type TakeoverResource struct {
+	Type       string                     `json:"type" example:"takeover"`
+	Attributes TakeoverResponseAttributes `json:"attributes"`
+}
+
+type TakeoverFileAttributes struct {
+	FileAttachmentID string `json:"file_attachment_id" example:"019d7000-aaaa-7bbb-8ccc-222222222222"`
+	FileName         string `json:"file_name,omitempty" example:"takeover-report.pdf"`
+	DownloadURL      string `json:"download_url,omitempty" example:"https://s3.localhost.localstack.cloud:4566/wucher-file-dev/files/2026/04/05/takeover-report.pdf?X-Amz-Signature=..."`
+}
+
+type TakeoverFileResource struct {
+	Type       string                 `json:"type" example:"takeover_file"`
+	ID         string                 `json:"id,omitempty" example:"019d7000-aaaa-7bbb-8ccc-111111111111"`
+	Attributes TakeoverFileAttributes `json:"attributes"`
+}
+
+type TakeoverResponse struct {
+	Data TakeoverResource `json:"data"`
+}
+
+type TakeoverListResponse struct {
+	Data []TakeoverResource `json:"data"`
+	Meta map[string]any     `json:"meta,omitempty"`
+}

internal/transport/http/dto/response/user_ref.go

@@ -0,0 +1,8 @@
+package response
+
+// UserRef is an audit user reference exposing both the raw UUID and a resolved
+// display name, e.g. for created_by / updated_by fields.
+type UserRef struct {
+	UUID string `json:"uuid" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	Name string `json:"name,omitempty" example:"Ganahl Stefan"`
+}

internal/transport/http/dto/role_dto.go

@@ -0,0 +1,174 @@
+package dto
+
+// JSON:API Role DTOs
+
+type RoleAttributes struct {
+	Name        string `json:"name" example:"admin"`
+	Description string `json:"description,omitempty" example:"Full access to all resources."`
+	CreatedBy   string `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CreatedAt   string `json:"created_at,omitempty" example:"2026-02-05T10:00:00Z"`
+	UpdatedAt   string `json:"updated_at,omitempty" example:"2026-02-05T10:00:00Z"`
+}
+
+type RoleResource struct {
+	Type        string               `json:"type" example:"role"`
+	ID          string               `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes  RoleAttributes       `json:"attributes"`
+	Permissions []PermissionResource `json:"permissions,omitempty"`
+}
+
+type RoleResponse struct {
+	Data RoleResource `json:"data"`
+}
+
+type RoleListResponse struct {
+	Data []RoleResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type RoleDataTableResponse struct {
+	Data []RoleResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type PermissionAttributes struct {
+	Name        string `json:"name" example:"User Management"`
+	Key         string `json:"key" example:"user.manage"`
+	Description string `json:"description,omitempty" example:"Allows managing users."`
+	RequiresPIN bool   `json:"requires_pin" example:"true"`
+	CreatedAt   string `json:"created_at,omitempty" example:"2026-02-05T10:00:00Z"`
+	UpdatedAt   string `json:"updated_at,omitempty" example:"2026-02-05T10:00:00Z"`
+}
+
+type PermissionResource struct {
+	Type       string               `json:"type" example:"permission"`
+	ID         string               `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes PermissionAttributes `json:"attributes"`
+}
+
+type PermissionListResponse struct {
+	Data []PermissionResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type PermissionGroupResource struct {
+	Module      string               `json:"module" example:"dul"`
+	ModuleLabel string               `json:"module_label" example:"DUL"`
+	Permissions []PermissionResource `json:"permissions"`
+}
+
+type PermissionGroupedResponse struct {
+	Data []PermissionGroupResource `json:"data"`
+}
+
+// Create
+type RoleCreateAttributes struct {
+	Name        string `json:"name" validate:"required" example:"admin"`
+	Description string `json:"description,omitempty" example:"Full access to all resources."`
+}
+
+type RoleCreateData struct {
+	Type       string               `json:"type" validate:"required,oneof=role_create role" example:"role_create"`
+	Attributes RoleCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type RoleCreateRequest struct {
+	Data RoleCreateData `json:"data" validate:"required"`
+}
+
+// Update
+type RoleUpdateAttributes struct {
+	Name        *string `json:"name,omitempty" example:"admin"`
+	Description *string `json:"description,omitempty" example:"Full access to all resources."`
+}
+
+type RoleUpdateData struct {
+	Type       string               `json:"type" validate:"required,oneof=role_update role" example:"role_update"`
+	ID         string               `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes RoleUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type RoleUpdateRequest struct {
+	Data RoleUpdateData `json:"data" validate:"required"`
+}
+
+// Role-Permission
+type RolePermissionAttributes struct {
+	RoleID       string `json:"role_id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	PermissionID string `json:"permission_id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9e"`
+}
+
+type RolePermissionResource struct {
+	Type       string                   `json:"type" example:"role_permission"`
+	ID         string                   `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9f"`
+	Attributes RolePermissionAttributes `json:"attributes"`
+}
+
+type RolePermissionResponse struct {
+	Data RolePermissionResource `json:"data"`
+}
+
+type RolePermissionListResponse struct {
+	Data []RolePermissionResource `json:"data"`
+}
+
+type RolePermissionAssignAttributes struct {
+	PermissionID string `json:"permission_id" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9e"`
+}
+
+type RolePermissionAssignData struct {
+	Type       string                         `json:"type" validate:"required,eq=role_permission" example:"role_permission"`
+	Attributes RolePermissionAssignAttributes `json:"attributes" validate:"required"`
+}
+
+type RolePermissionAssignRequest struct {
+	Data RolePermissionAssignData `json:"data" validate:"required"`
+}
+
+type RolePermissionBulkAttributes struct {
+	PermissionIDs []string `json:"permission_ids" validate:"required" example:"[\"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9e\",\"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9f\"]"`
+}
+
+type RolePermissionAssignBulkData struct {
+	Type       string                       `json:"type" validate:"required,eq=role_assign_permission_bulk" example:"role_assign_permission_bulk"`
+	Attributes RolePermissionBulkAttributes `json:"attributes" validate:"required"`
+}
+
+type RolePermissionAssignBulkRequest struct {
+	Data RolePermissionAssignBulkData `json:"data" validate:"required"`
+}
+
+type RolePermissionRemoveBulkData struct {
+	Type       string                       `json:"type" validate:"required,eq=role_remove_permission_bulk" example:"role_remove_permission_bulk"`
+	Attributes RolePermissionBulkAttributes `json:"attributes" validate:"required"`
+}
+
+type RolePermissionRemoveBulkRequest struct {
+	Data RolePermissionRemoveBulkData `json:"data" validate:"required"`
+}
+
+type PermissionUpdateAttributes struct {
+	RequiresPIN *bool `json:"requires_pin" validate:"required" example:"true"`
+}
+
+type PermissionUpdateData struct {
+	Type       string                     `json:"type" validate:"required,oneof=permission_update permission" example:"permission_update"`
+	ID         string                     `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes PermissionUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type PermissionUpdateRequest struct {
+	Data PermissionUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/shared/air_rescuer_checklist_shared.go

@@ -0,0 +1,13 @@
+package shared
+
+type AirRescuerChecklistBaseInfo struct {
+	ID               string `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	BaseName         string `json:"base_name,omitempty" example:"Gallus 1 - Zurs Lech"`
+	BaseAbbreviation string `json:"base_abbreviation,omitempty" example:"G1"`
+	BaseCategory     string `json:"base_category,omitempty" example:"hems"`
+}
+
+type AirRescuerChecklistItemInput struct {
+	Name     string `json:"name" validate:"required" example:"Oxygen supply check"`
+	Position *int   `json:"position,omitempty" example:"1"`
+}

internal/transport/http/dto/shared/file_manager_attachment_shared.go

@@ -0,0 +1,13 @@
+package shared
+
+type FileManagerAttachmentAttributes struct {
+	FileID     string `json:"file_id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	RefType    string `json:"ref_type" example:"helicopter"`
+	RefID      string `json:"ref_id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Category   string `json:"category,omitempty" example:"document"`
+	SortOrder  int    `json:"sort_order" example:"0"`
+	IsPrimary  bool   `json:"is_primary" example:"false"`
+	AttachedBy string `json:"attached_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	CreatedAt  string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedAt  string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+}

internal/transport/http/dto/shared/file_manager_file_shared.go

@@ -0,0 +1,104 @@
+package shared
+
+type FileManagerFileAttributes struct {
+	FileUUID            string `json:"file_uuid,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	FolderID            string `json:"folder_id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name                string `json:"name" example:"policy.pdf"`
+	NameNormalized      string `json:"name_normalized,omitempty" example:"policy.pdf"`
+	Extension           string `json:"extension,omitempty" example:"pdf"`
+	SizeBytes           int64  `json:"size_bytes" example:"1024"`
+	MimeType            string `json:"mime_type" example:"application/pdf"`
+	IsTemplate          bool   `json:"is_template" example:"true"`
+	DownloadURL         string `json:"download_url,omitempty" example:"https://s3.localhost.localstack.cloud:4566/wucher-file-dev/files/2026/04/05/policy.pdf?X-Amz-Signature=..."`
+	Status              string `json:"status" example:"validated"`
+	FailureReason       string `json:"failure_reason,omitempty" example:""`
+	UploadError         string `json:"upload_error,omitempty" example:""`
+	ProcessingStartedAt string `json:"processing_started_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	ProcessedAt         string `json:"processed_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	ValidatedAt         string `json:"validated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	FailedAt            string `json:"failed_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedAt           string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy           string `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt           string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy           string `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt           string `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy           string `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	TrashedAt           string `json:"trashed_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	PurgeAt             string `json:"purge_at,omitempty" example:"2026-04-12T03:04:05Z"`
+}
+
+type FileManagerFileListAttributes struct {
+	Name           string `json:"name" example:"policy.pdf"`
+	NameNormalized string `json:"name_normalized,omitempty" example:"policy.pdf"`
+	Extension      string `json:"extension,omitempty" example:"pdf"`
+	SizeBytes      int64  `json:"size_bytes" example:"1024"`
+	MimeType       string `json:"mime_type" example:"application/pdf"`
+	IsTemplate     bool   `json:"is_template" example:"true"`
+	DownloadURL    string `json:"download_url,omitempty" example:"https://s3.localhost.localstack.cloud:4566/wucher-file-dev/files/2026/04/05/policy.pdf?X-Amz-Signature=..."`
+	Status         string `json:"status" example:"ready"`
+	CreatedAt      string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy      string `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt      string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy      string `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type FileManagerFileLocationAttributes struct {
+	FolderID string `json:"folder_id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type FileManagerFileProcessingAttributes struct {
+	ProcessingStartedAt string `json:"processing_started_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	ProcessedAt         string `json:"processed_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	ValidatedAt         string `json:"validated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	FailedAt            string `json:"failed_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	FailureReason       string `json:"failure_reason,omitempty" example:"processing validation failed"`
+}
+
+type FileManagerFileAuditAttributes struct {
+	CreatedAt string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy string `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy string `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type FileManagerFileDetailAttributes struct {
+	Name           string                               `json:"name" example:"policy.pdf"`
+	NameNormalized string                               `json:"name_normalized,omitempty" example:"policy.pdf"`
+	Extension      string                               `json:"extension,omitempty" example:"pdf"`
+	SizeBytes      int64                                `json:"size_bytes" example:"1024"`
+	MimeType       string                               `json:"mime_type" example:"application/pdf"`
+	IsTemplate     bool                                 `json:"is_template" example:"true"`
+	DownloadURL    string                               `json:"download_url,omitempty" example:"https://s3.localhost.localstack.cloud:4566/wucher-file-dev/files/2026/04/05/policy.pdf?X-Amz-Signature=..."`
+	PreviewURL     string                               `json:"preview_url,omitempty" example:"https://s3.localhost.localstack.cloud:4566/wucher-file-dev/files/2026/04/05/policy.preview.pdf?X-Amz-Signature=..."`
+	Status         string                               `json:"status" example:"ready"`
+	Location       *FileManagerFileLocationAttributes   `json:"location,omitempty"`
+	Processing     *FileManagerFileProcessingAttributes `json:"processing,omitempty"`
+	Audit          FileManagerFileAuditAttributes       `json:"audit"`
+}
+
+type FileManagerFileDownloadAttributes struct {
+	URL             string `json:"url" example:"https://s3.localhost.localstack.cloud:4566/..."`
+	ExpiresInSecond int64  `json:"expires_in_second" example:"900"`
+}
+
+type FileManagerFileUploadIntentAttributes struct {
+	UploadIntentID   string            `json:"upload_intent_uuid" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UploadURL        string            `json:"upload_url" example:"https://s3.localhost.localstack.cloud:4566/wucher-file-dev/..."`
+	Method           string            `json:"method" example:"PUT"`
+	RequiredHeaders  map[string]string `json:"required_headers,omitempty"`
+	Object           FileUploadObject  `json:"object"`
+	File             FileUploadFile    `json:"file"`
+	ExpiresAt        string            `json:"expires_at" example:"2026-04-05T07:29:34Z"`
+	ExpiresInSeconds int64             `json:"expires_in_seconds" example:"900"`
+}
+
+type FileUploadObject struct {
+	Bucket string `json:"bucket" example:"wucher-file-dev"`
+	Key    string `json:"key" example:"files/2026/04/05/018f3a5c7a6f7c2a8d4a4b5b1f6c8e9d.pdf"`
+}
+
+type FileUploadFile struct {
+	Name      string `json:"name" example:"policy-final.pdf"`
+	MimeType  string `json:"mime_type" example:"application/pdf"`
+	SizeBytes int64  `json:"size_bytes" example:"1024"`
+}

internal/transport/http/dto/shared/file_manager_folder_shared.go

@@ -0,0 +1,36 @@
+package shared
+
+type FileManagerFolderAttributes struct {
+	ParentID       string `json:"parent_id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name           string `json:"name" example:"operations"`
+	NameNormalized string `json:"name_normalized,omitempty" example:"operations"`
+	Depth          int    `json:"depth" example:"1"`
+	PathCache      string `json:"path_cache,omitempty" example:"/root/operations"`
+	CreatedAt      string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy      string `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt      string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy      string `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt      string `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy      string `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	PurgeAt        string `json:"purge_at,omitempty" example:"2026-04-12T03:04:05Z"`
+}
+
+type FileManagerFolderLocationAttributes struct {
+	ParentID string `json:"parent_id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type FileManagerFolderAuditAttributes struct {
+	CreatedAt string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy string `json:"created_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy string `json:"updated_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type FileManagerFolderDetailAttributes struct {
+	Name           string                               `json:"name" example:"operations"`
+	NameNormalized string                               `json:"name_normalized,omitempty" example:"operations"`
+	Depth          *int                                 `json:"depth,omitempty" example:"1"`
+	PathCache      string                               `json:"path_cache,omitempty" example:"/root/operations"`
+	Location       *FileManagerFolderLocationAttributes `json:"location,omitempty"`
+	Audit          FileManagerFolderAuditAttributes     `json:"audit"`
+}

internal/transport/http/dto/shared/fleet_status_shared.go

@@ -0,0 +1,174 @@
+package shared
+
+type FleetStatusHelicopter struct {
+	ID          string `json:"id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Designation string `json:"designation,omitempty" example:"AIRBUS H145"`
+	Identifier  string `json:"identifier,omitempty" example:"D-HEMS"`
+	Type        string `json:"type,omitempty" example:"EC-135"`
+	Status      string `json:"status,omitempty" example:"available" enums:"available,booked,aog,mcf"`
+	// FlightID — id of the aircraft's current active flight (present only when it is in
+	// use / booked). The fleet page uses it to create an EASA release scoped to the flight.
+	FlightID      string                        `json:"flight_id,omitempty" example:"019d6774-98e8-7fba-9ef4-3795c0da8a13"`
+	StatusReasons []FleetStatusHelicopterReason `json:"status_reasons,omitempty"`
+}
+
+// FleetStatusMCF is the helicopter's maintenance check flight shown on the fleet page.
+// When the helicopter has no MCF yet, id is empty and sign is false. af_hours /
+// landing_count are the SIGNED check-flight values — present only once the MCF is signed.
+type FleetStatusMCF struct {
+	// Active — true when the helicopter is currently in MCF (an open draft, or a signed
+	// but failed MCF still needing a re-flight); false when cleared/cancelled/none.
+	Active bool    `json:"active"`
+	ID     string  `json:"id"`
+	Date   *string `json:"date"`
+	// AFHours / LandingCount present only once the MCF is signed; omitted for none/draft/cancelled.
+	AFHours      *string `json:"af_hours,omitempty"`
+	LandingCount *int    `json:"landing_count,omitempty"`
+	// Sign — true once the MCF is completed/signed; false while it is still a draft.
+	Sign bool `json:"sign"`
+	// SignedBy / SignedByName / SignedByShort — who signed (completed) the MCF; empty while unsigned.
+	SignedBy      string  `json:"signed_by,omitempty"`
+	SignedByName  *string `json:"signed_by_name,omitempty"`
+	SignedByShort *string `json:"signed_by_short,omitempty"`
+}
+
+type MaintenanceScheduleAttributes struct {
+	InspectionType string `json:"inspection_type" example:"A/F"`
+	Type           string `json:"type" example:"100H"`
+	Due            string `json:"due" validate:"omitempty,hours_or_date" example:"1200"`
+	Ext            string `json:"ext" validate:"omitempty,hours_or_date" example:"1300"`
+}
+
+type FleetStatusFileAttributes struct {
+	FileID   string `json:"file_id" validate:"required" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	Category string `json:"category" validate:"required,oneof=wb bfi" example:"wb"`
+	// IsMandatory — when true, this file must be checked (is_done) during takeover.
+	IsMandatory *bool `json:"is_mandatory,omitempty" example:"true"`
+}
+
+type FleetStatusSummaryAirframe struct {
+	Hours  *float64 `json:"hours"`
+	Cycles *float64 `json:"cycles"`
+}
+
+type FleetStatusSummaryEngine struct {
+	Hours   *float64 `json:"hours"`
+	GpcNgN1 *float64 `json:"gpc_ng_n1"`
+	PtcNfN2 *float64 `json:"ptc_nf_n2"`
+	Ccc     *float64 `json:"ccc"`
+}
+
+type FleetStatusSummary struct {
+	Airframe         FleetStatusSummaryAirframe `json:"airframe"`
+	Engine1          FleetStatusSummaryEngine   `json:"engine_1"`
+	Engine2          FleetStatusSummaryEngine   `json:"engine_2"`
+	Landings         *float64                   `json:"landings"`
+	FlightReports    *float64                   `json:"flight_reports"`
+	RotorBrakeCycles *float64                   `json:"rotor_brake_cycles"`
+	HookReleases     *float64                   `json:"hook_releases"`
+}
+
+type FleetStatusServiceLogAttributes struct {
+	FleetStatusID     string                 `json:"fleet_status_id" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	HelicopterID      string                 `json:"helicopter_id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Helicopter        *FleetStatusHelicopter `json:"helicopter,omitempty"`
+	FleetStatusStatus string                 `json:"fleet_status_status,omitempty" example:"serviced"`
+	InspectionType    string                 `json:"inspection_type" example:"A/F"`
+	Type              string                 `json:"type" example:"100H"`
+	Due               string                 `json:"due" example:"1200 FH"`
+	Ext               string                 `json:"ext" example:"1300 FH"`
+	ServicedAt        string                 `json:"serviced_at" example:"2026-05-29T07:43:06Z"`
+	CreatedAt         string                 `json:"created_at" example:"2026-05-29T07:43:06Z"`
+	CreatedBy         string                 `json:"created_by" example:"John Doe"`
+}
+
+const (
+	ReasonCodeManualAOG         = "manual_aog"
+	ReasonCodeMELExpired        = "mel_expired"
+	ReasonCodeNonMELPending     = "non_mel_pending"
+	ReasonCodeInspectionOverdue = "inspection_overdue"
+)
+
+type FleetStatusComplaint struct {
+	ID                    string                     `json:"id"`
+	FlightID              string                     `json:"flight_id,omitempty"`
+	Description           string                     `json:"description"`
+	Status                string                     `json:"status" enums:"active_non_mel,active_mel,serviced"`
+	ReportedAt            string                     `json:"reported_at"`
+	ReportedBy            string                     `json:"reported_by,omitempty"`
+	ReportedByName        string                     `json:"reported_by_name,omitempty"`
+	ReportedByShort       string                     `json:"reported_by_short,omitempty"`
+	AircraftHoursAtReport *string                    `json:"aircraft_hours_at_report,omitempty"`
+	MEL                   FleetStatusComplaintMEL    `json:"mel"`
+	NSR                   FleetStatusComplaintNSR    `json:"nsr"`
+	Action                FleetStatusComplaintAction `json:"action"`
+}
+
+type FleetStatusComplaintMEL struct {
+	Severity         int8    `json:"severity" enums:"0,1,2,3,4"`
+	SeverityLabel    *string `json:"severity_label"`
+	ClassifiedAt     *string `json:"classified_at,omitempty"`
+	ClassifiedBy      string  `json:"classified_by,omitempty"`
+	ClassifiedByName  string  `json:"classified_by_name,omitempty"`
+	ClassifiedByShort string  `json:"classified_by_short,omitempty"`
+	Deadline          *string `json:"deadline,omitempty"`
+}
+
+type FleetStatusComplaintNSR struct {
+	IsNSR         bool    `json:"is_nsr"`
+	DecidedAt     *string `json:"decided_at,omitempty"`
+	DecidedBy      string  `json:"decided_by,omitempty"`
+	DecidedByName  string  `json:"decided_by_name,omitempty"`
+	DecidedByShort string  `json:"decided_by_short,omitempty"`
+	Reason         *string `json:"reason,omitempty"`
+}
+
+type FleetStatusComplaintAction struct {
+	Taken              *string `json:"taken"`
+	SignedAt           *string `json:"signed_at,omitempty"`
+	SignedBy           string  `json:"signed_by,omitempty"`
+	SignedByName       string  `json:"signed_by_name,omitempty"`
+	SignedByShort      string  `json:"signed_by_short,omitempty"`
+	AircraftHoursAtFix *string `json:"aircraft_hours_at_fix,omitempty"`
+}
+
+type FleetStatusEASARelease struct {
+	ID                         string   `json:"id"`
+	IsSigned                   bool     `json:"is_signed"`
+	EASADate                   *string  `json:"easa_date,omitempty"`
+	EASAACHours                *string  `json:"easa_ac_hours,omitempty"`
+	EASALocation               *string  `json:"easa_location,omitempty"`
+	EASAWONo                   *string  `json:"easa_wo_no,omitempty"`
+	EASAMaintManualRevAirframe *string  `json:"easa_maint_manual_rev_airframe,omitempty"`
+	EASAMaintManualRevEngine   *string  `json:"easa_maint_manual_rev_engine,omitempty"`
+	EASASignerID               *string  `json:"easa_signer_id,omitempty"`
+	EASAPermitNo               *string  `json:"easa_permit_no,omitempty"`
+	SignedAt                   *string  `json:"signed_at,omitempty"`
+	SignedBy                   string   `json:"signed_by,omitempty"`
+	SignedByName               string   `json:"signed_by_name,omitempty"`
+	SignedByShort              string   `json:"signed_by_short,omitempty"`
+	MissingSignFields          []string `json:"missing_sign_fields,omitempty"`
+}
+
+func MELLabel(severity int8) string {
+	switch severity {
+	case 1:
+		return "A"
+	case 2:
+		return "B"
+	case 3:
+		return "C"
+	case 4:
+		return "D"
+	default:
+		return ""
+	}
+}
+
+type FleetStatusHelicopterReason struct {
+	Code        string  `json:"code" enums:"manual_aog,mel_expired,non_mel_pending,inspection_overdue"`
+	Detail      string  `json:"detail"`
+	Since       *string `json:"since,omitempty"`
+	ComplaintID string  `json:"complaint_id,omitempty"`
+	ScheduleID  string  `json:"schedule_id,omitempty"`
+}

internal/transport/http/dto/shared/flight_inspection_file_checklist_shared.go

@@ -0,0 +1,11 @@
+package shared
+
+type FlightInspectionFileChecklistAttributes struct {
+	IsDone             bool   `json:"is_done" example:"false"`
+	HelicopterFileID   string `json:"helicopter_file_id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	FlightInspectionID string `json:"flight_inspection_id" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	CreatedAt          string `json:"created_at,omitempty" example:"2026-04-14T08:00:00Z"`
+	CreatedBy          string `json:"created_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	UpdatedAt          string `json:"updated_at,omitempty" example:"2026-04-14T08:00:00Z"`
+	UpdatedBy          string `json:"updated_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+}

internal/transport/http/dto/shared/helicopter_file_shared.go

@@ -0,0 +1,18 @@
+package shared
+
+type HelicopterFileAttributes struct {
+	Section           string `json:"section" example:"bfi"`
+	Position          int    `json:"position" example:"1"`
+	IsMandatory       bool   `json:"is_mandatory" example:"true"`
+	IsTemplate        bool   `json:"is_template" example:"true"`
+	HelicopterID      string `json:"helicopter_id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	HelicopterName    string `json:"helicopter_name,omitempty" example:"AIRBUS H145"`
+	FileAttachmentID  string `json:"file_attachment_id" example:"019d6771-6c8e-7a2d-a7b8-03bcb65fcb3e"`
+	AttachmentPending bool   `json:"attachment_pending" example:"true"`
+	FileName          string `json:"file_name,omitempty" example:"Before Flight Checklist.pdf"`
+	DownloadURL       string `json:"download_url,omitempty" example:"https://s3.localhost.localstack.cloud:4566/wucher-file-dev/files/2026/04/05/policy.pdf?X-Amz-Signature=..."`
+	CreatedAt         string `json:"created_at,omitempty" example:"2026-04-14T08:00:00Z"`
+	CreatedBy         string `json:"created_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	UpdatedAt         string `json:"updated_at,omitempty" example:"2026-04-14T08:00:00Z"`
+	UpdatedBy         string `json:"updated_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+}

internal/transport/http/dto/shared/helicopter_shared.go

@@ -0,0 +1,45 @@
+package shared
+
+// Helicopter nested value objects reused as building blocks by helicopter
+// response DTOs (and available to any other module that embeds helicopter
+// summaries).
+
+type HelicopterLastDailyInspection struct {
+	InspectionID             string                             `json:"inspection_id,omitempty" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	Status                   string                             `json:"status" example:"inspected_cleared"`
+	Inspector                HelicopterLastDailyInspector       `json:"inspector"`
+	Base                     HelicopterLastDailyBase            `json:"base"`
+	InspectedAt              string                             `json:"inspected_at,omitempty" example:"2026-05-25T07:47:00Z"`
+	UTCTime                  string                             `json:"utc_time,omitempty" example:"07:47"`
+	InspectionFilesChecklist HelicopterInspectionFilesChecklist `json:"inspection_files_checklist"`
+}
+
+type HelicopterLastDailyInspector struct {
+	ID        string `json:"id,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	Name      string `json:"name,omitempty" example:"Teodora Lesmana"`
+	LicenseNo string `json:"license_no,omitempty" example:"4521"`
+}
+
+type HelicopterLastDailyBase struct {
+	ID               string `json:"id,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	BaseAbbreviation string `json:"base_abbreviation,omitempty" example:"G1"`
+	BaseName         string `json:"base_name,omitempty" example:"Gallus 1 - Zurs Lech"`
+	Type             string `json:"type,omitempty" example:"hems"`
+}
+
+type HelicopterInspectionFilesChecklist struct {
+	Completed int `json:"completed" example:"47"`
+	Total     int `json:"total" example:"47"`
+}
+
+type HelicopterFoto struct {
+	UUID                 string `json:"uuid" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DownloadURL          string `json:"download_url" example:"https://storage.example.com/helicopter/foto.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=900&X-Amz-Signature=abc123"`
+	ThumbnailDownloadURL string `json:"thumbnail_download_url,omitempty" example:"https://storage.example.com/helicopter/foto.thumb.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Expires=900&X-Amz-Signature=abc123"`
+	OriginalSizeBytes    *int64 `json:"original_size_bytes,omitempty" example:"1024000"`
+}
+
+type HelicopterAuditUser struct {
+	ID   string `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Name string `json:"name" example:"John Doe"`
+}

internal/transport/http/dto/shared/reserve_ac_shared.go

@@ -0,0 +1,120 @@
+package shared
+
+import "time"
+
+type ReserveAcAttributes struct {
+	Status     string                      `json:"status" example:"pending"`
+	AircraftID string                      `json:"helicopter_id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Aircraft   *ReserveAcAircraftSummary   `json:"helicopter,omitempty"`
+	LastDaily  *ReserveAcLastDailyInfo     `json:"last_daily_inspection,omitempty"`
+	FlightID   string                      `json:"flight_id,omitempty" example:"019d6773-ccca-71dd-b9c7-8e6f531deb90"`
+	Inspection *ReserveAcInspectionSummary `json:"inspection,omitempty"`
+	CreatedAt  string                      `json:"created_at,omitempty" example:"2026-04-14T08:00:00Z"`
+	CreatedBy  string                      `json:"created_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	UpdatedAt  string                      `json:"updated_at,omitempty" example:"2026-04-14T08:00:00Z"`
+	UpdatedBy  string                      `json:"updated_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+	DeletedAt  string                      `json:"deleted_at,omitempty" example:"2026-04-14T08:00:00Z"`
+	DeletedBy  string                      `json:"deleted_by,omitempty" example:"019d61db-53c6-7280-87ec-e65f205c6d3b"`
+}
+
+type ReserveAcLastDailyInfo struct {
+	Name      string `json:"name" example:"Ganahl Stefan"`
+	ShortName string `json:"short_name" example:"GAN"`
+	Date      string `json:"date" example:"17.04.2026"`
+	UTCTime   string `json:"utc_time" example:"10:57"`
+}
+
+type ReserveAcAircraftSummary struct {
+	ID          string `json:"id" example:"019d6771-5fb5-7337-837f-bc5ed85181a1"`
+	Designation string `json:"designation" example:"AIRBUS H145"`
+	Identifier  string `json:"identifier" example:"D-HYAR"`
+	Type        string `json:"type" example:"H145"`
+	AOG         bool   `json:"aog" example:"false"`
+	IsActive    bool   `json:"is_active" example:"true"`
+}
+
+type ReserveAcInspectionSummary struct {
+	ID              string                             `json:"id" example:"019d6772-471c-7b70-b42a-d94020ef61e4"`
+	InspectionDate  string                             `json:"inspection_date,omitempty" example:"2026-04-15"`
+	Before          ReserveAcBeforeSectionDTO          `json:"before"`
+	Prepare         ReserveAcPrepareSectionDTO         `json:"prepare"`
+	FleetStatusFile ReserveAcFleetStatusFileSectionDTO `json:"fleet_status_file"`
+}
+
+type ReserveAcBeforeSectionDTO struct {
+	Total         int                              `json:"total" example:"3"`
+	Completed     int                              `json:"completed" example:"1"`
+	DoneFiles     []ReserveAcFileChecklistItemDTO  `json:"done_file_checklist,omitempty"`
+	Fields        *ReserveAcBeforeInspectionFields `json:"fields,omitempty"`
+	FileChecklist []ReserveAcFileChecklistItemDTO  `json:"file_checklist"`
+}
+
+type ReserveAcPrepareSectionDTO struct {
+	Total         int                             `json:"total" example:"3"`
+	Completed     int                             `json:"completed" example:"1"`
+	DoneFiles     []ReserveAcFileChecklistItemDTO `json:"done_file_checklist,omitempty"`
+	PrepareFields *ReserveAcPrepareFields         `json:"prepare_fields,omitempty"`
+	FileChecklist []ReserveAcFileChecklistItemDTO `json:"file_checklist"`
+}
+
+type ReserveAcFleetStatusFileSectionDTO struct {
+	Total         int                             `json:"total" example:"2"`
+	Completed     int                             `json:"completed" example:"1"`
+	DoneFiles     []ReserveAcFileChecklistItemDTO `json:"done_file_checklist,omitempty"`
+	FileChecklist []ReserveAcFileChecklistItemDTO `json:"file_checklist"`
+}
+
+type ReserveAcFileChecklistItemDTO struct {
+	HelicopterFileID string `json:"helicopter_file_id" example:"019d7000-aaaa-7bbb-8ccc-111111111111"`
+	FileAttachmentID string `json:"file_attachment_id,omitempty" example:"019d7000-aaaa-7bbb-8ccc-222222222222"`
+	FileName         string `json:"file_name,omitempty" example:"Before Flight Checklist.pdf"`
+	DownloadURL      string `json:"download_url,omitempty" example:"https://s3.localhost.localstack.cloud:4566/wucher-file-dev/files/2026/04/05/policy.pdf?X-Amz-Signature=..."`
+	IsDone           bool   `json:"is_done" example:"false"`
+	IsMandatory      bool   `json:"is_mandatory" example:"true"`
+}
+
+type ReserveAcBeforeInspectionFields struct {
+	OilEngineNR1Checked       *bool    `json:"oil_engine_nr1_checked,omitempty"`
+	OilEngineNR2Checked       *bool    `json:"oil_engine_nr2_checked,omitempty"`
+	HydraulicLHChecked        *bool    `json:"hydraulic_lh_checked,omitempty"`
+	HydraulicRHChecked        *bool    `json:"hydraulic_rh_checked,omitempty"`
+	OilTransmissionMGBChecked *bool    `json:"oil_transmission_mgb_checked,omitempty"`
+	OilTransmissionIGBChecked *bool    `json:"oil_transmission_igb_checked,omitempty"`
+	OilTransmissionTGBChecked *bool    `json:"oil_transmission_tgb_checked,omitempty"`
+	FuelAmount                *float64 `json:"fuel_amount,omitempty"`
+	FuelUnit                  string   `json:"fuel_unit,omitempty"`
+	FuelAddedAmount           *float64 `json:"fuel_added_amount,omitempty"`
+	Note                      *string  `json:"note,omitempty"`
+}
+
+type ReserveAcPrepareFields struct {
+	NotamBriefing         *bool `json:"notam_briefing,omitempty"`
+	WeatherBriefing       *bool `json:"weather_briefing,omitempty"`
+	OperationalFlightPlan *bool `json:"operational_flight_plan,omitempty"`
+}
+
+type LastDailyInspection struct {
+	ID        []byte
+	Name      string
+	ShortName string
+	At        time.Time
+}
+
+type LastDailyInspectionSummary struct {
+	InspectionID string
+	Status       string
+
+	InspectorID        string
+	InspectorName      string
+	InspectorLicenseNo string
+
+	BaseID           string
+	BaseName         string
+	BaseAbbreviation string
+	BaseType         string
+
+	InspectedAt time.Time
+
+	InspectionFilesChecklistCompleted int
+	InspectionFilesChecklistTotal     int
+}

internal/transport/http/dto/user_dto.go

@@ -0,0 +1,103 @@
+package dto
+
+import (
+	"bytes"
+	"encoding/json"
+)
+
+// JSON:API User DTOs
+
+type UserResource struct {
+	Type       string         `json:"type" example:"user"`
+	ID         string         `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes UserAttributes `json:"attributes"`
+}
+
+type UserListResponse struct {
+	Data []UserResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type UserDataTableResponse struct {
+	Data []UserResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+// Create
+
+type UserCreateAttributes struct {
+	Email       string   `json:"email" validate:"required,email" example:"user@example.com"`
+	Username    string   `json:"username" validate:"required,min=3,max=100" example:"john.doe"`
+	FirstName   string   `json:"first_name" validate:"required" example:"John"`
+	LastName    string   `json:"last_name" validate:"required" example:"Doe"`
+	MobilePhone string   `json:"mobile_phone,omitempty" example:"+628123456789"`
+	Timezone    *string  `json:"timezone,omitempty" example:"Asia/Jakarta"`
+	ImageUUID   *string  `json:"image_uuid,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e90"`
+	RoleID      string   `json:"role_id" validate:"required" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	RoleIDs     []string `json:"role_ids,omitempty" example:"[\"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d\",\"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9e\"]"`
+}
+
+type UserCreateData struct {
+	Type       string               `json:"type" validate:"required,oneof=user_create user" example:"user_create"`
+	Attributes UserCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type UserCreateRequest struct {
+	Data UserCreateData `json:"data" validate:"required"`
+}
+
+// Update
+
+type UserUpdateAttributes struct {
+	Email       *string    `json:"email,omitempty" validate:"omitempty,email" example:"user@example.com"`
+	FirstName   *string    `json:"first_name,omitempty" example:"John"`
+	LastName    *string    `json:"last_name,omitempty" example:"Doe"`
+	MobilePhone *string    `json:"mobile_phone,omitempty" example:"+628123456789"`
+	Timezone    *string    `json:"timezone,omitempty" example:"Asia/Jakarta"`
+	ImageUUID   NullString `json:"image_uuid,omitempty" swaggertype:"string" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e90"`
+}
+
+// NullString allows PATCH semantics:
+// - field omitted => Set=false (no change)
+// - value null    => Set=true, Valid=false (clear value)
+// - value string  => Set=true, Valid=true, Value=<string>
+type NullString struct {
+	Set   bool
+	Valid bool
+	Value string
+}
+
+func (n *NullString) UnmarshalJSON(data []byte) error {
+	n.Set = true
+	trimmed := bytes.TrimSpace(data)
+	if bytes.Equal(trimmed, []byte("null")) {
+		n.Valid = false
+		n.Value = ""
+		return nil
+	}
+	var v string
+	if err := json.Unmarshal(trimmed, &v); err != nil {
+		return err
+	}
+	n.Valid = true
+	n.Value = v
+	return nil
+}
+
+type UserUpdateData struct {
+	Type       string               `json:"type" validate:"required,oneof=user_update user" example:"user_update"`
+	ID         string               `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes UserUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type UserUpdateRequest struct {
+	Data UserUpdateData `json:"data" validate:"required"`
+}

internal/transport/http/dto/vocation_dto.go

@@ -0,0 +1,77 @@
+package dto
+
+// JSON:API Vocation DTOs
+
+type VocationAttributes struct {
+	Name      string `json:"name" example:"Pilot"`
+	SortKey   *int   `json:"sortkey" example:"1"`
+	Note      string `json:"note,omitempty" example:"Helicopter pilot vocation"`
+	IsActive  bool   `json:"is_active" example:"true"`
+	CreatedAt string `json:"created_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	CreatedBy string `json:"created_by" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	UpdatedAt string `json:"updated_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	UpdatedBy string `json:"updated_by" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	DeletedAt string `json:"deleted_at,omitempty" example:"2026-03-12T03:04:05Z"`
+	DeletedBy string `json:"deleted_by,omitempty" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+}
+
+type VocationResource struct {
+	Type       string             `json:"type" example:"vocation"`
+	ID         string             `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes VocationAttributes `json:"attributes"`
+}
+
+type VocationResponse struct {
+	Data VocationResource `json:"data"`
+}
+
+type VocationListResponse struct {
+	Data []VocationResource `json:"data"`
+	Meta struct {
+		PageNumber int   `json:"page_number" example:"1"`
+		PageSize   int   `json:"page_size" example:"20"`
+		Total      int64 `json:"total" example:"120"`
+	} `json:"meta"`
+}
+
+type VocationDataTableResponse struct {
+	Data []VocationResource `json:"data"`
+	Meta struct {
+		Draw            int   `json:"draw" example:"1"`
+		RecordsTotal    int64 `json:"records_total" example:"120"`
+		RecordsFiltered int64 `json:"records_filtered" example:"12"`
+	} `json:"meta"`
+}
+
+type VocationCreateAttributes struct {
+	Name     string  `json:"name" validate:"required" example:"Pilot"`
+	SortKey  *int    `json:"sortkey" example:"1"`
+	Note     *string `json:"note,omitempty" example:"Helicopter pilot vocation"`
+	IsActive *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type VocationCreateData struct {
+	Type       string                   `json:"type" validate:"required,oneof=vocation_create vocation" example:"vocation_create"`
+	Attributes VocationCreateAttributes `json:"attributes" validate:"required"`
+}
+
+type VocationCreateRequest struct {
+	Data VocationCreateData `json:"data" validate:"required"`
+}
+
+type VocationUpdateAttributes struct {
+	Name     *string `json:"name,omitempty" example:"Pilot"`
+	SortKey  NullInt `json:"sortkey,omitempty" swaggertype:"integer" example:"1"`
+	Note     *string `json:"note,omitempty" example:"Helicopter pilot vocation"`
+	IsActive *bool   `json:"is_active,omitempty" example:"true"`
+}
+
+type VocationUpdateData struct {
+	Type       string                   `json:"type" validate:"required,oneof=vocation_update vocation" example:"vocation_update"`
+	ID         string                   `json:"id" example:"018f3a5c-7a6f-7c2a-8d4a-4b5b1f6c8e9d"`
+	Attributes VocationUpdateAttributes `json:"attributes" validate:"required"`
+}
+
+type VocationUpdateRequest struct {
+	Data VocationUpdateData `json:"data" validate:"required"`
+}