feat(parameters): track parameterview submission results

Author: leon-ape

apis/parameters/v1alpha1/parameterview_types.go

@@ -192,6 +192,35 @@ type ParameterViewSubmission struct {
 	//
 	// +optional
 	Parameters ParameterValueMap `json:"parameters,omitempty"`
+
+	// Result records the current observed outcome of this submission after it has
+	// been handed off to the ComponentParameter controller.
+	//
+	// +optional
+	Result ParameterViewSubmissionResult `json:"result,omitempty"`
+}
+
+// ParameterViewSubmissionResult records the current observed outcome of a submission.
+type ParameterViewSubmissionResult struct {
+	// Phase describes the current execution state of this submission.
+	//
+	// +optional
+	Phase ParameterViewSubmissionPhase `json:"phase,omitempty"`
+
+	// Reason is a stable, machine-friendly summary for the current submission result.
+	//
+	// +optional
+	Reason string `json:"reason,omitempty"`
+
+	// Message provides a human-readable summary for the current submission result.
+	//
+	// +optional
+	Message string `json:"message,omitempty"`
+
+	// UpdatedAt records when the result was last refreshed by the controller.
+	//
+	// +optional
+	UpdatedAt *metav1.Time `json:"updatedAt,omitempty"`
 }
 
 // ParameterViewMode defines whether a ParameterView can be edited.
@@ -232,6 +261,26 @@ const (
 	ParameterViewApplyingPhase ParameterViewPhase = "Applying"
 )
 
+// ParameterViewSubmissionPhase defines the observed execution state of a submission.
+// +enum
+// +kubebuilder:validation:Enum={Processing,Failed,Succeeded}
+type ParameterViewSubmissionPhase string
+
+const (
+	// ParameterViewSubmissionProcessingPhase means the submission has already
+	// been handed off to the ComponentParameter controller, and its final
+	// execution outcome is not known yet.
+	ParameterViewSubmissionProcessingPhase ParameterViewSubmissionPhase = "Processing"
+
+	// ParameterViewSubmissionFailedPhase means the submission has reached a final
+	// failure outcome in the ComponentParameter processing chain.
+	ParameterViewSubmissionFailedPhase ParameterViewSubmissionPhase = "Failed"
+
+	// ParameterViewSubmissionSucceededPhase means the submission has reached a
+	// final successful outcome in the ComponentParameter processing chain.
+	ParameterViewSubmissionSucceededPhase ParameterViewSubmissionPhase = "Succeeded"
+)
+
 // ParameterViewContent describes the editable document shown to users.
 type ParameterViewContent struct {
 	// Type declares how Text should be parsed and rendered.

apis/parameters/v1alpha1/zz_generated.deepcopy.go

@@ -309,6 +309,33 @@ spec:
                       description: Parameters contains the desired parameter updates
                         submitted from the view.
                       type: object
+                    result:
+                      description: |-
+                        Result records the current observed outcome of this submission after it has
+                        been handed off to the ComponentParameter controller.
+                      properties:
+                        message:
+                          description: Message provides a human-readable summary for
+                            the current submission result.
+                          type: string
+                        phase:
+                          description: Phase describes the current execution state
+                            of this submission.
+                          enum:
+                          - Processing
+                          - Failed
+                          - Succeeded
+                          type: string
+                        reason:
+                          description: Reason is a stable, machine-friendly summary
+                            for the current submission result.
+                          type: string
+                        updatedAt:
+                          description: UpdatedAt records when the result was last
+                            refreshed by the controller.
+                          format: date-time
+                          type: string
+                      type: object
                     revision:
                       description: Revision records the effective content revision
                         that the submission was based on.