🎅 Super Secret Santa 🎁

Super Secret Santa is a Discord bot designed to bring the joy of Secret Santa to your server! Organize campaigns, manage participants, and exchange anonymous gifts—all through easy-to-use commands and buttons.

---

✨ Features

• Create Campaigns: Organize Secret Santa campaigns with /santa create.
• Join or Leave: Participants can join or leave a campaign with intuitive buttons.
• Start the Fun: The organizer starts the gift exchange, assigning giftees randomly.
• Send Messages: Anonymous message exchange with /santa message.
• Secure & Persistent: Campaigns are stored securely in a PostgreSQL database.
• Automated QR Code PDF generation: Generate a PDF with QR codes labels for each participant!

---

🛠 Commands

/santa create <name>

Create a new Secret Santa campaign in your server.

/santa delete

Delete a campaign. Only the organizer can delete a campaign.

/santa message <message>

Send a message anonymously to your assigned giftee.

---

📦 Setup

1. Dependencies: you need Poetry to manage packages. Run poetry install to install the dependencies.
2. Database: the bot uses PostgreSQL for persistence. Ensure your database is accessible and apply the schema in schema.sql.
3. Config: specify your database and Discord credentials via config.ini as per config.ini.example.
4. Launch the bot: run poetry run python -m super_secret_santa to start the bot.
5. Add to Discord: invite the bot to your server using the link that appears in the console.