v1

type ApplicationComponent struct {
	// Name is the unique identifier for this component instance within the ApplicationDefinition.
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MaxLength=63
	// +kubebuilder:validation:Pattern=`^[a-z0-9]([-a-z0-9_.]*)?[a-z0-9]$`
	Name string `json:"name"`
	// +kubebuilder:validation:Required
	APIVersion string `json:"apiVersion"`
	// +kubebuilder:validation:Required
	Kind string `json:"kind"`
	// Type references the `metadata.name` of a `ComponentDefinition` resource in the same namespace.
	Type string `json:"type,omitempty"`

	// Properties provides the instance-specific configuration as raw JSON.
	// The structure is determined by the component 'type' and validated by the corresponding builder strategy.
	// +kubebuilder:validation:Required
	// +kubebuilder:pruning:PreserveUnknownFields
	// +kubebuilder:validation:Type=object
	Properties runtime.RawExtension `json:"properties"`
}

type ApplicationDefinition struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   ApplicationDefinitionSpec   `json:"spec,omitempty"`
	Status ApplicationDefinitionStatus `json:"status,omitempty"`
}

type ApplicationDefinitionList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []ApplicationDefinition `json:"items"`
}

type ApplicationDefinitionSpec struct {
	// Components lists the desired component instances for this application.
	// +kubebuilder:validation:Required
	// +kubebuilder:validation:MinItems=1
	// +listType=map
	// +listMapKey=name
	Components []ApplicationComponent `json:"components"`
}

type ApplicationDefinitionStatus struct {
	// ObservedGeneration reflects the generation of the ApplicationDefinition spec that was last processed by the controller.
	// +optional
	ObservedGeneration int64 `json:"observedGeneration,omitempty"`

	// Phase represents the current overall state of the application reconciliation.
	// +optional
	Phase ApplicationPhase `json:"phase,omitempty"`

	// Conditions provide observations of the application's state.
	// Known condition types include "Ready".
	// +optional
	// +patchStrategy=merge
	// +patchMergeKey=type
	// +listType=map
	// +listMapKey=type
	Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`

	// Components provides a summary status for each component defined in the spec.
	// +optional
	// +listType=map
	// +listMapKey=name
	Components  []ComponentStatusReference `json:"components,omitempty" listType:"map" listMapKey:"name"`
	Annotations map[string]string          `json:"annotations,omitempty"`
}

type ApplicationPhase string

type ComponentStatusReference struct {
	// Name matches the name of the component in the spec.
	// +kubebuilder:validation:Required
	Name string `json:"name"`

	// Kind is the Kubernetes Kind of the primary workload resource managed for this component (e.g., StatefulSet, Deployment).
	// Derived from the corresponding ComponentDefinition.
	// +optional
	Kind string `json:"kind,omitempty"`

	// APIVersion is the API version of the primary workload resource (e.g., apps/v1).
	// Derived from the corresponding ComponentDefinition.
	// +optional
	APIVersion string `json:"apiVersion,omitempty"`

	// ResourceName is the actual name of the primary workload resource created in Kubernetes.
	// +optional
	ResourceName string `json:"resourceName,omitempty"`

	// Namespace is the namespace where the primary workload resource resides (usually the same as the AppDef).
	// +optional
	Namespace string `json:"namespace,omitempty"`

	// Health indicates the observed health status of the component (considering both K8s readiness and app-level checks).
	// True means healthy, False means unhealthy or not yet ready.
	// +optional
	Health bool `json:"health,omitempty"`

	// Message provides a human-readable status message or error details for the component.
	// +optional
	Message string `json:"message,omitempty"`
}

type ConditionType string