Mapa de cross-repos — peças transversais
Esta página mapeia onde vivem as peças transversais que o produto NFS-e Inbound depende mas não implementa. Use como referência rápida quando precisar consultar contrato técnico, abrir ticket no time certo, ou linkar issue.
Sumário
Tabela de cross-repos
| Concern | Lives in | Canonical doc |
|---|---|---|
Webhook HMAC validation (x-hub-signature) | nfe/shared-webhook-api | docs/webhook-signature-validation.md |
| Polling DFe via ADN (NSU, polling ~30s) | nfe/dfetech-distribution-api | docs/01-doc-tecnica-equipe-dev.md (interno) |
| Signed URLs para XML/PDF (TTL 30min) | nfe/dfetech-distribution-api | docs/02-doc-tecnica-clientes-dev-nfse-inbound-api.md §11 |
| API Key & JWT auth | TODO — confirmar repo de identity | — |
| Rate limiting & circuit breaker | nfe/dfetech-distribution-api | docs/01-doc-tecnica-equipe-dev.md §6 |
| Bulk export pipeline (XML/PDF/CSV) | nfe/shared-usage-api | docs internos do shared-usage-api |
Como usar este mapa
- Precisa validar HMAC no seu endpoint? Vá ao
shared-webhook-api, não tente reimplementar a partir desta doc. - Precisa entender por que o polling é ~30s ou como o circuit breaker dispara?
dfetech-distribution-apitem o contrato canônico. - Precisa gerar bulk export (ZIPs de XML/PDF ou CSV analítico)? O endpoint é no
shared-usage-api— veja Como fazer: Bulk export.