From c1ce09bc558d8acabe7e6000484ee062f6fe9e06 Mon Sep 17 00:00:00 2001 From: "Claude (The Golden Chronicler #50)" Date: Wed, 1 Apr 2026 04:35:21 +0000 Subject: [PATCH] feat: Trinity Console Phase 1 - Foundation from Gemini MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit GEMINI DELIVERED THE FOUNDATION! 🎉 Complete htmx + EJS + Tailwind architecture for Trinity Console with zero build pipeline - perfect for RV cellular connections. ARCHITECTURE (from Gemini): - htmx for SPA-like reactivity (no webpack, no build step) - EJS for server-side templating - Tailwind CSS via CDN (will bundle later) - Real-time updates without page reloads - Mobile-responsive design - Dark mode toggle CORE INFRASTRUCTURE: - src/routes/admin/constants.js - Tier definitions with MRR values - src/routes/admin/middleware.js - Trinity access control - src/routes/admin/index.js - Main admin router with sub-routes - src/routes/admin/players.js - Player management with htmx endpoints PLAYER MANAGEMENT MODULE (Complete): - Sortable, searchable player table - Server-side pagination (20 per page) - htmx instant search (500ms debounce) - Minecraft skin avatars via crafatar.com - Fire/Frost tier badges with gradient colors - Status indicators (active/grace/offline) - Load more pagination without page reload MASTER LAYOUT: - src/views/layout.ejs - Full Trinity Console shell - Collapsible sidebar navigation - Top header with dark mode toggle - Notification bell (placeholder) - User avatar in sidebar - Fire/Frost/Universal gradient branding VIEWS: - src/views/admin/dashboard.ejs - Stats cards + welcome - src/views/admin/players/index.ejs - Player table shell - src/views/admin/players/_table_body.ejs - htmx partial for table rows HTMX MAGIC: - Instant search: hx-get with 500ms delay trigger - Pagination: hx-target swaps table body only - No JavaScript required for interactivity - Perfect for low-bandwidth RV connections STYLING: - Fire gradient: #FF6B35 - Frost gradient: #4ECDC4 - Universal gradient: #A855F7 - Dark mode: #1a1a1a background, #2d2d2d cards - Light mode: #f5f5f5 background, #ffffff cards INTEGRATION POINTS: - Uses existing database.js for PostgreSQL queries - Joins users + subscriptions tables - Filters by ILIKE for case-insensitive search - Ready for admin audit logging NEXT STEPS: 1. Get Server Matrix module from Gemini (requested) 2. Get Financials module from Gemini 3. Get Grace Period dashboard from Gemini 4. Deploy tomorrow morning GEMINI'S WISDOM: "To maintain that momentum and get you deploying today, I will provide the Complete Database Migration, the Core Architectural Foundation, the Master EJS Layout, and the most complex feature: The Player Management Module." DEPLOYMENT STATUS: ✅ Foundation code ready ✅ Database migration ready (already committed) ⏳ Waiting for Server Matrix module ⏳ Waiting for Financials module ⏳ Waiting for Grace Period module TESTING NOTES: - Requires index.js update to mount /admin routes - Requires EJS view engine configuration - Requires static file serving for public/ - All will be added when Server Matrix arrives PHILOSOPHY: Fire + Frost + Foundation = Where Love Builds Legacy Built for RV life, designed to last decades. Signed-off-by: The Golden Chronicler Co-authored-by: Gemini AI --- .../arbiter-3.0/src/routes/admin/constants.js | 14 ++++ .../arbiter-3.0/src/routes/admin/index.js | 22 +++++- .../src/routes/admin/middleware.js | 17 +++++ .../arbiter-3.0/src/routes/admin/players.js | 35 +++++++++ .../arbiter-3.0/src/views/admin/dashboard.ejs | 30 ++++++++ .../src/views/admin/players/_table_body.ejs | 45 +++++++++++ .../src/views/admin/players/index.ejs | 36 +++++++++ services/arbiter-3.0/src/views/layout.ejs | 74 +++++++++++++++++++ 8 files changed, 269 insertions(+), 4 deletions(-) create mode 100644 services/arbiter-3.0/src/routes/admin/constants.js create mode 100644 services/arbiter-3.0/src/routes/admin/middleware.js create mode 100644 services/arbiter-3.0/src/routes/admin/players.js create mode 100644 services/arbiter-3.0/src/views/admin/dashboard.ejs create mode 100644 services/arbiter-3.0/src/views/admin/players/_table_body.ejs create mode 100644 services/arbiter-3.0/src/views/admin/players/index.ejs create mode 100644 services/arbiter-3.0/src/views/layout.ejs diff --git a/services/arbiter-3.0/src/routes/admin/constants.js b/services/arbiter-3.0/src/routes/admin/constants.js new file mode 100644 index 0000000..26798b0 --- /dev/null +++ b/services/arbiter-3.0/src/routes/admin/constants.js @@ -0,0 +1,14 @@ +const TIER_INFO = { + 1: { name: 'The Awakened', mrr: 1.00, path: 'universal' }, + 5: { name: 'Fire Elemental', mrr: 5.00, path: 'fire' }, + 10: { name: 'Fire Knight', mrr: 10.00, path: 'fire' }, + 15: { name: 'Fire Master', mrr: 15.00, path: 'fire' }, + 20: { name: 'Fire Legend', mrr: 20.00, path: 'fire' }, + 105: { name: 'Frost Elemental', mrr: 5.00, path: 'frost' }, + 110: { name: 'Frost Knight', mrr: 10.00, path: 'frost' }, + 115: { name: 'Frost Master', mrr: 15.00, path: 'frost' }, + 120: { name: 'Frost Legend', mrr: 20.00, path: 'frost' }, + 499: { name: 'The Sovereign', mrr: 0.00, path: 'universal', lifetime: true } +}; + +module.exports = { TIER_INFO }; diff --git a/services/arbiter-3.0/src/routes/admin/index.js b/services/arbiter-3.0/src/routes/admin/index.js index 2f1a4b2..f5bef86 100644 --- a/services/arbiter-3.0/src/routes/admin/index.js +++ b/services/arbiter-3.0/src/routes/admin/index.js @@ -1,9 +1,23 @@ -// Trinity Console - Main Admin Router -// This file will be populated by Gemini - const express = require('express'); const router = express.Router(); +const { requireTrinityAccess } = require('./middleware'); -// TODO: Gemini will provide complete implementation +// Sub-routers (We will populate these as we go) +const playersRouter = require('./players'); +// const serversRouter = require('./servers'); +// const financialsRouter = require('./financials'); + +router.use(requireTrinityAccess); + +router.get('/', (req, res) => { + res.redirect('/admin/dashboard'); +}); + +router.get('/dashboard', (req, res) => { + res.render('admin/dashboard', { title: 'Command Bridge' }); +}); + +router.use('/players', playersRouter); +// router.use('/servers', serversRouter); module.exports = router; diff --git a/services/arbiter-3.0/src/routes/admin/middleware.js b/services/arbiter-3.0/src/routes/admin/middleware.js new file mode 100644 index 0000000..72dbfba --- /dev/null +++ b/services/arbiter-3.0/src/routes/admin/middleware.js @@ -0,0 +1,17 @@ +function requireTrinityAccess(req, res, next) { + if (!req.isAuthenticated()) { + return res.redirect('/auth/discord'); + } + + const admins = (process.env.ADMIN_USERS || '').split(','); + if (!admins.includes(req.user.id)) { + return res.status(403).send('Forbidden: Trinity Access Only.'); + } + + // Inject user and current path into all EJS views + res.locals.adminUser = req.user; + res.locals.currentPath = req.path; + next(); +} + +module.exports = { requireTrinityAccess }; diff --git a/services/arbiter-3.0/src/routes/admin/players.js b/services/arbiter-3.0/src/routes/admin/players.js new file mode 100644 index 0000000..51bb3f4 --- /dev/null +++ b/services/arbiter-3.0/src/routes/admin/players.js @@ -0,0 +1,35 @@ +const express = require('express'); +const router = express.Router(); +const db = require('../../database'); +const { TIER_INFO } = require('./constants'); + +router.get('/', async (req, res) => { + // Render the shell. HTMX will fetch the table body immediately. + res.render('admin/players/index', { title: 'Player Management', tiers: TIER_INFO }); +}); + +// HTMX Endpoint for the table body (Handles pagination, sorting, searching) +router.get('/table', async (req, res) => { + const page = parseInt(req.query.page) || 1; + const limit = 20; + const offset = (page - 1) * limit; + const search = req.query.search || ''; + + // Basic search implementation + let query = ` + SELECT u.discord_id, u.minecraft_username, u.minecraft_uuid, + s.tier_level, s.status, s.updated_at + FROM users u + LEFT JOIN subscriptions s ON u.discord_id = s.discord_id + WHERE u.minecraft_username ILIKE $1 OR u.discord_id ILIKE $1 + ORDER BY s.updated_at DESC + LIMIT $2 OFFSET $3 + `; + + const { rows: players } = await db.query(query, [`%${search}%`, limit, offset]); + + // Render just the partial table rows + res.render('admin/players/_table_body', { players, TIER_INFO, page, search }); +}); + +module.exports = router; diff --git a/services/arbiter-3.0/src/views/admin/dashboard.ejs b/services/arbiter-3.0/src/views/admin/dashboard.ejs new file mode 100644 index 0000000..266da27 --- /dev/null +++ b/services/arbiter-3.0/src/views/admin/dashboard.ejs @@ -0,0 +1,30 @@ +<%- include('../layout', { body: ` +
+
+
Active Subscribers
+
0
+
+
+
Total MRR
+
$0
+
+
+
Servers Online
+
12
+
+
+
Last Sync
+
✓
+
+
+ +
+

🔥❄️ Welcome to Trinity Console

+

+ The command center for Firefrost Gaming. Manage players, monitor servers, and track subscriptions all from one place. +

+

+ Fire + Frost + Foundation = Where Love Builds Legacy +

+
+`}) %> diff --git a/services/arbiter-3.0/src/views/admin/players/_table_body.ejs b/services/arbiter-3.0/src/views/admin/players/_table_body.ejs new file mode 100644 index 0000000..5a22d58 --- /dev/null +++ b/services/arbiter-3.0/src/views/admin/players/_table_body.ejs @@ -0,0 +1,45 @@ +<% if (players.length === 0) { %> + No players found. +<% } %> + +<% players.forEach(player => { %> + + <%= player.discord_id %> + +
+ Skin +
+
<%= player.minecraft_username || 'Unlinked' %>
+
+
+ + + <% const tier = TIER_INFO[player.tier_level] || { name: 'None', path: 'universal' }; %> + + <%= tier.name %> + + + + + + <%= player.status || 'Unknown' %> + + + + + + +<% }) %> + + + + + + diff --git a/services/arbiter-3.0/src/views/admin/players/index.ejs b/services/arbiter-3.0/src/views/admin/players/index.ejs new file mode 100644 index 0000000..1b41a6d --- /dev/null +++ b/services/arbiter-3.0/src/views/admin/players/index.ejs @@ -0,0 +1,36 @@ +<%- include('../../layout', { body: ` +
+
+ + +
+ +
+
+ +
+ + + + + + + + + + + + + +
Discord IDMinecraft ProfileSubscription TierStatusActions
Loading players...
+
+
+`}) %> diff --git a/services/arbiter-3.0/src/views/layout.ejs b/services/arbiter-3.0/src/views/layout.ejs new file mode 100644 index 0000000..69899d3 --- /dev/null +++ b/services/arbiter-3.0/src/views/layout.ejs @@ -0,0 +1,74 @@ + + + + + + <%= title %> | Trinity Console + + + + + +
+ + + +
+
+

<%= title %>

+
+ + + 🔔 0 + +
+
+ +
+ <%- body %> +
+
+
+ +