graph TD
    A[Usuário] -->|Cria| B[Task]
    B -->|Possui| C[Schedule]
    B -->|Usa| D[AI Model]
    B -->|Pode ter| E[Files/Images]
    C -->|Dispara| F[Execution]
    F -->|Gera| G[Output]
    F -->|Aciona| H[Notifications]
    H -->|Envia para| I[Email/WhatsApp/Notion/Webhook]

interface Task {
  // Identificação
  id: string;
  name: string;
  description?: string;
 
  // Prompts
  systemPrompt: string;      // Instruções para a IA
  userMessage?: string;      // Input específico
 
  // Modelo de IA
  model: string;             // Ex: "google/gemini-2.5-pro"
  temperature?: number;      // 0-1 (criatividade)
  maxTokens?: number;        // Limite de resposta
 
  // Agendamento
  scheduleType: "once" | "recurring" | "manual";
  cronExpression?: string;   // Para recurring
  timezone: string;          // Ex: "America/Sao_Paulo"
 
  // Estado
  isActive: boolean;
 
  // Multimodal
  fileIds?: string[];        // IDs de arquivos anexados
 
  // Notificações
  notifications: {
    email?: boolean;
    whatsapp?: boolean;
    webhook?: string;
    notion?: boolean;
    figma?: boolean;
  };
 
  // Metadados
  userId: string;
  createdAt: Date;
  updatedAt: Date;
}

{
  scheduleType: "manual",
  name: "Análise de Sentimento de Texto"
}

{
  scheduleType: "once",
  scheduledFor: "2025-10-20T14:00:00Z",
  name: "Relatório Trimestral Q4"
}

{
  scheduleType: "recurring",
  cronExpression: "0 9 * * 1-5", // Seg-Sex às 9h
  name: "Resumo Diário de Vendas"
}

Executa todos os dias às 9h da manhã

{
  scheduleType: "recurring",
  cronExpression: "0 9 * * *",
  timezone: "America/Sao_Paulo"
}

{
  timezone: "America/Sao_Paulo",    // BRT/BRST
  // ou
  timezone: "America/New_York",     // EST/EDT
  // ou
  timezone: "Europe/London"         // GMT/BST
}

interface Execution {
  // Identificação
  id: string;
  taskId: string;
 
  // Estado
  status: "pending" | "running" | "completed" | "failed";
 
  // Input/Output
  input: {
    systemPrompt: string;
    userMessage?: string;
    model: string;
    files?: File[];
  };
 
  output: {
    content: string;        // Resposta da IA
    raw?: object;           // Resposta completa da API
  };
 
  // Métricas
  metadata: {
    tokensUsed: {
      prompt: number;
      completion: number;
      total: number;
    };
    executionTime: number;  // Em segundos
    cost: number;           // Em USD
    model: string;
  };
 
  // Erro (se houver)
  error?: {
    message: string;
    code: string;
    stack?: string;
  };
 
  // Notificações
  notificationsSent: {
    email?: { success: boolean; sentAt?: Date };
    whatsapp?: { success: boolean; sentAt?: Date };
    webhook?: { success: boolean; sentAt?: Date };
    notion?: { success: boolean; sentAt?: Date };
  };
 
  // Timestamps
  startedAt: Date;
  completedAt?: Date;
  createdAt: Date;
}

stateDiagram-v2
    [*] --> Pending
    Pending --> Running: Scheduler inicia
    Running --> Completed: Sucesso
    Running --> Failed: Erro
    Running --> Timeout: Tempo esgotado
    Completed --> [*]
    Failed --> [*]
    Timeout --> [*]

{
  temperature: 0.0  // Determinístico, preciso
  temperature: 0.5  // Balanceado
  temperature: 1.0  // Criativo, variado
}

{
  maxTokens: 1000   // Respostas curtas
  maxTokens: 4000   // Respostas médias
  maxTokens: 16000  // Respostas longas
}

{
  topP: 1.0   // Considera todas as opções (padrão)
  topP: 0.9   // Mais focado
  topP: 0.5   // Muito focado
}

{
  name: "Análise de Screenshot de UI",
  model: "google/gemini-2.5-flash",
  systemPrompt: "Analise esta interface e sugira melhorias de UX",
  files: [uploadedScreenshot]
}

{
  name: "Extrair Texto de Documento",
  model: "google/gemini-2.5-pro",
  systemPrompt: "Extraia todo o texto desta imagem e formate como Markdown",
  files: [scannedDocument]
}

{
  name: "Comparar Versões de Design",
  model: "anthropic/claude-3.5-sonnet",
  systemPrompt: "Compare estas duas versões do design e liste as diferenças",
  files: [version1, version2]
}

{
  notifications: {
    email: true
  }
}

{
  notifications: {
    whatsapp: true
  }
}

{
  notifications: {
    webhook: "https://seu-servidor.com/api/webhook"
  }
}

{
  "taskId": "task_123",
  "executionId": "exec_456",
  "status": "completed",
  "output": "...",
  "metadata": { ... }
}

{
  notifications: {
    notion: true
  }
}

{
  notifications: {
    figma: true
  }
}

// API Keys são criptografadas antes de salvar
const encrypted = fernet.encrypt(apiKey);
 
// E descriptografadas apenas quando necessário
const decrypted = fernet.decrypt(encrypted);

// Toda request valida ownership
if (task.userId !== currentUser.id) {
  throw new UnauthorizedException();
}

{
  "timestamp": "2025-10-17T10:30:00Z",
  "level": "info",
  "message": "Execution started",
  "data": {
    "taskId": "task_123",
    "model": "google/gemini-2.5-pro"
  }
}