🚀 代码自动生成模块

generated/
├── python/                    # Python 代码
│   ├── schemas/              # 数据模型 (Pydantic)
│   │   ├── user_request.py
│   │   ├── order_response.py
│   │   └── __init__.py
│   ├── errors/               # 错误码和异常处理
│   │   ├── error_codes.py
│   │   ├── error_handler.py
│   │   ├── i18n/
│   │   │   ├── zh.json
│   │   │   └── en.json
│   │   └── __init__.py
│   └── auth/                 # 认证鉴权模块
│       ├── auth_config.py
│       ├── jwt_auth.py
│       ├── rbac.py
│       ├── middleware.py
│       └── __init__.py
├── java/                     # Java 代码
│   ├── schemas/              # 数据模型 (POJO + Lombok)
│   ├── errors/               # 错误码枚举
│   └── auth/                 # 认证配置
├── go/                       # Go 代码
│   ├── schemas/              # 数据结构
│   ├── errors/               # 错误定义
│   └── auth/                 # 认证模块
├── typescript/               # TypeScript 代码
│   ├── schemas/              # 接口定义
│   ├── errors/               # 错误码
│   └── auth/                 # 认证服务
├── README.md                 # 项目说明
└── generation_summary.json   # 生成摘要

# Python 环境要求：3.8+
pip install pydantic pyyaml

# api_config.yaml
project_name: "MyAPI"
version: "1.0.0"
languages:
  - python
  - typescript

schemas:
  - name: UserRequest
    description: "用户请求"
    fields:
      - name: username
        type: string
        required: true
      - name: email
        type: string
        required: true

# 命令行方式
python -m code_generator.generator -c api_config.yaml -o ./generated

# 或编程方式
from code_generator import CodeGenerator

generator = CodeGenerator.from_yaml("api_config.yaml")
result = generator.generate_all(output_dir="./generated")

print(f"Generated {len(result)} files")

# Python 示例
from generated.python.schemas import UserRequest
from generated.python.errors import ErrorCodes, handle_error
from generated.python.auth import JWTAuthService, require_permission

# 使用 Schema
user = UserRequest(username="john", email="john@example.com")

# 使用错误处理
try:
    if not user.username:
        raise handle_error(ErrorCodes.VAL_001)
except APIException as e:
    print(e.to_dict())

# 使用认证
jwt_service = JWTAuthService()
token = jwt_service.create_access_token(user_id="123", username="john")

# api_config.yaml - 完整配置示例
project_name: "ECommerceAPI"
version: "2.0.0"
base_package: "com.ecommerce.api"
languages:
  - python
  - typescript
  - java

schemas:
  - name: ProductCreateRequest
    description: "产品创建请求"
    fields:
      - name: name
        type: string
        required: true
        description: "产品名称"
        validation:
          min_length: 2
          max_length: 100
      - name: price
        type: number
        required: true
        description: "价格"
        validation:
          minimum: 0
      - name: stock
        type: integer
        required: false
        description: "库存数量"
        default: 0

error_codes:
  - code: PROD_001
    http_status: 404
    message: "产品不存在"
    message_en: "Product not found"
    category: BUSINESS
    solution: "请检查产品 ID 是否正确"
  
  - code: PROD_002
    http_status: 400
    message: "库存不足"
    message_en: "Insufficient stock"
    category: BUSINESS
    retryable: true

auth_rules:
  - name: jwt_auth
    type: JWT
    enabled: true
    config:
      secret_key: "${JWT_SECRET}"
      algorithm: HS256
      access_token_expire_minutes: 30
    roles:
      - admin
      - user

endpoints:
  - path: /api/v1/products
    method: POST
    summary: "创建产品"
    request_schema: ProductCreateRequest
    auth_rules:
      - jwt_auth

# generated/python/schemas/product_create_request.py
from typing import Optional
from pydantic import BaseModel, Field

class ProductCreateRequest(BaseModel):
    """产品创建请求"""
    
    name: str  # 产品名称
    price: float  # 价格
    stock: Optional[int] = 0  # 库存数量
    
    class Config:
        json_schema_extra = {
            "description": "产品创建请求"
        }

# generated/python/errors/error_codes.py
from enum import Enum
from dataclasses import dataclass

@dataclass
class ErrorCodeInfo:
    code: str
    http_status: int
    message: str
    message_en: str
    category: str
    solution: str = ""
    retryable: bool = False

class ErrorCodes:
    """错误码定义"""
    
    PROD_001 = "PROD_001"  # HTTP 404: 产品不存在
    PROD_002 = "PROD_002"  # HTTP 400: 库存不足

ERROR_CODE_REGISTRY = {
    ErrorCodes.PROD_001: ErrorCodeInfo(
        code="PROD_001",
        http_status=404,
        message="产品不存在",
        message_en="Product not found",
        category="BUSINESS",
        solution="请检查产品 ID 是否正确",
        retryable=False
    ),
    ErrorCodes.PROD_002: ErrorCodeInfo(
        code="PROD_002",
        http_status=400,
        message="库存不足",
        message_en="Insufficient stock",
        category="BUSINESS",
        retryable=True
    )
}

class CodeGenerator:
    """代码生成器主类"""
    
    def __init__(self, config: ConfigData)
    
    @classmethod
    def from_yaml(cls, yaml_path: str) -> CodeGenerator
        """从 YAML 配置文件创建生成器"""
    
    @classmethod
    def from_json(cls, json_path: str) -> CodeGenerator
        """从 JSON 配置文件创建生成器"""
    
    @classmethod
    def from_dict(cls, config_dict: dict) -> CodeGenerator
        """从字典配置创建生成器"""
    
    def generate_all(
        output_dir: str = None,
        languages: list[str] = None
    ) -> dict[str, list[str]]
        """生成所有代码文件"""
    
    def generate_schema(
        output_dir: str = None,
        languages: list[str] = None
    ) -> list[str]
        """生成 Schema 文件"""
    
    def generate_error_codes(
        output_dir: str = None,
        languages: list[str] = None
    ) -> list[str]
        """生成错误码文件"""
    
    def generate_auth(
        output_dir: str = None,
        languages: list[str] = None
    ) -> list[str]
        """生成认证模块文件"""

# 基本用法
python -m code_generator.generator -c config.yaml

# 指定输出目录
python -m code_generator.generator -c config.yaml -o ./output

# 指定生成语言
python -m code_generator.generator -c config.yaml -l python typescript

# 查看帮助
python -m code_generator.generator --help

# 参数说明
-c, --config     配置文件路径 (YAML 或 JSON) [必填]
-o, --output     输出目录 [默认：./generated]
-l, --languages  目标语言列表 [默认：配置文件中定义]