Home

🔧 Mecânica Hermes

Backend distribuído para gestão de uma oficina mecânica. Recebe veículos, monta orçamentos, recolhe a aprovação do cliente por e-mail/webhook, integra cobrança com Mercado Pago e devolve o carro ao cliente quando o pagamento é confirmado.

Projeto desenvolvido pelo grupo do Tech Challenge 13SOAT — FIAP.

Contexto em 1 diagrama

flowchart LR
  User([👤 Cliente / Atendente]):::actor
  MP([💳 Mercado Pago]):::ext
  SMTP([📧 SMTP]):::ext
  NR([📊 New Relic]):::ext

  subgraph Hermes[Mecânica Hermes]
    APIG[API Gateway + Cognito]
    Lambda[Lambda CognitoToken]
    OS[API Ordem de Serviço]
    Cad[API Cadastros]
    Pag[API Pagamentos]
  end

  User -->|HTTPS + JWT| APIG
  APIG --> Lambda
  APIG --> OS
  APIG --> Cad
  APIG --> Pag
  Pag <-->|preferences + webhook HMAC| MP
  Cad -->|orçamento + token webhook| SMTP
  Lambda -->|token JWT por e-mail| SMTP
  OS -.-> NR
  Cad -.-> NR
  Pag -.-> NR

  classDef actor fill:#2d6a4f,color:#fff
  classDef ext fill:#6c757d,color:#fff

Loading

Comece por aqui

Escolha a sua jornada:

Você é...	Comece por
🎓 Avaliador / banca FIAP	Para avaliadores → Tech Challenge — FIAP 13SOAT → Domínio de negócio → Arquitetura
👩‍💻 Dev novo no time	Para devs novos → Stack completa via Docker Compose → Componentes por serviço → Como contribuir
🛠️ Operador / SRE	Para operadores → Runbook macro → Observabilidade
🔌 Integrador externo	Para integradores externos → Autenticação Cognito + JWT → API pública

O que tem aqui

A Wiki está organizada em 13 seções (veja o menu lateral). As mais consultadas:

• 🏛️ Arquitetura — visão C4 do sistema e padrões transversais (Clean Architecture, SAGA, Outbox, State Pattern).
• 🔁 Fluxos de negócio — os 8 cenários cobertos pela suíte E2E, descritos passo a passo.
• 📂 Repositórios — os 9 repos do ecossistema, seus papéis e como se conectam.
• 📨 Catálogo de eventos — os 8 contratos .v1 que circulam no RabbitMQ.
• 🚨 Runbook macro — triagem inicial para incidentes cross-service.

Status do projeto

Serviço	Build / coverage
api-ordem-servico
api-cadastros
api-pagamentos
api-sdk

Cobertura mínima exigida pelo CI: ≥ 80% de linhas em todos os serviços .NET.

Sobre esta Wiki

Esta Wiki é mantida em arquivos Markdown versionados no repositório mecanica-hermes-docs, seguindo o plano editorial. Mudanças passam por Pull Request com revisão.

Última atualização: 2026-05-19