feat: expand vehicle data platform capabilities

vehicle-data-platform/apps/api/internal/platform/access.go

@@ -21,6 +21,10 @@ type accessUnresolvedIdentityStore interface {
 	AccessUnresolvedIdentities(context.Context, AccessUnresolvedIdentityQuery) (Page[AccessUnresolvedIdentity], error)
 }
 
+type accessIdentityClaimStore interface {
+	ClaimAccessIdentity(context.Context, string, AccessIdentityClaimInput) (AccessIdentityClaimResult, error)
+}
+
 func defaultAccessThresholds(now time.Time) AccessThresholdConfig {
 	return AccessThresholdConfig{
 		Version:             1,
@@ -114,6 +118,42 @@ func (s *Service) AccessUnresolvedIdentities(ctx context.Context, query AccessUn
 	return store.AccessUnresolvedIdentities(ctx, query)
 }
 
+func (s *Service) ClaimAccessIdentity(ctx context.Context, identityID string, input AccessIdentityClaimInput) (AccessIdentityClaimResult, error) {
+	identityID = strings.TrimSpace(identityID)
+	if identityID == "" || len(identityID) > 128 {
+		return AccessIdentityClaimResult{}, clientError{Code: "ACCESS_IDENTITY_INVALID", Message: "待认领来源标识无效，请刷新后重试"}
+	}
+	input.VIN = strings.ToUpper(strings.TrimSpace(input.VIN))
+	if !validAccessClaimVIN(input.VIN) {
+		return AccessIdentityClaimResult{}, clientError{Code: "ACCESS_IDENTITY_VIN_INVALID", Message: "请选择有效的权威 VIN"}
+	}
+	input.Note = strings.TrimSpace(input.Note)
+	if len([]rune(input.Note)) > 500 {
+		return AccessIdentityClaimResult{}, clientError{Code: "ACCESS_IDENTITY_NOTE_TOO_LONG", Message: "认领说明不能超过 500 个字"}
+	}
+	input.Actor = strings.TrimSpace(input.Actor)
+	if input.Actor == "" {
+		input.Actor = "platform-admin"
+	}
+	store, ok := s.store.(accessIdentityClaimStore)
+	if !ok {
+		return AccessIdentityClaimResult{}, clientError{Code: "ACCESS_IDENTITY_READ_ONLY", Message: "当前存储不支持来源身份认领"}
+	}
+	return store.ClaimAccessIdentity(ctx, identityID, input)
+}
+
+func validAccessClaimVIN(vin string) bool {
+	if len(vin) < 6 || len(vin) > 32 {
+		return false
+	}
+	for _, char := range vin {
+		if (char < 'A' || char > 'Z') && (char < '0' || char > '9') {
+			return false
+		}
+	}
+	return true
+}
+
 func (s *Service) AccessSummary(ctx context.Context, query AccessQuery) (AccessSummary, error) {
 	rows, config, err := s.accessRows(ctx, query)
 	if err != nil {