logger-designlisted

# Logger Design Skill Esta skill define padrões rígidos para logging estruturado com distributed tracing, garantindo rastreabilidade completa e segurança de dados sensíveis. ## Core Principle > **Logs são a memória do sistema. Estruturados, rastreáveis e seguros.** ``` ┌─────────────────────────────────────────────────────────────┐ │ ESTRUTURADO: Schema rígido, campos obrigatórios │ │ RASTREÁVEL: Distributed tracing com correlation IDs │ │ SEGURO: PII sanitizado, dados sensíveis protegidos │ └─────────────────────────────────────────────────────────────┘ ``` --- ## Schema de Log Obrigatório ### Interface Base ```typescript interface LogEntry { // === OBRIGATÓRIOS === timestamp: string; // ISO 8601: "2024-01-15T10:30:00.000Z" level: LogLevel; // "debug" | "info" | "warn" | "error" | "fatal" message: string; // Descrição legível service: string; // Nome do serviço/app environment: string; // "development" | "staging" | "production" // === TRACING (obrigatório em requests) === traceId: string; // ID único da requisição raiz spanId: string; // ID do span atual parentSpanId?: string; // ID do span pai (se existir) // === CONTEXTO (quando disponível) === userId?: string; // ID do usuário (nunca PII direto) sessionId?: string; // ID da sessão requestId?: string; // ID da requisição HTTP // === TÉCNICO === caller?: string;