docs: rewrite README for clarity

- Clear Quick Start section with numbered steps
- Comprehensive Repository API reference
- All Where conditions documented
- Entity definition patterns (minimal, with constructor, manual)
- Spring Boot integration example
- Structured for both developers and AI agents

Author: HansOspina