# ber17lino/eventusssss architecture

> Architecture diagram of the GitHub repository ber17lino/eventusssss, 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/ber17lino/eventusssss
- Repository: https://github.com/ber17lino/eventusssss

## Overview

«Ивентус» is an event-recommendation product for Tyumen State University students. The main user journey is account access, entering competence-test results and interests, then receiving event recommendations; the API also supports event browsing and profile/action management. The Vue router exposes the user-facing screens, while FastAPI routes requests to API handlers that query PostgreSQL. The excerpts establish several backend calls and the profile view’s profile request; other view-to-API wiring and unsampled handler internals are not asserted.

Main entry points: [`frontend/src/router/index.js`](https://github.com/ber17lino/eventusssss/blob/main/frontend/src/router/index.js) (View routing), [`app/database.py`](https://github.com/ber17lino/eventusssss/blob/main/app/database.py) (Database sessions), [`app/main.py`](https://github.com/ber17lino/eventusssss/blob/main/app/main.py) (FastAPI app), [`app/api/users.py`](https://github.com/ber17lino/eventusssss/blob/main/app/api/users.py) (User and survey routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_vue_app["Vue app<br/>[App.vue]"]
  node_vue_router["View routing<br/>[index.js]"]
  node_home_view["Event discovery<br/>[HomeView.vue]"]
  node_login_view["Login<br/>[LoginView.vue]"]
  node_register_view["Registration<br/>[RegisterView.vue]"]
  node_survey_view["Competence survey<br/>[SurveyView.vue]"]
  node_interests_view["Interest selection<br/>[InterestsView.vue]"]
  node_profile_view["Student profile<br/>[ProfileView.vue]"]
  node_settings_view["Settings<br/>[SettingsView.vue]"]
  node_frontend_api["HTTP client<br/>[api.js]"]
end

subgraph group_api["API and services"]
  node_api_app["FastAPI app<br/>[main.py]"]
  node_auth_api["Authentication routes<br/>[auth.py]"]
  node_auth_service["Password and JWT<br/>[auth.py]"]
  node_users_api["User and survey routes<br/>[users.py]"]
  node_events_api["Event routes<br/>[events.py]"]
  node_recommendations_api["Recommendations and actions<br/>[recommendations.py]"]
end

subgraph group_domain["Student and event domain"]
  node_schemas["Request and response schemas<br/>[schemas.py]"]
  node_models["Domain models<br/>[models.py]"]
end

subgraph group_storage["Persistence"]
  node_database_access["Database sessions<br/>[database.py]"]
  node_postgres[("PostgreSQL schema<br/>[init.sql]")]
end

node_student(("Student"))

node_student -.->|"uses"| node_vue_router
node_vue_router -->|"renders"| node_vue_app
node_vue_router -->|"routes to"| node_home_view
node_vue_router -->|"routes to"| node_login_view
node_vue_router -->|"routes to"| node_register_view
node_vue_router -->|"routes to"| node_survey_view
node_vue_router -->|"routes to"| node_interests_view
node_vue_router -->|"routes to"| node_profile_view
node_vue_router -->|"routes to"| node_settings_view
node_profile_view -->|"requests through"| node_frontend_api
node_frontend_api -.->|"sends HTTP"| node_api_app
node_api_app -->|"registers routes"| node_auth_api
node_api_app -->|"registers routes"| node_users_api
node_api_app -->|"registers routes"| node_events_api
node_api_app -->|"registers routes"| node_recommendations_api
node_auth_api -->|"uses"| node_auth_service
node_auth_service -->|"gets session"| node_database_access
node_auth_api -->|"gets session"| node_database_access
node_users_api -->|"gets session"| node_database_access
node_events_api -->|"gets session"| node_database_access
node_recommendations_api -->|"gets session"| node_database_access
node_users_api -->|"uses types"| node_schemas
node_events_api -->|"uses types"| node_schemas
node_recommendations_api -->|"uses types"| node_schemas
node_database_access -->|"connects to"| node_postgres
node_profile_view -->|"loads profile"| node_users_api

click node_vue_app "https://github.com/ber17lino/eventusssss/blob/main/frontend/src/App.vue"
click node_vue_router "https://github.com/ber17lino/eventusssss/blob/main/frontend/src/router/index.js"
click node_home_view "https://github.com/ber17lino/eventusssss/blob/main/frontend/src/views/HomeView.vue"
click node_login_view "https://github.com/ber17lino/eventusssss/blob/main/frontend/src/views/LoginView.vue"
click node_register_view "https://github.com/ber17lino/eventusssss/blob/main/frontend/src/views/RegisterView.vue"
click node_survey_view "https://github.com/ber17lino/eventusssss/blob/main/frontend/src/views/SurveyView.vue"
click node_interests_view "https://github.com/ber17lino/eventusssss/blob/main/frontend/src/views/InterestsView.vue"
click node_profile_view "https://github.com/ber17lino/eventusssss/blob/main/frontend/src/views/ProfileView.vue"
click node_settings_view "https://github.com/ber17lino/eventusssss/blob/main/frontend/src/views/SettingsView.vue"
click node_frontend_api "https://github.com/ber17lino/eventusssss/blob/main/frontend/src/api.js"
click node_api_app "https://github.com/ber17lino/eventusssss/blob/main/app/main.py"
click node_auth_api "https://github.com/ber17lino/eventusssss/blob/main/app/api/auth.py"
click node_auth_service "https://github.com/ber17lino/eventusssss/blob/main/app/services/auth.py"
click node_users_api "https://github.com/ber17lino/eventusssss/blob/main/app/api/users.py"
click node_events_api "https://github.com/ber17lino/eventusssss/blob/main/app/api/events.py"
click node_recommendations_api "https://github.com/ber17lino/eventusssss/blob/main/app/api/recommendations.py"
click node_schemas "https://github.com/ber17lino/eventusssss/blob/main/app/schemas.py"
click node_models "https://github.com/ber17lino/eventusssss/blob/main/app/models.py"
click node_database_access "https://github.com/ber17lino/eventusssss/blob/main/app/database.py"
click node_postgres "https://github.com/ber17lino/eventusssss/blob/main/postgres/init.sql"

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_vue_app,node_vue_router,node_home_view,node_login_view,node_register_view,node_survey_view,node_interests_view,node_profile_view,node_settings_view,node_frontend_api toneBlue
class node_api_app,node_auth_api,node_auth_service,node_users_api,node_events_api,node_recommendations_api toneAmber
class node_schemas,node_models toneMint
class node_database_access,node_postgres toneRose
class node_student toneIndigo
```

## Components

### Web application

- [Vue app](https://github.com/ber17lino/eventusssss/blob/main/frontend/src/App.vue): `frontend/src/App.vue`
- [View routing](https://github.com/ber17lino/eventusssss/blob/main/frontend/src/router/index.js): `frontend/src/router/index.js`
- [Event discovery](https://github.com/ber17lino/eventusssss/blob/main/frontend/src/views/HomeView.vue): `frontend/src/views/HomeView.vue`
- [Login](https://github.com/ber17lino/eventusssss/blob/main/frontend/src/views/LoginView.vue): `frontend/src/views/LoginView.vue`
- [Registration](https://github.com/ber17lino/eventusssss/blob/main/frontend/src/views/RegisterView.vue): `frontend/src/views/RegisterView.vue`
- [Competence survey](https://github.com/ber17lino/eventusssss/blob/main/frontend/src/views/SurveyView.vue): `frontend/src/views/SurveyView.vue`
- [Interest selection](https://github.com/ber17lino/eventusssss/blob/main/frontend/src/views/InterestsView.vue): `frontend/src/views/InterestsView.vue`
- [Student profile](https://github.com/ber17lino/eventusssss/blob/main/frontend/src/views/ProfileView.vue): `frontend/src/views/ProfileView.vue`
- [Settings](https://github.com/ber17lino/eventusssss/blob/main/frontend/src/views/SettingsView.vue): `frontend/src/views/SettingsView.vue`
- [HTTP client](https://github.com/ber17lino/eventusssss/blob/main/frontend/src/api.js): `frontend/src/api.js`

### API and services

- [FastAPI app](https://github.com/ber17lino/eventusssss/blob/main/app/main.py): `app/main.py`
- [Authentication routes](https://github.com/ber17lino/eventusssss/blob/main/app/api/auth.py): `app/api/auth.py`
- [Password and JWT](https://github.com/ber17lino/eventusssss/blob/main/app/services/auth.py): `app/services/auth.py`
- [User and survey routes](https://github.com/ber17lino/eventusssss/blob/main/app/api/users.py): `app/api/users.py`
- [Event routes](https://github.com/ber17lino/eventusssss/blob/main/app/api/events.py): `app/api/events.py`
- [Recommendations and actions](https://github.com/ber17lino/eventusssss/blob/main/app/api/recommendations.py): `app/api/recommendations.py`

### Student and event domain

- [Request and response schemas](https://github.com/ber17lino/eventusssss/blob/main/app/schemas.py): `app/schemas.py`
- [Domain models](https://github.com/ber17lino/eventusssss/blob/main/app/models.py): `app/models.py`

### Persistence

- [Database sessions](https://github.com/ber17lino/eventusssss/blob/main/app/database.py): `app/database.py`
- [PostgreSQL schema](https://github.com/ber17lino/eventusssss/blob/main/postgres/init.sql): `postgres/init.sql`

### Other components

- **Student**

## Connections

- Student → View routing: uses
- View routing → Vue app: renders (evidence: `frontend/src/main.js`)
- View routing → Event discovery: routes to (evidence: `frontend/src/router/index.js`)
- View routing → Login: routes to (evidence: `frontend/src/router/index.js`)
- View routing → Registration: routes to (evidence: `frontend/src/router/index.js`)
- View routing → Competence survey: routes to (evidence: `frontend/src/router/index.js`)
- View routing → Interest selection: routes to (evidence: `frontend/src/router/index.js`)
- View routing → Student profile: routes to (evidence: `frontend/src/router/index.js`)
- View routing → Settings: routes to (evidence: `frontend/src/router/index.js`)
- Student profile → HTTP client: requests through (evidence: `frontend/src/views/ProfileView.vue`)
- HTTP client → FastAPI app: sends HTTP
- FastAPI app → Authentication routes: registers routes (evidence: `app/main.py`)
- FastAPI app → User and survey routes: registers routes (evidence: `app/main.py`)
- FastAPI app → Event routes: registers routes (evidence: `app/main.py`)
- FastAPI app → Recommendations and actions: registers routes (evidence: `app/main.py`)
- Authentication routes → Password and JWT: uses (evidence: `app/api/auth.py`)
- Password and JWT → Database sessions: gets session (evidence: `app/services/auth.py`)
- Authentication routes → Database sessions: gets session (evidence: `app/api/auth.py`)
- User and survey routes → Database sessions: gets session (evidence: `app/api/users.py`)
- Event routes → Database sessions: gets session (evidence: `app/api/events.py`)
- Recommendations and actions → Database sessions: gets session (evidence: `app/api/recommendations.py`)
- User and survey routes → Request and response schemas: uses types (evidence: `app/api/users.py`)
- Event routes → Request and response schemas: uses types (evidence: `app/api/events.py`)
- Recommendations and actions → Request and response schemas: uses types (evidence: `app/api/recommendations.py`)
- Database sessions → PostgreSQL schema: connects to (evidence: `app/database.py`)
- Student profile → User and survey routes: loads profile (evidence: `frontend/src/views/ProfileView.vue`)
