How whyour/qinglong works
Qinglong is a web-based timed-task management platform for Python, JavaScript, Shell, and TypeScript scripts. Users manage scripts, environment variables, configuration, and scheduled tasks in the web panel, then inspect task logs and system status; scheduled work is executed by the backend. The repository also provides a remote CLI for managing panel resources and tasks. The tree and README establish these product areas, but sampled source is limited, so links between backend subsystems are shown only where their ownership is reasonably clear.
Main entry points: index.ts API routes · pages Management pages · app.ts Web application · http.tsx HTTP client
Components 25
Web panel
- Web application
src/app.ts - Management pages
src/pages - HTTP client
src/utils/http.tsx
Backend services
- API routes
back/api/index.ts - Task API
back/api/cron.ts - Script API
back/api/script.ts - Environment API
back/api/env.ts - Subscription API
back/api/subscription.ts - Open API
back/api/open.ts - System APIs
back/api/system.ts - Task services
back/services/cron.ts - Script services
back/services/script.ts - Subscription services
back/services/subscription.ts - Runtime data
back/data/index.ts - Database
back/bootstrap/database.ts
Task execution
- Scheduler
back/services/schedule.ts - Cron runner
back/shared/runCron.ts - Script runner
cli/src/internal/execution/runner.ts - Task logs
back/shared/logReader.ts
Remote CLI
- Remote commands
cli/src/entrypoints/remote.ts - Command dispatch
cli/src/remote/commands/dispatch.ts - Remote API client
cli/src/remote/api/client.ts
Other components
- Panel operator
- Remote CLI user
- Panel API
Connections 22
- Panel operator → Web application: uses
- Web application → Management pages: renders
- Management pages → HTTP client: requests
- HTTP client → API routes: calls
- API routes → Task API: dispatches
- API routes → Script API: dispatches
- API routes → Environment API: dispatches
- API routes → Subscription API: dispatches
- API routes → Open API: dispatches
- API routes → System APIs: dispatches
- Task API → Task services: handles
- Script API → Script services: handles
- Subscription API → Subscription services: handles
- Task services → Runtime data: uses
- Scheduler → Cron runner: runs
- Cron runner → Script runner: executes
- Remote CLI user → Remote commands: invokes
- Remote commands → Command dispatch: dispatches
- Command dispatch → Remote API client: calls
- Remote API client → Panel API: requests
- Panel API → API routes: serves
- Management pages → Task logs: views logs