Reduzir densidade do README e criar um caminho de onboarding mais curto

[rodri-oliveira-dev]

Parent roadmap: rodri-oliveira-dev/rodri-oliveira-dev#30

Contexto

O README contém documentação técnica rica, porém acumula onboarding, contrato público, arquitetura, garantias, observabilidade, extensibilidade e manutenção em um único fluxo longo.

A meta não é remover profundidade, e sim permitir que um consumidor entenda e experimente a biblioteca rapidamente antes de entrar nos detalhes.

Escopo

• Preservar no README principal:
  • propósito e problema;
  • garantias e limites essenciais;
  • instalação;
  • Quick Start executável;
  • exemplo mínimo de DI/dispatcher;
  • links claros para documentação aprofundada.
• Mover ou consolidar detalhes extensos em docs/ quando já existir local adequado:
  • modelo de entrega e leases;
  • retry/classificação;
  • segurança/assinatura;
  • observabilidade;
  • implementação de stores;
  • operação em produção;
  • extensibilidade.
• Criar uma pequena seção "Read next" / "Documentation map".
• Não esconder a garantia at-least-once nem sugerir exactly-once.
• Manter explícito que durabilidade real depende de store durável fornecido/configurado pelo consumidor.

Definition of Done

• Novo usuário encontra propósito, instalação e primeiro exemplo sem percorrer documentação interna extensa.
• Quick Start continua compilável/coerente com a API publicada.
• Garantias e limites essenciais permanecem visíveis no README.
• Conteúdo movido fica acessível por links claros em docs/.
• Não há duplicação conflitante entre README e docs.
• README PT-BR/EN permanecem factualmente equivalentes, se ambos forem mantidos.
• Links e snippets relevantes são validados.
• CI permanece verde.

[rodri-oliveira-dev]

Implementação preparada no PR #70.

Principais ajustes:

• README EN/PT-BR reduzidos para um onboarding curto;
• garantias at-least-once e dependência de store durável mantidas explícitas;
• Quick Start alinhado à API pública v1.0.0 e sem dependência de hosting concreto;
• exemplo mínimo de DI/dispatcher preservado;
• documentação aprofundada consolidada via mapa de links para docs/ e sample.

Validações já concluídas com sucesso incluem restore, formatação, build, snapshot da API pública, sample end-to-end, SonarQube Cloud e Dependency Review. As demais checks do PR seguem executando.

[rodri-oliveira-dev]

Validação final concluída no PR #70: CI, Release dry-run, CodeQL, Dependency Review e SonarQube Cloud estão verdes. O Definition of Done da issue está atendido.