ParaAIV3.0

Dockerfile

@@ -1,5 +1,6 @@
 # ============================================================================
 # Dockerfile para Hugging Face Spaces - para.AI API v3.0
+# Com PostgreSQL temporário embutido (ideal para testes/demo)
 # ============================================================================
 
 FROM python:3.11-slim
@@ -7,54 +8,102 @@ FROM python:3.11-slim
 # Metadados
 LABEL maintainer="para.AI Team"
 LABEL version="3.0.0"
-LABEL description="API de análise jurisprudencial com IA"
+LABEL description="API de análise jurisprudencial com IA + PostgreSQL local"
 
-# Definir diretório de trabalho
-WORKDIR /app
-
-# Variáveis de ambiente padrão (sobrescritas pelas Secrets do HF Spaces)
+# Variáveis de ambiente
 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
+    DEBIAN_FRONTEND=noninteractive \
+    POSTGRES_VERSION=15
 
-# Instalar dependências do sistema
+# Definir diretório de trabalho
+WORKDIR /app
+
+# ============================================================================
+# INSTALAR DEPENDÊNCIAS DO SISTEMA + POSTGRESQL
+# ============================================================================
 RUN apt-get update && apt-get install -y \
+    # Build essentials
     gcc \
     g++ \
-    postgresql-client \
-    libpq-dev \
+    make \
+    # PostgreSQL
+    postgresql-${POSTGRES_VERSION} \
+    postgresql-client-${POSTGRES_VERSION} \
+    postgresql-contrib-${POSTGRES_VERSION} \
+    # Utilities
     curl \
+    wget \
+    procps \
     && rm -rf /var/lib/apt/lists/*
 
-# Copiar requirements primeiro (para cache do Docker)
-COPY requirements.txt .
+# ============================================================================
+# CONFIGURAR POSTGRESQL
+# ============================================================================
+# Criar usuário postgres se não existir
+RUN useradd -m -s /bin/bash postgres || true
 
-# Instalar dependências Python
+# Criar diretórios para PostgreSQL
+RUN mkdir -p /var/lib/postgresql/data \
+    /var/run/postgresql \
+    /var/log/postgresql \
+    && chown -R postgres:postgres /var/lib/postgresql \
+    && chown -R postgres:postgres /var/run/postgresql \
+    && chmod 2777 /var/run/postgresql
+
+# ============================================================================
+# INSTALAR DEPENDÊNCIAS PYTHON
+# ============================================================================
+COPY requirements.txt .
 RUN pip install --no-cache-dir -r requirements.txt
 
-# Copiar código da aplicação
+# ============================================================================
+# COPIAR CÓDIGO DA APLICAÇÃO
+# ============================================================================
 COPY . .
 
-# Criar diretórios necessários
+# ============================================================================
+# COPIAR SCRIPTS DE INICIALIZAÇÃO
+# ============================================================================
+COPY scripts/docker-entrypoint.sh /docker-entrypoint.sh
+COPY scripts/init-postgres.sh /init-postgres.sh
+RUN chmod +x /docker-entrypoint.sh /init-postgres.sh
+
+# ============================================================================
+# CRIAR DIRETÓRIOS DA APLICAÇÃO
+# ============================================================================
 RUN mkdir -p /app/data/uploads \
     /app/data/outputs \
     /app/data/temp \
     /app/data/backups \
-    /app/logs
+    /app/logs \
+    && chmod -R 755 /app
 
-# Permissões
-RUN chmod -R 755 /app
+# ============================================================================
+# CONFIGURAÇÕES PADRÃO (podem ser sobrescritas por Secrets do HF)
+# ============================================================================
+ENV APP_ENV=production \
+    HOST=0.0.0.0 \
+    PORT=7860 \
+    DATABASE_URL=postgresql://para_ai:para_ai_temp@localhost:5432/para_ai \
+    POSTGRES_USER=para_ai \
+    POSTGRES_PASSWORD=para_ai_temp \
+    POSTGRES_DB=para_ai
 
-# Health check
-HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
+# ============================================================================
+# HEALTH CHECK
+# ============================================================================
+HEALTHCHECK --interval=30s --timeout=10s --start-period=60s --retries=3 \
     CMD curl -f http://localhost:7860/api/v1/health || exit 1
 
-# Expor porta (HF Spaces usa 7860)
+# Expor portas
 EXPOSE 7860
+EXPOSE 5432
 
-# Comando de inicialização
-CMD ["uvicorn", "api.main:app", "--host", "0.0.0.0", "--port", "7860", "--workers", "2"]
+# ============================================================================
+# ENTRYPOINT
+# ============================================================================
+ENTRYPOINT ["/docker-entrypoint.sh"]
+CMD ["uvicorn", "api.main:app", "--host", "0.0.0.0", "--port", "7860", "--workers", "1"]

README.md

@@ -9,4 +9,198 @@ license: agpl-3.0
 ---
 
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# ⚖️ para.AI - Análise Jurisprudencial com IA
+
+Sistema completo de análise automatizada de acórdãos jurídicos usando **9 especialistas IA** (LLMs).
+
+## 🚀 Funcionalidades
+
+- 📤 **Upload de lotes** (arquivos JSONL)
+- 🤖 **9 processadores especializados** para análise completa
+- 📦 **Download de resultados** em TAR.GZ
+- 🐘 **PostgreSQL embutido** (temporário para testes)
+- 🔍 **API completa para debug**
+
+## 📚 Documentação
+
+Acesse a **documentação interativa** em: [/api/docs](/api/docs)
+
+## ⚡ Quick Start
+
+### 1. Testar API
+
+```bash
+curl https://seu-space.hf.space/api/v1/health
+```
+
+### 2. Upload de acórdãos
+
+```bash
+# Criar arquivo JSONL de teste
+cat > acordaos.jsonl << 'EOF'
+{"acordao_id":"001","tribunal":"TJPR","ementa":"Teste ementa","integra":"Conteúdo completo do acórdão"}
+EOF
+
+# Fazer upload
+curl -X POST "https://seu-space.hf.space/api/v1/process/upload" \
+  -F "file=@acordaos.jsonl" \
+  -F "llm_provider=groq" \
+  -F "enable_parallel=true"
+```
+
+### 3. Consultar status
+
+```bash
+curl https://seu-space.hf.space/api/v1/process/status/TASK_ID
+```
+
+### 4. Download de resultados
+
+```bash
+curl -O https://seu-space.hf.space/api/v1/process/download/TASK_ID
+```
+
+## 🗄️ Banco de Dados
+
+### Modo 1: PostgreSQL Temporário (Padrão)
+
+Por padrão, um **PostgreSQL local** é iniciado dentro do container:
+- ✅ Pronto para uso imediatamente
+- ✅ Sem configuração necessária
+- ⚠️  **Dados são perdidos ao reiniciar**
+
+### Modo 2: Banco Externo (Recomendado para produção)
+
+Configure um banco PostgreSQL externo usando **Repository Secrets**:
+
+#### Opção A: Neon (Recomendado - Grátis)
+
+1. Acesse [neon.tech](https://neon.tech)
+2. Crie projeto gratuito
+3. Copie connection string
+4. Em **Settings → Repository Secrets**, adicione:
+   ```
+   DATABASE_URL=postgresql://usuario:senha@ep-xxx.neon.tech/para_ai?sslmode=require
+   ```
+
+#### Opção B: Supabase (Grátis)
+
+1. Acesse [supabase.com](https://supabase.com)
+2. Crie projeto
+3. Em Database → Connection string, copie
+4. Adicione nas Secrets:
+   ```
+   DATABASE_URL=postgresql://postgres:[senha]@db.xxx.supabase.co:5432/postgres
+   ```
+
+## 🔑 Configuração de LLM
+
+Configure pelo menos uma **API key de LLM** nas Repository Secrets:
+
+### Groq (Recomendado - Rápido e barato)
+```
+GROQ_API_KEY=gsk_sua_key_aqui
+```
+Obtenha em: [console.groq.com](https://console.groq.com/)
+
+### OpenAI (Opcional)
+```
+OPENAI_API_KEY=sk-sua_key_aqui
+```
+
+### Anthropic (Opcional)
+```
+ANTHROPIC_API_KEY=sk-ant-sua_key_aqui
+```
+
+## ⚙️ Repository Secrets
+
+Configure em **Settings → Repository Secrets**:
+
+### Obrigatórios
+- `GROQ_API_KEY` - API key do Groq (ou OpenAI/Anthropic)
+
+### Opcionais (para produção)
+- `DATABASE_URL` - PostgreSQL externo (recomendado)
+- `APP_ENV=production`
+- `LOG_LEVEL=INFO`
+- `ENABLE_CACHE=true`
+- `REDIS_URL` - Se usar cache Redis
+
+## 🧪 Endpoints Principais
+
+| Método | Endpoint | Descrição |
+|--------|----------|-----------|
+| GET | `/api/v1/health` | Health check |
+| POST | `/api/v1/process/upload` | Upload de JSONL |
+| GET | `/api/v1/process/status/{id}` | Status da task |
+| GET | `/api/v1/process/download/{id}` | Download resultados |
+| GET | `/api/v1/debug/info` | Info do sistema |
+| GET | `/api/docs` | Documentação Swagger |
+
+## 📋 Formato JSONL
+
+Cada linha deve ser um JSON com a estrutura:
+
+```json
+{
+  "acordao_id": "identificador-unico",
+  "tribunal": "TJPR",
+  "numero": "0000001-00.2025.8.16.0000",
+  "ementa": "Texto da ementa...",
+  "integra": "Texto completo do acórdão...",
+  "relator": "Des. Nome do Relator",
+  "data_julgamento": "2025-01-15"
+}
+```
+
+**Campos obrigatórios:** `ementa`, `integra`
+
+## 🤖 Especialistas IA
+
+O sistema processa cada acórdão com **9 especialistas**:
+
+1. **Metadados** - Extração de informações estruturadas
+2. **Relatório** - Análise do relatório processual
+3. **Fundamentação** - Análise da fundamentação legal
+4. **Decisão** - Análise do dispositivo decisório
+5. **Auditoria** - Verificação de qualidade
+6. **Arquivo Relacional** - Estruturação para BD
+7. **Segmentação Sintática** - Análise linguística
+8. **Análise Contextual** - Contexto jurídico
+9. **Transcrição 3-Partite** - Estruturação tripartite
+
+## 📊 Métricas
+
+Veja métricas de processamento em:
+- `/api/v1/debug/info` - Info do sistema
+- `/api/v1/debug/tasks` - Tasks ativas
+
+## ⚠️ Limitações (Modo PostgreSQL Temporário)
+
+- **Dados não persistem** entre reinicializações
+- **Limite de armazenamento** do container
+- **Performance reduzida** vs banco dedicado
+
+Para produção, **use banco externo** (Neon/Supabase).
+
+## 🔒 Segurança
+
+Para produção, configure nas Secrets:
+```
+APP_ENV=production
+DEBUG=false
+REQUIRE_API_KEY=true
+VALID_API_KEYS=sua_key_super_secreta
+```
+
+## 📖 Mais Informações
+
+- **Documentação completa:** [/api/docs](/api/docs)
+- **Health Check:** [/api/v1/health](/api/v1/health)
+- **Repositório:** [GitHub](seu-repo)
+
+---
+
+**Desenvolvido com ❤️ para análise jurisprudencial automatizada**
+

docker-entrypoint.sh

@@ -0,0 +1,127 @@
+#!/bin/bash
+# ============================================================================
+# Docker Entrypoint - para.AI API v3.0
+# Inicializa PostgreSQL local + API FastAPI
+# ============================================================================
+
+set -e
+
+echo ""
+echo "╔══════════════════════════════════════════════════════════════╗"
+echo "║                  para.AI API v3.0                            ║"
+echo "║          Análise Jurisprudencial com IA                      ║"
+echo "╚══════════════════════════════════════════════════════════════╝"
+echo ""
+
+# ============================================================================
+# FASE 1: VERIFICAR AMBIENTE
+# ============================================================================
+echo "🔍 Verificando ambiente..."
+
+# Mostrar informações do sistema
+echo "   Python: $(python --version)"
+echo "   PostgreSQL: $(su - postgres -c 'psql --version' | head -1)"
+echo "   Diretório: $(pwd)"
+echo ""
+
+# ============================================================================
+# FASE 2: INICIALIZAR POSTGRESQL
+# ============================================================================
+echo "🐘 Inicializando PostgreSQL local..."
+/init-postgres.sh
+
+# Verificar se PostgreSQL está rodando
+if ! pg_isready -h localhost -p 5432 &> /dev/null; then
+    echo "❌ PostgreSQL não está rodando!"
+    exit 1
+fi
+
+echo "✅ PostgreSQL OK"
+echo ""
+
+# ============================================================================
+# FASE 3: CONFIGURAR VARIÁVEIS DE AMBIENTE
+# ============================================================================
+echo "⚙️  Configurando variáveis de ambiente..."
+
+# Se DATABASE_URL não foi fornecida, usar a local
+if [ -z "$DATABASE_URL" ] || [ "$DATABASE_URL" = "postgresql://para_ai:para_ai_temp@localhost:5432/para_ai" ]; then
+    export DATABASE_URL="postgresql://${POSTGRES_USER:-para_ai}:${POSTGRES_PASSWORD:-para_ai_temp}@localhost:5432/${POSTGRES_DB:-para_ai}"
+    echo "   DATABASE_URL configurada para PostgreSQL local"
+fi
+
+# Configurações padrão para HF Spaces
+export APP_ENV="${APP_ENV:-production}"
+export DEBUG="${DEBUG:-false}"
+export HOST="${HOST:-0.0.0.0}"
+export PORT="${PORT:-7860}"
+
+echo "   APP_ENV: $APP_ENV"
+echo "   PORT: $PORT"
+echo "   DATABASE: PostgreSQL local"
+echo ""
+
+# ============================================================================
+# FASE 4: TESTAR CONEXÃO COM BANCO
+# ============================================================================
+echo "🔗 Testando conexão com banco de dados..."
+
+python3 << 'PYTHON_TEST'
+import sys
+from api.config import get_settings
+
+try:
+    settings = get_settings()
+    print(f"   ✅ Configurações carregadas")
+    print(f"   ✅ Environment: {settings.APP_ENV}")
+    print(f"   ✅ Database URL configurada")
+except Exception as e:
+    print(f"   ❌ Erro ao carregar configurações: {e}")
+    sys.exit(1)
+
+# Testar conexão com DB
+try:
+    from database.db_manager import get_db_manager
+    db = get_db_manager()
+    if db.health_check():
+        print(f"   ✅ Conexão com PostgreSQL OK")
+    else:
+        print(f"   ❌ Falha no health check do DB")
+        sys.exit(1)
+except Exception as e:
+    print(f"   ❌ Erro ao conectar com DB: {e}")
+    sys.exit(1)
+PYTHON_TEST
+
+if [ $? -ne 0 ]; then
+    echo "❌ Falha ao testar conexão com banco!"
+    exit 1
+fi
+
+echo ""
+
+# ============================================================================
+# FASE 5: INICIALIZAR API
+# ============================================================================
+echo "🚀 Iniciando API FastAPI..."
+echo ""
+echo "╔══════════════════════════════════════════════════════════════╗"
+echo "║                     API ONLINE                               ║"
+echo "╚══════════════════════════════════════════════════════════════╝"
+echo ""
+echo "📍 Endpoints disponíveis:"
+echo "   • Documentação: http://localhost:$PORT/api/docs"
+echo "   • Health Check: http://localhost:$PORT/api/v1/health"
+echo "   • Upload: http://localhost:$PORT/api/v1/process/upload"
+echo ""
+echo "💡 PostgreSQL rodando localmente (temporário)"
+echo "⚠️  ATENÇÃO: Dados são perdidos ao reiniciar o container!"
+echo ""
+echo "🔧 Para banco persistente, configure DATABASE_URL nas Secrets"
+echo "   Recomendado: Neon (https://neon.tech) ou Supabase"
+echo ""
+echo "=================================================="
+echo ""
+
+# Executar comando passado (geralmente uvicorn)
+exec "$@"

init-postgres.sh

@@ -0,0 +1,140 @@
+#!/bin/bash
+# ============================================================================
+# Script de inicialização do PostgreSQL dentro do container Docker
+# para.AI API v3.0 - Hugging Face Spaces
+# ============================================================================
+
+set -e
+
+echo "=================================================="
+echo "🐘 Inicializando PostgreSQL local..."
+echo "=================================================="
+
+# Variáveis
+POSTGRES_USER="${POSTGRES_USER:-para_ai}"
+POSTGRES_PASSWORD="${POSTGRES_PASSWORD:-para_ai_temp}"
+POSTGRES_DB="${POSTGRES_DB:-para_ai}"
+PGDATA="/var/lib/postgresql/data"
+
+# Verificar se já foi inicializado
+if [ -d "$PGDATA/base" ]; then
+    echo "✅ PostgreSQL já inicializado (dados existem)"
+else
+    echo "📦 Inicializando cluster PostgreSQL..."
+
+    # Criar diretório de dados
+    mkdir -p "$PGDATA"
+    chown -R postgres:postgres "$PGDATA"
+    chmod 700 "$PGDATA"
+
+    # Inicializar cluster como usuário postgres
+    su - postgres -c "/usr/lib/postgresql/15/bin/initdb -D $PGDATA --encoding=UTF8 --locale=C"
+
+    echo "✅ Cluster criado"
+fi
+
+# Configurar pg_hba.conf para aceitar conexões locais
+cat > "$PGDATA/pg_hba.conf" << EOF
+# TYPE  DATABASE        USER            ADDRESS                 METHOD
+local   all             all                                     trust
+host    all             all             127.0.0.1/32            md5
+host    all             all             ::1/128                 md5
+host    all             all             0.0.0.0/0               md5
+EOF
+
+# Configurar postgresql.conf
+cat >> "$PGDATA/postgresql.conf" << EOF
+
+# Configurações para ambiente Docker/HF Spaces
+listen_addresses = '*'
+port = 5432
+max_connections = 50
+shared_buffers = 128MB
+work_mem = 4MB
+maintenance_work_mem = 64MB
+effective_cache_size = 256MB
+log_destination = 'stderr'
+logging_collector = off
+log_min_messages = warning
+log_min_error_statement = error
+EOF
+
+echo "✅ Configurações aplicadas"
+
+# Iniciar PostgreSQL em background
+echo "🚀 Iniciando servidor PostgreSQL..."
+su - postgres -c "/usr/lib/postgresql/15/bin/pg_ctl -D $PGDATA -l /var/log/postgresql/postgresql.log start"
+
+# Aguardar PostgreSQL ficar pronto
+echo "⏳ Aguardando PostgreSQL ficar pronto..."
+for i in {1..30}; do
+    if su - postgres -c "psql -l" &> /dev/null; then
+        echo "✅ PostgreSQL está pronto!"
+        break
+    fi
+    echo "   Tentativa $i/30..."
+    sleep 1
+done
+
+# Verificar se ficou pronto
+if ! su - postgres -c "psql -l" &> /dev/null; then
+    echo "❌ PostgreSQL não iniciou corretamente!"
+    cat /var/log/postgresql/postgresql.log
+    exit 1
+fi
+
+# Criar usuário se não existir
+echo "👤 Criando usuário $POSTGRES_USER..."
+su - postgres -c "psql -tc \"SELECT 1 FROM pg_user WHERE usename = '$POSTGRES_USER'\" | grep -q 1" ||     su - postgres -c "psql -c \"CREATE USER $POSTGRES_USER WITH PASSWORD '$POSTGRES_PASSWORD';\"" &&     echo "✅ Usuário criado"
+
+# Criar database se não existir
+echo "🗄️  Criando database $POSTGRES_DB..."
+su - postgres -c "psql -lqt | cut -d \| -f 1 | grep -qw $POSTGRES_DB" ||     su - postgres -c "psql -c \"CREATE DATABASE $POSTGRES_DB OWNER $POSTGRES_USER;\"" &&     echo "✅ Database criado"
+
+# Dar permissões
+su - postgres -c "psql -c \"GRANT ALL PRIVILEGES ON DATABASE $POSTGRES_DB TO $POSTGRES_USER;\""
+
+# Executar DDL se arquivo existir
+if [ -f "/app/database/init_db.sql" ]; then
+    echo "📜 Executando DDL..."
+    PGPASSWORD=$POSTGRES_PASSWORD psql -h localhost -U $POSTGRES_USER -d $POSTGRES_DB -f /app/database/init_db.sql
+    echo "✅ DDL executado"
+else
+    echo "⚠️  Arquivo init_db.sql não encontrado"
+fi
+
+# Executar seed data se arquivo existir
+if [ -f "/app/scripts/seed_data.sql" ]; then
+    echo "🌱 Inserindo dados de teste..."
+    PGPASSWORD=$POSTGRES_PASSWORD psql -h localhost -U $POSTGRES_USER -d $POSTGRES_DB -f /app/scripts/seed_data.sql
+    echo "✅ Seed data inserido"
+fi
+
+# Mostrar status
+echo ""
+echo "=================================================="
+echo "✅ PostgreSQL inicializado com sucesso!"
+echo "=================================================="
+echo "📊 Informações:"
+echo "   Host:     localhost"
+echo "   Port:     5432"
+echo "   Database: $POSTGRES_DB"
+echo "   User:     $POSTGRES_USER"
+echo ""
+
+# Mostrar estatísticas
+echo "📈 Estatísticas:"
+PGPASSWORD=$POSTGRES_PASSWORD psql -h localhost -U $POSTGRES_USER -d $POSTGRES_DB -c "
+    SELECT 
+        'Tribunais' as tabela, COUNT(*)::text as registros FROM tribunais
+    UNION ALL
+    SELECT 'Usuários', COUNT(*)::text FROM usuarios
+    UNION ALL
+    SELECT 'Acórdãos', COUNT(*)::text FROM acordaos
+    UNION ALL
+    SELECT 'Decisões', COUNT(*)::text FROM decisoes;
+" 2>/dev/null || echo "   (tabelas ainda não criadas)"
+
+echo ""
+echo "✅ Pronto para iniciar API!"
+echo "=================================================="