feat: requirement controller (#16)

* feat: Update RequirementSpec and RequirementStatus with new fields and validation

* Implement Requirement Controller with enhanced reconciliation logic and status management

- Refactored RequirementReconciler to include a dedicated ReconcileHandler method for better separation of concerns.
- Introduced a new RequirementAdapterInterface to facilitate operations during reconciliation.
- Added default check interval for requeueing after reconciliation.
- Implemented field indexing for Operation resources owned by Requirement.
- Enhanced SetupWithManager to register event recorder for Requirement events.
- Created utility functions for managing Requirement status conditions, including ClearConditions, IsCacheMissed, and UpdateCondition.
- Added unit tests for Requirement status management functions to ensure correctness.
- Updated requirement_controller_test.go to cover new reconciliation logic and adapter interactions.
- Introduced constants for condition types and reasons to improve readability and maintainability.

* fix: Refactor requirement adapter tests to use a constant for operation name

* fix: Update validation comments and refactor test to use a constant for requirement UID

Author: ninjadq

api/v1/requirement_types.go

@@ -28,18 +28,30 @@ type RequirementSpec struct {
 	// INSERT ADDITIONAL SPEC FIELDS - desired state of cluster
 	// Important: Run "make" to regenerate code after modifying this file
 
-	// Foo is an example field of Requirement. Edit requirement_types.go to remove/update
-	Foo string `json:"foo,omitempty"`
+	// +kubebuilder:validation:Required
+	Template OperationSpec `json:"template"`
+	// +kubebuilder:validation:Required
+	EnableCache bool `json:"enableCache"`
+	// +kubebuilder:validation:Optional
+	// +kubebuilder:validation:Pattern:=`^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$`
+	ExpireAt string `json:"expireAt,omitempty"`
 }
 
 // RequirementStatus defines the observed state of Requirement.
 type RequirementStatus struct {
 	// INSERT ADDITIONAL STATUS FIELD - define observed state of cluster
 	// Important: Run "make" to regenerate code after modifying this file
+	OperationId   string             `json:"operationId"`
+	OperationName string             `json:"operationName"`
+	CacheKey      string             `json:"originalCacheKey"`
+	Phase         string             `json:"phase"`
+	Conditions    []metav1.Condition `json:"conditions"`
 }
 
 // +kubebuilder:object:root=true
 // +kubebuilder:subresource:status
+// +kubebuilder:printcolumn:name="Phase",type="string",JSONPath=`.status.phase`
+// +kubebuilder:printcolumn:name="OperationId",type="string",JSONPath=`.status.operationId`
 
 // Requirement is the Schema for the requirements API.
 type Requirement struct {