ParaAIV3.0

.env.local

@@ -0,0 +1,70 @@
+# ============================================================================
+# Variáveis de Ambiente - DESENVOLVIMENTO LOCAL
+# para.AI API v3.0
+# ============================================================================
+# Este arquivo é para desenvolvimento local com docker-compose
+# Copie para .env.local e ajuste conforme necessário
+
+# ============================================================================
+# APP SETTINGS
+# ============================================================================
+APP_ENV=development
+DEBUG=true
+
+# ============================================================================
+# DATABASE - PostgreSQL Local (Docker)
+# ============================================================================
+DATABASE_URL=postgresql://para_ai:para_ai_dev_2026@localhost:5432/para_ai
+
+# Ou se estiver usando docker-compose (conectando do host):
+# DATABASE_URL=postgresql://para_ai:para_ai_dev_2026@db:5432/para_ai
+
+DB_POOL_SIZE=10
+DB_MAX_OVERFLOW=20
+
+# ============================================================================
+# LLM PROVIDERS - SUAS API KEYS REAIS
+# ============================================================================
+# Obtenha suas keys em:
+# - Groq: https://console.groq.com/
+# - OpenAI: https://platform.openai.com/api-keys
+# - Anthropic: https://console.anthropic.com/
+
+GROQ_API_KEY=gsk_sua_key_aqui
+# OPENAI_API_KEY=sk-sua_key_aqui
+# ANTHROPIC_API_KEY=sk-ant-sua_key_aqui
+
+DEFAULT_LLM_PROVIDER=groq
+DEFAULT_MODEL_TYPE=balanced
+
+# ============================================================================
+# CACHE - Redis Local (Docker)
+# ============================================================================
+ENABLE_CACHE=true
+REDIS_URL=redis://localhost:6379/0
+
+# ============================================================================
+# PROCESSING
+# ============================================================================
+ENABLE_PARALLEL=true
+MAX_CONCURRENT_PROCESSES=3
+PROCESS_TIMEOUT_SECONDS=600
+
+# ============================================================================
+# LOGGING
+# ============================================================================
+LOG_LEVEL=DEBUG
+LOG_FILE_ENABLED=true
+
+# ============================================================================
+# SECURITY - Desenvolvimento (permissivo)
+# ============================================================================
+CORS_ORIGINS=*
+REQUIRE_API_KEY=false
+
+# ============================================================================
+# DEVELOPMENT
+# ============================================================================
+DEV_MODE=true
+MOCK_LLM_RESPONSES=false
+SAVE_DEBUG_FILES=true

Dockerfile

@@ -1,28 +1,60 @@
+# ============================================================================
+# Dockerfile para Hugging Face Spaces - para.AI API v3.0
+# ============================================================================
+
 FROM python:3.11-slim
 
-ENV PYTHONDONTWRITEBYTECODE=1 \
-    PYTHONUNBUFFERED=1
+# Metadados
+LABEL maintainer="para.AI Team"
+LABEL version="3.0.0"
+LABEL description="API de análise jurisprudencial com IA"
 
+# Definir diretório de trabalho
 WORKDIR /app
 
-# Dependências de sistema (PostgreSQL client, build, etc.)
-RUN apt-get update && \
-    apt-get install -y --no-install-recommends \
-        build-essential \
-        libpq-dev && \
-    rm -rf /var/lib/apt/lists/*
-
-# Instala dependências Python
+# Variáveis de ambiente padrão (sobrescritas pelas Secrets do HF Spaces)
+ENV PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PIP_NO_CACHE_DIR=1 \
+    PIP_DISABLE_PIP_VERSION_CHECK=1 \
+    APP_ENV=production \
+    HOST=0.0.0.0 \
+    PORT=7860
+
+# Instalar dependências do sistema
+RUN apt-get update && apt-get install -y \
+    gcc \
+    g++ \
+    postgresql-client \
+    libpq-dev \
+    curl \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copiar requirements primeiro (para cache do Docker)
 COPY requirements.txt .
+
+# Instalar dependências Python
 RUN pip install --no-cache-dir -r requirements.txt
 
-# Copia código do projeto
+# Copiar código da aplicação
 COPY . .
 
-# Diretório de dados
-RUN mkdir -p /app/data/files
+# Criar diretórios necessários
+RUN mkdir -p /app/data/uploads \
+    /app/data/outputs \
+    /app/data/temp \
+    /app/data/backups \
+    /app/logs
+
+# Permissões
+RUN chmod -R 755 /app
+
+# Health check
+HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+    CMD curl -f http://localhost:7860/api/v1/health || exit 1
 
+# Expor porta (HF Spaces usa 7860)
 EXPOSE 7860
 
-# Ajuste o módulo/path de entrada conforme sua API
-CMD ["uvicorn", "api.main:app", "--host", "0.0.0.0", "--port", "7860"]
+# Comando de inicialização
+CMD ["uvicorn", "api.main:app", "--host", "0.0.0.0", "--port", "7860", "--workers", "2"]

api/config.py

@@ -0,0 +1,393 @@
+"""
+Configurações centralizadas da API para.AI v3.0
+Gerencia todas as variáveis de ambiente e configurações do sistema
+"""
+import os
+from typing import Optional, List
+from pydantic_settings import BaseSettings
+from pydantic import Field
+from functools import lru_cache
+
+
+class Settings(BaseSettings):
+    """
+    Configurações da aplicação para.AI.
+
+    Todas as configurações podem ser sobrescritas via variáveis de ambiente.
+    Carrega automaticamente de arquivo .env se presente.
+    """
+
+    # ========================================================================
+    # API SETTINGS
+    # ========================================================================
+    APP_NAME: str = "para.AI API"
+    APP_VERSION: str = "3.0.0"
+    APP_DESCRIPTION: str = "API para análise automatizada de acórdãos jurisprudenciais"
+    APP_ENV: str = Field(default="production", env="APP_ENV")
+    DEBUG: bool = Field(default=False, env="DEBUG")
+
+    # ========================================================================
+    # SERVER SETTINGS
+    # ========================================================================
+    HOST: str = Field(default="0.0.0.0", env="HOST")
+    PORT: int = Field(default=8000, env="PORT")
+    WORKERS: int = Field(default=4, env="WORKERS")
+    RELOAD: bool = Field(default=False, env="RELOAD")
+
+    # ========================================================================
+    # DATABASE SETTINGS
+    # ========================================================================
+    DATABASE_URL: str = Field(
+        default="postgresql://para_ai:para_ai@localhost:5432/para_ai",
+        env="DATABASE_URL",
+        description="PostgreSQL connection string"
+    )
+    DB_POOL_SIZE: int = Field(default=20, env="DB_POOL_SIZE")
+    DB_MAX_OVERFLOW: int = Field(default=40, env="DB_MAX_OVERFLOW")
+    DB_POOL_TIMEOUT: int = Field(default=30, env="DB_POOL_TIMEOUT")
+    DB_POOL_RECYCLE: int = Field(default=3600, env="DB_POOL_RECYCLE")
+    SQL_ECHO: bool = Field(default=False, env="SQL_ECHO")
+
+    # ========================================================================
+    # FILES & STORAGE SETTINGS
+    # ========================================================================
+    FILES_BASE_PATH: str = Field(default="./data/files", env="FILES_BASE_PATH")
+    UPLOAD_PATH: str = Field(default="./data/uploads", env="UPLOAD_PATH")
+    OUTPUT_PATH: str = Field(default="./data/outputs", env="OUTPUT_PATH")
+    TEMP_PATH: str = Field(default="./data/temp", env="TEMP_PATH")
+    BACKUP_PATH: str = Field(default="./data/backups", env="BACKUP_PATH")
+
+    MAX_UPLOAD_SIZE_MB: int = Field(default=500, env="MAX_UPLOAD_SIZE_MB")
+    ALLOWED_EXTENSIONS: List[str] = [".jsonl", ".json", ".txt"]
+
+    # ========================================================================
+    # LLM PROVIDERS API KEYS
+    # ========================================================================
+    GROQ_API_KEY: Optional[str] = Field(default=None, env="GROQ_API_KEY")
+    OPENAI_API_KEY: Optional[str] = Field(default=None, env="OPENAI_API_KEY")
+    ANTHROPIC_API_KEY: Optional[str] = Field(default=None, env="ANTHROPIC_API_KEY")
+
+    DEFAULT_LLM_PROVIDER: str = Field(default="groq", env="DEFAULT_LLM_PROVIDER")
+    DEFAULT_MODEL_TYPE: str = Field(default="balanced", env="DEFAULT_MODEL_TYPE")
+
+    # LLM Request defaults
+    LLM_DEFAULT_TEMPERATURE: float = Field(default=0.7, env="LLM_DEFAULT_TEMPERATURE")
+    LLM_DEFAULT_MAX_TOKENS: int = Field(default=2048, env="LLM_DEFAULT_MAX_TOKENS")
+    LLM_TIMEOUT_SECONDS: int = Field(default=60, env="LLM_TIMEOUT_SECONDS")
+
+    # ========================================================================
+    # PROCESSING SETTINGS
+    # ========================================================================
+    MAX_CONCURRENT_PROCESSES: int = Field(default=5, env="MAX_CONCURRENT_PROCESSES")
+    PROCESS_TIMEOUT_SECONDS: int = Field(default=600, env="PROCESS_TIMEOUT_SECONDS")
+    ENABLE_PARALLEL_PROCESSING: bool = Field(default=True, env="ENABLE_PARALLEL")
+    DEFAULT_MAX_WORKERS: int = Field(default=3, env="DEFAULT_MAX_WORKERS")
+
+    # Batch processing
+    BATCH_SIZE: int = Field(default=10, env="BATCH_SIZE")
+    BATCH_DELAY_MS: int = Field(default=100, env="BATCH_DELAY_MS")
+
+    # ========================================================================
+    # LOGGING SETTINGS
+    # ========================================================================
+    LOG_LEVEL: str = Field(default="INFO", env="LOG_LEVEL")
+    LOG_FORMAT: str = "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
+    LOG_FILE_ENABLED: bool = Field(default=True, env="LOG_FILE_ENABLED")
+    LOG_FILE_PATH: str = Field(default="./logs", env="LOG_FILE_PATH")
+    LOG_FILE_MAX_BYTES: int = Field(default=10485760, env="LOG_FILE_MAX_BYTES")  # 10MB
+    LOG_FILE_BACKUP_COUNT: int = Field(default=5, env="LOG_FILE_BACKUP_COUNT")
+
+    # ========================================================================
+    # SECURITY SETTINGS
+    # ========================================================================
+    # CORS
+    CORS_ORIGINS: List[str] = ["*"]  # Em produção, especificar domínios
+    CORS_ALLOW_CREDENTIALS: bool = True
+    CORS_ALLOW_METHODS: List[str] = ["*"]
+    CORS_ALLOW_HEADERS: List[str] = ["*"]
+
+    # API Keys
+    API_KEY_HEADER: str = Field(default="X-API-Key", env="API_KEY_HEADER")
+    REQUIRE_API_KEY: bool = Field(default=False, env="REQUIRE_API_KEY")
+    VALID_API_KEYS: List[str] = []  # Carregar de env separado por vírgula
+
+    # Rate limiting
+    RATE_LIMIT_ENABLED: bool = Field(default=False, env="RATE_LIMIT_ENABLED")
+    RATE_LIMIT_PER_MINUTE: int = Field(default=60, env="RATE_LIMIT_PER_MINUTE")
+
+    # ========================================================================
+    # CACHE SETTINGS
+    # ========================================================================
+    ENABLE_CACHE: bool = Field(default=False, env="ENABLE_CACHE")
+    CACHE_TTL_SECONDS: int = Field(default=3600, env="CACHE_TTL_SECONDS")
+    CACHE_BACKEND: str = Field(default="memory", env="CACHE_BACKEND")  # memory/redis
+    REDIS_URL: Optional[str] = Field(default=None, env="REDIS_URL")
+
+    # ========================================================================
+    # MONITORING & METRICS
+    # ========================================================================
+    ENABLE_METRICS: bool = Field(default=True, env="ENABLE_METRICS")
+    METRICS_EXPORT_INTERVAL: int = Field(default=60, env="METRICS_EXPORT_INTERVAL")
+
+    # Prometheus
+    PROMETHEUS_ENABLED: bool = Field(default=False, env="PROMETHEUS_ENABLED")
+    PROMETHEUS_PORT: int = Field(default=9090, env="PROMETHEUS_PORT")
+
+    # ========================================================================
+    # PROCESSORS SETTINGS
+    # ========================================================================
+    # Quais processadores habilitar (1-9)
+    ENABLED_PROCESSORS: List[int] = [1, 2, 3, 4, 5, 6, 7, 8, 9]
+
+    # Confidence thresholds
+    MIN_CONFIDENCE_THRESHOLD: float = Field(default=0.7, env="MIN_CONFIDENCE_THRESHOLD")
+
+    # ========================================================================
+    # DEVELOPMENT & DEBUG
+    # ========================================================================
+    DEV_MODE: bool = Field(default=False, env="DEV_MODE")
+    MOCK_LLM_RESPONSES: bool = Field(default=False, env="MOCK_LLM_RESPONSES")
+    SAVE_DEBUG_FILES: bool = Field(default=False, env="SAVE_DEBUG_FILES")
+
+    # ========================================================================
+    # ADVANCED SETTINGS
+    # ========================================================================
+    # Request tracking
+    ENABLE_REQUEST_ID: bool = Field(default=True, env="ENABLE_REQUEST_ID")
+    REQUEST_ID_HEADER: str = "X-Request-ID"
+
+    # Compression
+    ENABLE_GZIP: bool = Field(default=True, env="ENABLE_GZIP")
+    GZIP_MIN_SIZE: int = Field(default=1000, env="GZIP_MIN_SIZE")
+
+    # Timeouts
+    HTTP_TIMEOUT_SECONDS: int = Field(default=300, env="HTTP_TIMEOUT_SECONDS")
+
+    # Task retention
+    TASK_RETENTION_HOURS: int = Field(default=24, env="TASK_RETENTION_HOURS")
+    AUTO_CLEANUP_ENABLED: bool = Field(default=True, env="AUTO_CLEANUP_ENABLED")
+
+    class Config:
+        """Pydantic config."""
+        env_file = ".env"
+        env_file_encoding = "utf-8"
+        case_sensitive = True
+
+    def __init__(self, **kwargs):
+        """Initialize settings com validações customizadas."""
+        super().__init__(**kwargs)
+
+        # Parse CORS_ORIGINS se vier como string
+        if isinstance(self.CORS_ORIGINS, str):
+            self.CORS_ORIGINS = [origin.strip() for origin in self.CORS_ORIGINS.split(",")]
+
+        # Parse VALID_API_KEYS se vier como string
+        if os.getenv("VALID_API_KEYS"):
+            self.VALID_API_KEYS = [key.strip() for key in os.getenv("VALID_API_KEYS").split(",")]
+
+    @property
+    def is_production(self) -> bool:
+        """Verifica se está em produção."""
+        return self.APP_ENV.lower() == "production"
+
+    @property
+    def is_development(self) -> bool:
+        """Verifica se está em desenvolvimento."""
+        return self.APP_ENV.lower() in ["development", "dev"]
+
+    @property
+    def database_url_masked(self) -> str:
+        """Retorna DATABASE_URL com senha mascarada."""
+        if "@" in self.DATABASE_URL:
+            parts = self.DATABASE_URL.split("@")
+            return f"***@{parts[1]}"
+        return self.DATABASE_URL
+
+    def get_llm_providers_status(self) -> dict:
+        """Retorna status de configuração dos provedores LLM."""
+        return {
+            "groq": bool(self.GROQ_API_KEY),
+            "openai": bool(self.OPENAI_API_KEY),
+            "anthropic": bool(self.ANTHROPIC_API_KEY)
+        }
+
+    def validate_paths(self) -> None:
+        """Cria diretórios necessários se não existirem."""
+        from pathlib import Path
+
+        paths = [
+            self.FILES_BASE_PATH,
+            self.UPLOAD_PATH,
+            self.OUTPUT_PATH,
+            self.TEMP_PATH,
+            self.BACKUP_PATH,
+            self.LOG_FILE_PATH
+        ]
+
+        for path_str in paths:
+            path = Path(path_str)
+            path.mkdir(parents=True, exist_ok=True)
+
+    def to_dict(self) -> dict:
+        """Converte settings para dict (sem expor secrets)."""
+        data = self.dict()
+
+        # Mascarar informações sensíveis
+        sensitive_keys = [
+            "GROQ_API_KEY",
+            "OPENAI_API_KEY", 
+            "ANTHROPIC_API_KEY",
+            "DATABASE_URL",
+            "VALID_API_KEYS",
+            "REDIS_URL"
+        ]
+
+        for key in sensitive_keys:
+            if key in data and data[key]:
+                if isinstance(data[key], str):
+                    data[key] = "***HIDDEN***"
+                elif isinstance(data[key], list):
+                    data[key] = ["***HIDDEN***"] * len(data[key])
+
+        return data
+
+
+# ============================================================================
+# SINGLETON INSTANCE
+# ============================================================================
+
+@lru_cache()
+def get_settings() -> Settings:
+    """
+    Retorna instância singleton das configurações.
+
+    Usa lru_cache para garantir que Settings é criado apenas uma vez
+    e reutilizado em toda a aplicação.
+
+    Returns:
+        Settings: Instância configurada
+    """
+    settings = Settings()
+
+    # Validar e criar paths necessários
+    settings.validate_paths()
+
+    return settings
+
+
+# ============================================================================
+# HELPER FUNCTIONS
+# ============================================================================
+
+def get_env(key: str, default: any = None) -> any:
+    """
+    Helper para pegar variável de ambiente.
+
+    Args:
+        key: Nome da variável
+        default: Valor padrão se não existir
+
+    Returns:
+        Valor da variável ou default
+    """
+    return os.getenv(key, default)
+
+
+def is_production() -> bool:
+    """Verifica se está rodando em produção."""
+    return get_settings().is_production
+
+
+def is_development() -> bool:
+    """Verifica se está rodando em desenvolvimento."""
+    return get_settings().is_development
+
+
+# ============================================================================
+# CONFIGURAÇÃO DE EXEMPLO (.env)
+# ============================================================================
+
+ENV_EXAMPLE = """
+# ============================================================================
+# para.AI API - Configuração de Ambiente
+# ============================================================================
+
+# API Settings
+APP_ENV=production
+DEBUG=false
+
+# Server
+HOST=0.0.0.0
+PORT=8000
+WORKERS=4
+
+# Database
+DATABASE_URL=postgresql://para_ai:SUA_SENHA@localhost:5432/para_ai
+DB_POOL_SIZE=20
+DB_MAX_OVERFLOW=40
+
+# LLM Providers (configure pelo menos um)
+GROQ_API_KEY=gsk_...
+OPENAI_API_KEY=sk-...
+ANTHROPIC_API_KEY=sk-ant-...
+
+DEFAULT_LLM_PROVIDER=groq
+DEFAULT_MODEL_TYPE=balanced
+
+# Files & Storage
+FILES_BASE_PATH=./data/files
+UPLOAD_PATH=./data/uploads
+OUTPUT_PATH=./data/outputs
+MAX_UPLOAD_SIZE_MB=500
+
+# Processing
+MAX_CONCURRENT_PROCESSES=5
+PROCESS_TIMEOUT_SECONDS=600
+ENABLE_PARALLEL=true
+DEFAULT_MAX_WORKERS=3
+
+# Logging
+LOG_LEVEL=INFO
+LOG_FILE_ENABLED=true
+
+# Security (IMPORTANTE EM PRODUÇÃO!)
+REQUIRE_API_KEY=false
+VALID_API_KEYS=key1,key2,key3
+CORS_ORIGINS=https://seudominio.com,https://app.seudominio.com
+
+# Cache (opcional - requer Redis)
+ENABLE_CACHE=false
+REDIS_URL=redis://localhost:6379/0
+
+# Monitoring
+ENABLE_METRICS=true
+PROMETHEUS_ENABLED=false
+"""
+
+
+def generate_env_file(path: str = ".env.example"):
+    """
+    Gera arquivo .env.example com todas as variáveis.
+
+    Args:
+        path: Caminho onde salvar o arquivo
+    """
+    with open(path, "w") as f:
+        f.write(ENV_EXAMPLE)
+    print(f"✅ Arquivo {path} criado com sucesso!")
+
+
+if __name__ == "__main__":
+    # Quando executado diretamente, gera .env.example
+    generate_env_file()
+
+    # Mostra configurações atuais
+    settings = get_settings()
+    print("\n" + "=" * 70)
+    print("CONFIGURAÇÕES ATUAIS - para.AI API")
+    print("=" * 70)
+    print(f"Environment: {settings.APP_ENV}")
+    print(f"Debug: {settings.DEBUG}")
+    print(f"Database: {settings.database_url_masked}")
+    print(f"LLM Providers: {settings.get_llm_providers_status()}")
+    print("=" * 70)

docker-compose.yaml

@@ -0,0 +1,156 @@
+# ============================================================================
+# Docker Compose para desenvolvimento local - para.AI API v3.0
+# ============================================================================
+# 
+# Uso:
+#   docker-compose up -d          # Iniciar todos os serviços
+#   docker-compose logs -f api    # Ver logs da API
+#   docker-compose down           # Parar todos os serviços
+#   docker-compose down -v        # Parar e remover volumes
+#
+# ============================================================================
+
+version: '3.8'
+
+services:
+  # ==========================================================================
+  # PostgreSQL Database
+  # ==========================================================================
+  db:
+    image: postgres:15-alpine
+    container_name: para_ai_db
+    restart: unless-stopped
+    environment:
+      POSTGRES_USER: para_ai
+      POSTGRES_PASSWORD: para_ai_dev_2026
+      POSTGRES_DB: para_ai
+      POSTGRES_INITDB_ARGS: "--encoding=UTF8 --locale=pt_BR.UTF-8"
+    ports:
+      - "5432:5432"
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+      - ./database/init_db.sql:/docker-entrypoint-initdb.d/01-init.sql
+      - ./scripts/seed_data.sql:/docker-entrypoint-initdb.d/02-seed.sql
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U para_ai -d para_ai"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - para_ai_network
+
+  # ==========================================================================
+  # Redis (opcional - para cache)
+  # ==========================================================================
+  redis:
+    image: redis:7-alpine
+    container_name: para_ai_redis
+    restart: unless-stopped
+    ports:
+      - "6379:6379"
+    volumes:
+      - redis_data:/data
+    command: redis-server --appendonly yes
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 10s
+      timeout: 5s
+      retries: 5
+    networks:
+      - para_ai_network
+
+  # ==========================================================================
+  # API Application
+  # ==========================================================================
+  api:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    container_name: para_ai_api
+    restart: unless-stopped
+    depends_on:
+      db:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+    environment:
+      # App
+      APP_ENV: development
+      DEBUG: "true"
+
+      # Database
+      DATABASE_URL: postgresql://para_ai:para_ai_dev_2026@db:5432/para_ai
+      DB_POOL_SIZE: 10
+      DB_MAX_OVERFLOW: 20
+
+      # LLM Providers (use suas keys reais aqui ou via .env)
+      GROQ_API_KEY: ${GROQ_API_KEY:-}
+      OPENAI_API_KEY: ${OPENAI_API_KEY:-}
+      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:-}
+
+      # Cache
+      ENABLE_CACHE: "true"
+      REDIS_URL: redis://redis:6379/0
+
+      # Processing
+      ENABLE_PARALLEL: "true"
+      MAX_CONCURRENT_PROCESSES: 3
+
+      # Logging
+      LOG_LEVEL: DEBUG
+    ports:
+      - "8000:7860"
+    volumes:
+      - ./:/app
+      - api_data:/app/data
+      - api_logs:/app/logs
+    healthcheck:
+      test: ["CMD", "curl", "-f", "http://localhost:7860/api/v1/health"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+    networks:
+      - para_ai_network
+
+  # ==========================================================================
+  # pgAdmin (opcional - interface web para PostgreSQL)
+  # ==========================================================================
+  pgadmin:
+    image: dpage/pgadmin4:latest
+    container_name: para_ai_pgadmin
+    restart: unless-stopped
+    environment:
+      PGADMIN_DEFAULT_EMAIL: admin@para.ai
+      PGADMIN_DEFAULT_PASSWORD: admin123
+      PGADMIN_CONFIG_SERVER_MODE: 'False'
+    ports:
+      - "5050:80"
+    volumes:
+      - pgadmin_data:/var/lib/pgadmin
+    depends_on:
+      - db
+    networks:
+      - para_ai_network
+
+# ============================================================================
+# VOLUMES
+# ============================================================================
+volumes:
+  postgres_data:
+    driver: local
+  redis_data:
+    driver: local
+  api_data:
+    driver: local
+  api_logs:
+    driver: local
+  pgadmin_data:
+    driver: local
+
+# ============================================================================
+# NETWORKS
+# ============================================================================
+networks:
+  para_ai_network:
+    driver: bridge

docker-compose.yml

@@ -1,47 +0,0 @@
-version: "3.9"
-
-services:
-  app:
-    build:
-      context: .
-      dockerfile: Dockerfile
-    container_name: para_ai_app
-    depends_on:
-      - db
-    environment:
-      APP_ENV: ${APP_ENV:-dev}
-      DEBUG: ${DEBUG:-true}
-      LOG_LEVEL: ${LOG_LEVEL:-INFO}
-      DATABASE_URL: ${DATABASE_URL:-postgresql://para_ai:para_ai@db:5432/para_ai}
-      FILES_BASE_PATH: ${FILES_BASE_PATH:-/app/data/files}
-      GROQ_API_KEY: ${GROQ_API_KEY:-}
-      OPENAI_API_KEY: ${OPENAI_API_KEY:-}
-      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:-}
-    volumes:
-      - .:/app
-      - para_ai_files:/app/data
-    ports:
-      - "7860:7860"
-    working_dir: /app
-    command: >
-      uvicorn main:app
-      --host 0.0.0.0
-      --port 7860
-      --reload
-
-  db:
-    image: postgres:16
-    container_name: para_ai_db
-    environment:
-      POSTGRES_USER: ${POSTGRES_USER:-para_ai}
-      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-para_ai}
-      POSTGRES_DB: ${POSTGRES_DB:-para_ai}
-    volumes:
-      - para_ai_db_data:/var/lib/postgresql/data
-      - ./database/init_db.sql:/docker-entrypoint-initdb.d/00_init_db.sql:ro
-    ports:
-      - "5432:5432"
-
-volumes:
-  para_ai_db_data:
-  para_ai_files:

requirements.txt

@@ -1,21 +1,67 @@
-# Core
-SQLAlchemy>=2.0.0
-psycopg2-binary>=2.9.0
-alembic>=1.12.0
-pydantic>=2.7.0
-python-dotenv>=1.0.0
-psutil
-pydantic_settings
-
-# API / Web (ajuste se for usar outro framework)
-fastapi>=0.110.0
-uvicorn[standard]>=0.27.0
+
+
+# ============================================================================
+# para.AI API v3.0 - Dependências Python
+# ============================================================================
+
+# Core Framework
+fastapi==0.109.0
+uvicorn[standard]==0.27.0
+python-multipart==0.0.6
+
+# Pydantic (validação)
+pydantic==2.5.3
+pydantic-settings==2.1.0
+
+# Database
+sqlalchemy==2.0.25
+psycopg2-binary==2.9.9
+alembic==1.13.1
 
 # LLM Providers
-groq>=0.5.0
-openai>=1.0.0
-anthropic>=0.34.0
+groq==0.4.1
+openai==1.10.0
+anthropic==0.8.1
+
+# Utilities
+python-dotenv==1.0.0
+psutil==5.9.8
+python-json-logger==2.0.7
+
+# HTTP & Async
+httpx==0.26.0
+aiofiles==23.2.1
+
+# Data Processing
+python-dateutil==2.8.2
+
+# Security
+python-jose[cryptography]==3.3.0
+passlib[bcrypt]==1.7.4
+
+# Testing (opcional - desenvolvimento)
+pytest==7.4.3
+pytest-asyncio==0.21.1
+pytest-cov==4.1.0
+httpx==0.26.0
+
+# Production Server (opcional)
+gunicorn==21.2.0
+
+# Monitoring (opcional)
+prometheus-client==0.19.0
 
-# Utilidades
-requests>=2.31.0
-loguru>=0.7.0
+# ============================================================================
+# INSTALAÇÃO
+# ============================================================================
+# 
+# Instalação básica (produção):
+#   pip install -r requirements.txt
+#
+# Instalação completa (desenvolvimento):
+#   pip install -r requirements.txt
+#
+# Atualizar dependências:
+#   pip install --upgrade -r requirements.txt
+#
+# ============================================================================

seed.sql

@@ -0,0 +1,83 @@
+-- ============================================================================
+-- Seed Data para desenvolvimento local - para.AI
+-- ============================================================================
+-- Este script insere dados de teste para desenvolvimento
+
+-- Inserir tribunal de teste
+INSERT INTO tribunais (id, nome, sigla, uf, tipo, url_base, created_at, updated_at)
+VALUES 
+    (gen_random_uuid(), 'Tribunal de Justiça do Paraná', 'TJPR', 'PR', 'Estadual', 'https://www.tjpr.jus.br', NOW(), NOW()),
+    (gen_random_uuid(), 'Tribunal de Justiça de São Paulo', 'TJSP', 'SP', 'Estadual', 'https://www.tjsp.jus.br', NOW(), NOW()),
+    (gen_random_uuid(), 'Superior Tribunal de Justiça', 'STJ', 'DF', 'Superior', 'https://www.stj.jus.br', NOW(), NOW())
+ON CONFLICT (sigla) DO NOTHING;
+
+-- Inserir usuário de teste
+INSERT INTO usuarios (id, email, nome, senha_hash, ativo, role, created_at, updated_at)
+VALUES 
+    (gen_random_uuid(), 'admin@para.ai', 'Administrador', '$2b$12$dummy_hash_for_development', TRUE, 'admin', NOW(), NOW()),
+    (gen_random_uuid(), 'dev@para.ai', 'Desenvolvedor', '$2b$12$dummy_hash_for_development', TRUE, 'user', NOW(), NOW())
+ON CONFLICT (email) DO NOTHING;
+
+-- Inserir acórdão de teste
+DO $$
+DECLARE
+    v_tribunal_id VARCHAR(36);
+    v_acordao_id VARCHAR(36);
+BEGIN
+    -- Pegar ID do TJPR
+    SELECT id INTO v_tribunal_id FROM tribunais WHERE sigla = 'TJPR' LIMIT 1;
+
+    -- Inserir acórdão de teste
+    INSERT INTO acordaos (
+        id, tribunal_id, numero, ano, data_julgamento, 
+        ementa, relator, orgao_julgador, 
+        hash_conteudo, status_processamento,
+        created_at, updated_at
+    )
+    VALUES (
+        gen_random_uuid(),
+        v_tribunal_id,
+        '0000001-00.2025.8.16.0000',
+        2025,
+        '2025-01-15 14:30:00',
+        'APELAÇÃO CÍVEL. DIREITO DO CONSUMIDOR. RESPONSABILIDADE CIVIL. DANO MORAL. CDC ART. 14. RECURSO PROVIDO.',
+        'Des. Teste da Silva',
+        '1ª Câmara Cível',
+        encode(sha256('teste_acordao_1'::bytea), 'hex'),
+        'pendente',
+        NOW(),
+        NOW()
+    )
+    ON CONFLICT (hash_conteudo) DO NOTHING
+    RETURNING id INTO v_acordao_id;
+
+    -- Inserir palavras-chave de teste
+    INSERT INTO palavras_chave (id, termo, categoria, frequencia, ativo, created_at)
+    VALUES 
+        (gen_random_uuid(), 'responsabilidade civil', 'direito_civil', 100, TRUE, NOW()),
+        (gen_random_uuid(), 'dano moral', 'direito_civil', 150, TRUE, NOW()),
+        (gen_random_uuid(), 'consumidor', 'direito_consumidor', 200, TRUE, NOW()),
+        (gen_random_uuid(), 'CDC', 'legislacao', 180, TRUE, NOW())
+    ON CONFLICT (termo) DO NOTHING;
+
+END $$;
+
+-- Criar índices adicionais úteis
+CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_acordao_ano_tribunal ON acordaos(ano, tribunal_id);
+CREATE INDEX CONCURRENTLY IF NOT EXISTS idx_acordao_status_data ON acordaos(status_processamento, data_julgamento DESC);
+
+-- Vacuum e analyze
+VACUUM ANALYZE acordaos;
+VACUUM ANALYZE tribunais;
+VACUUM ANALYZE usuarios;
+
+-- Mensagem de sucesso
+DO $$
+BEGIN
+    RAISE NOTICE '✅ Seed data inserido com sucesso!';
+    RAISE NOTICE '📊 Estatísticas:';
+    RAISE NOTICE '   - Tribunais: %', (SELECT COUNT(*) FROM tribunais);
+    RAISE NOTICE '   - Usuários: %', (SELECT COUNT(*) FROM usuarios);
+    RAISE NOTICE '   - Acórdãos: %', (SELECT COUNT(*) FROM acordaos);
+    RAISE NOTICE '   - Palavras-chave: %', (SELECT COUNT(*) FROM palavras_chave);
+END $$;