基础架构

internal/domains/certification/services/state_machine.go

@@ -124,17 +124,17 @@ func (sm *CertificationStateMachine) TransitionTo(
 	}
 
 	// 执行状态转换前的验证
-	if err := sm.validateTransition(ctx, cert, targetStatus, metadata); err != nil {
+	if err := sm.validateTransition(ctx, &cert, targetStatus, metadata); err != nil {
 		return fmt.Errorf("状态转换验证失败: %w", err)
 	}
 
 	// 更新状态和时间戳
 	oldStatus := cert.Status
 	cert.Status = targetStatus
-	sm.updateTimestamp(cert, targetStatus)
+	sm.updateTimestamp(&cert, targetStatus)
 
 	// 更新其他字段
-	sm.updateCertificationFields(cert, targetStatus, metadata)
+	sm.updateCertificationFields(&cert, targetStatus, metadata)
 
 	// 保存到数据库
 	if err := sm.certRepo.Update(ctx, cert); err != nil {
@@ -215,9 +215,9 @@ func (sm *CertificationStateMachine) validateTransition(
 	switch targetStatus {
 	case enums.StatusInfoSubmitted:
 		// 验证企业信息是否完整
-		if cert.EnterpriseID == nil {
-			return fmt.Errorf("企业信息未提交")
-		}
+		// 这里应该检查用户是否有企业信息，通过用户域的企业服务验证
+		// 暂时跳过验证，由应用服务层协调
+		break
 
 	case enums.StatusFaceVerified:
 		// 验证人脸识别是否成功
@@ -285,3 +285,164 @@ func (sm *CertificationStateMachine) GetTransitionAction(
 
 	return ""
 }
+
+// GetTransitionHistory 获取状态转换历史
+func (sm *CertificationStateMachine) GetTransitionHistory(ctx context.Context, certificationID string) ([]map[string]interface{}, error) {
+	cert, err := sm.certRepo.GetByID(ctx, certificationID)
+	if err != nil {
+		return nil, fmt.Errorf("获取认证记录失败: %w", err)
+	}
+
+	history := []map[string]interface{}{}
+
+	// 添加创建时间
+	history = append(history, map[string]interface{}{
+		"status":    "CREATED",
+		"timestamp": cert.CreatedAt,
+		"action":    "create",
+		"performer": "system",
+		"metadata":  map[string]interface{}{},
+	})
+
+	// 添加各个时间节点的状态转换
+	if cert.InfoSubmittedAt != nil {
+		history = append(history, map[string]interface{}{
+			"status":    string(enums.StatusInfoSubmitted),
+			"timestamp": *cert.InfoSubmittedAt,
+			"action":    "submit_info",
+			"performer": "user",
+			"metadata":  map[string]interface{}{},
+		})
+	}
+
+	if cert.FaceVerifiedAt != nil {
+		history = append(history, map[string]interface{}{
+			"status":    string(enums.StatusFaceVerified),
+			"timestamp": *cert.FaceVerifiedAt,
+			"action":    "face_verify",
+			"performer": "system",
+			"metadata":  map[string]interface{}{},
+		})
+	}
+
+	if cert.ContractAppliedAt != nil {
+		history = append(history, map[string]interface{}{
+			"status":    string(enums.StatusContractApplied),
+			"timestamp": *cert.ContractAppliedAt,
+			"action":    "apply_contract",
+			"performer": "user",
+			"metadata":  map[string]interface{}{},
+		})
+	}
+
+	if cert.ContractApprovedAt != nil {
+		metadata := map[string]interface{}{}
+		if cert.AdminID != nil {
+			metadata["admin_id"] = *cert.AdminID
+		}
+		if cert.ApprovalNotes != "" {
+			metadata["approval_notes"] = cert.ApprovalNotes
+		}
+		if cert.SigningURL != "" {
+			metadata["signing_url"] = cert.SigningURL
+		}
+
+		history = append(history, map[string]interface{}{
+			"status":    string(enums.StatusContractApproved),
+			"timestamp": *cert.ContractApprovedAt,
+			"action":    "admin_approve",
+			"performer": "admin",
+			"metadata":  metadata,
+		})
+	}
+
+	if cert.ContractSignedAt != nil {
+		metadata := map[string]interface{}{}
+		if cert.ContractURL != "" {
+			metadata["contract_url"] = cert.ContractURL
+		}
+
+		history = append(history, map[string]interface{}{
+			"status":    string(enums.StatusContractSigned),
+			"timestamp": *cert.ContractSignedAt,
+			"action":    "user_sign",
+			"performer": "user",
+			"metadata":  metadata,
+		})
+	}
+
+	if cert.CompletedAt != nil {
+		history = append(history, map[string]interface{}{
+			"status":    string(enums.StatusCompleted),
+			"timestamp": *cert.CompletedAt,
+			"action":    "system_complete",
+			"performer": "system",
+			"metadata":  map[string]interface{}{},
+		})
+	}
+
+	return history, nil
+}
+
+// ValidateCertificationFlow 验证认证流程的完整性
+func (sm *CertificationStateMachine) ValidateCertificationFlow(ctx context.Context, certificationID string) (map[string]interface{}, error) {
+	cert, err := sm.certRepo.GetByID(ctx, certificationID)
+	if err != nil {
+		return nil, fmt.Errorf("获取认证记录失败: %w", err)
+	}
+
+	validation := map[string]interface{}{
+		"certification_id": certificationID,
+		"current_status":   cert.Status,
+		"is_valid":         true,
+		"issues":           []string{},
+		"warnings":         []string{},
+	}
+
+	// 检查必要的时间节点
+	if cert.Status != enums.StatusPending {
+		if cert.InfoSubmittedAt == nil {
+			validation["is_valid"] = false
+			validation["issues"] = append(validation["issues"].([]string), "缺少企业信息提交时间")
+		}
+	}
+
+	if cert.Status == enums.StatusFaceVerified || cert.Status == enums.StatusContractApplied ||
+		cert.Status == enums.StatusContractPending || cert.Status == enums.StatusContractApproved ||
+		cert.Status == enums.StatusContractSigned || cert.Status == enums.StatusCompleted {
+		if cert.FaceVerifiedAt == nil {
+			validation["is_valid"] = false
+			validation["issues"] = append(validation["issues"].([]string), "缺少人脸识别完成时间")
+		}
+	}
+
+	if cert.Status == enums.StatusContractApproved || cert.Status == enums.StatusContractSigned ||
+		cert.Status == enums.StatusCompleted {
+		if cert.ContractApprovedAt == nil {
+			validation["is_valid"] = false
+			validation["issues"] = append(validation["issues"].([]string), "缺少合同审核时间")
+		}
+		if cert.SigningURL == "" {
+			validation["warnings"] = append(validation["warnings"].([]string), "缺少合同签署链接")
+		}
+	}
+
+	if cert.Status == enums.StatusContractSigned || cert.Status == enums.StatusCompleted {
+		if cert.ContractSignedAt == nil {
+			validation["is_valid"] = false
+			validation["issues"] = append(validation["issues"].([]string), "缺少合同签署时间")
+		}
+		if cert.ContractURL == "" {
+			validation["warnings"] = append(validation["warnings"].([]string), "缺少合同文件链接")
+		}
+	}
+
+	if cert.Status == enums.StatusCompleted {
+		if cert.CompletedAt == nil {
+			validation["is_valid"] = false
+			validation["issues"] = append(validation["issues"].([]string), "缺少认证完成时间")
+		}
+	}
+
+	return validation, nil
+}