docs: add comprehensive project documentation

- Complete README with installation and usage instructions
- Architecture overview and best practices
- API documentation and examples
- Contributing guidelines and development standards
- Professional documentation for technical assessment

Author: lucasleandro1