🔧 Build & Development Commands

• Always use python -m venv to create virtual environments.
• Always install dependencies using pip install -r requirements.txt.
• If docker-compose.yml is present, prefer containerized execution.

🧪 Testing Guidelines

• All features must be covered with pytest-based unit tests.
• Use assert expressions clearly, and test error conditions.
• Prefer requests_mock or FastAPI TestClient for API endpoints.

🎨 Code Style & Guidelines

• Use black for formatting and ruff for linting.
• Avoid wildcard imports and unused variables.
• Class names should use CamelCase, functions — snake_case.
• Avoid deeply nested logic (max 3 levels).