refactor: resolve pylint errors and warnings across api and src routers

chore: codebase audit and fixes (ruff, mypy, pytest)

Fix codebase issues: linting, types, tests, and security.

Refactor: Improve code quality, security, and configuration

docs: update all documentation to reflect current codebase state

refactor: major repository cleanup and bug fixes