🏗️ Arquitetura GIPM do Projeto

# Template: 3 Camadas do Seu Projeto

## CAMADA HUMANA (Decisao)
O que HUMANOS definem e a IA NAO pode alterar:
- [ ] Limites de custo: R$ ___ /mes
- [ ] Personas permitidas: [lista]
- [ ] Topicos bloqueados: [lista]
- [ ] Formato de output: [formatos]
- [ ] Criterios de qualidade: [metricas]

## CAMADA SISTEMA (Orquestracao)
O que o CODIGO controla:
- [ ] Validacao de inputs
- [ ] Selecao de persona
- [ ] Montagem de contexto
- [ ] Persistencia de logs
- [ ] Controle de custos

## CAMADA COGNITIVA (Execucao)
O que a IA faz (e APENAS isso):
- [ ] Analisar conteudo
- [ ] Gerar estrutura/texto
- [ ] Responder perguntas
- (IA NAO controla fluxo)

# Template de Persona

PERSONA_NOME = """
Voce e um [PAPEL] especializado em [DOMINIO].

CARACTERISTICAS:
- Tom: [formal/informal/tecnico/didatico]
- Nivel de detalhe: [alto/medio/baixo]
- Publico-alvo: [quem vai consumir]

REGRAS:
1. SEMPRE [comportamento obrigatorio]
2. NUNCA [comportamento proibido]
3. QUANDO [situacao], FACA [acao]

FORMATO DE RESPOSTA:
[Estrutura esperada das respostas]
"""

# Exemplo para Documentacao Tecnica
PERSONA_DOC_TECNICA = """
Voce e um technical writer especializado em documentacao de software.

CARACTERISTICAS:
- Tom: Tecnico mas acessivel
- Nivel: Detalhado com exemplos de codigo
- Publico: Desenvolvedores

REGRAS:
1. SEMPRE inclua exemplos de codigo
2. NUNCA assuma conhecimento previo
3. QUANDO houver multiplas opcoes, liste todas
"""

# Seu Pipeline - Preencha cada passo

ENTRADA:
1. Receber: [O que o usuario envia?]
2. Validar: [Quais validacoes aplicar?]
3. Contexto: [Que informacoes agregar?]

PROCESSAMENTO:
4. Invocar IA: [Qual modelo? Quais parametros?]
5. Estrutura: [Que formato a IA retorna?]
6. Validar saida: [Como verificar qualidade?]

SAIDA:
7. Materializar: [Que artefato gerar?]
8. Persistir: [O que salvar? Onde?]
9. Retornar: [Que resposta o usuario recebe?]

Stack Recomendada para Iniciantes

# Modelo Minimo GIPM

## Tabelas Obrigatorias
- requests: Toda requisicao recebida
- responses: Toda resposta gerada
- interactions: Log completo (request + response + metadados)

## Campos Obrigatorios para Auditoria
- request_id: UUID unico
- timestamp: Data/hora
- prompt_sent: Prompt completo
- response_received: Resposta completa
- tokens_used: Consumo
- cost_usd: Custo
- persona_used: Persona aplicada
- user_id: Quem solicitou (se aplicavel)

# Template de API

## Endpoints Principais
POST   /api/v1/{recurso}        # Criar/processar
GET    /api/v1/{recurso}        # Listar
GET    /api/v1/{recurso}/{id}   # Obter um
DELETE /api/v1/{recurso}/{id}   # Remover

## Endpoints de Auditoria
GET    /api/v1/audit/requests   # Historico de requests
GET    /api/v1/audit/costs      # Custos agregados
GET    /api/v1/health           # Health check

## Exemplo para Projeto de Resumos
POST   /api/v1/summaries        # Gerar resumo
GET    /api/v1/summaries        # Listar resumos
GET    /api/v1/summaries/{id}   # Obter resumo
GET    /api/v1/audit/usage      # Uso de tokens

┌─────────────────────────────────────────────────────────┐
│                    CAMADA HUMANA                        │
│  [Configuracoes] [Limites] [Personas] [Regras]          │
└─────────────────────────────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────┐
│                   CAMADA SISTEMA                         │
│  ┌─────────┐  ┌──────────┐  ┌─────────┐  ┌─────────┐   │
│  │   API   │→ │ Validar  │→ │Pipeline │→ │Persistir│   │
│  │Endpoints│  │  Input   │  │ 9 steps │  │  Logs   │   │
│  └─────────┘  └──────────┘  └─────────┘  └─────────┘   │
└─────────────────────────────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────┐
│                  CAMADA COGNITIVA                        │
│              [LLM: Gemini / GPT / Claude]               │
│              (Executa apenas - NAO decide)              │
└─────────────────────────────────────────────────────────┘