docs: enhance README.md with comprehensive project documentation

[VolodymyrBg]

This PR:

• Enhances the README.md with comprehensive project documentation
• Adds clear project overview and feature list
• Includes detailed project structure information
• Provides usage examples with code snippets
• Improves benchmarks section with interpretation guidelines
• Adds contributing guidelines and contact information

This PR does not:

• Add any new functionality to the codebase
• Modify any implementation details
• Change any existing code behavior

Key places to review:

• README.md - All sections, with particular attention to:
  • Project Overview section
  • Usage Examples section
  • Benchmarks section

[x] Issue linked or PR description mentions why this change is necessary.
[x] PR description is clear enough for reviewers.
[x] Documentation for changes (additions) has been updated (added).
[x] If this is a draft it is marked as "draft".