How sanjayvasudevan-c/java-project works
SwarmCron is a local-first peer-to-peer cron scheduler. Jobs are configured or edited through the API, replicated in a CRDT registry, assigned through a membership-driven hash ring, scheduled and executed with leases/retries, and recorded for crash recovery. Nodes discover peers through SWIM gossip and elect a leader for fencing tokens; each node also serves a live dashboard. The graph reflects README capabilities and shown source references; unsampled wiring is omitted or marked unverified.
Main entry points: Main.java Node bootstrap · JobExecutor.java Job executor · Membership.java Membership table · HttpApiServer.java HTTP API server
Components 21
Startup and configuration
- Node bootstrap
src/com/swarmcron/Main.java - Node config
src/com/swarmcron/config/ConfigParser.java - Job specification
src/com/swarmcron/config/JobSpec.java
Cluster coordination
- SWIM failure detection
src/com/swarmcron/cluster/FailureDetector.java - Membership table
src/com/swarmcron/cluster/Membership.java - Gossip engine
src/com/swarmcron/cluster/GossipEngine.java - Peer transport
src/com/swarmcron/net/UdpTransport.java - Ownership ring
src/com/swarmcron/hash/RingManager.java - Leader election
src/com/swarmcron/election/RaftLite.java
Job lifecycle
- Job CRDT registry
src/com/swarmcron/state/JobRegistry.java - Registry sync
src/com/swarmcron/state/AntiEntropySync.java - Cron scheduling
src/com/swarmcron/schedule/CronExpression.java - Timer wheel
src/com/swarmcron/schedule/TimerWheel.java - Job executor
src/com/swarmcron/exec/JobExecutor.java - Process runner
src/com/swarmcron/exec/ProcessRunner.java
Durability
- Write-ahead log
src/com/swarmcron/store/WriteAheadLog.java - Crash recovery
src/com/swarmcron/store/Recovery.java
HTTP interface
- HTTP API server
src/com/swarmcron/http/HttpApiServer.java - Live dashboard
src/com/swarmcron/http/DashboardPage.java - Event stream
src/com/swarmcron/http/SseHub.java
Other components
- Operator
Connections 29
- Operator → Node bootstrap: starts node
README.md - Node bootstrap → Node config: loads config
src/com/swarmcron/Main.java - Node bootstrap → Job specification: loads seed jobs
src/com/swarmcron/Main.java - Node bootstrap → SWIM failure detection: starts detector
src/com/swarmcron/Main.java - Node bootstrap → Membership table: starts membership
src/com/swarmcron/Main.java - Node bootstrap → Gossip engine: starts gossip
src/com/swarmcron/Main.java - Node bootstrap → Leader election: starts election
src/com/swarmcron/Main.java - Node bootstrap → Job executor: starts executor
src/com/swarmcron/Main.java - Node bootstrap → Ownership ring: starts ring
src/com/swarmcron/Main.java - SWIM failure detection → Membership table: updates states
src/com/swarmcron/cluster/FailureDetector.java - SWIM failure detection → Peer transport: sends probes
src/com/swarmcron/cluster/FailureDetector.java - Gossip engine → Membership table: exchanges updates
src/com/swarmcron/cluster/GossipEngine.java - Ownership ring → Membership table: reads alive nodes
src/com/swarmcron/hash/RingManager.java - Ownership ring → Membership table: listens for changes
src/com/swarmcron/hash/RingManager.java - Leader election → Membership table: reads voters
src/com/swarmcron/election/RaftLite.java - Leader election → Peer transport: sends vote messages
src/com/swarmcron/election/RaftLite.java - Operator → HTTP API server: manages jobs
README.md - HTTP API server → Live dashboard: serves page
src/com/swarmcron/http/HttpApiServer.java - HTTP API server → Event stream: streams events
src/com/swarmcron/http/HttpApiServer.java - HTTP API server → Job CRDT registry: reads and edits jobs
src/com/swarmcron/http/HttpApiServer.java - Job CRDT registry → Registry sync: syncs peer state
src/com/swarmcron/state/AntiEntropySync.java - Job executor → Job CRDT registry: reads job state
src/com/swarmcron/exec/JobExecutor.java - Job executor → Ownership ring: checks ownership
src/com/swarmcron/exec/JobExecutor.java - Job executor → Leader election: requests fencing
src/com/swarmcron/exec/JobExecutor.java - Job executor → Cron scheduling: calculates next fire
src/com/swarmcron/exec/JobExecutor.java - Job executor → Timer wheel: schedules jobs
src/com/swarmcron/exec/JobExecutor.java - Job executor → Process runner: launches command
src/com/swarmcron/exec/JobExecutor.java - Job executor → Write-ahead log: records runs
src/com/swarmcron/exec/JobExecutor.java - Crash recovery → Write-ahead log: replays records
src/com/swarmcron/store/Recovery.java