firefrost-gaming/firefrost-operations-manual
3
0
Fork 0
Code Issues 146 Pull Requests Packages Projects Releases Wiki Activity
1,456 Commits 1 Branch 0 Tags
master
Commit Graph

10 Commits

Author SHA1 Message Date
Claude
b38f08189e feat: Add task_number to YAML frontmatter for 26 tasks 
Long-term fix for mobile task index - task numbers now in frontmatter.

Numbers added from BACKLOG.md cross-reference:
#2 rank-system-deployment
#3 fire-frost-holdings-restructuring
#14 vaultwarden-ssh-setup
#22 netdata-deployment
#23 department-structure
#26 modpack-version-checker
#32 terraria-branding-training-arc
#35 pokerole-wikijs-deployment
#36 notebooklm-integration
#40 world-backup-automation
#44 nc1-node-usage-stats
#45 steam-and-state-server
#48 n8n-rebuild
#51 ignis-protocol
#55 discord-invite-setup
#65 claude-infrastructure-access
#67 nc1-security-monitoring
#82 plane-decommissioning
#87 arbiter-2-1-cancellation-flow
#89 staff-portal-consolidation
#90 decap-tasks-collection
#91 server-matrix-node-fix
#92 desktop-mcp
#93 trinity-codex
#94 global-restart-scheduler
#98 discord-channel-automation
#99 claude-projects-architecture

Chronicler #69
 2026-04-08 14:32:38 +00:00
Claude
3542afbe28 feat: Add YAML frontmatter to all 57 task READMEs 
Phase 1 of task management consolidation (per Gemini consultation).

Added standardized frontmatter with:
- status: open | blocked | complete
- priority: P1 | P2 | P3 | P4
- owner: Michael | Meg | Holly
- created: YYYY-MM-DD

Final counts:
- 39 open tasks
- 17 complete tasks
- 1 blocked task

Metadata extracted from existing inline markdown and audit results.
Ready for Phase 2: 11ty mobile index generation.

Chronicler #69
 2026-04-08 14:21:41 +00:00
Claude
6d1f082c6f Document ModpackChecker Phase 11: Licensing & Support Infrastructure 
GEMINI CONSULTATION ROUND 3 COMPLETE

Added Phase 11 (6-8 hours) to flagship completion plan:
- License validation system (BuiltByBit Order ID as key)
- Discord verification bot (/verify-mvc command)
- Gated support channels (#mvc-general + #mvc-support)
- Descriptive UI error messages (highest ROI)
- GitBook knowledge base migration
- Business hours & boundaries (protect Michael's time)
- Community Helper program (6-12 month strategy)

Gemini's Core Philosophy:
"The real anti-piracy measure is gating updates and Discord support"

Key Decisions:
- NO complex DRM/IonCube (breaks panels)
- YES BuiltByBit Order ID validation
- 72-hour phone-home via cron (NOT page load)
- 7-day grace period for validation failures
- SLA: 24-48 hours (underpromise, overdeliver)
- Support hours: Mon-Fri 9am-5pm CST
- Peer support in #mvc-general reduces ticket load

Database schema updated with:
- max_activations, current_activations
- hardware_ids (JSONB for multi-panel)
- status (active/suspended/refunded)

Updated:
- docs/tasks/modpack-version-checker/FLAGSHIP-PRODUCT-COMPLETION-PLAN.md
  Added complete Phase 11 section (300+ lines)
  Updated time estimates: 20-29 hours total
  Updated launch criteria (licensing + support)
  Updated feature matrix

Created:
- docs/consultations/gemini-modpackchecker-round3-licensing-support/GEMINI-RECOMMENDATIONS-SUMMARY.md
  Complete strategic summary
  Implementation checklist
  Success metrics
  Scaling strategy for 10+ products

Total flagship time: 20-29 hours (3-4 work sessions)

Chronicler #64 - Flagship Standard: Do it right or don't do it
 2026-04-06 21:40:52 +00:00
Claude
ce26f63d71 Add ModpackChecker Flagship Product Completion Plan 
- Complete roadmap from current state to launch-ready
- 10 phases: Modrinth auto-detection, Ignore Version, backoff logic, docs, marketing
- Gemini-validated architecture and commercial strategy integrated
- Launch criteria checklist (code, docs, marketing, testing, support)
- Time estimates: 14-21 hours to minimum viable flagship
- Support strategy placeholder for future discussion with Michael
- FFG-PLAN-001 - Flagship Product Standard

Chronicler #64 - Session planning for commercial launch
 2026-04-06 20:52:12 +00:00
Claude (Chronicler #62)
2e82ec43df docs: add verified Blueprint implementation guide for Task #26 
MAJOR SESSION ACCOMPLISHMENTS (Chronicler #62, April 5, 2026):

Task #26 — ModpackChecker Extension:
- Full Dev Panel deployed (64.50.188.128)
- Pterodactyl 1.12.2 + Wings Local Node + Blueprint beta-2026-01
- Extension scaffolded with real structure verified
- 4-platform support from Day 1 (CurseForge, Modrinth, Technic, FTB)
- FTB now accessible via modpacks.ch API (game changer)
- Pricing locked: $14.99 Standard / $24.99 Professional
- Gemini consultation: 20+ gaps filled with concrete details

Implementation Guide includes:
- Real Blueprint file structure (verified from scaffold)
- All 4 API endpoints with response schemas
- Database schema (modpack_settings, server_modpack_data)
- Admin controller boilerplate (Blade)
- Client API controller boilerplate (PHP)
- React component boilerplate (TSX)
- Detection strategy (Egg Variables → File Fingerprinting → Manual)
- Error handling patterns
- Cron job chunking for rate limit protection

Other session work:
- Complete task audit (#2-94)
- BACKLOG.md full rewrite (30 active tasks)
- Fabric egg fix (eclipse-temurin:21-jdk-jammy)
- Gemini consultation procedure updated with template

TODO before Phase 2:
- Create dev@firefrostgaming.com in Mailcow
- Begin admin settings UI (Blade)
- Implement Modrinth API first (easiest)

Signed-off-by: Claude (Chronicler #62) <claude@firefrostgaming.com>
 2026-04-05 22:32:37 +00:00
Claude (Chronicler #47)
cfa838e86a feat: modpack version checker dashboard + PHP proxy (v1.0) 
WHAT WAS DONE:
- Built browser dashboard (dashboard.html) showing installed vs latest version
  for all Pterodactyl game servers
- Built PHP proxy (proxy.php + config.php) for Billing VPS deployment
- Created isolated Nginx server block (version-proxy.conf)
- Created full deployment guide (DEPLOYMENT-GUIDE.md)

ARCHITECTURE:
- PHP proxy at /var/www/version-proxy on Billing VPS (38.68.14.188)
- Isolated from Paymenter/Laravel routing — separate directory + port
- API keys (Pterodactyl ptlc_, CurseForge) live server-side only
- FTB packs: fully automatic via .manifest.json + FTB public API
- CurseForge packs: reads manifest.json, needs CF Project ID + API key
- config.php blocked from direct web access via Nginx

PENDING AT DEPLOYMENT:
- Verify port 8080 is free (ss -tlnp) before enabling Nginx block
- Fill real API keys into config.php on server
- Enter CurseForge Project IDs for CF packs (saved in localStorage)

COLLABORATION:
- PHP proxy architecture designed by Gemini (consultation session 2026-03-29)
- Dashboard HTML and detection logic by Chronicler #47
- Gemini identified Laravel routing conflict and content-type gotcha

WHY:
- Interim solution before full Blueprint extension (post-launch)
- Hands-off modpack update monitoring for staff
- Zero manual checking required after initial CF Project ID setup

Signed-off-by: claude@firefrostgaming.com
 2026-03-29 14:10:47 +00:00
The Chronicler
e6c52c31df feat: Add complete modpack-version-checker production code 
Complete Python package from Claude Code session:
- src/modpack_checker/: 1,154 lines (cli, config, curseforge, database, notifier)
- tests/: 913 lines (comprehensive test suite)
- docs/: README, API, INSTALLATION guides
- setup.py, requirements.txt, LICENSE (MIT)

Total: 2,121+ lines of production-ready code
Ready for BuiltByBit marketplace deployment

Transferred via tar.gz from Claude Code → Chronicler #26
 2026-02-24 10:36:49 +00:00
The Chronicler
e559ec4e9e feat: Add modpack-version-checker code directory structure 
- Created src/modpack_checker/ package structure
- Created tests/ directory
- Placeholder files for all Python modules
- Complete source code preserved in Chronicler #26 chat history
- Ready for code population in next session

Full file contents available in session transcript for reconstruction.
 2026-02-24 10:07:59 +00:00
Claude
1b9ade8ed2 docs: Add CLAUDE.md for Claude Code development workflow 
Enables Claude Code to autonomously build the modpack version checker by:
- Cloning the operations manual
- Reading all planning docs
- Following the complete technical spec
- Building production-ready commercial product

Chronicler #24
 2026-02-23 05:36:03 +00:00
The Chronicler #21
c7c753f4b3 feat: Complete Modpack Version Checker commercial product plan 
- Comprehensive commercial product documentation for BuiltByBit marketplace
- 5 detailed documents covering all aspects of commercial development
- Complete implementation guide with all Gemini-provided code blocks
- Full marketing strategy with BuiltByBit launch materials
- Comprehensive testing guide with essential test cases
- Support playbook for 2-5 hours/month sustainable operations

COMMERCIAL VIABILITY:
- Market validated: $9,600 proven revenue (competitor analysis)
- Revenue projection: $1,000-6,750 year 1 (realistic: $3,000)
- Development time: 8-10 hours (Gemini provided complete code)
- Break-even: 40 sales (2-3 months at realistic pace)
- ROI: Even worst case justifies build (saves 120 hours/year internal use)

TECHNICAL ARCHITECTURE:
- Backend: PHP/Laravel services (ModpackDetector, CacheService, 3 API providers)
- Frontend: React/TypeScript status badge component
- Database: Idempotent installation scripts (install.sh, remove.sh)
- Platforms: CurseForge, Modrinth, FTB (Feed The Beast)
- Caching: Egg Variable storage for performance
- Auto-detection: File fingerprinting with graceful fallbacks

PRODUCT FEATURES:
- Standard tier ($14.99): CurseForge + Modrinth, manual checking
- Professional tier ($24.99): + FTB + cron automation + Discord webhooks
- Zero-click monitoring (status badges on dashboard)
- Auto-detection (no manual configuration)
- Manual override capability
- Graceful API failure handling

DOCUMENTATION COMPLETE:
1. README.md - Executive summary, architecture, strategy (11.6KB)
2. IMPLEMENTATION-PLAN.md - All code blocks organized by component (16.9KB)
3. MARKETING-STRATEGY.md - BuiltByBit launch materials, SEO copy (16.7KB)
4. TESTING-GUIDE.md - QA procedures, test cases, beta testing (13.7KB)
5. SUPPORT-PLAYBOOK.md - Operations guide, sustainable support (15.2KB)

MARKET POSITIONING:
- Unique value: MONITORING tool (competitors only install)
- Solves Day 2-365 problem (maintenance, not setup)
- Complementary to existing installers (not competitive)
- Professional tier features unique to market (cron automation)

RESEARCH SOURCE:
- Complete Gemini Pro research session (4 hours, February 22, 2026)
- Competitor analysis, technical architecture, commercial strategy
- Operations planning, marketing materials, support strategy
- Compressed months of traditional planning into single night

This commercial product is READY TO BUILD when resources available.
Expected execution: 8-10 hours assembly + testing + launch.

Built by: The Chronicler #21
Research partner: Gemini Pro
For: Firefrost Gaming (internal use) + BuiltByBit marketplace (passive income)
Purpose: Generate $1,000-6,750/year passive revenue while solving internal need

Fire + Frost + Foundation = Where Innovation Generates Income
 2026-02-22 10:51:25 +00:00