Redesign of the current UI

[Thanas-R]

📌 Description

This PR replaces the default Swagger UI documentation page at / with a custom, lightweight, and modern interactive API Explorer (app/playground.py).

• What is the purpose of this PR?
  Provide an interactive playground where developers can inspect endpoint parameters, view schema responses, and test live API endpoints directly from the browser with preloaded documentation and curl examples.

• What features does it add?

  • Interactive request runner with customizable parameters, headers, and body.
  • Native System / Light / Dark theme switcher with local storage persistence.
  • Interactive cursor-tracking dot-grid spotlight canvas.
  • Preloaded endpoint documentation and markdown explanations generated from the local OpenAPI schema (no external services or AI dependencies).
  • Clean, minimal aesthetic with zero changes to backend authentication, metrics, or scraping logic.

ℹ️ Fixes / Related Issues
Fixes: #
Related: #

🧱 Type of Change

• 🐛 Bug fix – Non-breaking fix for a functional/logic error
• ✨ New feature – Adds functionality without breaking existing APIs
• ⚠️ Breaking change – Introduces backward-incompatible changes (API, schema, etc.)
• 📝 Documentation update – README, docstrings, OpenAPI tags, etc.
• 🧪 Test suite change – Adds/updates unit, functional, or integration tests
• ⚙️ CI/CD pipeline update – Modifies GitHub Actions, pre-commit, or Docker build
• 🧹 Code quality / Refactor – Improves structure, readability, or style (no functional changes)
• 🐢 Performance improvement – Speeds up auth, scraping, or reduces I/O
• 🕵️ Debug/logging enhancement – Adds or improves logging/debug support
• 🔧 Developer tooling – Scripts, benchmarks, local testing improvements
• 🔒 Security fix – Addresses auth/session/data validation vulnerabilities
• 🧰 Dependency update – Updates libraries in pyproject.toml, uv.lock

🧪 How Has This Been Tested?

• Unit Tests (tests/unit/test_playground.py, tests/unit/test_openapi_docs.py)
• Functional Tests (tests/functional/)
• Integration Tests (tests/integration/)
• Manual Testing (verified in browser across light, dark, and system themes, responsive viewports, and live request execution)

⚙️ Test Configuration:

• OS: Windows
• Python: 3.14 (or 3.12+)
• Browser testing across Light and Dark themes

✅ Checklist

• My code follows the CONTRIBUTING.md guidelines
• I've performed a self-review of my changes
• I've added/updated necessary comments and docstrings
• I've updated relevant docs (README or endpoint docs)
• No new warnings introduced
• I've added tests to cover my changes
• All tests pass locally (scripts/run_tests.py / pytest tests/unit/)
• I've run linting and formatting (pre-commit run --all-files)
• Docker image builds and runs correctly
• Changes are backwards compatible (if applicable)
• Feature flags or .env vars updated (if applicable)
• I've tested across multiple environments (if applicable)
• Benchmarks still meet expected performance (scripts/benchmark/benchmark_requests.py)

🛠️ Affected API Behaviour

• app/playground.py – UI redesign for the interactive API explorer
• app/app.py – Mounted custom explorer at / while keeping backend routes untouched

🧩 Models

• app/models/request.py – Input validation or request schema changes
• app/models/response.py – Authentication response formatting
• app/models/profile.py – Profile extraction logic

🐳 DevOps & Config

• Dockerfile – Changes to base image or build process
• .github/workflows/*.yml – CI/CD pipeline or deployment updates
• pyproject.toml / uv.lock – Dependency version changes
• .pre-commit-config.yaml – Linting or formatting hook changes

📊 Benchmarks & Analysis

• scripts/benchmark/benchmark_requests.py – Performance or latency measurement changes
• scripts/benchmark/analyze_benchmark.py – Benchmark result analysis changes
• scripts/run_tests.py – Custom test runner logic or behavior updates

📸 Screenshots / API Demos (if applicable)

Light Theme

Dark Theme

🧠 Additional Notes (if applicable)

• Backend authentication logic, rate limiting, and endpoints remain 100% untouched.
• The explorer operates purely on the client side using the local /openapi.json spec with no external tracking or third-party AI services.

[achyu-dev]

Revert this, this will be handled anyway in migration PR

[Thanas-R]

Oh alr, will revert

[achyu-dev]

what is this change?

[Thanas-R]

Ahh not really sure, i had by mistake deleted that line, so typed it back and must gave given a new line space, will revert this issue too