Refactor giveaway job processing and enhance environment documentation

- Improved handling of the `giveawayCreate` job in the bot's job processing for better consistency.
- Updated `.env.example` to clarify the usage of `BOT_TOKEN` for both the bot and WebUI.
- Added `bullmq` dependency to the WebUI package for enhanced job management capabilities.

apps/webui/src/app/api/guilds/[guildId]/selfroles/route.ts

@@ -0,0 +1,44 @@
+import { SelfRolePanelDashboardCreateSchema } from '@nexumi/shared';
+import { type NextRequest, NextResponse } from 'next/server';
+import { requireGuildAccess, toApiErrorResponse } from '@/lib/auth';
+import { writeDashboardAudit } from '@/lib/audit';
+import { createSelfRolePanel, listSelfRolePanels } from '@/lib/module-configs/selfroles';
+import { prisma } from '@/lib/prisma';
+
+interface RouteParams {
+  params: Promise<{ guildId: string }>;
+}
+
+export async function GET(_request: NextRequest, { params }: RouteParams) {
+  const { guildId } = await params;
+  try {
+    await requireGuildAccess(guildId);
+    const panels = await listSelfRolePanels(guildId);
+    return NextResponse.json({ panels });
+  } catch (error) {
+    return toApiErrorResponse(error);
+  }
+}
+
+export async function POST(request: NextRequest, { params }: RouteParams) {
+  const { guildId } = await params;
+  try {
+    const session = await requireGuildAccess(guildId);
+    const body = await request.json();
+    const input = SelfRolePanelDashboardCreateSchema.parse(body);
+
+    const panel = await createSelfRolePanel(guildId, input);
+
+    await writeDashboardAudit(prisma, {
+      guildId,
+      actorUserId: session.user.id,
+      action: 'selfroles.create',
+      path: `/dashboard/${guildId}/selfroles`,
+      after: panel
+    });
+
+    return NextResponse.json(panel, { status: 201 });
+  } catch (error) {
+    return toApiErrorResponse(error);
+  }
+}