Update tasks.md: Expand Whitelist Manager to web dashboard

- Task #1 (Whitelist Manager) expanded from CLI script to full web dashboard
- Changed from 1 hour → 2-2.5 hours (more comprehensive solution)
- Added reference to docs/tools/whitelist-manager-deployment-plan.md
- Detailed tech stack, deployment phases, prerequisites
- Listed all 11 Minecraft servers managed (TX1 + NC1)
- Excluded non-Minecraft servers (FoundryVTT, Hytale)
- Added future Phase 2 enhancements
- Updated document version to 2.2

Philosophy change: Tasks now REFERENCE detailed plans rather than inline everything.

Updated by: The Chronicler
Date: February 16, 2026
This commit is contained in:
2026-02-16 05:42:52 -06:00
parent dd54bd8a8f
commit 8812c9b3f1

View File

@@ -2,7 +2,7 @@
**Last Updated:** February 16, 2026
**Updated By:** The Chronicler (current session)
**Version:** 2.1 (NC1 Cleanup marked complete with lessons learned)
**Version:** 2.2 (Whitelist Manager expanded to web dashboard with full deployment plan)
**Purpose:** Comprehensive dependency-ordered roadmap — execute top to bottom
---
@@ -25,42 +25,68 @@
Quick wins with high impact and no dependencies. (1 of 3 complete)
### 1. Centralized Whitelist Manager
**Time:** 1 hour
**Priority:** DO WHEN HOME
**Location:** `/opt/firefrost/whitelist-manager.sh` on Command Center
### 1. Centralized Whitelist Manager Web Dashboard
**Time:** 2-2.5 hours
**Priority:** DO WHEN HOME + LIGHT DUTY APPROVED
**Status:** READY TO BUILD
**Documentation:** `docs/tools/whitelist-manager-deployment-plan.md`
**Overview:**
Build web dashboard at `whitelist.firefrostgaming.com` to manage player whitelists across all 11 Minecraft servers, replacing manual SSH and console work.
**The Problem:**
- Currently requires manual SSH to each node (TX1, NC1)
- Update whitelist on each of 12+ servers individually via Pterodactyl console
- Time-consuming, error-prone, painful
- Update whitelist on each server individually via Pterodactyl console
- Time-consuming (15+ minutes), error-prone, no visibility
**The Solution:**
- Command Center script using Pterodactyl API
- One command updates all whitelisted servers at once
- Logs all changes (audit trail)
- Master whitelist stored in repo
Web interface with:
- Toggle whitelist ON/OFF per server (one click)
- Add/remove player from one or all servers
- View current whitelist status across all servers
- Staff-accessible (you, Meg, trusted staff)
**Usage:**
```bash
whitelist-manager.sh add PlayerName
whitelist-manager.sh remove PlayerName
whitelist-manager.sh list
whitelist-manager.sh sync # Ensure all servers match
```
**Managed Servers (11 Minecraft):**
- TX1: Reclamation, Stoneblock 4, Society Sunlit Valley, Vanilla 1.21.11, All The Mons
- NC1: Ember Project, Minecolonies, ATM10, Homestead, EMC Subterra Tech
**Before Building:**
- Which servers are whitelisted vs public?
- Pterodactyl API key (create or use existing)
- Toggle enforcement or just add/remove names?
- Access control (Michael only or also Meg/staff?)
**Excluded (Non-Minecraft):**
- FoundryVTT, Hytale (stay public)
**Future Enhancement (Phase 2):**
- Paymenter integration (subscriber pays → auto-whitelisted)
- Discord bot interface
- Web interface on staff.firefrostgaming.com
**Tech Stack:**
- Backend: Python Flask
- Frontend: HTML + TailwindCSS
- Host: Ghost VPS (Chicago) - same as Wiki.js Staff
- Domain: whitelist.firefrostgaming.com
- Auth: Basic username/password (SSL/HTTPS)
**After Completion:** 15-minute task → 10 seconds
**Prerequisites:**
- Pterodactyl panel URL
- Pterodactyl API key (generate in panel)
- Ghost VPS SSH access
- DNS A record: whitelist.firefrostgaming.com → Ghost VPS
- Admin credentials for dashboard
**Deployment Phases:**
1. Information Gathering (5 min) - Get API key, credentials, DNS
2. Infrastructure Setup (15 min) - DNS, directories, Python dependencies
3. Build Application (45-60 min) - Flask app, HTML dashboard, API integration
4. Security & Web Server (20 min) - Nginx, SSL, systemd service
5. Testing (15 min) - Test with one server, then all servers
6. Deploy & Document (15 min) - Add to Wiki.js, commit to Git
**After Completion:**
- ✅ 15-minute task → 30 seconds
- ✅ Zero-error whitelist management
- ✅ Full visibility across all servers
- ✅ Link from Wiki.js Staff portal
**Future Enhancements (Phase 2):**
- Discord bot integration
- Paymenter subscriber auto-whitelist
- Whitelist sync verification
**See full deployment plan:** `docs/tools/whitelist-manager-deployment-plan.md`
---