How juanpablojs1024/orbital-net works
Orbital Net simulates satellite and ground-station motion, derives changing visibility, and exposes that state to routing, communications, and the control-center UI. Users can create or remove nodes, inspect live topology and message logs, and send messages between nodes. Communications handles routing and congestion queues; storage persists message logs. The README also describes Kubernetes horizontal scaling. Service interactions follow the sampled entry points and documented responsibilities; implementation details not sampled are represented only where the README supports them.
Main entry points: server.go Simulation gRPC · cmd/main.go Communications gRPC · control-center-service/main.go HTTP API · cmd/main.go Pathfinder gRPC
Components 15
Simulation
- Simulation gRPC
services/sim-service/internal/server/server.go - Physics Loop
services/sim-service/cmd/main.go - Orbital Model
services/sim-service/internal/model - Simulation Contract
pkg/proto/sim/sim-service.proto
Routing
- Pathfinder gRPC
services/pathfinder-service/cmd/main.go - Network Graph
services/pathfinder-service/internal/model/graph.go
Messaging
- Communications gRPC
services/communications-service/cmd/main.go - Message Protocol
services/communications-service/internal/model - Pending Queue
services/communications-service/cmd/main.go - Storage gRPC
services/storage-service/cmd/main.go - Message Log
services/storage-service/cmd/main.go - Communications HPA
k8s/hpa-communications.yaml
Control Center
- Browser UI
services/control-center-service/web/index.html - HTTP API
services/control-center-service/main.go
Other components
- User
Connections 18
- User → Browser UI: uses
- Browser UI → HTTP API: HTTP requests
- HTTP API → Simulation gRPC: node commands
- Physics Loop → Orbital Model: ticks physics
- Simulation gRPC → Orbital Model: reads state
- Simulation gRPC → Simulation Contract: streams state
- Simulation gRPC → HTTP API: streams topology
- Simulation gRPC → Pathfinder gRPC: streams topology
- Simulation gRPC → Communications gRPC: streams topology
- HTTP API → Communications gRPC: sends messages
- Communications gRPC → Message Protocol: delegates delivery
- Communications gRPC → Pending Queue: queues overload
- Communications gRPC → Pathfinder gRPC: requests routes
- Message Protocol → Storage gRPC: persists messages
- HTTP API → Storage gRPC: requests logs
- Storage gRPC → Message Log: appends and reads
- Pathfinder gRPC → Network Graph: builds and queries
- Communications HPA → Communications gRPC: scales replicas