docs: enhance README with badges, TOC, Swagger/OpenAPI documentation
- Add shields.io badges for Python, FastAPI, License, Coverage, Tests
- Add Table of Contents for easy navigation
- Add Quick Start section with Docker
- Enhance OpenAPI documentation in main.py with detailed description
- Add VERIFICA_PROGETTO.md with complete PRD compliance report
- Update all API documentation links (Swagger UI, ReDoc, OpenAPI)
- Add API usage examples with curl commands
- Add client generation instructions