7e14c6e8c1
Sandbox Briefing v2.1: - Complete project context for Gemini sessions - Added Frostwall Protocol comprehensive documentation - Updated Phase 0.5 completion status - Gemini session prompts included Next Session Reminders: - Housekeeping tasks checklist - Mobile SSH setup guide - Phase 1 planning notes - Real-world comparison reference Ready for exploratory AI sessions 🔥❄️
345 lines
8.7 KiB
Markdown
345 lines
8.7 KiB
Markdown
# 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** 🔥❄️
|