# Peça Match AI - Documentação Técnica & Comercial Completa

> Plataforma SaaS B2B de Inteligência Artificial e Visão Computacional para identificação de autopeças pesadas (caminhões e ônibus).

A Peça Match AI ajuda transportadoras, operadores logísticos, oficinas mecânicas e frotistas a reduzirem o tempo de caminhão parado (downtime estimado em R$ 3.500 a R$ 4.000/dia pelo SETCESP) através da rápida identificação de peças por imagem, áudio e cruzamento instantâneo de códigos OEM de fábrica.

## Dados Corporativos
- **Plataforma**: Peça Match AI
- **Site Institucional**: https://www.pecamatchai.com.br/
- **Aplicativo Oficial Web & Mobile**: https://app.pecamatchai.com.br/
- **Contato Comercial**: contato@pecamatchai.com.br
- **Fundador**: Thiago Campos de Oliveira

## Política Comercial & Período de Teste Gratuito (7 Dias)
- **Oferta de Entrada**: 7 dias gratuitos de acesso total à plataforma.
- **Cartão de Crédito**: NÃO é necessário cadastrar cartão para desfrutar dos 7 dias.
- **Liberação Imediata**: O usuário acessa [https://app.pecamatchai.com.br/](https://app.pecamatchai.com.br/) e cria a conta em menos de 1 minuto.
- **Planos Mensais**:
  - **Plano Básico**: R$ 199/mês por usuário (até 150 identificações, cruzamento OEM, suporte WhatsApp).
  - **Plano Corporativo**: R$ 499/mês por usuário (identificações ilimitadas, tabela de torques, métricas de downtime, SLA prioritário).
  - **Plano Enterprise**: Sob consulta (usuários ilimitados, integrações SAP/Totvs e treinamento in-loco).

## Catálogo de Peças Pesadas & Conversão de Códigos Cruzados
O Peça Match AI mantém um grafo de correspondência entre fabricantes de componentes originais e montadoras de veículos comerciais:
- **Sistemas de Freios & Pneumática**: Válvulas APU Secadoras de Ar, Cuícas de Freio Spring Brake Tristop 30/30, Válvulas de Pedal EBS, Válvulas Relé, Válvulas Moduladoras ABS.
- **Fabricantes Sistemistas**: WABCO, Knorr-Bremse, Haldex, Master Freios, Bosch, Mahle, Cummins, Meritor, Dana Spicer, ZF.
- **Montadoras Suportadas**: Mercedes-Benz (Actros, Axor, Atego, Accelo), Volvo (FH 460/540, FM, VM), Scania (Séries PGR e NTG), Volkswagen Caminhões (Constellation, Delivery), DAF (XF, CF), Iveco (Stralis, Tector, Hi-Way).
- **Parâmetros Técnicos Exibidos**: Torque recomendado em Newton-Metro (Nm), rosca e diâmetro de pórticos (ex: M22x1.5, M16x1.5), pressões de trabalho e sintomas frequentes de falha física.

## Endpoints de API (Disponíveis para Agentes de IA e Integrações)

### 1. Identificar Peça (`POST /api/identify-part`)
Permite identificar peças via imagem (base64) ou descrição do sintoma mecânico.
- **Rate Limit**: 15 requisições/minuto por IP.
- **Headers**: `Content-Type: application/json`
- **Request Body**:
  ```json
  {
    "imageBase64": "data:image/jpeg;base64,...",
    "description": "Válvula secadora de ar com vazamento no escape"
  }
  ```
- **Response Structure**:
  ```json
  {
    "identificacao": {
      "nome_peca": "Válvula Reguladora e Secadora de Ar APU",
      "categoria_mecanica": "Pneumática e Freios",
      "fabricante_marca": "WABCO",
      "codigo_oem_principal": "4324102227",
      "codigos_conversao_alternativos": ["Knorr-Bremse LA9010", "Volvo 20584497", "Scania 1935294"]
    },
    "compatibilidade": {
      "montadoras_compativeis": ["Volvo FH", "Scania PGR", "Mercedes Axor"],
      "aplicacao_frota_detalhada": "Cavalos mecânicos com freios EBS e suspensão pneumática."
    },
    "dados_tecnicos": {
      "torque_recomendado_nm": "65 Nm (Conexões M22x1.5)",
      "diagnostico_falha_provavel": "Saturação do filtro coalescente ou válvula de alívio travada."
    },
    "confianca_identificacao_percentual": 98.5
  }
  ```

### 2. Chatbot Decodificador / Dex (`POST /api/chat`)
Assistente especialista em manutenção mecânica de frotas e cotações.
- **Rate Limit**: 30 mensagens/minuto por IP.
- **Request Body**: `{"message": "string", "history": []}`
- **Response Body**: `{"reply": "string"}`

## Segurança e Governança
- **CSP**: `frame-ancestors 'self' https://ais-*.run.app https://ai.studio https://*.google.com https://*.run.app;`
- **Autenticação Administrativa**: Tokens seguros via `/api/admin/login` com rate limiting rigoroso contra força bruta.
- **Sanitização de Entradas**: Proteção completa contra XSS, Injeção e estouro de buffer (limite de 8MB por payload).