Contribution Guidelines — Capinetta RP Bot System

// Variables and functions: camelCase
const userName = "Tullo";
function handleTicketCreation() {}

// Classes and constructors: PascalCase
class TicketManager {}

// Global constants: UPPER_SNAKE_CASE
const MAX_WARNINGS = 3;

// ✅ Correct
async function handleTicket(interaction) {
    try {
        const result = await getTicketData(id);
        return result;
    } catch (error) {
        console.error("Error fetching ticket:", error);
    }
}

// ❌ Avoid
function handleTicket() {
    getTicketData(id).then(result => {
        // ...
    });
}

// ✅ Validated inputs + structured error logging
if (!interaction.guild || !interaction.member) {
    return interaction.reply({
        content: "❌ Error: This command must be used in a server.",
        flags: [MessageFlags.Ephemeral]
    });
}

try {
    // command logic
} catch (error) {
    console.error("Context:", error);
    logError(client, error, "Description of what failed");
}

// ✅ Import only what you need
const {
    SlashCommandBuilder,
    EmbedBuilder,
    PermissionFlagsBits
} = require('discord.js');

// ✅ Always validate permissions using PermissionFlagsBits
if (!interaction.member.permissions.has(PermissionFlagsBits.Administrator)) {
    return interaction.reply("❌ Insufficient permissions.");
}

// ✅ Well-defined model with indexes
model Guild {
    id            String        @id
    name          String
    settings      GuildSettings?
    users         GuildUser[]
    tickets       Ticket[]
    createdAt     DateTime      @default(now())
    updatedAt     DateTime      @updatedAt

    @@index([id])
}

// ❌ Avoid loose JSON blobs
model Guild {
    id      String
    data    Json
}

/**
 * @file tickets/handlers.js
 * @description Handles ticket category creation and panel rendering.
 */

/**
 * Generates an HTML transcript for a closed ticket.
 * @param {import('discord.js').TextChannel} channel - The ticket channel.
 * @returns {Promise<Buffer>} The rendered HTML file buffer.
 */
async function generateTranscript(channel) {
    // ...
}

# Validate Prisma schema
npx prisma validate

# Start the bot in development mode
npm run dev