# alexanderminko/eva2.0 architecture

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

- Interactive diagram: https://gitdiagram.com/alexanderminko/eva2.0
- Repository: https://github.com/alexanderminko/eva2.0

## Overview

Eva is a desktop English vocabulary-learning application. Users browse and sort vocabulary, inspect meanings and examples, and update learning details; a separate word-gym panel supports practice. Services coordinate searches and updates over repositories that persist the vocabulary data, while Swing panels present the results. Domain objects capture words, meanings, examples, and learning metadata. The README is empty, so capability coverage is limited to the source tree and indexed references; some UI-to-service links are documented by those references rather than inspected implementation excerpts.

Main entry points: [`src/main/java/com/english/eva/ui/panel/VocabularyPanel.java`](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/panel/VocabularyPanel.java) (Vocabulary browser), [`src/main/java/com/english/eva/ui/frame/ApplicationFrame.java`](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/frame/ApplicationFrame.java) (Application frame), [`src/main/java/com/english/eva/service/WordService.java`](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/service/WordService.java) (Word service), [`src/main/java/com/english/eva/service/MeaningService.java`](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/service/MeaningService.java) (Meaning service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_app["App startup<br/>[App.java]"]
  node_frame["Application frame"]
  node_vocab["Vocabulary browser"]
  node_words["Words table<br/>[WordsTable.java]"]
  node_meaningtree["Meaning tree<br/>[MeaningTree.java]"]
  node_gym["Word gym<br/>[WordGymPanel.java]"]
  node_settings["Search settings<br/>[SettingsPanel.java]"]
  node_meaning_settings["Meaning settings"]
  node_statistics["Statistics panel"]
end

subgraph group_services["Learning services"]
  node_wordservice["Word service<br/>[WordService.java]"]
  node_meaningservice["Meaning service"]
end

subgraph group_storage["Persistence"]
  node_wordrepo["Word repository"]
  node_meaningrepo["Meaning repository"]
  node_examplerepo["Example repository"]
  node_database[("Relational database")]
end

subgraph group_domain["Vocabulary model"]
  node_domain["Words, meanings, examples"]
  node_searchparams["Search parameters"]
end

node_user(("Learner"))

node_user -->|"uses"| node_frame
node_app -->|"opens"| node_frame
node_app -->|"wires"| node_wordservice
node_app -->|"wires"| node_meaningservice
node_frame -->|"shows"| node_vocab
node_frame -->|"shows"| node_gym
node_frame -->|"provides"| node_meaningservice
node_frame -->|"provides"| node_wordservice
node_vocab -->|"uses"| node_words
node_vocab -->|"shows"| node_meaningtree
node_vocab -->|"uses"| node_settings
node_vocab -->|"queries"| node_wordservice
node_vocab -->|"queries"| node_meaningservice
node_words -->|"loads"| node_wordservice
node_meaningtree -->|"renders"| node_domain
node_gym -->|"searches"| node_meaningservice
node_gym -->|"configures"| node_searchparams
node_meaning_settings -->|"configures"| node_searchparams
node_settings -->|"configures"| node_searchparams
node_statistics -->|"uses"| node_searchparams
node_wordservice -->|"delegates"| node_wordrepo
node_wordservice -->|"loads meanings"| node_meaningrepo
node_meaningservice -->|"delegates"| node_meaningrepo
node_meaningservice -->|"updates"| node_wordrepo
node_meaningrepo -->|"loads examples"| node_examplerepo
node_wordrepo -->|"loads meanings"| node_meaningrepo
node_meaningrepo -->|"reads/writes"| node_database
node_examplerepo -->|"reads/writes"| node_database

click node_app "https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/App.java"
click node_frame "https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/frame/ApplicationFrame.java"
click node_vocab "https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/panel/VocabularyPanel.java"
click node_words "https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/word/WordsTable.java"
click node_meaningtree "https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/meaning/MeaningTree.java"
click node_gym "https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/panel/WordGymPanel.java"
click node_settings "https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/settings/SettingsPanel.java"
click node_meaning_settings "https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/settings/MeaningSettingsPanel.java"
click node_statistics "https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/settings/StatisticPanel.java"
click node_wordservice "https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/service/WordService.java"
click node_meaningservice "https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/service/MeaningService.java"
click node_wordrepo "https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/repository/WordRepository.java"
click node_meaningrepo "https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/repository/MeaningRepository.java"
click node_examplerepo "https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/repository/ExampleRepository.java"
click node_domain "https://github.com/alexanderminko/eva2.0/tree/main/src/main/java/com/english/eva/domain"
click node_searchparams "https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/model/MeaningSearchParams.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_app,node_frame,node_vocab,node_words,node_meaningtree,node_gym,node_settings,node_meaning_settings,node_statistics toneBlue
class node_wordservice,node_meaningservice toneAmber
class node_wordrepo,node_meaningrepo,node_examplerepo,node_database toneMint
class node_domain,node_searchparams toneRose
class node_user toneIndigo
```

## Components

### Desktop interface

- [App startup](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/App.java): `src/main/java/com/english/eva/App.java`
- [Application frame](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/frame/ApplicationFrame.java): `src/main/java/com/english/eva/ui/frame/ApplicationFrame.java`
- [Vocabulary browser](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/panel/VocabularyPanel.java): `src/main/java/com/english/eva/ui/panel/VocabularyPanel.java`
- [Words table](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/word/WordsTable.java): `src/main/java/com/english/eva/ui/word/WordsTable.java`
- [Meaning tree](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/meaning/MeaningTree.java): `src/main/java/com/english/eva/ui/meaning/MeaningTree.java`
- [Word gym](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/panel/WordGymPanel.java): `src/main/java/com/english/eva/ui/panel/WordGymPanel.java`
- [Search settings](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/settings/SettingsPanel.java): `src/main/java/com/english/eva/ui/settings/SettingsPanel.java`
- [Meaning settings](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/settings/MeaningSettingsPanel.java): `src/main/java/com/english/eva/ui/settings/MeaningSettingsPanel.java`
- [Statistics panel](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/ui/settings/StatisticPanel.java): `src/main/java/com/english/eva/ui/settings/StatisticPanel.java`

### Learning services

- [Word service](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/service/WordService.java): `src/main/java/com/english/eva/service/WordService.java`
- [Meaning service](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/service/MeaningService.java): `src/main/java/com/english/eva/service/MeaningService.java`

### Persistence

- [Word repository](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/repository/WordRepository.java): `src/main/java/com/english/eva/repository/WordRepository.java`
- [Meaning repository](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/repository/MeaningRepository.java): `src/main/java/com/english/eva/repository/MeaningRepository.java`
- [Example repository](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/repository/ExampleRepository.java): `src/main/java/com/english/eva/repository/ExampleRepository.java`
- **Relational database**

### Vocabulary model

- [Words, meanings, examples](https://github.com/alexanderminko/eva2.0/tree/main/src/main/java/com/english/eva/domain): `src/main/java/com/english/eva/domain`
- [Search parameters](https://github.com/alexanderminko/eva2.0/blob/main/src/main/java/com/english/eva/model/MeaningSearchParams.java): `src/main/java/com/english/eva/model/MeaningSearchParams.java`

### Other components

- **Learner**

## Connections

- Learner → Application frame: uses (evidence: `src/main/java/com/english/eva/ui/frame/ApplicationFrame.java`)
- App startup → Application frame: opens (evidence: `src/main/java/com/english/eva/App.java`)
- App startup → Word service: wires (evidence: `src/main/java/com/english/eva/App.java`)
- App startup → Meaning service: wires (evidence: `src/main/java/com/english/eva/App.java`)
- Application frame → Vocabulary browser: shows (evidence: `src/main/java/com/english/eva/ui/frame/ApplicationFrame.java`)
- Application frame → Word gym: shows (evidence: `src/main/java/com/english/eva/ui/frame/ApplicationFrame.java`)
- Application frame → Meaning service: provides (evidence: `src/main/java/com/english/eva/ui/frame/ApplicationFrame.java`)
- Application frame → Word service: provides (evidence: `src/main/java/com/english/eva/ui/frame/ApplicationFrame.java`)
- Vocabulary browser → Words table: uses (evidence: `src/main/java/com/english/eva/ui/panel/VocabularyPanel.java`)
- Vocabulary browser → Meaning tree: shows (evidence: `src/main/java/com/english/eva/ui/panel/VocabularyPanel.java`)
- Vocabulary browser → Search settings: uses (evidence: `src/main/java/com/english/eva/ui/panel/VocabularyPanel.java`)
- Vocabulary browser → Word service: queries (evidence: `src/main/java/com/english/eva/ui/panel/VocabularyPanel.java`)
- Vocabulary browser → Meaning service: queries (evidence: `src/main/java/com/english/eva/ui/panel/VocabularyPanel.java`)
- Words table → Word service: loads (evidence: `src/main/java/com/english/eva/ui/word/WordsTable.java`)
- Meaning tree → Words, meanings, examples: renders (evidence: `src/main/java/com/english/eva/ui/meaning/MeaningTree.java`)
- Word gym → Meaning service: searches (evidence: `src/main/java/com/english/eva/ui/panel/WordGymPanel.java`)
- Word gym → Search parameters: configures (evidence: `src/main/java/com/english/eva/ui/panel/WordGymPanel.java`)
- Meaning settings → Search parameters: configures (evidence: `src/main/java/com/english/eva/ui/settings/MeaningSettingsPanel.java`)
- Search settings → Search parameters: configures (evidence: `src/main/java/com/english/eva/ui/settings/SettingsPanel.java`)
- Statistics panel → Search parameters: uses (evidence: `src/main/java/com/english/eva/model/MeaningSearchParams.java`)
- Word service → Word repository: delegates (evidence: `src/main/java/com/english/eva/service/WordService.java`)
- Word service → Meaning repository: loads meanings (evidence: `src/main/java/com/english/eva/service/WordService.java`)
- Meaning service → Meaning repository: delegates (evidence: `src/main/java/com/english/eva/service/MeaningService.java`)
- Meaning service → Word repository: updates (evidence: `src/main/java/com/english/eva/service/MeaningService.java`)
- Meaning repository → Example repository: loads examples (evidence: `src/main/java/com/english/eva/repository/MeaningRepository.java`)
- Word repository → Meaning repository: loads meanings (evidence: `src/main/java/com/english/eva/repository/WordRepository.java`)
- Meaning repository → Relational database: reads/writes (evidence: `src/main/java/com/english/eva/repository/MeaningRepository.java`)
- Example repository → Relational database: reads/writes (evidence: `src/main/java/com/english/eva/repository/ExampleRepository.java`)
