# wwwyssa/opilab3 architecture

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

## Overview

This repository contains two separate applications: a Docker tutorial todo service and a point-checking web application. The todo workflow serves a UI and exposes item CRUD routes backed by selectable SQLite or MySQL persistence. The point-checker workflow authenticates users, then lets them submit and view points with hit results. Backend Java components are represented from the tree, but their internal call relationships were not excerpted; those links are therefore omitted. The frontend-to-backend HTTP calls are visible in the Angular source.

Main entry points: [`dockerTutorial/app/src/index.js`](https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/index.js) (Express server), [`dockerTutorial/app/src/persistence/index.js`](https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/persistence/index.js) (Adapter selector), [`laba4/frontend/src/app/app.routes.ts`](https://github.com/wwwyssa/opilab3/blob/master/laba4/frontend/src/app/app.routes.ts) (UI routes), [`dockerTutorial/app/src/routes/getItems.js`](https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/routes/getItems.js) (List items)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_todo["Todo service"]
  node_todo_server["Express server<br/>[index.js]"]
  node_todo_ui["Todo interface<br/>[app.js]"]
  node_list_items["List items<br/>[getItems.js]"]
  node_add_item["Add item<br/>[addItem.js]"]
  node_update_item["Update item<br/>[updateItem.js]"]
  node_delete_item["Delete item<br/>[deleteItem.js]"]
end

subgraph group_todo_storage["Todo persistence"]
  node_persistence_select["Adapter selector<br/>[index.js]"]
  node_mysql_adapter["MySQL adapter<br/>[mysql.js]"]
  node_sqlite_adapter["SQLite adapter<br/>[sqlite.js]"]
  node_todo_database[("Todo database")]
end

subgraph group_point_ui["Point-checker UI"]
  node_angular_app["Angular app<br/>[app.ts]"]
  node_auth_view["Login/register<br/>[auth.component.ts]"]
  node_point_view["Point graph<br/>[home.component.ts]"]
  node_route_config["UI routes<br/>[app.routes.ts]"]
end

subgraph group_point_backend["Point-checker backend"]
  node_auth_api["Authentication API"]
  node_point_api["Point API"]
  node_auth_service["Auth service<br/>[AuthService.java]"]
  node_hit_service["Hit checker"]
  node_user_repository["User repository"]
  node_point_repository["Point repository"]
end

node_todo_user(("Todo user"))
node_point_user(("Point-checker user"))

node_todo_user -->|"sends requests"| node_todo_server
node_todo_server -->|"serves static"| node_todo_ui
node_todo_server -->|"routes GET"| node_list_items
node_todo_server -->|"routes POST"| node_add_item
node_todo_server -->|"routes PUT"| node_update_item
node_todo_server -->|"routes DELETE"| node_delete_item
node_list_items -->|"reads items"| node_persistence_select
node_add_item -->|"stores item"| node_persistence_select
node_update_item -->|"updates and reads"| node_persistence_select
node_delete_item -->|"removes item"| node_persistence_select
node_persistence_select -->|"selects by env"| node_mysql_adapter
node_persistence_select -->|"selects by env"| node_sqlite_adapter
node_mysql_adapter -->|"queries MySQL"| node_todo_database
node_sqlite_adapter -->|"queries SQLite"| node_todo_database
node_point_user -.->|"uses interface"| node_angular_app
node_angular_app -->|"loads routes"| node_route_config
node_route_config -->|"routes auth"| node_auth_view
node_route_config -->|"routes home"| node_point_view
node_auth_view -->|"posts credentials"| node_auth_api
node_point_view -->|"loads and submits"| node_point_api

click node_todo_server "https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/index.js"
click node_todo_ui "https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/static/js/app.js"
click node_list_items "https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/routes/getItems.js"
click node_add_item "https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/routes/addItem.js"
click node_update_item "https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/routes/updateItem.js"
click node_delete_item "https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/routes/deleteItem.js"
click node_persistence_select "https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/persistence/index.js"
click node_mysql_adapter "https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/persistence/mysql.js"
click node_sqlite_adapter "https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/persistence/sqlite.js"
click node_angular_app "https://github.com/wwwyssa/opilab3/blob/master/laba4/frontend/src/app/app.ts"
click node_auth_view "https://github.com/wwwyssa/opilab3/blob/master/laba4/frontend/src/app/auth/auth.component.ts"
click node_point_view "https://github.com/wwwyssa/opilab3/blob/master/laba4/frontend/src/app/home/home.component.ts"
click node_route_config "https://github.com/wwwyssa/opilab3/blob/master/laba4/frontend/src/app/app.routes.ts"
click node_auth_api "https://github.com/wwwyssa/opilab3/blob/master/laba4/src/main/java/com/example/laba4/auth/AuthController.java"
click node_point_api "https://github.com/wwwyssa/opilab3/blob/master/laba4/src/main/java/com/example/laba4/pointChecker/PointController.java"
click node_auth_service "https://github.com/wwwyssa/opilab3/blob/master/laba4/src/main/java/com/example/laba4/auth/AuthService.java"
click node_hit_service "https://github.com/wwwyssa/opilab3/blob/master/laba4/src/main/java/com/example/laba4/pointChecker/HitCheckService.java"
click node_user_repository "https://github.com/wwwyssa/opilab3/blob/master/laba4/src/main/java/com/example/laba4/auth/UserRepository.java"
click node_point_repository "https://github.com/wwwyssa/opilab3/blob/master/laba4/src/main/java/com/example/laba4/pointChecker/PointRepository.java"

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_todo_server,node_todo_ui,node_list_items,node_add_item,node_update_item,node_delete_item,node_todo_user,node_point_user toneBlue
class node_persistence_select,node_mysql_adapter,node_sqlite_adapter,node_todo_database toneAmber
class node_angular_app,node_auth_view,node_point_view,node_route_config toneMint
class node_auth_api,node_point_api,node_auth_service,node_hit_service,node_user_repository,node_point_repository toneRose
```

## Components

### Todo service

- [Express server](https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/index.js): `dockerTutorial/app/src/index.js`
- [Todo interface](https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/static/js/app.js): `dockerTutorial/app/src/static/js/app.js`
- [List items](https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/routes/getItems.js): `dockerTutorial/app/src/routes/getItems.js`
- [Add item](https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/routes/addItem.js): `dockerTutorial/app/src/routes/addItem.js`
- [Update item](https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/routes/updateItem.js): `dockerTutorial/app/src/routes/updateItem.js`
- [Delete item](https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/routes/deleteItem.js): `dockerTutorial/app/src/routes/deleteItem.js`

### Todo persistence

- [Adapter selector](https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/persistence/index.js): `dockerTutorial/app/src/persistence/index.js`
- [MySQL adapter](https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/persistence/mysql.js): `dockerTutorial/app/src/persistence/mysql.js`
- [SQLite adapter](https://github.com/wwwyssa/opilab3/blob/master/dockerTutorial/app/src/persistence/sqlite.js): `dockerTutorial/app/src/persistence/sqlite.js`
- **Todo database**

### Point-checker UI

- [Angular app](https://github.com/wwwyssa/opilab3/blob/master/laba4/frontend/src/app/app.ts): `laba4/frontend/src/app/app.ts`
- [Login/register](https://github.com/wwwyssa/opilab3/blob/master/laba4/frontend/src/app/auth/auth.component.ts): `laba4/frontend/src/app/auth/auth.component.ts`
- [Point graph](https://github.com/wwwyssa/opilab3/blob/master/laba4/frontend/src/app/home/home.component.ts): `laba4/frontend/src/app/home/home.component.ts`
- [UI routes](https://github.com/wwwyssa/opilab3/blob/master/laba4/frontend/src/app/app.routes.ts): `laba4/frontend/src/app/app.routes.ts`

### Point-checker backend

- [Authentication API](https://github.com/wwwyssa/opilab3/blob/master/laba4/src/main/java/com/example/laba4/auth/AuthController.java): `laba4/src/main/java/com/example/laba4/auth/AuthController.java`
- [Point API](https://github.com/wwwyssa/opilab3/blob/master/laba4/src/main/java/com/example/laba4/pointChecker/PointController.java): `laba4/src/main/java/com/example/laba4/pointChecker/PointController.java`
- [Auth service](https://github.com/wwwyssa/opilab3/blob/master/laba4/src/main/java/com/example/laba4/auth/AuthService.java): `laba4/src/main/java/com/example/laba4/auth/AuthService.java`
- [Hit checker](https://github.com/wwwyssa/opilab3/blob/master/laba4/src/main/java/com/example/laba4/pointChecker/HitCheckService.java): `laba4/src/main/java/com/example/laba4/pointChecker/HitCheckService.java`
- [User repository](https://github.com/wwwyssa/opilab3/blob/master/laba4/src/main/java/com/example/laba4/auth/UserRepository.java): `laba4/src/main/java/com/example/laba4/auth/UserRepository.java`
- [Point repository](https://github.com/wwwyssa/opilab3/blob/master/laba4/src/main/java/com/example/laba4/pointChecker/PointRepository.java): `laba4/src/main/java/com/example/laba4/pointChecker/PointRepository.java`

### Other components

- **Todo user**
- **Point-checker user**

## Connections

- Todo user → Express server: sends requests (evidence: `dockerTutorial/app/src/index.js`)
- Express server → Todo interface: serves static (evidence: `dockerTutorial/app/src/index.js`)
- Express server → List items: routes GET (evidence: `dockerTutorial/app/src/index.js`)
- Express server → Add item: routes POST (evidence: `dockerTutorial/app/src/index.js`)
- Express server → Update item: routes PUT (evidence: `dockerTutorial/app/src/index.js`)
- Express server → Delete item: routes DELETE (evidence: `dockerTutorial/app/src/index.js`)
- List items → Adapter selector: reads items (evidence: `dockerTutorial/app/src/routes/getItems.js`)
- Add item → Adapter selector: stores item (evidence: `dockerTutorial/app/src/routes/addItem.js`)
- Update item → Adapter selector: updates and reads (evidence: `dockerTutorial/app/src/routes/updateItem.js`)
- Delete item → Adapter selector: removes item (evidence: `dockerTutorial/app/src/routes/deleteItem.js`)
- Adapter selector → MySQL adapter: selects by env (evidence: `dockerTutorial/app/src/persistence/index.js`)
- Adapter selector → SQLite adapter: selects by env (evidence: `dockerTutorial/app/src/persistence/index.js`)
- MySQL adapter → Todo database: queries MySQL (evidence: `dockerTutorial/app/src/persistence/mysql.js`)
- SQLite adapter → Todo database: queries SQLite (evidence: `dockerTutorial/app/src/persistence/sqlite.js`)
- Point-checker user → Angular app: uses interface
- Angular app → UI routes: loads routes (evidence: `laba4/frontend/src/app/app.ts`)
- UI routes → Login/register: routes auth (evidence: `laba4/frontend/src/app/app.routes.ts`)
- UI routes → Point graph: routes home (evidence: `laba4/frontend/src/app/app.routes.ts`)
- Login/register → Authentication API: posts credentials (evidence: `laba4/frontend/src/app/auth/auth.component.ts`)
- Point graph → Point API: loads and submits (evidence: `laba4/frontend/src/app/home/home.component.ts`)
