docs(readme): align structure and update prose

[nanotaboada]

Summary

• Fixed Codecov badge URL (branch/master/)
• Rewrote Architecture prose: injection framing, removed academic UML references, trimmed subsections
• Unified Legal wording

Test plan

• README renders correctly on GitHub
• Table of Contents anchors resolve correctly
• Mermaid diagram renders

🤖 Generated with Claude Code

Summary by CodeRabbit

• Documentation
  • Updated Codecov badge to show branch-specific coverage metrics.
  • Revised architecture and guidance content: clarified arrow semantics and dependency notation; tightened explanations for composition root, layered architecture, models, and color coding; and refined legal/disclaimer wording.

[coderabbitai]

Walkthrough

Updated README documentation: adjusted the Codecov badge URL to a branch-specific path and revised several architecture explanation sections (Arrow Semantics, Composition Root Pattern, Layered Architecture, Models, Color Coding) and the Legal disclaimer wording.

Changes

Cohort / File(s)	Summary
Documentation README.md	Updated Codecov badge image URL to include /branch/master/graph/; rewrote multiple architecture explanation sections (Arrow Semantics, Composition Root Pattern, Layered Architecture, Models, Color Coding) for concise wording; tweaked Legal disclaimer phrasing.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

• docs(readme): update architecture diagram and add explanatory text #413 — Similar README architecture documentation edits (Arrow Semantics, Composition Root, Layered Architecture, Color Coding).
• chore: update status badges #186 — Similar changes to README badge/coverage URL handling.

🚥 Pre-merge checks | ✅ 2

✅ Passed checks (2 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Title check	✅ Passed	The title follows Conventional Commits format (docs:), is under 80 characters (46 chars), and is descriptive, though it focuses on prose updates rather than the primary objective of fixing the Codecov badge URL.

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

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/fix-codecov-badge

• 🛠️ sync documentation: Commit on current branch
• 🛠️ sync documentation: Create PR
• 🛠️ enforce http error handling: Commit on current branch
• 🛠️ enforce http error handling: Create PR
• 🛠️ idiomatic review: Commit on current branch
• 🛠️ idiomatic review: Create PR
• 🛠️ verify api contract: Commit on current branch
• 🛠️ verify api contract: Create PR

---

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.}

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud