docs(python-sdk): major update to SDK documentation with new features and examples

- Add comprehensive environment variables documentation
- Document Flask and FastAPI framework support
- Enhance permissions, feature flags, and claims documentation
- Add Management API integration guide
- Update code examples with async/await patterns

Author: Brett Chaldecott