v1alpha1

type Application struct {
	metav1.TypeMeta `json:",inline"`

	// Standard object's metadata.
	// +optional
	metav1.ObjectMeta `json:"metadata,omitzero"`

	// Spec defines the desired behavior of the Application.
	// +required
	Spec ApplicationSpec `json:"spec"`

	// Status represents the current information about the Application.
	// +optional
	Status ApplicationStatus `json:"status,omitzero"`
}

type ApplicationList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitzero"`
	Items           []Application `json:"items"`
}

type ApplicationSpec struct {
	// WorkloadType determines whether to create a Deployment (default), CronJob, or Job.
	// Changing this field causes the operator to delete the previously managed workload
	// resource and create the new one.
	//
	// +kubebuilder:default=Deployment
	// +optional
	WorkloadType WorkloadType `json:"workloadType,omitempty"`

	// DeploymentConfig groups the Deployment spec together with its optional
	// Service, PersistentVolumeClaim, and mount path.
	// Required when workloadType is Deployment; ignored otherwise.
	// +optional
	DeploymentConfig *DeploymentConfig `json:"deploymentConfig,omitempty"`

	// CronJob defines the schedule and job template for a scheduled workload.
	// Required when workloadType is CronJob; ignored otherwise.
	// +optional
	CronJob *batchv1.CronJobSpec `json:"cronJob,omitempty"`

	// Job defines the job template for a one-off workload.
	// Required when workloadType is Job; ignored otherwise.
	// +optional
	Job *batchv1.JobSpec `json:"job,omitempty"`
}

type ApplicationStatus struct {
	// ObservedGeneration is the most recent generation observed by the controller.
	// It corresponds to the Application's generation, which is updated on mutation by the API Server.
	// +optional
	ObservedGeneration int64 `json:"observedGeneration,omitempty"`

	// DeploymentRef is a reference to the Deployment managed by this Application.
	// Only set when workloadType is Deployment.
	// +optional
	DeploymentRef *ResourceReference `json:"deploymentRef,omitempty"`

	// CronJobRef is a reference to the CronJob managed by this Application.
	// Only set when workloadType is CronJob.
	// +optional
	CronJobRef *ResourceReference `json:"cronJobRef,omitempty"`

	// JobRef is a reference to the Job managed by this Application.
	// Only set when workloadType is Job.
	// +optional
	JobRef *ResourceReference `json:"jobRef,omitempty"`

	// ServiceRef is a reference to the Service managed by this Application.
	// Only set when workloadType is Deployment and a Service spec is provided.
	// +optional
	ServiceRef *ResourceReference `json:"serviceRef,omitempty"`

	// PersistentVolumeClaimRef is a reference to the PersistentVolumeClaim managed by this Application.
	// +optional
	PersistentVolumeClaimRef *ResourceReference `json:"persistentVolumeClaimRef,omitempty"`

	// Conditions store the status conditions of the Application (e.g., Ready, Progressing, Degraded).
	// +listType=map
	// +listMapKey=type
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}

type DeploymentConfig struct {
	// Deployment defines the pod template, replicas, and update strategy
	// for a long-running workload.
	// +required
	Deployment appsv1.DeploymentSpec `json:"deployment"`

	// Service defines the Service configuration.
	// If specified, a Service will be created to expose the application.
	// +optional
	Service *corev1.ServiceSpec `json:"service,omitempty"`

	// PersistentVolumeClaim defines the desired characteristics of the PVC.
	// If specified, a PVC will be created and automatically mounted into all
	// containers at MountPath.
	// +optional
	PersistentVolumeClaim *corev1.PersistentVolumeClaimSpec `json:"persistentVolumeClaim,omitempty"`

	// MountPath is the absolute path within every container at which the PVC
	// will be mounted (e.g. "/data").
	// Required when persistentVolumeClaim is set.
	//
	// +kubebuilder:validation:MinLength=1
	// +optional
	MountPath string `json:"mountPath,omitempty"`
}

type ResourceReference struct {
	// Name is the name of the referenced resource.
	// +required
	Name string `json:"name"`

	// Namespace is the namespace of the referenced resource.
	// +optional
	Namespace string `json:"namespace,omitempty"`
}

type WorkloadType string