How maheeth07/lucge works
LUCG appears to provide a web interface and REST API for running submitted code in language-specific Docker environments. The documented execution path accepts a request, checks its API key and daily usage, queues a job, runs it in a worker, and returns the result. The UI also presents key generation, feature information, and API documentation. The README contains no usable product detail, so the map relies on the sampled source and source index; some frontend-to-backend wiring and database connectivity remain unverified.
Main entry points: App.jsx Page composition · executionService.js Language dispatch · executionController.js Execution handler · index.js HTTP server
Components 26
Web interface
- Page composition
frontend/src/App.jsx - Navigation
frontend/src/components/Navbar.jsx - Hero section
frontend/src/components/Hero.jsx - Feature overview
frontend/src/components/Features.jsx - Key generator UI
frontend/src/components/GenerateKey.jsx - API documentation
frontend/src/components/Docs.jsx - Code examples
frontend/src/components/CodeBlock.jsx - Page footer
frontend/src/components/Footer.jsx
API backend
- HTTP server
backend/index.js - Key route
backend/routes/keyRoutes.js - Execution route
backend/routes/executionRoutes.js - Key generation
backend/controllers/apikey.js - Execution handler
backend/controllers/executionController.js
Execution runtime
- Queue worker
backend/worker.js - Language dispatch
backend/services/executionService.js - Docker runtime
- C++ runner image
backend/Docker/cpp/Dockerfile - Java runner image
backend/Docker/Java/Dockerfile - JavaScript runner image
backend/Docker/Js/Dockerfile - Python runner image
backend/Docker/python/Dockerfile
State and queues
- API key model
backend/models/Key.js - Execution model
backend/models/Execution.js - Database connection
backend/config/db.js - Redis connection
backend/config/redis.js - Job queue
backend/queue.js
Other components
- API user
Connections 28
- API user → Page composition: opens interface
- Page composition → Navigation: renders
frontend/src/App.jsx - Page composition → Hero section: renders
frontend/src/App.jsx - Page composition → Feature overview: renders
frontend/src/App.jsx - Page composition → Key generator UI: renders
frontend/src/App.jsx - Page composition → API documentation: renders
frontend/src/App.jsx - Page composition → Page footer: renders
frontend/src/App.jsx - API documentation → Code examples: renders examples
frontend/src/components/Docs.jsx - API user → HTTP server: submits requests
- HTTP server → Key route: mounts route
backend/index.js - HTTP server → Execution route: mounts route
backend/index.js - HTTP server → Database connection: connects database
backend/index.js - Key route → Key generation: routes to
backend/routes/keyRoutes.js - Execution route → Execution handler: routes to
backend/routes/executionRoutes.js - Key generation → API key model: saves key
backend/controllers/apikey.js - Execution handler → API key model: validates key
backend/controllers/executionController.js - Execution handler → Redis connection: counts usage
backend/controllers/executionController.js - Execution handler → Job queue: enqueues job
backend/controllers/executionController.js - Execution handler → Job queue: waits for result
backend/controllers/executionController.js - Queue worker → Redis connection: uses connection
backend/worker.js - Queue worker → Language dispatch: dispatches execution
backend/worker.js - Job queue → Redis connection: uses connection
backend/queue.js - Job queue → Queue worker: delivers jobs
- Language dispatch → Docker runtime: runs container
backend/services/executionService.js - Language dispatch → C++ runner image: selects image
backend/services/executionService.js - Language dispatch → Java runner image: selects image
backend/services/executionService.js - Language dispatch → JavaScript runner image: selects image
backend/services/executionService.js - Language dispatch → Python runner image: selects image
backend/services/executionService.js