# Genesis Radio Internal Architecture Map

---

## 🏢 Core Infrastructure

| System | Purpose | Location |
|:---|:---|:---|
| Krang | Main admin server / script runner / monitoring node | On-premises / VM |
| SPL Server (Windows) | StationPlaylist Studio automation and playout system | On-premises / VM |
| Shredder | MinIO Object Storage / Cache server | On-premises / VM |
| PostgreSQL Cluster (db1/db2) | Mastodon database backend / Other app storage | Clustered VMs |
| Mastodon Server | Frontend social interface for alerts, community | Hosted at `chatwithus.live` |

---

## 🧠 Automation Components

| Component | Description | Hosted Where |
|:---|:---|:---|
| `mount_guardian.ps1` | Automatically ensures Rclone mounts (Q:\ and R:\) are up | SPL Server (Windows) |
| `rotate_mount_logs.ps1` | Weekly log rotation for mount logs | SPL Server (Windows) |
| `healthcheck.py` | Multi-node health and service monitor | Krang |
| Mastodon DM Alerts | Immediate alerting if something breaks (Mounts, Services) | Krang via API |
| Genesis Mission Control Landing Page | Web dashboard with Commandments + Live Healthcheck | Hosted on Krang's Nginx |

---

## 🎙️ Storage and Streaming

| Mount | Purpose | Backed by |
|:---|:---|:---|
| Q:\ (Assets) | Station IDs, sweepers, intro/outros, promos | GenesisAssets Bucket (Rclone) |
| R:\ (Library) | Full music library content | GenesisLibrary Bucket (Rclone) |

✅ Primary Cache: `L:\` (SSD)  
✅ Secondary Cache: `X:\` (Spinning HDD)

---

## 📡 Communications

| Alert Type | How Sent |
|:---|:---|
| Mount Failures | Direct Mastodon DM |
| Healthcheck Failures (Disk, Service, SMART, RAID) | Direct Mastodon DM |
| Git Push Auto-Retry Failures (optional future upgrade) | Potential Mastodon DM |

---

## 📋 GitOps Flow

| Step | Script | Behavior |
|:---|:---|:---|
| Save changes | giteapush.sh | Auto stage, commit (timestamped), push to Gitea |
| Retry failed push | giteapush.sh auto-retry block | Up to 3x tries with 5-second gaps |
| Repo status summary | giteapush.sh final step | Clean `git status -sb` displayed |

✅ Follows GROWL commit style:  
Good, Readable, Obvious, Well-Scoped, Logical.

---

## 📜 Policies and Procedures

| Document | Purpose |
|:---|:---|
| `OPS.md` | Healthcheck Runbook and Service Recovery Instructions |
| `GROWL.md` | Git Commit Message Style Guide |
| `Mission Control Landing Page` | Browser homepage with live dashboard + ops philosophy |

---

## 🛡️ Key Principles

- Calm is Contagious.
- Go Slow to Go Fast.
- Snappy Snaps Save Lives.
- Scripts are Smarter Than Sleepy Admins.
- If You Didn't Write It Down, It Didn't Happen.

---

# 🎙️ Genesis Radio Ops  
Built with pride. Built to last. 🛡️🚀