How gholsona171/qboxplatform works
Guildhall is a multi-server Discord community management platform, operated through a web portal and Discord bot. The principal portal workflow is sign-in with Discord, select a guild, then manage a feature through API routes and its domain service; Discord commands and interactions provide another entry point to community features. The README documents the broader feature set, while the sampled excerpts show route-to-service calls, session behavior, and game-query clients. Several feature and persistence connections are represented at subsystem level because their wiring was not sampled.
Main entry points: ApiApplication.ts Fastify API · DiscordModule.ts Discord bot · KnowledgeService.ts Knowledge base · app.js Web portal
Components 19
User entry points
- Web portal
apps/web/public/js/app.js - Discord bot
packages/discord/src/DiscordModule.ts
Platform services
- Fastify API
apps/api/src/composition/ApiApplication.ts - Browser auth routes
apps/api/src/auth/BrowserAuthenticationRoutes.ts - Browser sessions
packages/authentication/src/services/BrowserSessionService.ts - PostgreSQL persistence
packages/database/src/DatabaseService.ts
Support features
- Ticket routes
apps/api/src/tickets/TicketRoutes.ts - Ticket service
modules/tickets/src/TicketService.ts - Applications
modules/applications/src/ApplicationService.ts - Knowledge base
modules/knowledge-base/src/KnowledgeService.ts
Community features
- Safety features
modules/moderation/src/ModerationService.ts - Staff features
modules/staff/src/StaffService.ts - Community features
modules/levels/src/LevelService.ts
Server operations
- Server integrations
modules/server-builder/src/BuilderService.ts - Game queries
modules/game-servers/src/ProtocolQueryClient.ts
Other components
- Community manager
- Discord platform
- OpenAI
- Game servers
Connections 23
- Community manager → Web portal: uses
- Community manager → Discord bot: commands
- Web portal → Fastify API: calls
- Fastify API → Browser auth routes: registers
- Browser auth routes → Browser sessions: verifies sessions
- Browser sessions → PostgreSQL persistence: persists sessions
- Fastify API → Ticket routes: registers
- Ticket routes → Ticket service: calls
- Fastify API → Applications: serves via routes
- Fastify API → Knowledge base: serves via routes
- Fastify API → Safety features: serves via routes
- Fastify API → Staff features: serves via routes
- Fastify API → Community features: serves via routes
- Fastify API → Server integrations: serves via routes
- Discord bot → Discord platform: connects
- Discord bot → Ticket service: dispatches features
- Discord bot → Applications: dispatches features
- Discord bot → Knowledge base: dispatches features
- Discord bot → Safety features: dispatches features
- Discord bot → Community features: dispatches features
- Discord bot → Server integrations: dispatches features
- Knowledge base → OpenAI: answers optionally
- Game queries → Game servers: queries status