# aaryan218/game-ansh architecture

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

- Interactive diagram: https://gitdiagram.com/aaryan218/game-ansh
- Repository: https://github.com/aaryan218/game-ansh

## Overview

Gamers’G is a gaming-platform backend API. The principal workflow is an API request routed through Express to domain handlers and services, which validate and authorize it, apply platform rules, and access PostgreSQL; results or errors return through the API. Domain capabilities include player and organization accounts, teams, recruitment, discovery, social feeds, messaging, tournaments, and administration. The README identifies Redis and Socket.io as platform technologies, and source references show messaging and social/recruitment integrations; unsampled implementation details are not inferred.

Main entry points: [`ars/src/app.js`](https://github.com/aaryan218/game-ansh/blob/main/ars/src/app.js) (Express app), [`ars/src/shared/auth/middleware.js`](https://github.com/aaryan218/game-ansh/blob/main/ars/src/shared/auth/middleware.js) (Auth middleware), [`ars/src/modules/auth/auth.routes.js`](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/auth/auth.routes.js) (Auth routes), [`ars/src/modules/players/players.routes.js`](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/players/players.routes.js) (Player routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_app["Express app<br/>[app.js]"]
  node_auth_routes["Auth routes<br/>[auth.routes.js]"]
  node_auth_controller["Auth handler<br/>[auth.controller.js]"]
  node_players_routes["Player routes<br/>[players.routes.js]"]
  node_players_controller["Player handler"]
  node_orgs_routes["Organization routes<br/>[orgs.routes.js]"]
  node_orgs_controller["Organization handler<br/>[orgs.controller.js]"]
  node_discovery_routes["Discovery routes"]
  node_discovery_controller["Discovery handler"]
  node_social_routes["Social routes<br/>[social.routes.js]"]
  node_social_controller["Social handler"]
  node_messages_routes["Messaging routes"]
  node_messages_controller["Messaging handler"]
  node_teams_routes["Team routes<br/>[teams.routes.js]"]
  node_teams_controller["Team handler"]
  node_recruitment_routes["Recruitment routes"]
  node_recruitment_controller["Recruitment handler"]
  node_tournaments_routes["Tournament routes"]
  node_tournaments_controller["Tournament handler"]
  node_admin_routes["Admin routes<br/>[admin.routes.js]"]
  node_admin_controller["Admin handler"]
end

subgraph group_accounts["Accounts and discovery"]
  node_auth_service["Account service<br/>[auth.service.js]"]
  node_players_service["Player service<br/>[players.service.js]"]
  node_orgs_service["Organization service<br/>[orgs.service.js]"]
  node_discovery_service["Discovery service"]
end

subgraph group_community["Community"]
  node_social_service["Social service<br/>[social.service.js]"]
  node_messages_service["Messaging service"]
end

subgraph group_competition["Teams and competition"]
  node_teams_service["Team service<br/>[teams.service.js]"]
  node_recruitment_service["Recruitment service"]
  node_tournaments_service["Tournament service"]
end

subgraph group_platform["Shared services"]
  node_admin_service["Admin service<br/>[admin.service.js]"]
  node_middleware["Auth middleware<br/>[middleware.js]"]
  node_jwt["JWT utilities<br/>[jwt.js]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_auth_routes
node_app -->|"mounts routes"| node_players_routes
node_app -->|"mounts routes"| node_orgs_routes
node_app -->|"mounts routes"| node_discovery_routes
node_app -->|"mounts routes"| node_social_routes
node_app -->|"mounts routes"| node_messages_routes
node_app -->|"mounts routes"| node_teams_routes
node_app -->|"mounts routes"| node_recruitment_routes
node_app -->|"mounts routes"| node_tournaments_routes
node_app -->|"mounts routes"| node_admin_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_players_routes -->|"dispatches"| node_players_controller
node_orgs_routes -->|"dispatches"| node_orgs_controller
node_discovery_routes -->|"dispatches"| node_discovery_controller
node_social_routes -->|"dispatches"| node_social_controller
node_messages_routes -->|"dispatches"| node_messages_controller
node_teams_routes -->|"dispatches"| node_teams_controller
node_recruitment_routes -->|"dispatches"| node_recruitment_controller
node_tournaments_routes -->|"dispatches"| node_tournaments_controller
node_admin_routes -->|"dispatches"| node_admin_controller
node_auth_controller -->|"calls"| node_auth_service
node_players_controller -->|"calls"| node_players_service
node_orgs_controller -->|"calls"| node_orgs_service
node_discovery_controller -->|"calls"| node_discovery_service
node_social_controller -->|"calls"| node_social_service
node_messages_controller -->|"calls"| node_messages_service
node_teams_controller -->|"calls"| node_teams_service
node_recruitment_controller -->|"calls"| node_recruitment_service
node_tournaments_controller -->|"calls"| node_tournaments_service
node_admin_controller -->|"calls"| node_admin_service
node_auth_routes -->|"authenticates"| node_middleware
node_players_routes -->|"authenticates"| node_middleware
node_orgs_routes -->|"authenticates"| node_middleware
node_social_routes -->|"authenticates"| node_middleware
node_messages_routes -->|"authenticates"| node_middleware
node_teams_routes -->|"authenticates"| node_middleware
node_recruitment_routes -->|"authenticates"| node_middleware
node_tournaments_routes -->|"authenticates"| node_middleware
node_admin_routes -->|"authenticates"| node_middleware
node_middleware -->|"verifies tokens"| node_jwt

click node_app "https://github.com/aaryan218/game-ansh/blob/main/ars/src/app.js"
click node_auth_routes "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/auth/auth.routes.js"
click node_auth_controller "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/auth/auth.controller.js"
click node_auth_service "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/auth/auth.service.js"
click node_players_routes "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/players/players.routes.js"
click node_players_controller "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/players/players.controller.js"
click node_players_service "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/players/players.service.js"
click node_orgs_routes "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/orgs/orgs.routes.js"
click node_orgs_controller "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/orgs/orgs.controller.js"
click node_orgs_service "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/orgs/orgs.service.js"
click node_discovery_routes "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/discovery/discovery.routes.js"
click node_discovery_controller "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/discovery/discovery.controller.js"
click node_discovery_service "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/discovery/discovery.service.js"
click node_social_routes "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/social/social.routes.js"
click node_social_controller "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/social/social.controller.js"
click node_social_service "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/social/social.service.js"
click node_messages_routes "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/messaging/messaging.routes.js"
click node_messages_controller "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/messaging/messaging.controller.js"
click node_messages_service "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/messaging/messaging.service.js"
click node_teams_routes "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/teams/teams.routes.js"
click node_teams_controller "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/teams/teams.controller.js"
click node_teams_service "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/teams/teams.service.js"
click node_recruitment_routes "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/recruitment/recruitment.routes.js"
click node_recruitment_controller "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/recruitment/recruitment.controller.js"
click node_recruitment_service "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/recruitment/recruitment.service.js"
click node_tournaments_routes "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/tournaments/tournaments.routes.js"
click node_tournaments_controller "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/tournaments/tournaments.controller.js"
click node_tournaments_service "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/tournaments/tournaments.service.js"
click node_admin_routes "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/admin/admin.routes.js"
click node_admin_controller "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/admin/admin.controller.js"
click node_admin_service "https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/admin/admin.service.js"
click node_middleware "https://github.com/aaryan218/game-ansh/blob/main/ars/src/shared/auth/middleware.js"
click node_jwt "https://github.com/aaryan218/game-ansh/blob/main/ars/src/shared/auth/jwt.js"

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_app,node_auth_routes,node_auth_controller,node_players_routes,node_players_controller,node_orgs_routes,node_orgs_controller,node_discovery_routes,node_discovery_controller,node_social_routes,node_social_controller,node_messages_routes,node_messages_controller,node_teams_routes,node_teams_controller,node_recruitment_routes,node_recruitment_controller,node_tournaments_routes,node_tournaments_controller,node_admin_routes,node_admin_controller,node_client toneBlue
class node_auth_service,node_players_service,node_orgs_service,node_discovery_service toneAmber
class node_social_service,node_messages_service toneMint
class node_teams_service,node_recruitment_service,node_tournaments_service toneRose
class node_admin_service,node_middleware,node_jwt toneIndigo
```

## Components

### API and access

- [Express app](https://github.com/aaryan218/game-ansh/blob/main/ars/src/app.js): `ars/src/app.js`
- [Auth routes](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/auth/auth.routes.js): `ars/src/modules/auth/auth.routes.js`
- [Auth handler](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/auth/auth.controller.js): `ars/src/modules/auth/auth.controller.js`
- [Player routes](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/players/players.routes.js): `ars/src/modules/players/players.routes.js`
- [Player handler](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/players/players.controller.js): `ars/src/modules/players/players.controller.js`
- [Organization routes](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/orgs/orgs.routes.js): `ars/src/modules/orgs/orgs.routes.js`
- [Organization handler](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/orgs/orgs.controller.js): `ars/src/modules/orgs/orgs.controller.js`
- [Discovery routes](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/discovery/discovery.routes.js): `ars/src/modules/discovery/discovery.routes.js`
- [Discovery handler](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/discovery/discovery.controller.js): `ars/src/modules/discovery/discovery.controller.js`
- [Social routes](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/social/social.routes.js): `ars/src/modules/social/social.routes.js`
- [Social handler](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/social/social.controller.js): `ars/src/modules/social/social.controller.js`
- [Messaging routes](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/messaging/messaging.routes.js): `ars/src/modules/messaging/messaging.routes.js`
- [Messaging handler](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/messaging/messaging.controller.js): `ars/src/modules/messaging/messaging.controller.js`
- [Team routes](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/teams/teams.routes.js): `ars/src/modules/teams/teams.routes.js`
- [Team handler](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/teams/teams.controller.js): `ars/src/modules/teams/teams.controller.js`
- [Recruitment routes](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/recruitment/recruitment.routes.js): `ars/src/modules/recruitment/recruitment.routes.js`
- [Recruitment handler](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/recruitment/recruitment.controller.js): `ars/src/modules/recruitment/recruitment.controller.js`
- [Tournament routes](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/tournaments/tournaments.routes.js): `ars/src/modules/tournaments/tournaments.routes.js`
- [Tournament handler](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/tournaments/tournaments.controller.js): `ars/src/modules/tournaments/tournaments.controller.js`
- [Admin routes](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/admin/admin.routes.js): `ars/src/modules/admin/admin.routes.js`
- [Admin handler](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/admin/admin.controller.js): `ars/src/modules/admin/admin.controller.js`

### Accounts and discovery

- [Account service](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/auth/auth.service.js): `ars/src/modules/auth/auth.service.js`
- [Player service](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/players/players.service.js): `ars/src/modules/players/players.service.js`
- [Organization service](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/orgs/orgs.service.js): `ars/src/modules/orgs/orgs.service.js`
- [Discovery service](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/discovery/discovery.service.js): `ars/src/modules/discovery/discovery.service.js`

### Community

- [Social service](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/social/social.service.js): `ars/src/modules/social/social.service.js`
- [Messaging service](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/messaging/messaging.service.js): `ars/src/modules/messaging/messaging.service.js`

### Teams and competition

- [Team service](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/teams/teams.service.js): `ars/src/modules/teams/teams.service.js`
- [Recruitment service](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/recruitment/recruitment.service.js): `ars/src/modules/recruitment/recruitment.service.js`
- [Tournament service](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/tournaments/tournaments.service.js): `ars/src/modules/tournaments/tournaments.service.js`

### Shared services

- [Admin service](https://github.com/aaryan218/game-ansh/blob/main/ars/src/modules/admin/admin.service.js): `ars/src/modules/admin/admin.service.js`
- [Auth middleware](https://github.com/aaryan218/game-ansh/blob/main/ars/src/shared/auth/middleware.js): `ars/src/shared/auth/middleware.js`
- [JWT utilities](https://github.com/aaryan218/game-ansh/blob/main/ars/src/shared/auth/jwt.js): `ars/src/shared/auth/jwt.js`

### Other components

- **API client**

## Connections

- API client → Express app: sends requests (evidence: `ars/src/app.js`)
- Express app → Auth routes: mounts routes (evidence: `ars/src/app.js`)
- Express app → Player routes: mounts routes (evidence: `ars/src/app.js`)
- Express app → Organization routes: mounts routes (evidence: `ars/src/app.js`)
- Express app → Discovery routes: mounts routes (evidence: `ars/src/app.js`)
- Express app → Social routes: mounts routes (evidence: `ars/src/app.js`)
- Express app → Messaging routes: mounts routes (evidence: `ars/src/app.js`)
- Express app → Team routes: mounts routes (evidence: `ars/src/app.js`)
- Express app → Recruitment routes: mounts routes (evidence: `ars/src/app.js`)
- Express app → Tournament routes: mounts routes (evidence: `ars/src/app.js`)
- Express app → Admin routes: mounts routes (evidence: `ars/src/app.js`)
- Auth routes → Auth handler: dispatches (evidence: `ars/src/modules/auth/auth.routes.js`)
- Player routes → Player handler: dispatches (evidence: `ars/src/modules/players/players.routes.js`)
- Organization routes → Organization handler: dispatches (evidence: `ars/src/modules/orgs/orgs.routes.js`)
- Discovery routes → Discovery handler: dispatches (evidence: `ars/src/modules/discovery/discovery.routes.js`)
- Social routes → Social handler: dispatches (evidence: `ars/src/modules/social/social.routes.js`)
- Messaging routes → Messaging handler: dispatches (evidence: `ars/src/modules/messaging/messaging.routes.js`)
- Team routes → Team handler: dispatches (evidence: `ars/src/modules/teams/teams.routes.js`)
- Recruitment routes → Recruitment handler: dispatches (evidence: `ars/src/modules/recruitment/recruitment.routes.js`)
- Tournament routes → Tournament handler: dispatches (evidence: `ars/src/modules/tournaments/tournaments.routes.js`)
- Admin routes → Admin handler: dispatches (evidence: `ars/src/modules/admin/admin.routes.js`)
- Auth handler → Account service: calls (evidence: `ars/src/modules/auth/auth.controller.js`)
- Player handler → Player service: calls (evidence: `ars/src/modules/players/players.controller.js`)
- Organization handler → Organization service: calls (evidence: `ars/src/modules/orgs/orgs.controller.js`)
- Discovery handler → Discovery service: calls (evidence: `ars/src/modules/discovery/discovery.controller.js`)
- Social handler → Social service: calls (evidence: `ars/src/modules/social/social.controller.js`)
- Messaging handler → Messaging service: calls (evidence: `ars/src/modules/messaging/messaging.controller.js`)
- Team handler → Team service: calls (evidence: `ars/src/modules/teams/teams.controller.js`)
- Recruitment handler → Recruitment service: calls (evidence: `ars/src/modules/recruitment/recruitment.controller.js`)
- Tournament handler → Tournament service: calls (evidence: `ars/src/modules/tournaments/tournaments.controller.js`)
- Admin handler → Admin service: calls (evidence: `ars/src/modules/admin/admin.controller.js`)
- Auth routes → Auth middleware: authenticates (evidence: `ars/src/modules/auth/auth.routes.js`)
- Player routes → Auth middleware: authenticates (evidence: `ars/src/modules/players/players.routes.js`)
- Organization routes → Auth middleware: authenticates (evidence: `ars/src/modules/orgs/orgs.routes.js`)
- Social routes → Auth middleware: authenticates (evidence: `ars/src/modules/social/social.routes.js`)
- Messaging routes → Auth middleware: authenticates (evidence: `ars/src/modules/messaging/messaging.routes.js`)
- Team routes → Auth middleware: authenticates (evidence: `ars/src/modules/teams/teams.routes.js`)
- Recruitment routes → Auth middleware: authenticates (evidence: `ars/src/modules/recruitment/recruitment.routes.js`)
- Tournament routes → Auth middleware: authenticates (evidence: `ars/src/modules/tournaments/tournaments.routes.js`)
- Admin routes → Auth middleware: authenticates (evidence: `ars/src/modules/admin/admin.routes.js`)
- Auth middleware → JWT utilities: verifies tokens (evidence: `ars/src/shared/auth/middleware.js`)
