vATCSCC-TMU

TMU Bot for vATCSCC Discord Server

Running the Discord bot locally

1. Install Python 3.11+.
2. Create a virtual environment and install dependencies:

   python -m venv .venv
   source .venv/bin/activate
   pip install -r requirements.txt

3. Copy .env.example to .env and fill in your Discord bot token. The defaults are prefilled for the vATCSCC Backup guild and staging/publish channels. Do not commit secrets.
4. Start the bot:

   python bot.py

Available slash commands

• /ntml-coordinate, /ntml-coord, /ntml-c — start NTML coordination with block-text restrictions. The bot parses MIT/MINIT ranges, facilities, timeframes, and posts the coordination card to the NTML staging channel with ✔/🔔/❌ reactions.
  • 🔔 adds a coordination note to the thread and exposes a "Submit coordination rationale" button on the card to collect rationale.
  • ❌ marks the request as denied and locks further interaction.
• /ntml-initiate, /ntml-init, /ntml-i — opens a modal to collect details for a new NTML entry and posts the completed form to the staging channel (with a link back to the FAA NTML Reference Guide).
• /ntml-edit, /ntml-e — opens a modal for capturing NTML edits and posts the update embed to the staging channel.
• /ntml-cancel, /ntml-canc, /ntml-x — opens a cancellation modal and posts a cancellation embed to the staging channel.
• /ntml-delete, /ntml-del, /ntml-d — opens a deletion modal and posts a deletion embed to the staging channel.

Discord App Design

See docs/discord_app_design.md for a proposed architecture and workflow plan to manage NTML entries, TMIs, and external data sources directly in Discord.