# team-3-softserve-academy/tournamenthall architecture

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

- Interactive diagram: https://gitdiagram.com/team-3-softserve-academy/tournamenthall
- Repository: https://github.com/team-3-softserve-academy/tournamenthall

## Overview

TournamentHall is presented as a tournament-themed web application, but the README documents no detailed tournament features. The sampled Flask app supports a basic login form, session assignment, redirect to a knights-book route, and placeholder registration/logout routes. Separate SQLAlchemy models and role repositories define persistence, but the sampled app does not connect them to its routes. The runtime picture is therefore limited to demonstrated behavior; database wiring beyond the model/repository references is not inferred.

Main entry points: [`database/models.py`](https://github.com/team-3-softserve-academy/tournamenthall/blob/main/database/models.py) (Domain models), [`app/run.py`](https://github.com/team-3-softserve-academy/tournamenthall/blob/main/app/run.py) (Flask routes), [`database/repositories/user_repository.py`](https://github.com/team-3-softserve-academy/tournamenthall/blob/main/database/repositories/user_repository.py) (User repository), [`database/repositories/knight_repository.py`](https://github.com/team-3-softserve-academy/tournamenthall/blob/main/database/repositories/knight_repository.py) (Knight repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_flask["Flask routes<br/>[run.py]"]
  node_login_view["Login view<br/>[login.html]"]
  node_base_view["Base view<br/>[base.html]"]
end

subgraph group_persistence["Persistence"]
  node_models["Domain models<br/>[models.py]"]
  node_user_repo["User repository<br/>[user_repository.py]"]
  node_knight_repo["Knight repository"]
  node_lord_repo["Lord repository<br/>[lord_repository.py]"]
  node_folk_repo["Common folk repository"]
end

node_visitor(("Visitor"))
node_postgres[("PostgreSQL")]

node_visitor -->|"submits login"| node_flask
node_flask -->|"renders login"| node_login_view
node_flask -->|"renders page"| node_base_view
node_models -->|"creates tables"| node_postgres
node_user_repo -->|"queries models"| node_models
node_knight_repo -->|"creates and queries"| node_models
node_lord_repo -->|"creates and queries"| node_models
node_folk_repo -->|"creates and queries"| node_models

click node_flask "https://github.com/team-3-softserve-academy/tournamenthall/blob/main/app/run.py"
click node_login_view "https://github.com/team-3-softserve-academy/tournamenthall/blob/main/app/templates/login.html"
click node_base_view "https://github.com/team-3-softserve-academy/tournamenthall/blob/main/app/templates/base.html"
click node_models "https://github.com/team-3-softserve-academy/tournamenthall/blob/main/database/models.py"
click node_user_repo "https://github.com/team-3-softserve-academy/tournamenthall/blob/main/database/repositories/user_repository.py"
click node_knight_repo "https://github.com/team-3-softserve-academy/tournamenthall/blob/main/database/repositories/knight_repository.py"
click node_lord_repo "https://github.com/team-3-softserve-academy/tournamenthall/blob/main/database/repositories/lord_repository.py"
click node_folk_repo "https://github.com/team-3-softserve-academy/tournamenthall/blob/main/database/repositories/common_folk_repository.py"

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_flask,node_login_view,node_base_view toneBlue
class node_models,node_user_repo,node_knight_repo,node_lord_repo,node_folk_repo,node_postgres toneAmber
class node_visitor toneIndigo
```

## Components

### Web application

- [Flask routes](https://github.com/team-3-softserve-academy/tournamenthall/blob/main/app/run.py): `app/run.py`
- [Login view](https://github.com/team-3-softserve-academy/tournamenthall/blob/main/app/templates/login.html): `app/templates/login.html`
- [Base view](https://github.com/team-3-softserve-academy/tournamenthall/blob/main/app/templates/base.html): `app/templates/base.html`

### Persistence

- [Domain models](https://github.com/team-3-softserve-academy/tournamenthall/blob/main/database/models.py): `database/models.py`
- [User repository](https://github.com/team-3-softserve-academy/tournamenthall/blob/main/database/repositories/user_repository.py): `database/repositories/user_repository.py`
- [Knight repository](https://github.com/team-3-softserve-academy/tournamenthall/blob/main/database/repositories/knight_repository.py): `database/repositories/knight_repository.py`
- [Lord repository](https://github.com/team-3-softserve-academy/tournamenthall/blob/main/database/repositories/lord_repository.py): `database/repositories/lord_repository.py`
- [Common folk repository](https://github.com/team-3-softserve-academy/tournamenthall/blob/main/database/repositories/common_folk_repository.py): `database/repositories/common_folk_repository.py`

### Other components

- **Visitor**
- **PostgreSQL**

## Connections

- Visitor → Flask routes: submits login (evidence: `app/run.py`)
- Flask routes → Login view: renders login (evidence: `app/run.py`)
- Flask routes → Base view: renders page (evidence: `app/run.py`)
- Domain models → PostgreSQL: creates tables (evidence: `database/models.py`)
- User repository → Domain models: queries models (evidence: `database/repositories/user_repository.py`)
- Knight repository → Domain models: creates and queries (evidence: `database/repositories/knight_repository.py`)
- Lord repository → Domain models: creates and queries (evidence: `database/repositories/lord_repository.py`)
- Common folk repository → Domain models: creates and queries (evidence: `database/repositories/common_folk_repository.py`)
