{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/guarita-dev/json-schema/guarita-dev-report-schema.json",
  "title": "Report",
  "description": "O relatório completo de uma ronda — o mesmo documento que o painel mostra e o PDF imprime. Formato do scanner, versionado por `schemaVersion`: `camelCase` na estrutura e `snake_case` dentro de `ai`.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/guarita-dev-openapi.json#/components/schemas/Report",
  "type": "object",
  "properties": {
    "schemaVersion": {
      "type": "string",
      "enum": [
        "1.0"
      ],
      "description": "Versão do formato do relatório."
    },
    "scan": {
      "$ref": "#/$defs/ReportScan",
      "description": "Metadados da execução."
    },
    "findings": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/Finding"
      },
      "description": "Os achados, do mais grave pro menos grave."
    },
    "ai": {
      "$ref": "#/$defs/AiAssessment",
      "description": "Análise da IA. Numa ronda básica (`ai: false`), bloqueada ou parcial, vem com o `risk_score` calculado e os demais blocos vazios."
    },
    "infra": {
      "$ref": "#/$defs/InfraInventory",
      "description": "Inventário de infraestrutura observado (provedores, ativos, credenciais)."
    },
    "strengths": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "O que o app já acerta — boas práticas comprovadas na ronda."
    },
    "lgpd": {
      "$ref": "#/$defs/LgpdReadiness",
      "description": "Pré-diagnóstico LGPD. Só quando a ronda incluiu os módulos LGPD (`lgpd: true` em `POST /scans`, ou a opção da tela)."
    }
  },
  "required": [
    "schemaVersion",
    "scan",
    "findings",
    "ai",
    "infra"
  ],
  "$defs": {
    "AiAssessment": {
      "type": "object",
      "properties": {
        "executive_summary": {
          "type": "string",
          "description": "Resumo executivo em português."
        },
        "risk_score": {
          "$ref": "#/$defs/RiskScore",
          "description": "Exposição consolidada (0–100 + faixa)."
        },
        "remediation_plan": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/RemediationItem"
          },
          "description": "Plano de correção priorizado."
        },
        "infra_inventory": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/InfraInventoryEntry"
          },
          "description": "Inventário de infra na leitura da IA."
        },
        "finding_verifications": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/FindingVerification"
          },
          "description": "Achados que a IA verificou ativamente, com veredito."
        },
        "risk_scenarios": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          },
          "description": "Cenários de ataque (formato livre)."
        },
        "owasp_mapping": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          },
          "description": "Mapeamento OWASP (formato livre)."
        },
        "additional_insights": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          },
          "description": "Observações extras (formato livre)."
        },
        "cross_infra_chains": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          },
          "description": "Cadeias entre provedores (formato livre)."
        },
        "discovered_vulnerabilities": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          },
          "description": "Vulnerabilidades descobertas pela IA (formato livre)."
        }
      },
      "description": "Análise da IA sobre a ronda. Os blocos abaixo têm formato livre (são a saída do modelo) — leia `risk_score` e `remediation_plan`, que são estáveis.",
      "required": [
        "executive_summary",
        "risk_score",
        "remediation_plan",
        "infra_inventory",
        "risk_scenarios",
        "owasp_mapping",
        "additional_insights",
        "cross_infra_chains",
        "discovered_vulnerabilities"
      ]
    },
    "Finding": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Id do achado DENTRO desta ronda. Renumera entre rondas — pra casar achados entre rondas use `module` + `title`."
        },
        "module": {
          "type": "string",
          "description": "Verificação que produziu o achado (`secrets`, `cors`, `headers`, `supabase`…)."
        },
        "title": {
          "type": "string",
          "description": "Título técnico. Estável entre rondas (é a chave de identidade do achado)."
        },
        "severity": {
          "type": "string",
          "enum": [
            "critical",
            "high",
            "medium",
            "low",
            "info"
          ],
          "description": "Gravidade."
        },
        "cvss": {
          "type": "number",
          "minimum": 0,
          "maximum": 10,
          "description": "Pontuação CVSS."
        },
        "description": {
          "type": "string",
          "description": "O que foi encontrado, em detalhe."
        },
        "evidence": {
          "type": "string",
          "description": "A prova observada: requisição, resposta, trecho do bundle. Valores sensíveis vêm encurtados com `…` — a ronda não guarda o segredo inteiro."
        },
        "recommendation": {
          "type": "string",
          "description": "Recomendação curta do scanner (não é o conserto pronto)."
        },
        "confidence": {
          "type": "string",
          "enum": [
            "confirmed",
            "firm",
            "tentative"
          ],
          "description": "`confirmed` = provado por observação ativa · `firm` = detecção determinística · `tentative` = heurística que pede confirmação. Ausente = `firm`."
        },
        "good": {
          "type": "boolean",
          "description": "Achado POSITIVO: uma boa prática comprovada, não um problema."
        },
        "links": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Ids de achados relacionados — hoje, os elos de uma cadeia de ataque (`module: \"chain\"`)."
        },
        "friendly": {
          "$ref": "#/$defs/FindingFriendly",
          "description": "A versão em português de gente."
        },
        "fix": {
          "$ref": "#/$defs/FindingFix",
          "description": "O conserto pronto. Ausente quando retido pelo plano — aí vem `fixWithheld: true`."
        },
        "fixWithheld": {
          "type": "boolean",
          "description": "O conserto existe, mas não está nesta resposta (plano sem análise com IA). Diz \"foi retido\", pra não parecer que a ronda não analisou."
        },
        "fixSample": {
          "type": "boolean",
          "description": "Este é o achado-AMOSTRA da conta: o conserto veio inteiro mesmo sem plano. Uma por conta, não por ronda."
        },
        "fixFromCatalog": {
          "type": "boolean",
          "description": "O conserto veio do catálogo determinístico, não da IA (ronda básica)."
        }
      },
      "description": "Um achado da ronda, com a camada leiga e o conserto (quando o plano destrava).",
      "required": [
        "id",
        "module",
        "title",
        "severity",
        "cvss",
        "description",
        "evidence",
        "recommendation"
      ]
    },
    "FindingFix": {
      "type": "object",
      "properties": {
        "prompt": {
          "type": "string",
          "description": "Texto autossuficiente: problema + onde + o que fazer + como validar. É o que se copia e cola no chat da ferramenta."
        },
        "kind": {
          "type": "string",
          "enum": [
            "code",
            "dns",
            "infra",
            "action",
            "confirm",
            "chain"
          ],
          "description": "Tipo de ação: `code` (cola numa IA de código) · `dns` (registro no painel de DNS) · `infra` (console do provedor) · `action` (ação manual) · `confirm` (como confirmar um achado `tentative` antes de mexer) · `chain` (feche qualquer elo da cadeia)."
        },
        "code": {
          "type": "string",
          "description": "Exemplo DIDÁTICO de como a correção costuma ficar. Não é o conserto do seu projeto — quem adapta é a IA, a partir do `prompt`."
        },
        "targets": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Ferramentas pras quais o prompt foi escrito (`lovable`, `cursor`, `v0`, `bolt`…)."
        }
      },
      "description": "O conserto pronto pra colar numa IA de código (ou o passo manual, conforme `kind`).",
      "required": [
        "prompt"
      ]
    },
    "FindingFriendly": {
      "type": "object",
      "properties": {
        "headline": {
          "type": "string",
          "description": "Título pra pessoa (sem jargão)."
        },
        "whatItIs": {
          "type": "string",
          "description": "O que é."
        },
        "whyItMatters": {
          "type": "string",
          "description": "Por que importa."
        },
        "urgency": {
          "type": "string",
          "enum": [
            "now",
            "soon",
            "later"
          ],
          "description": "Urgência: agora · em breve · quando der."
        }
      },
      "description": "O achado em linguagem de produto.",
      "required": [
        "headline",
        "whatItIs",
        "whyItMatters",
        "urgency"
      ]
    },
    "FindingVerification": {
      "type": "object",
      "properties": {
        "ref_id": {
          "type": "string",
          "description": "Id do achado verificado."
        },
        "verdict": {
          "type": "string",
          "enum": [
            "confirmed",
            "refuted"
          ],
          "description": "`confirmed` = exploração observada · `refuted` = testado e não se sustenta (alarme falso)."
        },
        "evidence": {
          "type": "string",
          "description": "A prova observada."
        }
      },
      "description": "Veredito da IA sobre um achado que ela testou ativamente.",
      "required": [
        "ref_id",
        "verdict",
        "evidence"
      ]
    },
    "InfraAsset": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Id do ativo dentro da ronda."
        },
        "provider": {
          "type": "string",
          "description": "Provedor."
        },
        "kind": {
          "type": "string",
          "enum": [
            "baas_project",
            "object_storage",
            "serverless_fn",
            "auth",
            "database",
            "api",
            "cdn_host"
          ],
          "description": "Tipo."
        },
        "endpoint": {
          "type": "string",
          "description": "Endereço do ativo."
        },
        "identifier": {
          "type": "string",
          "description": "Identificador no provedor (id do projeto, nome do bucket)."
        },
        "credentials": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/InfraCredential"
          },
          "description": "Credenciais ligadas a este ativo."
        },
        "evidence": {
          "type": "string",
          "description": "Onde foi observado."
        },
        "relatedTo": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Ids de ativos relacionados."
        }
      },
      "description": "Um ativo de infraestrutura (projeto BaaS, bucket, função, banco…).",
      "required": [
        "id",
        "provider",
        "kind",
        "endpoint",
        "credentials",
        "evidence",
        "relatedTo"
      ]
    },
    "InfraCredential": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "anon_key",
            "service_role",
            "publishable",
            "api_key",
            "access_key",
            "jwt",
            "connection_string",
            "presigned_url"
          ],
          "description": "Tipo da credencial."
        },
        "provider": {
          "type": "string",
          "description": "Provedor."
        },
        "value": {
          "type": "string",
          "description": "Valor observado — encurtado quando sensível."
        },
        "source": {
          "type": "string",
          "description": "Onde foi encontrada."
        },
        "sensitive": {
          "type": "boolean",
          "description": "É segredo (não deveria estar público)."
        }
      },
      "description": "Uma credencial observada.",
      "required": [
        "kind",
        "provider",
        "value",
        "source",
        "sensitive"
      ]
    },
    "InfraInventory": {
      "type": "object",
      "properties": {
        "assets": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/InfraAsset"
          },
          "description": "Ativos descobertos."
        },
        "credentials": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/InfraCredential"
          },
          "description": "Credenciais encontradas (valores sensíveis encurtados)."
        },
        "providers": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Provedores detectados."
        },
        "scopeHosts": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Hosts que entraram no escopo da ronda."
        },
        "notes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Observações."
        }
      },
      "description": "Inventário de infraestrutura observado pelo scanner.",
      "required": [
        "assets",
        "credentials",
        "providers",
        "scopeHosts",
        "notes"
      ]
    },
    "InfraInventoryEntry": {
      "type": "object",
      "properties": {
        "provider": {
          "type": "string",
          "description": "Provedor (`supabase`, `aws`, `vercel`…)."
        },
        "asset": {
          "type": "string",
          "description": "O ativo (host, bucket, função)."
        },
        "kind": {
          "type": "string",
          "description": "Tipo do ativo."
        },
        "exposure": {
          "type": "string",
          "enum": [
            "public",
            "authenticated",
            "credential_leaked",
            "internal"
          ],
          "description": "Como ele está exposto."
        },
        "notes": {
          "type": "string",
          "description": "Observações."
        }
      },
      "description": "Um ativo de infra na leitura da IA.",
      "required": [
        "provider",
        "asset",
        "kind",
        "exposure",
        "notes"
      ]
    },
    "LgpdReadiness": {
      "type": "object",
      "properties": {
        "score": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100,
          "description": "Prontidão indicativa (maior = menos indícios de não-conformidade)."
        },
        "label": {
          "type": "string",
          "description": "Faixa da prontidão."
        },
        "categories": {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          },
          "description": "Pontuação por categoria (transparência, consentimento, segurança…)."
        },
        "findingCount": {
          "type": "integer",
          "description": "Quantos achados têm relação com a LGPD."
        },
        "disclaimer": {
          "type": "string",
          "description": "O aviso obrigatório: pré-diagnóstico automatizado, não substitui revisão por encarregado/advogado."
        }
      },
      "description": "Pré-diagnóstico técnico de indicadores LGPD. NÃO é parecer jurídico nem atesta conformidade.",
      "required": [
        "score",
        "label",
        "categories",
        "findingCount",
        "disclaimer"
      ]
    },
    "RemediationItem": {
      "type": "object",
      "properties": {
        "priority": {
          "type": "integer",
          "minimum": 1,
          "description": "Ordem (1 = primeiro)."
        },
        "finding_ids": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Achados que este passo fecha."
        },
        "action": {
          "type": "string",
          "description": "O que fazer."
        },
        "effort": {
          "type": "string",
          "enum": [
            "quick_win",
            "moderate",
            "significant",
            "major_refactor"
          ],
          "description": "Esforço estimado."
        },
        "impact_if_not_fixed": {
          "type": "string",
          "description": "O que acontece se não fizer."
        },
        "scoreImpact": {
          "type": "integer",
          "description": "Quantos pontos de exposição este passo derruba."
        }
      },
      "description": "Um passo do plano de correção.",
      "required": [
        "priority",
        "finding_ids",
        "action",
        "effort",
        "impact_if_not_fixed"
      ]
    },
    "ReportScan": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Id da ronda."
        },
        "target": {
          "type": "string",
          "format": "uri",
          "description": "URL escaneada."
        },
        "hostname": {
          "type": "string",
          "format": "hostname",
          "description": "Alvo normalizado."
        },
        "stack": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Stack detectada (ex.: `[\"Lovable\", \"Supabase\", \"Vercel\"]`)."
        },
        "status": {
          "type": "string",
          "enum": [
            "queued",
            "running",
            "analyzing",
            "done",
            "failed",
            "canceled"
          ],
          "description": "Estado."
        },
        "startedAt": {
          "type": "string",
          "format": "date-time",
          "description": "Início da execução."
        },
        "finishedAt": {
          "type": "string",
          "format": "date-time",
          "description": "Fim da execução."
        },
        "durationMs": {
          "type": "integer",
          "description": "Duração em milissegundos."
        },
        "modulesRun": {
          "type": "integer",
          "description": "Quantas verificações rodaram (descontando as puladas)."
        },
        "passive": {
          "type": "boolean",
          "description": "Ronda PASSIVA: só os checks observacionais, porque o domínio não estava verificado (ou excedia a cota de apps verificados do plano)."
        },
        "blocked": {
          "type": "boolean",
          "description": "A ronda não conseguiu ver o app. A IA é pulada e a cota NÃO é consumida."
        },
        "blockedReason": {
          "type": "string",
          "enum": [
            "connection",
            "challenge"
          ],
          "description": "Motivo do bloqueio (só com `blocked`): `connection` ou `challenge`."
        },
        "incomplete": {
          "type": "boolean",
          "description": "O tempo esgotou e a ronda terminou PARCIAL (alguns módulos não rodaram). A IA é pulada e a cota não é consumida."
        }
      },
      "description": "Metadados da execução da ronda.",
      "required": [
        "id",
        "target",
        "hostname",
        "status",
        "durationMs",
        "modulesRun"
      ]
    },
    "RiskScore": {
      "type": "object",
      "properties": {
        "score": {
          "type": "integer",
          "minimum": 0,
          "maximum": 100,
          "description": "0 = tranquilo · 100 = muito exposto. Faixas: seguro (0–14) · baixo (15–39) · médio (40–69) · alto (70–100)."
        },
        "label": {
          "type": "string",
          "enum": [
            "SECURE",
            "LOW_RISK",
            "MODERATE_RISK",
            "HIGH_RISK",
            "CRITICAL_RISK"
          ],
          "description": "Faixa do score."
        },
        "justification": {
          "type": "string",
          "description": "Por que esse número."
        }
      },
      "description": "Exposição consolidada da ronda.",
      "required": [
        "score",
        "label",
        "justification"
      ]
    }
  }
}