How younaxo/twomcsu-website works
twomc.su is a Minecraft-server community portal with a Next.js client and NestJS API, backed by PostgreSQL/Prisma and Redis. The main user flow is account registration or sign-in, then using community features such as profiles, reports, messaging and the store through the web app and API. Administrative and moderation surfaces manage those same domains. The graph preserves README-documented capabilities and source-indexed service boundaries; several subsystem links are documented rather than verified from sampled runtime code.
Main entry points: app.module.ts NestJS API · [locale] Web application · MessagesClient.tsx Messages interface · auth.service.ts Authentication
Components 23
Web client
- Web application
apps/web/src/app/[locale] - Messages interface
apps/web/src/components/messages/MessagesClient.tsx
Identity and profiles
- Authentication
apps/api/src/modules/auth/auth.service.ts - User profiles
apps/api/src/modules/users/users.service.ts - Achievements
apps/api/src/modules/achievements/achievements.service.ts
Community features
- Player reports
apps/api/src/modules/reports/reports.service.ts - Profile comments
apps/api/src/modules/comments/comments.service.ts - Activity feed
apps/api/src/modules/activity/activity.service.ts - News and articles
apps/api/src/modules/news - Forms and responses
apps/api/src/modules/forms - Direct messages
apps/api/src/modules/direct-messages/direct-messages.service.ts - Notifications
apps/api/src/modules/notifications/notifications.service.ts - Socket.IO messages
apps/api/src/modules/direct-messages/direct-messages.gateway.ts
Store and servers
- Store and orders
apps/api/src/modules/store - Minecraft servers
apps/api/src/modules/minecraft - Server voting
apps/api/src/modules/voting
API and operations
- Admin and moderation
apps/api/src/modules/admin - Data exports
apps/api/src/modules/export/export.service.ts - NestJS API
apps/api/src/app.module.ts - PostgreSQL
- Redis
- Shared contracts
packages/shared/src/profile.ts
Other components
- Visitor or member
Connections 26
- Visitor or member → Web application: browses and acts
README.md - Web application → NestJS API: uses API
README.md - Web application → Messages interface: opens messages
README.md - Messages interface → Direct messages: uses REST
- Messages interface → Socket.IO messages: uses realtime
README.md - NestJS API → Authentication: routes authentication
- NestJS API → User profiles: routes profile features
- NestJS API → Player reports: routes reports
- NestJS API → Profile comments: routes comments
- NestJS API → Direct messages: routes messages
- NestJS API → Notifications: routes notifications
- NestJS API → Data exports: routes exports
- NestJS API → Admin and moderation: serves administration
apps/api/src/modules/admin/admin-panel.controller.ts - NestJS API → PostgreSQL: accesses data via Prisma
README.md - NestJS API → Redis: uses cache
README.md - NestJS API → Shared contracts: uses shared types
- Web application → Shared contracts: shares contracts
README.md - Web application → Achievements: views achievements
- Web application → Activity feed: views community feed
- Web application → News and articles: reads news
- Web application → Forms and responses: submits responses
- Web application → Store and orders: shops and checks out
- Web application → Minecraft servers: browses servers
- Web application → Server voting: casts server votes
- Admin and moderation → Data exports: requests exports
apps/api/src/modules/admin/admin-panel.controller.ts - Authentication → User profiles: builds user view
apps/api/src/modules/auth/auth.service.ts