app_store_dev_api 0.1.9 → 0.3.0

data/release_remote.sh

@@ -0,0 +1,121 @@
+#!/bin/bash
+
+#当前脚本目录
+CURRENT_DIR=$(dirname $(readlink -f $0))
+echo $CURRENT_DIR
+
+
+# Make all files and directories in the current directory readable, writable, and executable for all users.
+/bin/chmod -R a+rwx $CURRENT_DIR
+# Change the owner of the current directory to the current user.
+/usr/sbin/chown $(whoami) $CURRENT_DIR
+# Change the group of the current directory to "admin".
+/usr/bin/chgrp admin $CURRENT_DIR
+
+function readConfigValue()
+{
+  File=$1
+  KEY=$2
+  VALUE=$(grep -m 1 -o "^[ ]*$KEY[ ]*=[ ]*[\"]*.*[\"]*" $File | sed -e "s/^[ ]*$KEY[ ]*=[ ]*[\"]*//" -e "s/[\"]*$//")VALUE=$(grep -m 1 -o "^[ ]*$KEY[ ]*=[ ]*[\"]*.*[\"]*" $File | sed -e "s/^[ ]*$KEY[ ]*=[ ]*[\"]*//" -e "s/[\"]*$//")
+  echo $VALUE
+}
+
+
+rm -rf $CURRENT_DIR/*app_store_dev_api-*.gem
+
+VERSION_FILE=${CURRENT_DIR}/lib/app_store_dev_api/version.rb
+VERSION_TAG_NAME=$(grep VERSION ${VERSION_FILE} | cut -d"'" -f2)
+TAG_NAME="v${VERSION_TAG_NAME}"
+
+COMMIT_FILE_LIST=$(git -C $CURRENT_DIR ls-files --other --modified --exclude-standard)
+echo $COMMIT_FILE_LIST
+
+if [ -z "$COMMIT_FILE_LIST" ]; then
+  echo "没有需要提交的文件！"
+else
+  echo "提交没有提交的文件！"
+  # $(git -C $CURRENT_DIR ls-files --other --modified --exclude-standard)
+  git -C $CURRENT_DIR add -A
+  git -C $CURRENT_DIR commit -m "res ${VERSION_TAG_NAME}"
+  git -C $CURRENT_DIR push
+fi
+
+
+
+#合并到master分支
+RELEASE_BRANCH="master"
+CODING_BRANCH=$(git -C $CURRENT_DIR rev-parse --abbrev-ref HEAD)
+
+if [[ "$CODING_BRANCH" == "$RELEASE_BRANCH" ]]; then
+  echo "在master分支不需要处理"
+else
+  git -C $CURRENT_DIR checkout $RELEASE_BRANCH
+  git -C $CURRENT_DIR merge $CODING_BRANCH
+  git -C $CURRENT_DIR push
+
+  git -C $CURRENT_DIR checkout $CODING_BRANCH
+  git -C $CURRENT_DIR merge $RELEASE_BRANCH
+  git -C $CURRENT_DIR push
+  
+fi
+
+
+
+gem build $CURRENT_DIR/app_store_dev_api.gemspec
+if [[ -f $CURRENT_DIR/app_store_dev_api-${VERSION_TAG_NAME}.gem ]]; then
+  gem install --local $CURRENT_DIR/app_store_dev_api-${VERSION_TAG_NAME}.gem
+fi
+
+
+#添加tag
+git -C $CURRENT_DIR checkout $RELEASE_BRANCH
+EXIST_LOCAL_TAG=$(git -C $CURRENT_DIR tag --list ${TAG_NAME})
+if [ -z "$EXIST_LOCAL_TAG" ]; then
+  #statements
+  echo "无本地tag:${TAG_NAME}"
+else
+
+  echo "删除本地tag:${TAG_NAME}"
+  git -C $CURRENT_DIR tag -d ${TAG_NAME}
+fi
+
+REMOTE_EXIST_TAG=$(git -C $CURRENT_DIR ls-remote --tags origin "refs/tags/${TAG_NAME}")
+if [ -z "$REMOTE_EXIST_TAG" ]; then
+  #statements
+  echo "无远程tag:${TAG_NAME}"
+else
+
+  DELETE_REMOTE_TAG=""
+  read -p "存在远程分支,确认要删除远程分支吗？[Y/n]: " DELETE_REMOTE_TAG
+  case "${DELETE_REMOTE_TAG}" in
+  [yY][eE][sS] | [yY])
+      echo "删除远程tag:${TAG_NAME}"
+      git -C $CURRENT_DIR push origin :${TAG_NAME}
+      ;;
+  # [nN][oO] | [nN])
+  #     echo "exit!"
+  #     exit 1
+  #     ;;
+  *)
+      echo "Exit!"
+      exit 1
+      ;;
+  esac  
+fi
+
+git -C $CURRENT_DIR tag  ${TAG_NAME}
+git -C $CURRENT_DIR push origin ${TAG_NAME}
+git -C $CURRENT_DIR checkout $CODING_BRANCH
+
+
+if [[ -f $CURRENT_DIR/app_store_dev_api-${VERSION_TAG_NAME}.gem ]]; then
+  gem push $CURRENT_DIR/app_store_dev_api-${VERSION_TAG_NAME}.gem
+fi
+
+
+
+
+
+
+
+

data/scripts/README.md

@@ -0,0 +1,126 @@
+# Scripts 目录说明
+
+本目录包含用于维护和验证 AppStoreDevApi 的工具脚本。
+
+## 🔧 核心工具（建议保留）
+
+### 1. `validate_requests.rb` ⭐ 核心验证工具
+**用途**: 验证所有 Request 类与 OpenAPI 规范的一致性
+**使用场景**:
+- API 升级后验证
+- 定期检查一致性
+- CI/CD 流程集成
+
+**使用方法**:
+```bash
+ruby scripts/validate_requests.rb
+```
+
+### 2. `comprehensive_validation.rb` ⭐ 全面验证工具
+**用途**: 三方交叉验证（schema.json ↔ Request 类 ↔ OpenAPI）
+**使用场景**:
+- 重大更新后的全面检查
+- 发布前验证
+
+**使用方法**:
+```bash
+ruby scripts/comprehensive_validation.rb
+```
+
+### 3. `test_request_body_classes.rb` ⭐ 功能测试
+**用途**: 测试 Request Body 类的功能是否正常
+**使用场景**:
+- 修改核心代码后测试
+- 回归测试
+
+**使用方法**:
+```bash
+ruby scripts/test_request_body_classes.rb
+```
+
+### 4. `find_deprecated_requests.rb` ⭐ 废弃检测工具
+**用途**: 查找代码库中不在 OpenAPI 规范中的废弃接口
+**使用场景**:
+- OpenAPI 规范更新后
+- 定期清理
+
+**使用方法**:
+```bash
+ruby scripts/find_deprecated_requests.rb
+```
+
+## 🛠️ 一次性工具（可以删除）
+
+### 修复和分析工具
+这些脚本用于一次性修复问题，完成后可以删除：
+
+- `fix_requests.rb` - 自动修复工具（已完成使用）
+- `analyze_deprecated.rb` - 废弃接口分析（已完成使用）
+- `check_naming_conflicts.rb` - 命名冲突检查（已完成使用）
+
+### 代码生成工具
+这些是早期开发使用的工具，可以删除：
+
+- `generate_request_body_classes.rb`
+- `generate_smart_schema.rb`
+- `generate_smart_schema_v2.rb`
+- `openapi_to_schema.rb`
+
+### 分析和对比工具
+一次性分析工具，可以删除：
+
+- `analyze_alias_changes.rb`
+- `analyze_request_body_coverage.rb`
+- `architecture_compatibility_test.rb`
+- `check_missing_endpoints.rb`
+- `check_request_body_types.rb`
+- `compare_schemas.rb`
+- `compare_types.rb`
+- `comprehensive_code_review.rb`
+- `comprehensive_uniqueness_check.rb`
+- `deep_validation.rb`
+- `detailed_compatibility_check.rb`
+- `detect_duplicate_aliases.rb`
+- `extract_naming_rules.rb`
+- `list_alias_changes.rb`
+- `verify_compatibility.rb`
+- `verify_all_requests.rb`
+
+## 📄 报告文件（可以删除）
+
+所有 JSON 报告文件都是临时生成的，可以删除：
+
+- `validation_report.json`
+- `comprehensive_validation_report.json`
+- `deprecated_requests.json`
+- `deprecated_analysis.json`
+- `validation_certificate.json`
+
+如果需要，这些文件可以通过运行对应的脚本重新生成。
+
+## 📋 最终清理方案
+
+### 建议保留（4个核心脚本）
+```
+scripts/
+├── validate_requests.rb              # API 一致性验证
+├── comprehensive_validation.rb       # 三方交叉验证
+├── test_request_body_classes.rb     # 功能测试
+├── find_deprecated_requests.rb      # 废弃检测
+└── README.md                        # 本说明文件
+```
+
+### 可以删除的文件
+- 所有其他 .rb 脚本（30+ 个）
+- 所有 .json 报告文件（5+ 个）
+
+## 🔄 未来维护
+
+当 Apple 发布新的 API 版本时：
+
+1. 更新 `docs/openapi.oas{version}.json`
+2. 运行 `validate_requests.rb` 检查不一致
+3. 运行 `find_deprecated_requests.rb` 查找废弃接口
+4. 修复发现的问题
+5. 运行 `comprehensive_validation.rb` 全面验证
+6. 运行 `test_request_body_classes.rb` 确保功能正常

data/scripts/cleanup_scripts.sh

@@ -0,0 +1,73 @@
+#!/bin/bash
+# 清理 scripts 目录中的临时文件
+
+echo "=========================================="
+echo "清理 scripts 目录"
+echo "=========================================="
+echo
+
+# 要保留的核心脚本
+KEEP_FILES=(
+  "validate_requests.rb"
+  "comprehensive_validation.rb"
+  "test_request_body_classes.rb"
+  "find_deprecated_requests.rb"
+  "final_validation_report.rb"
+  "README.md"
+  "cleanup_scripts.sh"
+)
+
+cd "$(dirname "$0")"
+
+echo "📋 将保留以下文件："
+for file in "${KEEP_FILES[@]}"; do
+  echo "  ✓ $file"
+done
+echo
+
+# 收集要删除的文件
+FILES_TO_DELETE=()
+
+for file in *.rb *.json *.sh; do
+  if [[ -f "$file" ]]; then
+    # 检查是否在保留列表中
+    should_keep=false
+    for keep in "${KEEP_FILES[@]}"; do
+      if [[ "$file" == "$keep" ]]; then
+        should_keep=true
+        break
+      fi
+    done
+
+    if [[ "$should_keep" == false ]]; then
+      FILES_TO_DELETE+=("$file")
+    fi
+  fi
+done
+
+if [ ${#FILES_TO_DELETE[@]} -eq 0 ]; then
+  echo "✅ 没有需要删除的文件"
+  exit 0
+fi
+
+echo "🗑️  将删除以下文件 (${#FILES_TO_DELETE[@]} 个):"
+for file in "${FILES_TO_DELETE[@]}"; do
+  echo "  ✗ $file"
+done
+echo
+
+read -p "确认删除? (y/n) " -n 1 -r
+echo
+if [[ $REPLY =~ ^[Yy]$ ]]; then
+  for file in "${FILES_TO_DELETE[@]}"; do
+    rm "$file"
+    echo "  已删除: $file"
+  done
+  echo
+  echo "✅ 清理完成！"
+  echo
+  echo "保留的核心工具："
+  ls -lh *.rb *.md 2>/dev/null | awk '{print "  " $9 " (" $5 ")"}'
+else
+  echo "❌ 取消删除"
+fi

data/scripts/comprehensive_validation.rb

@@ -0,0 +1,359 @@
+#!/usr/bin/env ruby
+# 全面验证：schema.json、Request 类、OpenAPI v4.2 三方一致性
+
+require 'json'
+require 'set'
+
+puts "=" * 100
+puts "🔍 全面一致性验证：schema.json ↔ Request 类 ↔ OpenAPI v4.2"
+puts "=" * 100
+puts
+
+# 1. 读取 OpenAPI 规范
+openapi_file = File.join(__dir__, '../docs/openapi.oas4.2.json')
+openapi_data = JSON.parse(File.read(openapi_file))
+openapi_schemas = openapi_data['components']['schemas']
+openapi_paths = openapi_data['paths']
+
+# 2. 读取 schema.json 配置
+schema_files = [
+  File.join(__dir__, '../lib/config/schema_v4.2.json'),
+  File.join(__dir__, '../lib/config/schema.json')
+].find { |f| File.exist?(f) }
+
+if schema_files.nil?
+  puts "❌ 错误: 未找到 schema.json 文件"
+  exit 1
+end
+
+schema_data = JSON.parse(File.read(schema_files))
+schema_endpoints = schema_data['web_service_endpoints'] || []
+
+# 3. 扫描所有 Request 类文件
+def scan_request_classes
+  request_classes = []
+
+  ['v1', 'v2'].each do |version|
+    base_dir = File.join(__dir__, "../lib/app_store_dev_api/requests/#{version}")
+    next unless Dir.exist?(base_dir)
+
+    Dir.glob("#{base_dir}/**/{create,update}.rb").each do |file|
+      request_classes << {
+        file: file.gsub(__dir__ + '/../', ''),
+        version: version,
+        action: File.basename(file, '.rb')
+      }
+    end
+  end
+
+  request_classes
+end
+
+request_classes = scan_request_classes
+
+puts "📊 统计信息："
+puts "  OpenAPI 路径数: #{openapi_paths.size}"
+puts "  OpenAPI Request Schemas: #{openapi_schemas.select { |k, _| k.end_with?('Request') }.size}"
+puts "  schema.json 端点数: #{schema_endpoints.size}"
+puts "  Request 类文件数: #{request_classes.size}"
+puts
+
+# ==================== 验证 1: schema.json vs OpenAPI ====================
+puts "=" * 100
+puts "📋 验证 1/3: schema.json 配置 vs OpenAPI 路径"
+puts "=" * 100
+puts
+
+schema_issues = []
+
+schema_endpoints.each do |endpoint|
+  alias_name = endpoint['alias']
+  http_method = endpoint['http_method']
+  url = endpoint['url']
+
+  # 提取路径（去掉 base URL）
+  path = url.gsub('https://api.appstoreconnect.apple.com', '')
+
+  # 检查路径是否存在
+  unless openapi_paths.key?(path)
+    schema_issues << {
+      type: 'path_not_found',
+      alias: alias_name,
+      path: path,
+      method: http_method
+    }
+    next
+  end
+
+  # 检查 HTTP 方法是否存在
+  path_methods = openapi_paths[path]
+  unless path_methods.key?(http_method)
+    schema_issues << {
+      type: 'method_not_found',
+      alias: alias_name,
+      path: path,
+      method: http_method,
+      available_methods: path_methods.keys
+    }
+  end
+end
+
+if schema_issues.empty?
+  puts "✅ 所有 schema.json 端点都在 OpenAPI 中存在"
+else
+  puts "⚠️  发现 #{schema_issues.size} 个问题："
+  schema_issues.each_with_index do |issue, idx|
+    puts "\n#{idx + 1}. #{issue[:alias]}"
+    if issue[:type] == 'path_not_found'
+      puts "   路径不存在: #{issue[:method].upcase} #{issue[:path]}"
+    else
+      puts "   方法不存在: #{issue[:method].upcase} #{issue[:path]}"
+      puts "   可用方法: #{issue[:available_methods].map(&:upcase).join(', ')}"
+    end
+  end
+end
+puts
+
+# ==================== 验证 2: Request 类 vs OpenAPI Schemas ====================
+puts "=" * 100
+puts "📋 验证 2/3: Request 类实现 vs OpenAPI Request Schemas"
+puts "=" * 100
+puts
+
+# 从文件路径推断 schema 名称
+def file_to_schema_name(file_path, version, action)
+  parts = file_path.split('/')
+  module_name = parts[-2]
+
+  camel_case = module_name.split('_').map(&:capitalize).join
+
+  if version == 'v2' && !camel_case.end_with?('V2')
+    camel_case += 'V2'
+  end
+
+  action_suffix = action.capitalize + 'Request'
+  "#{camel_case}#{action_suffix}"
+end
+
+# 提取 Request 类的属性定义
+def extract_request_properties(file_path)
+  return nil unless File.exist?(file_path)
+
+  content = File.read(file_path)
+
+  attributes = []
+  relationships = []
+
+  in_attributes = false
+  in_relationships = false
+
+  content.each_line do |line|
+    line = line.strip
+
+    if line == 'attributes do'
+      in_attributes = true
+      in_relationships = false
+    elsif line == 'relationships do'
+      in_relationships = true
+      in_attributes = false
+    elsif line == 'end'
+      in_attributes = false if in_attributes
+      in_relationships = false if in_relationships
+    elsif line.start_with?('property :')
+      match = line.match(/property :(\w+)/)
+      if match
+        prop_name = match[1]
+        next if prop_name == 'id'  # 跳过 id
+
+        if in_attributes
+          attributes << prop_name
+        elsif in_relationships
+          relationships << prop_name
+        end
+      end
+    end
+  end
+
+  { attributes: attributes, relationships: relationships }
+end
+
+# 提取 OpenAPI Schema 的属性定义
+def extract_openapi_schema_properties(schema_data)
+  return nil unless schema_data
+
+  data_props = schema_data.dig('properties', 'data', 'properties')
+  return nil unless data_props
+
+  attributes = data_props.dig('attributes', 'properties')&.keys || []
+  relationships = data_props.dig('relationships', 'properties')&.keys || []
+
+  { attributes: attributes, relationships: relationships }
+end
+
+request_issues = []
+
+request_classes.each do |req|
+  schema_name = file_to_schema_name(req[:file], req[:version], req[:action])
+
+  # 检查 schema 是否存在
+  unless openapi_schemas.key?(schema_name)
+    request_issues << {
+      type: 'schema_not_found',
+      file: req[:file],
+      schema: schema_name
+    }
+    next
+  end
+
+  # 提取属性
+  file_path = File.join(__dir__, '..', req[:file])
+  request_props = extract_request_properties(file_path)
+  openapi_props = extract_openapi_schema_properties(openapi_schemas[schema_name])
+
+  next unless request_props && openapi_props
+
+  # 对比属性
+  req_attrs = Set.new(request_props[:attributes])
+  api_attrs = Set.new(openapi_props[:attributes])
+
+  missing_attrs = api_attrs - req_attrs
+  extra_attrs = req_attrs - api_attrs
+
+  # 对比关系
+  req_rels = Set.new(request_props[:relationships])
+  api_rels = Set.new(openapi_props[:relationships])
+
+  missing_rels = api_rels - req_rels
+  extra_rels = req_rels - api_rels
+
+  if missing_attrs.any? || extra_attrs.any? || missing_rels.any? || extra_rels.any?
+    request_issues << {
+      type: 'property_mismatch',
+      file: req[:file],
+      schema: schema_name,
+      missing_attributes: missing_attrs.to_a,
+      extra_attributes: extra_attrs.to_a,
+      missing_relationships: missing_rels.to_a,
+      extra_relationships: extra_rels.to_a
+    }
+  end
+end
+
+if request_issues.empty?
+  puts "✅ 所有 Request 类都与 OpenAPI Schemas 一致"
+else
+  puts "⚠️  发现 #{request_issues.size} 个问题："
+  request_issues.each_with_index do |issue, idx|
+    puts "\n#{idx + 1}. #{issue[:schema]}"
+    puts "   文件: #{issue[:file]}"
+
+    if issue[:type] == 'schema_not_found'
+      puts "   ❌ OpenAPI 中不存在此 Schema"
+    else
+      if issue[:missing_attributes].any?
+        puts "   ❌ 缺失属性: #{issue[:missing_attributes].join(', ')}"
+      end
+      if issue[:extra_attributes].any?
+        puts "   ⚠️  多余属性: #{issue[:extra_attributes].join(', ')}"
+      end
+      if issue[:missing_relationships].any?
+        puts "   ❌ 缺失关系: #{issue[:missing_relationships].join(', ')}"
+      end
+      if issue[:extra_relationships].any?
+        puts "   ⚠️  多余关系: #{issue[:extra_relationships].join(', ')}"
+      end
+    end
+  end
+end
+puts
+
+# ==================== 验证 3: 三方完整性检查 ====================
+puts "=" * 100
+puts "📋 验证 3/3: 三方完整性检查"
+puts "=" * 100
+puts
+
+# 检查 OpenAPI 中所有 POST/PATCH/PUT 端点是否都有对应的配置和实现
+completeness_issues = []
+
+openapi_paths.each do |path, methods|
+  methods.each do |method, details|
+    next unless ['post', 'patch', 'put'].include?(method)
+
+    operation_id = details['operationId']
+    next unless operation_id
+
+    # 检查是否有对应的 schema.json 配置
+    schema_endpoint = schema_endpoints.find do |ep|
+      ep['url'].include?(path) && ep['http_method'] == method
+    end
+
+    unless schema_endpoint
+      completeness_issues << {
+        type: 'missing_in_schema',
+        path: path,
+        method: method,
+        operation_id: operation_id
+      }
+    end
+  end
+end
+
+if completeness_issues.empty?
+  puts "✅ OpenAPI 中所有 POST/PATCH/PUT 端点都有对应配置"
+else
+  puts "⚠️  发现 #{completeness_issues.size} 个端点缺少 schema.json 配置："
+  completeness_issues.take(10).each_with_index do |issue, idx|
+    puts "  #{idx + 1}. #{issue[:method].upcase} #{issue[:path]}"
+    puts "     operationId: #{issue[:operation_id]}"
+  end
+
+  if completeness_issues.size > 10
+    puts "  ... 还有 #{completeness_issues.size - 10} 个"
+  end
+end
+puts
+
+# ==================== 总结 ====================
+puts "=" * 100
+puts "📊 验证总结"
+puts "=" * 100
+puts
+
+total_issues = schema_issues.size + request_issues.size + completeness_issues.size
+
+if total_issues == 0
+  puts "🎉 完美！所有验证都通过："
+  puts "  ✅ schema.json 配置完全匹配 OpenAPI"
+  puts "  ✅ Request 类实现完全匹配 OpenAPI Schemas"
+  puts "  ✅ 所有端点都有完整的实现"
+  puts
+  puts "当前状态: 100% 符合 OpenAPI v4.2 规范"
+else
+  puts "⚠️  发现 #{total_issues} 个问题需要修复："
+  puts "  - schema.json 配置问题: #{schema_issues.size}"
+  puts "  - Request 类实现问题: #{request_issues.size}"
+  puts "  - 完整性问题: #{completeness_issues.size}"
+  puts
+  puts "建议: 根据上述问题进行修复"
+end
+
+# 保存详细报告
+report = {
+  timestamp: Time.now.iso8601,
+  summary: {
+    total_issues: total_issues,
+    schema_issues: schema_issues.size,
+    request_issues: request_issues.size,
+    completeness_issues: completeness_issues.size
+  },
+  schema_issues: schema_issues,
+  request_issues: request_issues,
+  completeness_issues: completeness_issues
+}
+
+report_file = File.join(__dir__, 'comprehensive_validation_report.json')
+File.write(report_file, JSON.pretty_generate(report))
+
+puts
+puts "详细报告已保存到: #{report_file}"

data/scripts/comprehensive_validation_report.json

@@ -0,0 +1,12 @@
+{
+  "timestamp": "2026-01-05T18:13:18+08:00",
+  "summary": {
+    "total_issues": 0,
+    "schema_issues": 0,
+    "request_issues": 0,
+    "completeness_issues": 0
+  },
+  "schema_issues": [],
+  "request_issues": [],
+  "completeness_issues": []
+}