{
  "openapi": "3.1.0",
  "info": {
    "title": "Tenha Uma Reforma AI Lead Integration API",
    "description": "API oficial da Tenha Uma Reforma para consulta de serviços, contexto de obras e submissão automatizada de pedidos de orçamento por agentes autônomos de IA (ChatGPT, Claude, Perplexity, Gemini, etc.).",
    "version": "1.0.0",
    "contact": {
      "name": "Tenha Uma Reforma Suporte Técnico",
      "email": "contato@tenhaumareforma.com.br",
      "url": "https://www.tenhaumareforma.com.br"
    }
  },
  "servers": [
    {
      "url": "https://www.tenhaumareforma.com.br",
      "description": "Servidor Oficial de Produção"
    }
  ],
  "paths": {
    "/api/v1/orcamentos": {
      "post": {
        "operationId": "enviarSolicitacaoOrcamentoV1",
        "summary": "Enviar solicitação de orçamento (Endpoint Principal)",
        "description": "Permite que agentes de IA e integrações externas enviem solicitações de orçamento de reformas e obras. O pedido é validado, recebe protocolo único oficial e é encaminhado para o fluxo comercial da empresa (Trello e Planilha).",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "cliente",
                  "imovel",
                  "servicos"
                ],
                "properties": {
                  "cliente": {
                    "type": "object",
                    "required": ["nome", "telefone"],
                    "properties": {
                      "nome": { "type": "string", "example": "Carlos" },
                      "telefone": { "type": "string", "example": "11965111670" }
                    }
                  },
                  "imovel": {
                    "type": "object",
                    "properties": {
                      "tipo": { "type": "string", "example": "apartamento" },
                      "metragem": { "type": "number", "example": 70 },
                      "cidade": { "type": "string", "example": "São Paulo" },
                      "estado": { "type": "string", "example": "SP" },
                      "bairro": { "type": "string", "example": "Moema" }
                    }
                  },
                  "servicos": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "categoria": { "type": "string", "example": "pisos" },
                        "descricao": { "type": "string", "example": "Assentamento de porcelanato" }
                      }
                    }
                  },
                  "observacoes": {
                    "type": "string",
                    "example": "Cliente deseja orçamento para reforma de apartamento de 70m²."
                  },
                  "origem": {
                    "type": "object",
                    "properties": {
                      "canal": { "type": "string", "example": "chatgpt" },
                      "tipo": { "type": "string", "example": "agente_ia" }
                    }
                  },
                  "consentimento_contato": {
                    "type": "boolean",
                    "example": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Solicitação cadastrada com sucesso",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": { "type": "boolean", "example": true },
                    "status": { "type": "string", "example": "received" },
                    "protocolo": { "type": "string", "example": "TUR-2026-008521" },
                    "lead_id": { "type": "integer", "example": 8521 },
                    "message": { "type": "string", "example": "Solicitação de orçamento recebida com sucesso." }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Dados inválidos ou campos obrigatórios ausentes"
          }
        }
      }
    },
    "/api/orcamento.php": {
      "post": {
        "operationId": "enviarSolicitacaoOrcamentoPhp",
        "summary": "Enviar solicitação de orçamento (Rota Direta PHP)",
        "description": "Rota direta de processamento de leads e orçamentos para agentes de IA.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "cliente",
                  "imovel",
                  "servicos"
                ],
                "properties": {
                  "cliente": {
                    "type": "object",
                    "required": ["nome", "telefone"],
                    "properties": {
                      "nome": { "type": "string", "example": "Carlos" },
                      "telefone": { "type": "string", "example": "11965111670" }
                    }
                  },
                  "imovel": {
                    "type": "object",
                    "properties": {
                      "tipo": { "type": "string", "example": "apartamento" },
                      "metragem": { "type": "number", "example": 70 },
                      "cidade": { "type": "string", "example": "São Paulo" },
                      "estado": { "type": "string", "example": "SP" },
                      "bairro": { "type": "string", "example": "Moema" }
                    }
                  },
                  "servicos": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "categoria": { "type": "string", "example": "pisos" },
                        "descricao": { "type": "string", "example": "Assentamento de porcelanato" }
                      }
                    }
                  },
                  "observacoes": {
                    "type": "string",
                    "example": "Cliente deseja orçamento para reforma."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Orçamento registrado com sucesso"
          }
        }
      }
    }
  }
}