How shivaa-rana/buildqueue works
BuildQueue combines two products: BuildQueue Live runs real file-checksum batches through a desktop UI, while the original application provides a deterministic scheduling and resource simulation through CLI and HTTP/dashboard interfaces. The simulation coordinator owns dispatch and resource admission; the Live batch queue owns real checksum-job scheduling. Edges are limited to excerpted relationships and README statements; the browser-to-server link is marked unverified because its wiring was not shown.
Main entry points: BuildQueueEngine.cpp Tick coordinator · app.js Dashboard · BatchQueue.cpp Batch queue · main.cpp Qt desktop
Components 22
BuildQueue Live
- Qt desktop
live/desktop/main.cpp - Batch queue
live/src/BatchQueue.cpp - Checksum worker
live/src/Checksum.cpp - Buffer pool
live/include/BufferPool.hpp - Deadlock detector
live/src/DeadlockDetector.cpp - Live web client
live/web/js/app.js
Simulation engine
- Tick coordinator
src/BuildQueueEngine.cpp - Job state
src/JobManager.cpp - Policy scheduler
src/SchedulerEngine.cpp - Memory allocator
src/MemoryManager.cpp - Slot admission
src/SyncController.cpp
User interfaces
- CLI
src/CLI.cpp - HTTP server
src/HttpServer.cpp - Dashboard
web/js/app.js - Browser API client
web/js/api.js - Charts and views
web/js/charts.js - UI components
web/js/components.js - Data exports
web/js/exports.js
Runtime services
- Worker pool
src/WorkerManager.cpp - Metrics
src/MonitoringEngine.cpp - Execution log
src/Logger.cpp
Other components
- Operator
Connections 22
- Operator → Qt desktop: submits files
README.md - Qt desktop → Batch queue: controls batches
live/desktop/main.cpp - Batch queue → Checksum worker: runs checksums
- Checksum worker → Buffer pool: streams through
- Batch queue → Deadlock detector: checks deadlocks
- Operator → Live web client: submits files
README.md - Tick coordinator → Job state: manages jobs
- Tick coordinator → Policy scheduler: orders dispatch
- Tick coordinator → Memory allocator: allocates memory
src/BuildQueueEngine.cpp - Tick coordinator → Slot admission: acquires slots
src/BuildQueueEngine.cpp - Tick coordinator → Worker pool: submits work
src/BuildQueueEngine.cpp - Tick coordinator → Metrics: computes metrics
- Tick coordinator → Execution log: records events
- Operator → CLI: issues commands
README.md - Operator → Dashboard: uses dashboard
README.md - CLI → Tick coordinator: controls runs
- HTTP server → Tick coordinator: serves operations
- Dashboard → Browser API client: requests data
web/js/app.js - Browser API client → HTTP server: calls endpoints
- Dashboard → Charts and views: renders charts
web/js/app.js - Dashboard → UI components: renders controls
web/js/app.js - Dashboard → Data exports: exports comparisons
web/js/app.js