# eternityradiance/lab4_oop architecture

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

- Interactive diagram: https://gitdiagram.com/eternityradiance/lab4_oop
- Repository: https://github.com/eternityradiance/lab4_oop

## Overview

The repository contains a Python equipment-management API and a separate Go web application. The evidenced API workflow is an HTTP request routed by FastAPI to domain repositories or direct database operations, with model objects returned through response schemas. Its domain covers equipment, armor, weapons, rifles, magic weapons, spells, and heroes. The Go tree suggests a web interface with handlers, business logic, caching, and proxying, but no README or excerpts establish its runtime connections or its relationship to the Python API; those links are therefore omitted.

Main entry points: [`python/repositories`](https://github.com/eternityradiance/lab4_oop/tree/main/python/repositories) (Domain repositories), [`python/api/routes.py`](https://github.com/eternityradiance/lab4_oop/blob/main/python/api/routes.py) (API routes), [`python/main.py`](https://github.com/eternityradiance/lab4_oop/blob/main/python/main.py) (FastAPI application), [`python/repositories/base_repository.py`](https://github.com/eternityradiance/lab4_oop/blob/main/python/repositories/base_repository.py) (CRUD repository base)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_go_app["Go web application"]
  node_go_main["Go server<br/>[main.go]"]
  node_go_handlers["HTTP handlers<br/>[handlers.go]"]
  node_go_business["Business logic<br/>[business.go]"]
  node_go_proxy["Proxy handlers<br/>[proxy.go]"]
  node_go_cache["Cache<br/>[cache.go]"]
  node_go_config["Configuration<br/>[config.go]"]
  node_go_ui["Web interface<br/>[app.js]"]
  node_go_templates["Page templates"]
end

subgraph group_api_runtime["Python API runtime"]
  node_api_app["FastAPI application<br/>[main.py]"]
  node_api_routes["API routes<br/>[routes.py]"]
  node_api_schemas["Request and response schemas<br/>[schemas.py]"]
end

subgraph group_domain["Equipment domain"]
  node_equipment_models["Equipment models<br/>[equipment.py]"]
  node_armor_model["Armor model<br/>[armor.py]"]
  node_weapon_models["Weapon models<br/>[weapon.py]"]
  node_rifle_model["Rifle model<br/>[rifle.py]"]
  node_magic_model["Magic weapon model<br/>[magic_weapon.py]"]
  node_spell_model["Spell model<br/>[spell.py]"]
  node_hero_model["Hero model<br/>[hero.py]"]
end

subgraph group_persistence["Persistence"]
  node_repositories["Domain repositories"]
  node_base_repository["CRUD repository base<br/>[base_repository.py]"]
end

node_user(("API client"))
node_database[("Relational database")]

node_user -->|"sends requests"| node_api_app
node_api_app -->|"registers routes"| node_api_routes
node_api_routes -->|"calls repositories"| node_repositories
node_api_routes -->|"uses models"| node_equipment_models
node_api_routes -->|"validates responses"| node_api_schemas
node_repositories -->|"extends CRUD"| node_base_repository
node_base_repository -->|"queries and commits"| node_database
node_api_routes -->|"queries and commits"| node_database
node_repositories -->|"loads armor"| node_armor_model
node_repositories -->|"loads weapons"| node_weapon_models
node_repositories -->|"loads rifles"| node_rifle_model
node_repositories -->|"loads magic weapons"| node_magic_model
node_repositories -->|"loads equipment"| node_equipment_models
node_repositories -->|"loads heroes"| node_hero_model
node_repositories -->|"loads spells"| node_spell_model

click node_go_main "https://github.com/eternityradiance/lab4_oop/blob/main/go/main.go"
click node_go_handlers "https://github.com/eternityradiance/lab4_oop/blob/main/go/handlers/handlers.go"
click node_go_business "https://github.com/eternityradiance/lab4_oop/blob/main/go/handlers/business.go"
click node_go_proxy "https://github.com/eternityradiance/lab4_oop/blob/main/go/handlers/proxy.go"
click node_go_cache "https://github.com/eternityradiance/lab4_oop/blob/main/go/cache/cache.go"
click node_go_config "https://github.com/eternityradiance/lab4_oop/blob/main/go/config/config.go"
click node_go_ui "https://github.com/eternityradiance/lab4_oop/blob/main/go/static/js/app.js"
click node_go_templates "https://github.com/eternityradiance/lab4_oop/tree/main/go/templates"
click node_api_app "https://github.com/eternityradiance/lab4_oop/blob/main/python/main.py"
click node_api_routes "https://github.com/eternityradiance/lab4_oop/blob/main/python/api/routes.py"
click node_api_schemas "https://github.com/eternityradiance/lab4_oop/blob/main/python/schemas/schemas.py"
click node_equipment_models "https://github.com/eternityradiance/lab4_oop/blob/main/python/models/equipment.py"
click node_armor_model "https://github.com/eternityradiance/lab4_oop/blob/main/python/models/armor.py"
click node_weapon_models "https://github.com/eternityradiance/lab4_oop/blob/main/python/models/weapon.py"
click node_rifle_model "https://github.com/eternityradiance/lab4_oop/blob/main/python/models/rifle.py"
click node_magic_model "https://github.com/eternityradiance/lab4_oop/blob/main/python/models/magic_weapon.py"
click node_spell_model "https://github.com/eternityradiance/lab4_oop/blob/main/python/models/spell.py"
click node_hero_model "https://github.com/eternityradiance/lab4_oop/blob/main/python/models/hero.py"
click node_repositories "https://github.com/eternityradiance/lab4_oop/tree/main/python/repositories"
click node_base_repository "https://github.com/eternityradiance/lab4_oop/blob/main/python/repositories/base_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_go_main,node_go_handlers,node_go_business,node_go_proxy,node_go_cache,node_go_config,node_go_ui,node_go_templates,node_user toneBlue
class node_api_app,node_api_routes,node_api_schemas,node_database toneAmber
class node_equipment_models,node_armor_model,node_weapon_models,node_rifle_model,node_magic_model,node_spell_model,node_hero_model toneMint
class node_repositories,node_base_repository toneRose
```

## Components

### Go web application

- [Go server](https://github.com/eternityradiance/lab4_oop/blob/main/go/main.go): `go/main.go`
- [HTTP handlers](https://github.com/eternityradiance/lab4_oop/blob/main/go/handlers/handlers.go): `go/handlers/handlers.go`
- [Business logic](https://github.com/eternityradiance/lab4_oop/blob/main/go/handlers/business.go): `go/handlers/business.go`
- [Proxy handlers](https://github.com/eternityradiance/lab4_oop/blob/main/go/handlers/proxy.go): `go/handlers/proxy.go`
- [Cache](https://github.com/eternityradiance/lab4_oop/blob/main/go/cache/cache.go): `go/cache/cache.go`
- [Configuration](https://github.com/eternityradiance/lab4_oop/blob/main/go/config/config.go): `go/config/config.go`
- [Web interface](https://github.com/eternityradiance/lab4_oop/blob/main/go/static/js/app.js): `go/static/js/app.js`
- [Page templates](https://github.com/eternityradiance/lab4_oop/tree/main/go/templates): `go/templates`

### Python API runtime

- [FastAPI application](https://github.com/eternityradiance/lab4_oop/blob/main/python/main.py): `python/main.py`
- [API routes](https://github.com/eternityradiance/lab4_oop/blob/main/python/api/routes.py): `python/api/routes.py`
- [Request and response schemas](https://github.com/eternityradiance/lab4_oop/blob/main/python/schemas/schemas.py): `python/schemas/schemas.py`

### Equipment domain

- [Equipment models](https://github.com/eternityradiance/lab4_oop/blob/main/python/models/equipment.py): `python/models/equipment.py`
- [Armor model](https://github.com/eternityradiance/lab4_oop/blob/main/python/models/armor.py): `python/models/armor.py`
- [Weapon models](https://github.com/eternityradiance/lab4_oop/blob/main/python/models/weapon.py): `python/models/weapon.py`
- [Rifle model](https://github.com/eternityradiance/lab4_oop/blob/main/python/models/rifle.py): `python/models/rifle.py`
- [Magic weapon model](https://github.com/eternityradiance/lab4_oop/blob/main/python/models/magic_weapon.py): `python/models/magic_weapon.py`
- [Spell model](https://github.com/eternityradiance/lab4_oop/blob/main/python/models/spell.py): `python/models/spell.py`
- [Hero model](https://github.com/eternityradiance/lab4_oop/blob/main/python/models/hero.py): `python/models/hero.py`

### Persistence

- [Domain repositories](https://github.com/eternityradiance/lab4_oop/tree/main/python/repositories): `python/repositories`
- [CRUD repository base](https://github.com/eternityradiance/lab4_oop/blob/main/python/repositories/base_repository.py): `python/repositories/base_repository.py`

### Other components

- **API client**
- **Relational database**

## Connections

- API client → FastAPI application: sends requests (evidence: `python/main.py`)
- FastAPI application → API routes: registers routes (evidence: `python/main.py`)
- API routes → Domain repositories: calls repositories (evidence: `python/api/routes.py`)
- API routes → Equipment models: uses models (evidence: `python/api/routes.py`)
- API routes → Request and response schemas: validates responses (evidence: `python/api/routes.py`)
- Domain repositories → CRUD repository base: extends CRUD (evidence: `python/repositories/armor_repository.py`)
- CRUD repository base → Relational database: queries and commits (evidence: `python/repositories/base_repository.py`)
- API routes → Relational database: queries and commits (evidence: `python/api/routes.py`)
- Domain repositories → Armor model: loads armor (evidence: `python/repositories/armor_repository.py`)
- Domain repositories → Weapon models: loads weapons (evidence: `python/repositories/weapon_repository.py`)
- Domain repositories → Rifle model: loads rifles (evidence: `python/repositories/rifle_repository.py`)
- Domain repositories → Magic weapon model: loads magic weapons (evidence: `python/repositories/magic_weapon_repository.py`)
- Domain repositories → Equipment models: loads equipment (evidence: `python/repositories/equipment_repository.py`)
- Domain repositories → Hero model: loads heroes (evidence: `python/repositories/hero_repository.py`)
- Domain repositories → Spell model: loads spells (evidence: `python/repositories/spell_repository.py`)
