ADR 0051 - Standardized Status Fields for AppCat Services

type VSHNServiceStatus struct {
    // Phase summarizes the lifecycle state of the service.
    // +kubebuilder:validation:Enum=Provisioning;Ready;Scaling;Maintenance;Degraded;Failed;Deleting;Unknown
    // +kubebuilder:default=Unknown
    Phase VSHNServicePhase `json:"phase,omitempty"`

    // Reason is a short CamelCase reason for the current phase.
    // +optional
    Reason string `json:"reason,omitempty"`

    // Message is a human-readable explanation of the current phase.
    // +optional
    Message string `json:"message,omitempty"`

    // LastTransitionTime is when the phase last changed.
    // +optional
    LastTransitionTime *metav1.Time `json:"lastTransitionTime,omitempty"`

    // Conditions holds the detailed transition history and per-state reasons.
    // Follows the Crossplane convention: each phase transition is recorded as a condition.
    // +optional
    // +listType=map
    // +listMapKey=type
    Conditions []metav1.Condition `json:"conditions,omitempty"`
}

type VSHNServicePhase string

const (
    VSHNServicePhaseProvisioning VSHNServicePhase = "Provisioning"
    VSHNServicePhaseReady        VSHNServicePhase = "Ready"
    VSHNServicePhaseScaling      VSHNServicePhase = "Scaling"
    VSHNServicePhaseMaintenance  VSHNServicePhase = "Maintenance"
    VSHNServicePhaseDegraded     VSHNServicePhase = "Degraded"
    VSHNServicePhaseFailed       VSHNServicePhase = "Failed"
    VSHNServicePhaseDeleting     VSHNServicePhase = "Deleting"
    VSHNServicePhaseUnknown      VSHNServicePhase = "Unknown"
)

type VSHNPostgreSQLStatus struct {
    VSHNServiceStatus `json:",inline"`
    // ... existing fields ...
}

Deleting > Failed > Provisioning > Maintenance > Scaling > Degraded > Ready > Unknown

type VSHNBillingStatus struct {
    // CurrentMonthlyPrice is the current estimated monthly price in CHF.
    // Set by the billing controller.
    // +optional
    CurrentMonthlyPrice *resource.Quantity `json:"currentMonthlyPrice,omitempty"`

    // Unit is the unit of measurement for consumption (e.g. "GiB", "minutes").
    // +optional
    Unit string `json:"unit,omitempty"`

    // QuantityConsumed is the amount consumed in the current billing period, in Unit.
    // +optional
    QuantityConsumed *resource.Quantity `json:"quantityConsumed,omitempty"`
}

type VSHNPostgreSQLStatus struct {
    VSHNServiceStatus `json:",inline"`

    // Billing exposes cost and usage information, populated by the billing controller.
    // +optional
    Billing *VSHNBillingStatus `json:"billing,omitempty"`

    // ... existing fields ...
}