refactor(backend): Split main.py into modular route files

[DevanshuNEU]

Summary

Refactors the monolithic main.py (826 lines) into modular route files for better maintainability and separation of concerns.

Closes #52

Changes

New Files

File	Lines	Purpose
dependencies.py	52	Shared service instances and helper functions
routes/health.py	17	Health check endpoint
routes/playground.py	150	Demo/playground endpoints (no auth)
routes/repos.py	218	Repository CRUD + WebSocket indexing
routes/search.py	92	Search and explain endpoints
routes/analysis.py	134	Dependency graph, impact analysis, insights
routes/api_keys.py	59	API key management + metrics

Refactored

• main.py: 826 → 105 lines (87% reduction)
  • Now contains only: app setup, middleware, router includes, error handlers

Updated Tests

• Updated imports from main to dependencies and routes.repos
• All 49 tests passing ✅

Architecture

backend/
├── main.py              # App setup, middleware, router orchestration
├── dependencies.py      # Singleton services, shared helpers
└── routes/
    ├── health.py        # GET /health
    ├── auth.py          # /api/auth/* (existing)
    ├── playground.py    # /api/playground/*
    ├── repos.py         # /api/repos/*
    ├── search.py        # /api/search, /api/explain
    ├── analysis.py      # /api/repos/{id}/dependency-graph, etc.
    └── api_keys.py      # /api/keys/*, /api/metrics

Testing

• All 49 backend tests pass
• App imports and starts successfully
• All 19 endpoints verified via Swagger UI
• Docker build succeeds

Notes

• No API changes - all endpoints remain at same paths
• API versioning (/api/v1/) will be addressed in feat(backend): Add API versioning (/api/v1/) #55

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Preview	Comments	Updated (UTC)
opencodeintel	Ignored	Preview		Dec 8, 2025 5:53am