Plan out system architecture #13

Merged
tepichord merged 3 commits from feat/6-plan-out-system-architecture into main 2026-08-18 23:48:05 -07:00
Owner

Closes #6

Automated PR created by forgejo-done adapter.

Closes #6 Automated PR created by forgejo-done adapter.
- Create ARCHITECTURE.md with worker node sizing, simulation pod scaling,
  pod topology, resource budget, and runtime considerations
- Recommend hybrid approach: 1×20 GB on naina, 1×7 GB on ida
- Recommend Strategy C (KEDA with queue depth + resource guardrails),
  include Strategy A as alternative
- Add topology diagram, resource budget math, and Godot/Unreal comparison
- Reference ARCHITECTURE.md from README.md and PLAN.md

Refs: #6
tepichord left a comment
Author
Owner

Work needed

Work needed
@ -0,0 +16,4 @@
|--------|-------------|----------------|------|------|
| Many small workers | 24 GB VMs, one per application | ~300400 MB × N nodes | Strong isolation, independent upgrades, fault containment | High cumulative overhead, fragmented resources, more nodes to manage |
| Few large workers | 1220 GB VMs, multi-tenant | ~300400 MB × 2 | Low overhead, efficient packing, simpler operations | Blast radius larger, resource contention between workloads |
| **Hybrid (recommended)** | 1×20 GB on naina, 1×7 GB on ida | ~700 MB total | Balances isolation and efficiency; simulation workloads get a dedicated node | Slightly more complex topology; ida worker is single-purpose |
Author
Owner

This change is solely considering the hybrid strategy, remove the others.

This change is solely considering the hybrid strategy, remove the others.
tepichord marked this conversation as resolved
ARCHITECTURE.md Outdated
@ -0,0 +85,4 @@
- Requires RabbitMQ HTTP management endpoint exposure
- More moving parts than fixed-count approach
### Fixed Pod Count with Self-Limiting Simulations (Alternative)
Author
Owner

Remove the fixed pod count consideration.

Remove the fixed pod count consideration.
tepichord marked this conversation as resolved
tepichord added this to the MVP project 2026-08-18 23:17:33 -07:00
- Remove 'Many small workers' and 'Few large workers' rows from worker
  node sizing table, keeping only the recommended hybrid approach
- Remove 'Fixed Pod Count with Self-Limiting Simulations' subsection
  from simulation pod scaling
- Update introductory prose to describe only the selected strategies

Addresses review comments #6946 and #6947.
tepichord deleted branch feat/6-plan-out-system-architecture 2026-08-18 23:48:05 -07:00
tepichord referenced this pull request from a commit 2026-08-18 23:48:07 -07:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
tepichord/milner!13
No description provided.