# Discord Ticket Management Bot

A Discord bot for creating and managing project update tickets with integration to devanturas.net projects.

## Features

- ✅ Create tickets with slash commands
- 📋 Track project updates from devanturas.net
- 🔄 Update ticket status (Pending, In Progress, Completed, Cancelled)
- 📦 Automatic archiving of completed tickets
- 🎫 List and view all active tickets
- 📊 Beautiful embed messages with ticket information

## Setup Instructions

### 1. Create a Discord Bot

1. Go to [Discord Developer Portal](https://discord.com/developers/applications)
2. Click "New Application" and give it a name
3. Go to the "Bot" section
4. Click "Add Bot"
5. Under "Privileged Gateway Intents", enable:
   - MESSAGE CONTENT INTENT
   - SERVER MEMBERS INTENT
6. Click "Reset Token" and copy your bot token

### 2. Install Dependencies

```bash
pip install -r requirements.txt
```

### 3. Configure the Bot

1. Copy `.env.example` to `.env`:
   ```bash
   copy .env.example .env
   ```

2. Edit `.env` and add your bot token:
   ```
   DISCORD_TOKEN=your_bot_token_here
   ```

### 4. Invite the Bot to Your Server

1. In the Discord Developer Portal, go to "OAuth2" > "URL Generator"
2. Select scopes:
   - `bot`
   - `applications.commands`
3. Select bot permissions:
   - Send Messages
   - Embed Links
   - Read Message History
   - Manage Messages
4. Copy the generated URL and open it in your browser
5. Select your server and authorize

### 5. Run the Bot

```bash
python bot.py
```

### 6. Configure Channels

In Discord, use the `/setup` command to configure the channels:

```
/setup active_channel:#active-tickets archive_channel:#archived-tickets
```

## Commands

### `/ticket` - Create a New Ticket

Create a new project update ticket.

**Parameters:**
- `message_id`: Discord message ID to reference
- `project_name`: Project name from devanturas.net/versions
- `title`: Brief description of the update

**Example:**
```
/ticket message_id:123456789 project_name:MyProject title:Version 2.0 Update
```

### `/status` - Update Ticket Status

Update the status of an existing ticket.

**Parameters:**
- `ticket_id`: The ticket ID (e.g., TICKET-0001)
- `new_status`: Choose from:
  - ⏳ Pending
  - 🔄 In Progress
  - ✅ Completed
  - ❌ Cancelled

**Example:**
```
/status ticket_id:TICKET-0001 new_status:In Progress
```

**Note:** When a ticket is marked as "Completed", it will automatically be moved to the archive channel.

### `/list` - View Active Tickets

Lists all currently active (non-archived) tickets.

**Example:**
```
/list
```

### `/info` - Get Ticket Details

Get detailed information about a specific ticket.

**Parameters:**
- `ticket_id`: The ticket ID to view

**Example:**
```
/info ticket_id:TICKET-0001
```

### `/setup` - Configure Bot Channels

Configure the active and archive channels for tickets (Admin only).

**Parameters:**
- `active_channel`: Channel for active tickets
- `archive_channel`: Channel for completed tickets

**Example:**
```
/setup active_channel:#active-tickets archive_channel:#archived-tickets
```

## Ticket Workflow

1. **Create**: Use `/ticket` to create a new ticket in the active channel
2. **Update**: Use `/status` to update the ticket status as you work
3. **Complete**: Mark ticket as "Completed" to automatically archive it
4. **Archive**: Completed tickets are moved to the archive channel

## Project Integration

The bot integrates with devanturas.net:
- All projects: https://devanturas.net/versions
- Specific project: https://devanturas.net/projects/{project_name}

Each ticket embed includes direct links to the project pages.

## Data Storage

Currently, tickets are stored in memory. For production use, consider implementing:
- Database storage (SQLite, PostgreSQL, etc.)
- Persistent ticket data between restarts
- Backup and recovery mechanisms

## Docker Support

Build and run with Docker:

```bash
# Build the image
docker build -t discord-ticket-bot .

# Run the container
docker run -d --name ticket-bot --env-file .env discord-ticket-bot
```

## Troubleshooting

### Bot doesn't respond to commands
- Make sure the bot is online
- Check that you've enabled the correct intents in the Developer Portal
- Verify the bot has permissions in your server

### Commands don't appear
- Wait a few minutes for commands to sync
- Try kicking and re-inviting the bot
- Check the bot logs for sync errors

### Tickets aren't archiving
- Verify you've run `/setup` to configure channels
- Check that the bot has permissions in both channels

## License

MIT License - feel free to modify and use for your projects!

## Author

Created for SimolZimol