docs: README em tom mais direto e profissional

[thomasmoreira]

Reescrita do README sem o tom de pitch/mentor. Conteúdo técnico inalterado.

Summary by CodeRabbit

Release Notes

• Documentation
  • Reorganized and expanded documentation to better present distributed consistency pattern implementations
  • Enhanced guarantees section with detailed testing scenarios and broker resilience simulations
  • Clarified setup and execution instructions with improved guidance
  • Added architectural decision references for better understanding

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: ecab1378-d0ab-4e5d-a0e7-ca255c9cb405

📥 Commits

Reviewing files that changed from the base of the PR and between 0003bf1 and d93a92f.

📒 Files selected for processing (1)

• README.md

---

📝 Walkthrough

Walkthrough

README.md was restructured to emphasize the lab's hand-built Transactional Outbox, Inbox, and Saga implementations on RabbitMQ/PostgreSQL. The narrative now leads with distributed consistency patterns, broker-failure resilience testing, updated test execution guidance, and reorganized architecture decision records.

Changes

Documentation Refresh for Distributed Consistency Lab

Layer / File(s)	Summary
Introduction and problem statement README.md	Introductory narrative reworked to establish the lab's focus on hand-built implementation of Outbox, Inbox idempotent consumption, and Saga with compensation on RabbitMQ and PostgreSQL, including the dual-write anti-pattern and checkout flow example.
Architecture explanation and saga flow README.md	Service table and saga-flow description updated with clearer framing of RabbitMQ event paths and component interactions.
Testing and guarantees documentation README.md	"Garantias provadas" section replaced with restructured "Garantias e testes" section featuring a refreshed guarantees table, explicit broker outage simulation guidance (docker pause/unpause), and clarified Testcontainers per-test isolation and sequential execution instructions.
Project structure and architecture decisions README.md	Integration folder description expanded and ADR list wording refined (ADR-004 label updated) while preserving all ADR-001 through ADR-006 link targets.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~5 minutes

Poem

📚 A README grows with clearer grace,
Outbox, Inbox, Saga find their place,
When brokers pause, the tests still dance,
Hand-built patterns at a glance! 🐇

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The PR title accurately describes the main change: rewording README in a more direct and professional tone, which aligns with the raw summary showing README restructuring and rephrasing.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/readme-tom-humano

Warning

Review ran into problems

🔥 Problems

Git: Failed to clone repository. Please run the @coderabbitai full review command to re-trigger a full review. If the issue persists, set path_filters to include or exclude specific files.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}