asepharyana
1f91f99de3
QoL lanjutan dari fix60084b3: content pesan mentah masih nampilin snowflake (<@&roleid>, <@userid>, <:emoji:id>) di log moderasi dan prompt LLM. Sekarang dirender ke nama yang bisa dibaca: - Gateway capture: metadata menyimpan mentionedRoles + mentionedUsers (id+name) dari message.mentions, disimpan ke metadata JSON - renderDiscordMentions(): <@&id> -> @RoleName, <@id> -> @Username, <:name:id> -> :name:, fallback @role/@user — dipakai di conversationContext (konteks LLM) dan moderationBuilders (getAnalysisContent) sehingga LLM lihat nama role/user beneran, bukan placeholder generik - Frontend renderMessageContent() (mirror gateway) dipasang di semua tempat nampilin content: message-card, message-detail(-view), search-overlay, search-panel, users/channels section, live-stream, mod-queue, review list; sticker-only message tetap [Sticker: name], pesan teks+sticker kini ikut nampilin nama sticker - tsc --noEmit PASS di gateway & frontend; renderDiscordMentions diverifikasi manual (6 kasus: role/user/emoji/unknown/plain)
Bete — Discord Moderation Dashboard
Bot monitoring Discord yang merekam voice channel, menangkap pesan teks, menyimpan attachment, menjalankan analisis AI opsional, dan menyediakan dashboard web real-time.
Stack utama: Node.js (Express 5), pnpm, TypeScript, React 19 (Next.js 16), Tailwind v4, shadcn/ui, Drizzle ORM, PostgreSQL, WebSocket, Redis pub/sub.
Prasyarat
- Node.js 22+
- pnpm 11.x
- FFmpeg di
PATH(untuk audio muxing dan playback media) yt-dlpdiPATH(untuk resolve audio YouTube/Spotify)- Bun (untuk frontend dev — opsional, bisa pake pnpm)
- PostgreSQL 15+
Setup
pnpm install
cp .env.example .env
# Edit .env sesuai konfigurasi server
Menjalankan
# Backend (port 3001)
pnpm run dev:backend
# Discord Gateway (capture messages, voice, dll)
pnpm run dev:discord-gateway
# Frontend (port 3000)
pnpm run dev:web
Build
pnpm run build:backend
pnpm run build:discord-gateway
pnpm run build:web # next build — static export ke out/
pnpm run build # build semua service
Deploy
./deploy.sh # Build + deploy semua service ke VPS
./deploy.sh --frontend # Frontend only
./deploy.sh --backend # Backend only
./deploy.sh --no-build # Skip build, copy files aja
Service Architecture
Discord
|
v
discord-gateway ←→ Redis ←→ backend (Express 5) ←→ frontend (Next.js)
| pub/sub | |
| +— REST API (/api/*) |
| +— WebSocket (/ws) |
+— message capture +— AI moderation |
+— voice recording +— dashboard data +— dashboard UI
+— attachment upload +— real-time updates
Fitur
- Message capture: Capture pesan baru, edit, dan delete dari Discord
- Voice recording: Rekam voice channel ke segmen OGG per user, streaming PCM real-time ke WebSocket
- Attachment upload: Download + upload attachment ke external storage
- AI moderation: Analisis pesan opsional via LLM, auto-delete, queue management
- Dashboard: Messages feed, AI analysis review, voice connection, music player, recordings, user/channel stats
- Media playback: Playback dari URL, file lokal, YouTube, Spotify
- WebSocket: Real-time event streaming untuk semua aktivitas
- Public API: Semua endpoint REST dan WebSocket dapat diakses tanpa autentikasi
Struktur Proyek
services/
├── backend/ # Express 5 REST API + WebSocket server
│ ├── src/modules/ # Feature modules (messages, voice, media, dll)
│ └── src/http/ # Express app setup, middleware
├── discord-gateway/ # Discord client, voice recording, AI analysis
│ ├── src/modules/ # message-capture, voice-recording, ai-moderation
│ └── src/shared/ # Config, database, Discord client
└── frontend/ # Next.js 16 dashboard (static export)
├── src/app/ # Pages (login, dashboard tabs)
├── src/features/ # Feature components (dashboard, live, messages)
└── src/lib/ # API client, WebSocket, types
packages/
└── shared/ # Shared types, errors, logger, utilities
Database
PostgreSQL via Drizzle ORM. Migrasi:
pnpm run db:generate # Generate migration
pnpm run db:migrate # Apply migration
pnpm run db:studio # Drizzle Studio
WebSocket Events
Backend broadcast event berikut ke frontend via WebSocket:
message_created,message_updated,message_deleted,message_analyzedattachment_created,attachment_uploadedvoice_recording_started,voice_recording_stopped,voice_recording_uploadedvoice_active_user,voice_pcm_datamedia_statereaction_*,thread_*,presence_updated,guild_member_*