# brunn0b/uran architecture

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

- Interactive diagram: https://gitdiagram.com/brunn0b/uran
- Repository: https://github.com/brunn0b/uran

## Overview

Clan Uran is a clan-management portal for World of Warships: members and administrators sign in, manage the roster, publish ship builds and redeem codes, and view fleet statistics. The server mounts separate page, authentication, content, and statistics routes; route handlers access MongoDB-backed models, and code publication can send a Discord alert. The tree also shows browser scripts and EJS views for these capabilities. Their detailed wiring is not established by the available excerpts, so those links are omitted.

Main entry points: [`server.js`](https://github.com/brunn0b/uran/blob/main/server.js) (Express server), [`middleware/auth.js`](https://github.com/brunn0b/uran/blob/main/middleware/auth.js) (Session authorization), [`routes/codes.js`](https://github.com/brunn0b/uran/blob/main/routes/codes.js) (Redeem codes), [`routes/stats.js`](https://github.com/brunn0b/uran/blob/main/routes/stats.js) (Clan statistics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_server["Server and access"]
  node_server_app["Express server<br/>[server.js]"]
  node_db_connect["Database connection<br/>[db.js]"]
  node_auth_guard["Session authorization<br/>[auth.js]"]
  node_error_handler["Error handling<br/>[errorHandler.js]"]
  node_admin_auth["Admin login<br/>[auth.js]"]
end

subgraph group_content["Clan content"]
  node_build_routes["Build management<br/>[builds.js]"]
  node_build_model["Build records<br/>[Build.js]"]
  node_code_routes["Redeem codes<br/>[codes.js]"]
  node_code_model["Code records<br/>[RedeemCode.js]"]
  node_discord_alerts["Code alerts<br/>[discord.js]"]
end

subgraph group_members["Member accounts"]
  node_member_routes["Roster management<br/>[members.js]"]
  node_member_auth["Member registration<br/>[memberAuth.js]"]
  node_member_model["Member records<br/>[Member.js]"]
end

subgraph group_insights["Statistics"]
  node_member_stats["Member performance<br/>[memberStats.js]"]
  node_stats_routes["Clan statistics<br/>[stats.js]"]
end

subgraph group_interface["Web interface"]
  node_pages["Page routing<br/>[pages.js]"]
  node_views["Page templates"]
  node_build_ui["Build browser UI<br/>[builds.js]"]
  node_build_form_ui["Build editor UI<br/>[build-form.js]"]
  node_codes_ui["Code browser UI<br/>[codigos.js]"]
  node_code_form_ui["Code editor UI<br/>[code-form.js]"]
  node_roster_ui["Roster browser UI<br/>[membros.js]"]
  node_member_login_ui["Member login UI<br/>[entrar.js]"]
  node_profile_ui["Profile UI<br/>[perfil.js]"]
  node_performance_ui["Performance UI<br/>[desempenho.js]"]
  node_statistics_ui["Statistics UI<br/>[estatisticas.js]"]
  node_admin_ui["Admin UI<br/>[admin.js]"]
end

node_visitor(("Visitor"))
node_admin(("Administrator"))
node_clan_member(("Clan member"))
node_discord["Discord webhook"]
node_mongo[("MongoDB")]

node_visitor -->|"requests pages"| node_server_app
node_admin -.->|"uses portal"| node_server_app
node_clan_member -.->|"uses portal"| node_server_app
node_server_app -->|"connects database"| node_db_connect
node_db_connect -->|"connects"| node_mongo
node_server_app -->|"mounts routes"| node_pages
node_server_app -->|"mounts routes"| node_admin_auth
node_server_app -->|"mounts routes"| node_build_routes
node_server_app -->|"mounts routes"| node_member_routes
node_server_app -->|"mounts routes"| node_code_routes
node_server_app -->|"mounts routes"| node_stats_routes
node_server_app -->|"mounts routes"| node_member_auth
node_server_app -->|"mounts routes"| node_member_stats
node_server_app -->|"handles errors"| node_error_handler
node_member_auth -->|"requires member session"| node_auth_guard
node_member_auth -->|"reads and updates"| node_member_model
node_member_routes -->|"uses authorization"| node_auth_guard
node_member_routes -->|"accesses records"| node_member_model
node_member_stats -->|"accesses records"| node_member_model
node_build_routes -->|"uses authorization"| node_auth_guard
node_build_routes -->|"accesses records"| node_build_model
node_code_routes -->|"uses authorization"| node_auth_guard
node_code_routes -->|"reads and writes"| node_code_model
node_code_routes -->|"sends code alerts"| node_discord_alerts
node_discord_alerts -->|"posts webhook"| node_discord
node_stats_routes -->|"aggregates builds"| node_build_model
node_stats_routes -->|"aggregates members"| node_member_model
node_stats_routes -->|"counts active codes"| node_code_model
node_pages -->|"uses page authorization"| node_auth_guard
node_server_app -.->|"renders pages"| node_views

click node_server_app "https://github.com/brunn0b/uran/blob/main/server.js"
click node_db_connect "https://github.com/brunn0b/uran/blob/main/config/db.js"
click node_auth_guard "https://github.com/brunn0b/uran/blob/main/middleware/auth.js"
click node_error_handler "https://github.com/brunn0b/uran/blob/main/middleware/errorHandler.js"
click node_admin_auth "https://github.com/brunn0b/uran/blob/main/routes/auth.js"
click node_pages "https://github.com/brunn0b/uran/blob/main/routes/pages.js"
click node_build_routes "https://github.com/brunn0b/uran/blob/main/routes/builds.js"
click node_build_model "https://github.com/brunn0b/uran/blob/main/models/Build.js"
click node_code_routes "https://github.com/brunn0b/uran/blob/main/routes/codes.js"
click node_code_model "https://github.com/brunn0b/uran/blob/main/models/RedeemCode.js"
click node_discord_alerts "https://github.com/brunn0b/uran/blob/main/utils/discord.js"
click node_member_routes "https://github.com/brunn0b/uran/blob/main/routes/members.js"
click node_member_auth "https://github.com/brunn0b/uran/blob/main/routes/memberAuth.js"
click node_member_stats "https://github.com/brunn0b/uran/blob/main/routes/memberStats.js"
click node_member_model "https://github.com/brunn0b/uran/blob/main/models/Member.js"
click node_stats_routes "https://github.com/brunn0b/uran/blob/main/routes/stats.js"
click node_views "https://github.com/brunn0b/uran/tree/main/views"
click node_build_ui "https://github.com/brunn0b/uran/blob/main/public/js/builds.js"
click node_build_form_ui "https://github.com/brunn0b/uran/blob/main/public/js/build-form.js"
click node_codes_ui "https://github.com/brunn0b/uran/blob/main/public/js/codigos.js"
click node_code_form_ui "https://github.com/brunn0b/uran/blob/main/public/js/code-form.js"
click node_roster_ui "https://github.com/brunn0b/uran/blob/main/public/js/membros.js"
click node_member_login_ui "https://github.com/brunn0b/uran/blob/main/public/js/entrar.js"
click node_profile_ui "https://github.com/brunn0b/uran/blob/main/public/js/perfil.js"
click node_performance_ui "https://github.com/brunn0b/uran/blob/main/public/js/desempenho.js"
click node_statistics_ui "https://github.com/brunn0b/uran/blob/main/public/js/estatisticas.js"
click node_admin_ui "https://github.com/brunn0b/uran/blob/main/public/js/admin.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_server_app,node_db_connect,node_auth_guard,node_error_handler,node_admin_auth toneBlue
class node_build_routes,node_build_model,node_code_routes,node_code_model,node_discord_alerts,node_mongo toneAmber
class node_member_routes,node_member_auth,node_member_model,node_discord toneMint
class node_member_stats,node_stats_routes toneRose
class node_pages,node_views,node_build_ui,node_build_form_ui,node_codes_ui,node_code_form_ui,node_roster_ui,node_member_login_ui,node_profile_ui,node_performance_ui,node_statistics_ui,node_admin_ui,node_visitor,node_admin,node_clan_member toneIndigo
```

## Components

### Server and access

- [Express server](https://github.com/brunn0b/uran/blob/main/server.js): `server.js`
- [Database connection](https://github.com/brunn0b/uran/blob/main/config/db.js): `config/db.js`
- [Session authorization](https://github.com/brunn0b/uran/blob/main/middleware/auth.js): `middleware/auth.js`
- [Error handling](https://github.com/brunn0b/uran/blob/main/middleware/errorHandler.js): `middleware/errorHandler.js`
- [Admin login](https://github.com/brunn0b/uran/blob/main/routes/auth.js): `routes/auth.js`

### Clan content

- [Build management](https://github.com/brunn0b/uran/blob/main/routes/builds.js): `routes/builds.js`
- [Build records](https://github.com/brunn0b/uran/blob/main/models/Build.js): `models/Build.js`
- [Redeem codes](https://github.com/brunn0b/uran/blob/main/routes/codes.js): `routes/codes.js`
- [Code records](https://github.com/brunn0b/uran/blob/main/models/RedeemCode.js): `models/RedeemCode.js`
- [Code alerts](https://github.com/brunn0b/uran/blob/main/utils/discord.js): `utils/discord.js`

### Member accounts

- [Roster management](https://github.com/brunn0b/uran/blob/main/routes/members.js): `routes/members.js`
- [Member registration](https://github.com/brunn0b/uran/blob/main/routes/memberAuth.js): `routes/memberAuth.js`
- [Member records](https://github.com/brunn0b/uran/blob/main/models/Member.js): `models/Member.js`

### Statistics

- [Member performance](https://github.com/brunn0b/uran/blob/main/routes/memberStats.js): `routes/memberStats.js`
- [Clan statistics](https://github.com/brunn0b/uran/blob/main/routes/stats.js): `routes/stats.js`

### Web interface

- [Page routing](https://github.com/brunn0b/uran/blob/main/routes/pages.js): `routes/pages.js`
- [Page templates](https://github.com/brunn0b/uran/tree/main/views): `views`
- [Build browser UI](https://github.com/brunn0b/uran/blob/main/public/js/builds.js): `public/js/builds.js`
- [Build editor UI](https://github.com/brunn0b/uran/blob/main/public/js/build-form.js): `public/js/build-form.js`
- [Code browser UI](https://github.com/brunn0b/uran/blob/main/public/js/codigos.js): `public/js/codigos.js`
- [Code editor UI](https://github.com/brunn0b/uran/blob/main/public/js/code-form.js): `public/js/code-form.js`
- [Roster browser UI](https://github.com/brunn0b/uran/blob/main/public/js/membros.js): `public/js/membros.js`
- [Member login UI](https://github.com/brunn0b/uran/blob/main/public/js/entrar.js): `public/js/entrar.js`
- [Profile UI](https://github.com/brunn0b/uran/blob/main/public/js/perfil.js): `public/js/perfil.js`
- [Performance UI](https://github.com/brunn0b/uran/blob/main/public/js/desempenho.js): `public/js/desempenho.js`
- [Statistics UI](https://github.com/brunn0b/uran/blob/main/public/js/estatisticas.js): `public/js/estatisticas.js`
- [Admin UI](https://github.com/brunn0b/uran/blob/main/public/js/admin.js): `public/js/admin.js`

### Other components

- **Visitor**
- **Administrator**
- **Clan member**
- **Discord webhook**
- **MongoDB**

## Connections

- Visitor → Express server: requests pages (evidence: `server.js`)
- Administrator → Express server: uses portal
- Clan member → Express server: uses portal
- Express server → Database connection: connects database (evidence: `server.js`)
- Database connection → MongoDB: connects (evidence: `config/db.js`)
- Express server → Page routing: mounts routes (evidence: `server.js`)
- Express server → Admin login: mounts routes (evidence: `server.js`)
- Express server → Build management: mounts routes (evidence: `server.js`)
- Express server → Roster management: mounts routes (evidence: `server.js`)
- Express server → Redeem codes: mounts routes (evidence: `server.js`)
- Express server → Clan statistics: mounts routes (evidence: `server.js`)
- Express server → Member registration: mounts routes (evidence: `server.js`)
- Express server → Member performance: mounts routes (evidence: `server.js`)
- Express server → Error handling: handles errors (evidence: `server.js`)
- Member registration → Session authorization: requires member session (evidence: `routes/memberAuth.js`)
- Member registration → Member records: reads and updates (evidence: `routes/memberAuth.js`)
- Roster management → Session authorization: uses authorization (evidence: `middleware/auth.js`)
- Roster management → Member records: accesses records (evidence: `routes/members.js`)
- Member performance → Member records: accesses records (evidence: `routes/memberStats.js`)
- Build management → Session authorization: uses authorization (evidence: `routes/builds.js`)
- Build management → Build records: accesses records (evidence: `routes/builds.js`)
- Redeem codes → Session authorization: uses authorization (evidence: `routes/codes.js`)
- Redeem codes → Code records: reads and writes (evidence: `routes/codes.js`)
- Redeem codes → Code alerts: sends code alerts (evidence: `routes/codes.js`)
- Code alerts → Discord webhook: posts webhook (evidence: `utils/discord.js`)
- Clan statistics → Build records: aggregates builds (evidence: `routes/stats.js`)
- Clan statistics → Member records: aggregates members (evidence: `routes/stats.js`)
- Clan statistics → Code records: counts active codes (evidence: `routes/stats.js`)
- Page routing → Session authorization: uses page authorization (evidence: `middleware/auth.js`)
- Express server → Page templates: renders pages
