# younaxo/twomcsu-website architecture

> Architecture diagram of the GitHub repository younaxo/twomcsu-website, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/younaxo/twomcsu-website
- Repository: https://github.com/younaxo/twomcsu-website

## Overview

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: [`apps/api/src/app.module.ts`](https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/app.module.ts) (NestJS API), [`apps/web/src/app/[locale]`](https://github.com/younaxo/twomcsu-website/tree/main/apps/web/src/app/%5Blocale%5D) (Web application), [`apps/web/src/components/messages/MessagesClient.tsx`](https://github.com/younaxo/twomcsu-website/blob/main/apps/web/src/components/messages/MessagesClient.tsx) (Messages interface), [`apps/api/src/modules/auth/auth.service.ts`](https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/auth/auth.service.ts) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_web["Web application"]
  node_messages_ui["Messages interface<br/>[MessagesClient.tsx]"]
end

subgraph group_identity["Identity and profiles"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_profiles["User profiles<br/>[users.service.ts]"]
  node_achievements["Achievements"]
end

subgraph group_community["Community features"]
  node_reports["Player reports<br/>[reports.service.ts]"]
  node_comments["Profile comments"]
  node_activity["Activity feed"]
  node_news["News and articles"]
  node_forms["Forms and responses"]
  node_direct_messages["Direct messages"]
  node_notifications["Notifications"]
  node_messages_socket["Socket.IO messages"]
end

subgraph group_commerce["Store and servers"]
  node_store["Store and orders"]
  node_minecraft["Minecraft servers"]
  node_voting["Server voting"]
end

subgraph group_platform["API and operations"]
  node_admin["Admin and moderation"]
  node_export["Data exports<br/>[export.service.ts]"]
  node_api["NestJS API<br/>[app.module.ts]"]
  node_postgres[("PostgreSQL")]
  node_redis[("Redis")]
  node_shared["Shared contracts<br/>[profile.ts]"]
end

node_visitor(("Visitor or member"))

node_visitor -->|"browses and acts"| node_web
node_web -.->|"uses API"| node_api
node_web -.->|"opens messages"| node_messages_ui
node_messages_ui -->|"uses REST"| node_direct_messages
node_messages_ui -->|"uses realtime"| node_messages_socket
node_api -.->|"routes authentication"| node_auth
node_api -.->|"routes profile features"| node_profiles
node_api -->|"routes reports"| node_reports
node_api -->|"routes comments"| node_comments
node_api -->|"routes messages"| node_direct_messages
node_api -->|"routes notifications"| node_notifications
node_api -->|"routes exports"| node_export
node_api -->|"serves administration"| node_admin
node_api -->|"accesses data via Prisma"| node_postgres
node_api -.->|"uses cache"| node_redis
node_api -->|"uses shared types"| node_shared
node_web -.->|"shares contracts"| node_shared
node_web -.->|"views achievements"| node_achievements
node_web -.->|"views community feed"| node_activity
node_web -.->|"reads news"| node_news
node_web -.->|"submits responses"| node_forms
node_web -.->|"shops and checks out"| node_store
node_web -.->|"browses servers"| node_minecraft
node_web -.->|"casts server votes"| node_voting
node_admin -->|"requests exports"| node_export
node_auth -->|"builds user view"| node_profiles

click node_web "https://github.com/younaxo/twomcsu-website/tree/main/apps/web/src/app/%5Blocale%5D"
click node_messages_ui "https://github.com/younaxo/twomcsu-website/blob/main/apps/web/src/components/messages/MessagesClient.tsx"
click node_auth "https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/auth/auth.service.ts"
click node_profiles "https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/users/users.service.ts"
click node_achievements "https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/achievements/achievements.service.ts"
click node_reports "https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/reports/reports.service.ts"
click node_comments "https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/comments/comments.service.ts"
click node_activity "https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/activity/activity.service.ts"
click node_news "https://github.com/younaxo/twomcsu-website/tree/main/apps/api/src/modules/news"
click node_forms "https://github.com/younaxo/twomcsu-website/tree/main/apps/api/src/modules/forms"
click node_direct_messages "https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/direct-messages/direct-messages.service.ts"
click node_notifications "https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/notifications/notifications.service.ts"
click node_store "https://github.com/younaxo/twomcsu-website/tree/main/apps/api/src/modules/store"
click node_minecraft "https://github.com/younaxo/twomcsu-website/tree/main/apps/api/src/modules/minecraft"
click node_voting "https://github.com/younaxo/twomcsu-website/tree/main/apps/api/src/modules/voting"
click node_admin "https://github.com/younaxo/twomcsu-website/tree/main/apps/api/src/modules/admin"
click node_export "https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/export/export.service.ts"
click node_api "https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/app.module.ts"
click node_shared "https://github.com/younaxo/twomcsu-website/blob/main/packages/shared/src/profile.ts"
click node_messages_socket "https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/direct-messages/direct-messages.gateway.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web,node_messages_ui toneBlue
class node_auth,node_profiles,node_achievements toneAmber
class node_reports,node_comments,node_activity,node_news,node_forms,node_direct_messages,node_notifications,node_messages_socket toneMint
class node_store,node_minecraft,node_voting toneRose
class node_admin,node_export,node_api,node_postgres,node_redis,node_shared,node_visitor toneIndigo
```

## Components

### Web client

- [Web application](https://github.com/younaxo/twomcsu-website/tree/main/apps/web/src/app/%5Blocale%5D): `apps/web/src/app/[locale]`
- [Messages interface](https://github.com/younaxo/twomcsu-website/blob/main/apps/web/src/components/messages/MessagesClient.tsx): `apps/web/src/components/messages/MessagesClient.tsx`

### Identity and profiles

- [Authentication](https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/auth/auth.service.ts): `apps/api/src/modules/auth/auth.service.ts`
- [User profiles](https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/users/users.service.ts): `apps/api/src/modules/users/users.service.ts`
- [Achievements](https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/achievements/achievements.service.ts): `apps/api/src/modules/achievements/achievements.service.ts`

### Community features

- [Player reports](https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/reports/reports.service.ts): `apps/api/src/modules/reports/reports.service.ts`
- [Profile comments](https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/comments/comments.service.ts): `apps/api/src/modules/comments/comments.service.ts`
- [Activity feed](https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/activity/activity.service.ts): `apps/api/src/modules/activity/activity.service.ts`
- [News and articles](https://github.com/younaxo/twomcsu-website/tree/main/apps/api/src/modules/news): `apps/api/src/modules/news`
- [Forms and responses](https://github.com/younaxo/twomcsu-website/tree/main/apps/api/src/modules/forms): `apps/api/src/modules/forms`
- [Direct messages](https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/direct-messages/direct-messages.service.ts): `apps/api/src/modules/direct-messages/direct-messages.service.ts`
- [Notifications](https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/notifications/notifications.service.ts): `apps/api/src/modules/notifications/notifications.service.ts`
- [Socket.IO messages](https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/direct-messages/direct-messages.gateway.ts): `apps/api/src/modules/direct-messages/direct-messages.gateway.ts`

### Store and servers

- [Store and orders](https://github.com/younaxo/twomcsu-website/tree/main/apps/api/src/modules/store): `apps/api/src/modules/store`
- [Minecraft servers](https://github.com/younaxo/twomcsu-website/tree/main/apps/api/src/modules/minecraft): `apps/api/src/modules/minecraft`
- [Server voting](https://github.com/younaxo/twomcsu-website/tree/main/apps/api/src/modules/voting): `apps/api/src/modules/voting`

### API and operations

- [Admin and moderation](https://github.com/younaxo/twomcsu-website/tree/main/apps/api/src/modules/admin): `apps/api/src/modules/admin`
- [Data exports](https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/modules/export/export.service.ts): `apps/api/src/modules/export/export.service.ts`
- [NestJS API](https://github.com/younaxo/twomcsu-website/blob/main/apps/api/src/app.module.ts): `apps/api/src/app.module.ts`
- **PostgreSQL**
- **Redis**
- [Shared contracts](https://github.com/younaxo/twomcsu-website/blob/main/packages/shared/src/profile.ts): `packages/shared/src/profile.ts`

### Other components

- **Visitor or member**

## Connections

- Visitor or member → Web application: browses and acts (evidence: `README.md`)
- Web application → NestJS API: uses API (evidence: `README.md`)
- Web application → Messages interface: opens messages (evidence: `README.md`)
- Messages interface → Direct messages: uses REST
- Messages interface → Socket.IO messages: uses realtime (evidence: `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 (evidence: `apps/api/src/modules/admin/admin-panel.controller.ts`)
- NestJS API → PostgreSQL: accesses data via Prisma (evidence: `README.md`)
- NestJS API → Redis: uses cache (evidence: `README.md`)
- NestJS API → Shared contracts: uses shared types
- Web application → Shared contracts: shares contracts (evidence: `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 (evidence: `apps/api/src/modules/admin/admin-panel.controller.ts`)
- Authentication → User profiles: builds user view (evidence: `apps/api/src/modules/auth/auth.service.ts`)
