p-queue

.env.test.example

@@ -2,29 +2,34 @@
 # Broccolini Bot – Test environment template (no secrets)
 # Copy to .env.test and fill with TEST-only values. Run with ENV_FILE=.env.test
 # so changes are tried here first, then migrated to .env after confirmation.
-# See ENV_AND_SECURITY.md. Never commit .env or .env.test.
+# See docs/setup/ENV_AND_SECURITY.md. Never commit .env or .env.test.
 # =============================================================================
 
 # --- Discord: Core (use a test guild / bot if possible) ---
-DISCORD_TOKEN=
-DISCORD_APPLICATION_ID=
-DISCORD_GUILD_ID=
+DISCORD_TOKEN=                    # Bot token (test bot)
+DISCORD_APPLICATION_ID=           # Application (client) ID
+DISCORD_GUILD_ID=               # Test server ID
 
 # --- Discord: Channel & category IDs (test server) ---
+# Ticket creation: set one or both; /panel and /email-routing choose behavior
 DISCORD_TICKET_CATEGORY_ID=
 TICKET_CATEGORY_ID=
-DISCORD_THREAD_CHANNEL_ID=
-EMAIL_THREAD_CHANNEL_ID=
+# DISCORD_THREAD_CHANNEL_ID=      # Text channel for Discord ticket threads (optional)
+# EMAIL_THREAD_CHANNEL_ID=        # Text channel for email ticket threads (optional)
 
-# --- Escalation (optional for test) ---
-DISCORD_ESCALATED_CATEGORY_ID=
-EMAIL_ESCALATED_CATEGORY_ID=
+# Overflow categories when main hits 50 channels (comma-separated, optional)
+# EMAIL_TICKET_OVERFLOW_CATEGORY_IDS=
+# DISCORD_TICKET_OVERFLOW_CATEGORY_IDS=
+
+# Escalation (optional for test)
+# DISCORD_ESCALATED_CATEGORY_ID=
+# EMAIL_ESCALATED_CATEGORY_ID=    # legacy alias: ESCALATED_CATEGORY_ID
 DISCORD_ESCALATED2_CHANNEL_ID=
 DISCORD_ESCALATED3_CHANNEL_ID=
-EMAIL_ESCALATED2_CHANNEL_ID=
+EMAIL_ESCALATED2_CHANNEL_ID=      # Tier 2 category ID (email); env name *_CHANNEL_* is legacy
 EMAIL_ESCALATED3_CHANNEL_ID=
 
-# --- Logging & utility ---
+# --- Logging, transcripts, and utility ---
 ROLE_ID_TO_PING=
 TRANSCRIPT_CHANNEL_ID=
 LOGGING_CHANNEL_ID=
@@ -33,7 +38,7 @@ BACKUP_EXPORT_CHANNEL_ID=
 ACCOUNT_INFO_CHANNEL_ID=
 DISCORD_CHANNEL_ID=
 
-# --- Buttons / copy ---
+# --- Discord: Ticket copy & buttons ---
 ESCALATION_MESSAGE=
 BUTTON_LABEL_CLOSE=Close Ticket
 BUTTON_LABEL_CLAIM=Claim
@@ -42,21 +47,27 @@ BUTTON_EMOJI_CLOSE=🔒
 BUTTON_EMOJI_CLAIM=📌
 BUTTON_EMOJI_UNCLAIM=🔓
 
-# --- Google / Gmail (test inbox or same as prod – your choice) ---
+# --- Google / Gmail (test inbox / separate OAuth client optional) ---
 GOOGLE_CLIENT_ID=
 GOOGLE_CLIENT_SECRET=
 REFRESH_TOKEN=
 MY_EMAIL=
 
-# --- Server ---
-NGROK_URL=
-DISCORD_ONLY_PORT=5001
+# --- Server & URLs ---
+# NGROK_URL=                      # Optional; public URL if you use ngrok for webhooks
+DISCORD_ONLY_PORT=5000
+# HEALTHCHECK_HOST=
 
-# --- Database (use a separate test DB or db name to avoid data loss) ---
+# --- bOSScord (support cockpit) ---
+# BOSSCORD_API_KEY=
+# BOSSCORD_CORS_ORIGIN=*
+
+# --- Database (test cluster or local) ---
 MONGODB_URI=
+# MONGODB_DATABASE=
 
 # --- Branding & copy ---
-SUPPORT_NAME=Support (Test)
+SUPPORT_NAME=Support
 LOGO_URL=
 EMAIL_SIGNATURE=
 TICKET_CLOSE_SUBJECT_PREFIX=[Resolved]
@@ -66,7 +77,7 @@ DISCORD_CLOSE_MESSAGE=
 DISCORD_TRANSCRIPT_MESSAGE=
 DISCORD_AUTO_CLOSE_MESSAGE=
 
-# --- Limits & permissions ---
+# --- Ticket limits & permissions ---
 GLOBAL_TICKET_LIMIT=5
 TICKET_LIMIT_PER_CATEGORY=3
 RATE_LIMIT_TICKETS_PER_USER=0
@@ -74,10 +85,12 @@ RATE_LIMIT_WINDOW_MINUTES=60
 BLACKLISTED_ROLES=
 ADDITIONAL_STAFF_ROLES=
 
-# --- Auto-close / reminders ---
+# --- Auto-close ---
 AUTO_CLOSE_ENABLED=false
 AUTO_CLOSE_AFTER_HOURS=72
 AUTO_CLOSE_MESSAGE=
+
+# --- Reminders ---
 REMINDER_ENABLED=false
 REMINDER_AFTER_HOURS=24
 REMINDER_MESSAGE=
@@ -99,16 +112,16 @@ AUTO_UNCLAIM_ENABLED=false
 AUTO_UNCLAIM_AFTER_HOURS=24
 ALLOW_CLAIM_OVERWRITE=false
 
-# --- Thread (legacy) ---
+# --- Thread-style tickets (legacy) ---
 USE_THREADS=false
 THREAD_PARENT_CHANNEL=
 
-# --- Game list ---
-GAME_LIST=Project Zomboid, Minecraft, ...
-
-# --- Embed colors ---
+# --- Embed colors (hex with 0x prefix) ---
 EMBED_COLOR_OPEN=0x00FF00
 EMBED_COLOR_CLOSED=0xFF0000
 EMBED_COLOR_CLAIMED=0xFFFF00
 EMBED_COLOR_ESCALATED=0xFF6600
 EMBED_COLOR_INFO=0x1e2124
+
+# --- Game list (comma-separated; used for detection and tags) ---
+GAME_LIST=Project Zomboid, Minecraft