# polisiv/demo_lab_management architecture

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

- Interactive diagram: https://gitdiagram.com/polisiv/demo_lab_management
- Repository: https://github.com/polisiv/demo_lab_management

## Overview

This is a laboratory experiment manager with a console workflow for inserting, deleting, updating, searching, and displaying experiments, plus a Swing interface for entry, search/detail, and deletion. Both use an in-memory database of long- and short-term experiment records. The source excerpts show the console dispatch and several database operations; the README is empty, and some modules are indexed but not excerpted, so their internal behavior and links are limited to relationships named in the source index.

Main entry points: [`src/database/Database.java`](https://github.com/polisiv/demo_lab_management/blob/main/src/database/Database.java) (Experiment database), [`Main.java`](https://github.com/polisiv/demo_lab_management/blob/main/Main.java) (Console menu), [`src/GUI/UI.java`](https://github.com/polisiv/demo_lab_management/blob/main/src/GUI/UI.java) (Swing interface), [`src/types/Long_term.java`](https://github.com/polisiv/demo_lab_management/blob/main/src/types/Long_term.java) (Long-term experiment)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_main["Console menu<br/>[Main.java]"]
  node_gui["Swing interface<br/>[UI.java]"]
end

subgraph group_operations["Experiment operations"]
  node_insert["Insert<br/>[Insert.java]"]
  node_delete["Delete<br/>[Delete.java]"]
  node_update["Update<br/>[Update.java]"]
  node_search["Search<br/>[Search.java]"]
  node_display["Display<br/>[Display.java]"]
end

subgraph group_storage["In-memory data"]
  node_database[("Experiment database<br/>[Database.java]")]
  node_contracts["Database contracts"]
end

subgraph group_domain["Experiment model"]
  node_experiment["Experiment base<br/>[Experiment.java]"]
  node_long_term["Long-term experiment<br/>[Long_term.java]"]
  node_short_term["Short-term experiment<br/>[Short_term.java]"]
  node_timable["Duration contract<br/>[timable.java]"]
end

node_console_user(("Console user"))
node_swing_user(("GUI user"))

node_console_user -->|"chooses option"| node_main
node_main -->|"dispatches insert"| node_insert
node_main -->|"dispatches delete"| node_delete
node_main -->|"dispatches update"| node_update
node_main -->|"dispatches search"| node_search
node_main -->|"dispatches display"| node_display
node_swing_user -->|"uses interface"| node_gui
node_gui -->|"adds records"| node_database
node_gui -->|"searches details"| node_database
node_gui -->|"removes records"| node_database
node_gui -->|"creates records"| node_long_term
node_gui -->|"creates records"| node_short_term
node_insert -->|"adds records"| node_database
node_insert -->|"creates records"| node_long_term
node_insert -->|"creates records"| node_short_term
node_delete -->|"removes matches"| node_database
node_search -->|"searches records"| node_database
node_display -->|"displays records"| node_database
node_database -->|"implements contracts"| node_contracts
node_database -->|"stores and searches"| node_experiment
node_database -->|"recognizes subtype"| node_long_term
node_database -->|"recognizes subtype"| node_short_term
node_long_term -->|"extends"| node_experiment
node_short_term -->|"extends"| node_experiment
node_long_term -->|"implements duration"| node_timable

click node_main "https://github.com/polisiv/demo_lab_management/blob/main/Main.java"
click node_gui "https://github.com/polisiv/demo_lab_management/blob/main/src/GUI/UI.java"
click node_insert "https://github.com/polisiv/demo_lab_management/blob/main/src/mainFunctions/Insert.java"
click node_delete "https://github.com/polisiv/demo_lab_management/blob/main/src/mainFunctions/Delete.java"
click node_update "https://github.com/polisiv/demo_lab_management/blob/main/src/mainFunctions/Update.java"
click node_search "https://github.com/polisiv/demo_lab_management/blob/main/src/mainFunctions/Search.java"
click node_display "https://github.com/polisiv/demo_lab_management/blob/main/src/mainFunctions/Display.java"
click node_database "https://github.com/polisiv/demo_lab_management/blob/main/src/database/Database.java"
click node_contracts "https://github.com/polisiv/demo_lab_management/tree/main/src/functions"
click node_experiment "https://github.com/polisiv/demo_lab_management/blob/main/src/types/Experiment.java"
click node_long_term "https://github.com/polisiv/demo_lab_management/blob/main/src/types/Long_term.java"
click node_short_term "https://github.com/polisiv/demo_lab_management/blob/main/src/types/Short_term.java"
click node_timable "https://github.com/polisiv/demo_lab_management/blob/main/src/functions/timable.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_main,node_gui,node_console_user,node_swing_user toneBlue
class node_insert,node_delete,node_update,node_search,node_display toneAmber
class node_database,node_contracts toneMint
class node_experiment,node_long_term,node_short_term,node_timable toneRose
```

## Components

### User interfaces

- [Console menu](https://github.com/polisiv/demo_lab_management/blob/main/Main.java): `Main.java`
- [Swing interface](https://github.com/polisiv/demo_lab_management/blob/main/src/GUI/UI.java): `src/GUI/UI.java`

### Experiment operations

- [Insert](https://github.com/polisiv/demo_lab_management/blob/main/src/mainFunctions/Insert.java): `src/mainFunctions/Insert.java`
- [Delete](https://github.com/polisiv/demo_lab_management/blob/main/src/mainFunctions/Delete.java): `src/mainFunctions/Delete.java`
- [Update](https://github.com/polisiv/demo_lab_management/blob/main/src/mainFunctions/Update.java): `src/mainFunctions/Update.java`
- [Search](https://github.com/polisiv/demo_lab_management/blob/main/src/mainFunctions/Search.java): `src/mainFunctions/Search.java`
- [Display](https://github.com/polisiv/demo_lab_management/blob/main/src/mainFunctions/Display.java): `src/mainFunctions/Display.java`

### In-memory data

- [Experiment database](https://github.com/polisiv/demo_lab_management/blob/main/src/database/Database.java): `src/database/Database.java`
- [Database contracts](https://github.com/polisiv/demo_lab_management/tree/main/src/functions): `src/functions`

### Experiment model

- [Experiment base](https://github.com/polisiv/demo_lab_management/blob/main/src/types/Experiment.java): `src/types/Experiment.java`
- [Long-term experiment](https://github.com/polisiv/demo_lab_management/blob/main/src/types/Long_term.java): `src/types/Long_term.java`
- [Short-term experiment](https://github.com/polisiv/demo_lab_management/blob/main/src/types/Short_term.java): `src/types/Short_term.java`
- [Duration contract](https://github.com/polisiv/demo_lab_management/blob/main/src/functions/timable.java): `src/functions/timable.java`

### Other components

- **Console user**
- **GUI user**

## Connections

- Console user → Console menu: chooses option (evidence: `Main.java`)
- Console menu → Insert: dispatches insert (evidence: `Main.java`)
- Console menu → Delete: dispatches delete (evidence: `Main.java`)
- Console menu → Update: dispatches update (evidence: `Main.java`)
- Console menu → Search: dispatches search (evidence: `Main.java`)
- Console menu → Display: dispatches display (evidence: `Main.java`)
- GUI user → Swing interface: uses interface (evidence: `src/GUI/UI.java`)
- Swing interface → Experiment database: adds records (evidence: `src/GUI/UI.java`)
- Swing interface → Experiment database: searches details (evidence: `src/GUI/UI.java`)
- Swing interface → Experiment database: removes records (evidence: `src/GUI/UI.java`)
- Swing interface → Long-term experiment: creates records (evidence: `src/GUI/UI.java`)
- Swing interface → Short-term experiment: creates records (evidence: `src/GUI/UI.java`)
- Insert → Experiment database: adds records (evidence: `src/mainFunctions/Insert.java`)
- Insert → Long-term experiment: creates records (evidence: `src/mainFunctions/Insert.java`)
- Insert → Short-term experiment: creates records (evidence: `src/mainFunctions/Insert.java`)
- Delete → Experiment database: removes matches (evidence: `src/mainFunctions/Delete.java`)
- Search → Experiment database: searches records (evidence: `src/mainFunctions/Search.java`)
- Display → Experiment database: displays records (evidence: `src/mainFunctions/Display.java`)
- Experiment database → Database contracts: implements contracts (evidence: `src/database/Database.java`)
- Experiment database → Experiment base: stores and searches (evidence: `src/database/Database.java`)
- Experiment database → Long-term experiment: recognizes subtype (evidence: `src/database/Database.java`)
- Experiment database → Short-term experiment: recognizes subtype (evidence: `src/database/Database.java`)
- Long-term experiment → Experiment base: extends (evidence: `src/types/Long_term.java`)
- Short-term experiment → Experiment base: extends (evidence: `src/types/Short_term.java`)
- Long-term experiment → Duration contract: implements duration (evidence: `src/types/Long_term.java`)
