firefrost-gaming/firefrost-operations-manual
3
0
Fork 0
Code Issues 146 Pull Requests Packages Projects Releases Wiki Activity

Cleanup: Remove project-files/ (duplicates of docs/)

Browse Source
This commit is contained in:
mkrause612
2026-02-12 00:58:24 -06:00
parent da697c4671
commit 5bd1668962
1 changed files with 0 additions and 344 deletions
Download Patch File Download Diff File Expand all files Collapse all files

344
project-files/SANDBOX-BRIEFING.md
View File

@@ -1,344 +0,0 @@
# Firefrost Gaming: Complete Context for Gemini Exploration Sessions
**Last Updated:** February 10, 2026
**Version:** 2.1
**Purpose:** Sandbox briefing for exploratory AI sessions with Gemini
---
## CRITICAL: What This Document Is For
This is a **SANDBOX BRIEFING** for brainstorming with Google Gemini.
**Use for:** Exploring ideas, creative input, architecture discussions
**NOT for:** Production deployments (that's Claude's job)
---
## Current Status: PHASE 0.5 COMPLETE ✅
**All 7 Management Services Operational (Feb 9-10, 2026):**
1. Gitea - Git repository
2. Uptime Kuma - Infrastructure monitoring
3. Automation System - 95% manual work reduction
4. MkDocs - Public documentation
5. Wiki.js Subscribers - Premium content portal
6. Wiki.js Staff - Internal SOPs (Git-synced)
7. NextCloud - World download system
**Deployment Stats:**
- 13+ hours total
- 6 servers, 15 game servers
- Zero downtime, zero data loss
- All SSL certificates valid
- Complete monitoring coverage
---
## The Fire + Frost Philosophy
**Core Concept:** Balance of opposing forces
**Fire (Gingerfury - Meg):**
- Passion, Community, Warmth
- The Emissary (Community Manager)
- Fire Path: Competitive gameplay, 18+ Ignis space
**Frost (Frostystyle - Michael):**
- Precision, Infrastructure, Technical Excellence
- The Wizard (Technical Lead)
- Frost Path: Collaborative gameplay, all-ages
**Tagline:** "Fire melts barriers. Frost builds foundations."
---
## Infrastructure Overview
**6 Servers Total:**
**VPS Tier (Management):**
- Command Center: Gitea, Uptime Kuma, Automation
- Ghost VPS: MkDocs, Wiki.js x2, NextCloud
- Panel VPS: Pterodactyl Panel
- Billing VPS: Paymenter
**Dedicated Tier (Performance):**
- TX1 Dallas: 6 game servers
- NC1 Charlotte: 9 game servers
**Total:** 15 game servers (Minecraft modpacks, vanilla, Hytale, FoundryVTT)
---
## Three-Tier Documentation Architecture
**PUBLIC (docs.firefrostgaming.com):**
- MkDocs + Material Theme
- No authentication required
- Server rules, getting started, modpack info
**SUBSCRIBERS (subscribers + downloads):**
- Wiki.js: Premium guides
- NextCloud: World downloads
- Subscriber login required
**STAFF (staff.firefrostgaming.com):**
- Wiki.js with Git sync
- SOPs, admin procedures
- Staff/Admin only
- Bi-directional sync every 5 minutes
---
## Subscription Model
**$1/month - "The Awakened Gateway"**
- Anti-bot barrier
- Server whitelist access
**$5/month - "Elemental Tier"**
- Choose Fire or Frost path
- Full server access (15 servers)
- Subscriber docs + downloads
- Path-specific Discord channels
**$10/month - "Ascendant Tier"**
- Vote on modpacks
- Extended downloads (90 days)
- Beta access
**$25/month - "Eternal Flame/Frost"**
- Permanent world downloads
- Server naming rights
- Custom spawn builds
---
## Leadership Team
**Michael "Frostystyle" (The Wizard):**
- Age: 57, Minnesota
- Technical Lead
- Type 1 Diabetes (Omnipod 5 + Dexcom G7)
- Service Dog: Jack (Siberian Husky, diabetic alert)
- Hand Limitations: Permanent nerve damage (March 2025 surgery)
- Accessibility: Requires micro-block code (8-10 lines max)
**Meg "Gingerfury" (The Emissary):**
- Community Manager
- Natural red hair, 5'4"
- D&D Elven Rogue persona
- Currently: Recovering from broken ankle (Feb 4, 2026)
- Role: Social media, Fire Path leadership
**The Four-Legged Consultants:**
- Jack (Siberian Husky): Diabetic Alert Dog - CRITICAL MEDICAL ROLE
- Oscar (Catahoula): Senior Advisor
- Jasmine (Doberman-Shepherd): Security
- Butter (Persian-Maine Coon): The Ice King
- Midnight Noir (Bombay): The Shadow
---
## Technical Stack
**OS:** Ubuntu 22.04 LTS
**Web:** Nginx
**Languages:** PHP 8.3, Python 3.12, Node.js 20/22
**Databases:** PostgreSQL, MySQL
**Game Management:** Pterodactyl Panel + Wings
**Version Control:** Gitea (self-hosted)
**Monitoring:** Uptime Kuma
**Docs:** MkDocs Material, Wiki.js
**Files:** NextCloud
**Billing:** Paymenter
---
## Automation System
**Purpose:** Minimize manual operations (95% reduction)
**How It Works:**
1. Claude creates task script
2. Michael pastes ONE command
3. Daemon executes automatically (10s polling)
4. Results committed to Git
5. Claude reads from GitHub mirror
**Location:** `/root/firefrost-work/firefrost-operations-manual/automation/`
---
## Brand Identity
**Frost Colors:**
- Primary: #00E5FF (Electric Cyan)
- Secondary: #01579B (Deep Navy)
- Background: #0A0A0A (Obsidian Black)
**Fire Colors:**
- Primary: #FF3D00 (Deep Orange/Red)
- Secondary: #BF360C (Burnt Umber)
- Background: #120000 (Blood Black)
- Accent: #FFD600 (Amber Gold)
**Visual Symbols:**
- Frost: Snowflakes, geometric patterns, books
- Fire: Flames, organic flow, banhammers
- Combined: Firefrost Sigil (snowflake in flame)
---
## The Frostwall Protocol
**Definition:** Custom DDoS Shield + Gateway system using cloaked networking
**Architecture Components:**
**1. GRE Tunneling (The Pipeline)**
- Private encrypted link between Command Center and remote nodes
- Hides real physical IP addresses of backend servers
- Creates "invisible" connection through public internet
**2. 1-to-1 NAT/DMZ Forwarding**
- /29 IP block allocation
- Specific external IPs → Specific internal services
- "Binding Truth" for network traffic
**3. Iron Wall Security**
- Default DROP on all physical interfaces
- ONLY exceptions:
- GRE Tunnel traffic
- Management IP access
- "Deny all, allow specific"
**4. IP Hierarchy (Three-Layer)**
- **Scrubbing Center IP:** What customers see/connect to (Command Center)
- **Backend Alias IP:** Hidden server node address
- **Binding Truth IP:** Internal IP for service binding
**How Traffic Flows:**
```
Player → Scrubbing Center IP (visible)
→ GRE Tunnel (encrypted)
→ Backend Alias IP (hidden)
→ Binding Truth IP (internal)
```
**Phase History:**
**Phase 0 (Dismantled - Feb 2026):**
- Complex GRE configuration
- Over-engineered
- Frequent connectivity issues
- **Status:** REMOVED for stability
**Phase 0.5 (Current):**
- UFW-based simple firewall
- IP-specific rules
- Nginx reverse proxy
- "Good enough" security
**Phase 1 (Planned - Next):**
- Rebuild Frostwall from ground up
- Self-healing GRE tunnels (auto-recovery)
- Greater IP-specific granularity
- Simpler than Phase 0, more robust than Phase 0.5
---
## Current Challenges & Open Questions
**Phase 1 Planning:**
- Frostwall Protocol rebuild
- LuckPerms MySQL backend
- World backup automation
- Subscriber auth workflow (manual → webhook → SSO)
**Community Growth:**
- Social media content calendar
- Staff recruitment (builders, social media)
- Fire vs Frost balance
**Technical Debt:**
- MkDocs auto-rebuild on Git commit
- Wiki.js Fire + Frost theming
- Pterodactyl extensions
- Website v1.0
---
## What Makes This Project Unique
1. **Medical Accessibility:** Built around hand limitations and diabetes
2. **Relationship Foundation:** Fire + Frost = Michael + Meg
3. **Family Planning:** Infrastructure for when baby arrives
4. **Automation First:** 95% manual work reduction
5. **Documentation Obsession:** Everything in Git
6. **The Four-Legged Team:** Service dog + pets part of story
7. **Minnesota Refuge:** Local with global reach
8. **Dual Path Philosophy:** Fire vs Frost player choice
---
## Success Metrics
**Technical:**
- Uptime: 99.9%+
- Automation success: 95%+
- SSL: All valid
- Monitoring: Complete
**Business:**
- Month 1: 3 subscribers (soft launch)
- Month 3: 20 subscribers (public launch)
- Month 6: 50 subscribers
- Month 12: 100+ subscribers
**Community:**
- Fire vs Frost: 45-55% balance
- Retention: 80%+ monthly
- Support: <24 hour response
---
## For Gemini Sessions
**Session Opening Prompt:**
```
Hi Gemini! I'm Michael "Frostystyle" Krause, founder of Firefrost Gaming.
I'm using you as my brainstorming partner for exploratory work before production implementation with Claude.
IMPORTANT CONTEXT:
- Current Status: Phase 0.5 complete (7/7 management services operational)
- Your Role: Explore ideas, provide creative input, discuss architecture
- NOT for: Production deployments (that's Claude's job with our automation system)
Today I want to explore: [YOUR TOPIC HERE]
Let's brainstorm! 🔥❄️
At the end of our session, I'll ask you to format our discussion using the template at:
https://raw.githubusercontent.com/frostystyle/firefrost-operations-manual/master/docs/sandbox-sessions/TEMPLATE.md
```
**Session End Prompt:**
```
Please format our discussion using the template at:
https://raw.githubusercontent.com/frostystyle/firefrost-operations-manual/master/docs/sandbox-sessions/TEMPLATE.md
Save output as: gemini-[topic]-[date].md
This will be reviewed by Production Claude.
```
---
**Last Major Update:** February 10, 2026
**Phase Status:** 0.5 complete (100%)
**Next Milestone:** Polish & testing before Phase 1
**Fire + Frost = Where Passion Meets Precision** 🔥❄️