# majkownica2000/zapis_vah architecture

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

- Interactive diagram: https://gitdiagram.com/majkownica2000/zapis_vah
- Repository: https://github.com/majkownica2000/zapis_vah

## Overview

Zápis váh is an offline-first Flutter workout log. The user starts a workout, adds library exercises and warm-up or working sets, then saves progress and can review, edit, or repeat workouts from history. Separate branches manage the exercise library and unit/theme preferences. The README documents a feature-first repository architecture over local SQLite. Dart implementation excerpts were not provided, so relationships below rely on README statements; the backup service is shown without inferred connections.

Main entry points: [`lib/core/widgets/scaffold_with_nav_bar.dart`](https://github.com/majkownica2000/zapis_vah/blob/master/lib/core/widgets/scaffold_with_nav_bar.dart) (Bottom navigation), [`lib/features/workouts/data/workout_repository.dart`](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/data/workout_repository.dart) (Workout repository), [`lib/features/workouts/presentation/workout_screen.dart`](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/presentation/workout_screen.dart) (Active workout), [`lib/features/exercises/data/exercise_repository.dart`](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/exercises/data/exercise_repository.dart) (Exercise repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App navigation"]
  node_entry["App entry<br/>[main.dart]"]
  node_app_root["App root<br/>[app.dart]"]
  node_router["Route navigation<br/>[app_router.dart]"]
  node_nav_shell["Bottom navigation"]
end

subgraph group_training["Workout tracking"]
  node_home["Workout home<br/>[home_screen.dart]"]
  node_active_workout["Active workout"]
  node_workout_detail["Workout detail"]
  node_history["Workout history"]
  node_workout_model["Workout records<br/>[workout.dart]"]
  node_workout_exercise["Workout exercises"]
  node_set_entry["Set entries<br/>[set_entry.dart]"]
  node_workout_repo["Workout repository"]
end

subgraph group_library["Exercise library"]
  node_exercise_screen["Exercise library"]
  node_exercise_model["Exercise records<br/>[exercise.dart]"]
  node_exercise_repo["Exercise repository"]
end

subgraph group_preferences["Preferences and storage"]
  node_settings_screen["Settings screen"]
  node_settings_controller["Settings controller"]
  node_settings_repo["Settings repository"]
  node_theme["App theme<br/>[app_theme.dart]"]
  node_database[("Local SQLite")]
  node_backup["Backup service"]
end

node_user(("Gym user"))

node_user -->|"opens app"| node_entry
node_entry -->|"starts"| node_app_root
node_app_root -->|"configures routes"| node_router
node_router -->|"hosts navigation"| node_nav_shell
node_nav_shell -->|"opens home"| node_home
node_nav_shell -->|"opens history"| node_history
node_nav_shell -->|"opens library"| node_exercise_screen
node_nav_shell -->|"opens settings"| node_settings_screen
node_home -->|"starts workout"| node_active_workout
node_active_workout -->|"adds library exercise"| node_exercise_repo
node_active_workout -->|"saves workout"| node_workout_repo
node_active_workout -->|"records sets"| node_set_entry
node_history -->|"opens details"| node_workout_detail
node_workout_detail -->|"edits or repeats"| node_workout_repo
node_exercise_screen -->|"manages library"| node_exercise_repo
node_settings_screen -->|"changes preferences"| node_settings_controller
node_settings_controller -->|"stores preferences"| node_settings_repo
node_settings_controller -->|"selects theme"| node_theme
node_workout_repo -->|"uses SQLite"| node_database
node_exercise_repo -->|"uses SQLite"| node_database
node_settings_repo -->|"uses SQLite"| node_database
node_workout_repo -.->|"persists records"| node_workout_model
node_workout_repo -.->|"persists exercises"| node_workout_exercise
node_exercise_repo -.->|"persists records"| node_exercise_model

click node_entry "https://github.com/majkownica2000/zapis_vah/blob/master/lib/main.dart"
click node_app_root "https://github.com/majkownica2000/zapis_vah/blob/master/lib/app.dart"
click node_router "https://github.com/majkownica2000/zapis_vah/blob/master/lib/core/router/app_router.dart"
click node_nav_shell "https://github.com/majkownica2000/zapis_vah/blob/master/lib/core/widgets/scaffold_with_nav_bar.dart"
click node_home "https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/presentation/home_screen.dart"
click node_active_workout "https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/presentation/workout_screen.dart"
click node_workout_detail "https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/presentation/workout_detail_screen.dart"
click node_history "https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/presentation/history_screen.dart"
click node_workout_model "https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/data/workout.dart"
click node_workout_exercise "https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/data/workout_exercise.dart"
click node_set_entry "https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/data/set_entry.dart"
click node_workout_repo "https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/data/workout_repository.dart"
click node_exercise_screen "https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/exercises/presentation/exercises_screen.dart"
click node_exercise_model "https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/exercises/data/exercise.dart"
click node_exercise_repo "https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/exercises/data/exercise_repository.dart"
click node_settings_screen "https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/settings/presentation/settings_screen.dart"
click node_settings_controller "https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/settings/presentation/settings_controller.dart"
click node_settings_repo "https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/settings/data/settings_repository.dart"
click node_theme "https://github.com/majkownica2000/zapis_vah/blob/master/lib/core/theme/app_theme.dart"
click node_database "https://github.com/majkownica2000/zapis_vah/blob/master/lib/core/db/database_helper.dart"
click node_backup "https://github.com/majkownica2000/zapis_vah/blob/master/lib/core/services/backup_service.dart"

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_entry,node_app_root,node_router,node_nav_shell,node_user toneBlue
class node_home,node_active_workout,node_workout_detail,node_history,node_workout_model,node_workout_exercise,node_set_entry,node_workout_repo toneAmber
class node_exercise_screen,node_exercise_model,node_exercise_repo toneMint
class node_settings_screen,node_settings_controller,node_settings_repo,node_theme,node_database,node_backup toneRose
```

## Components

### App navigation

- [App entry](https://github.com/majkownica2000/zapis_vah/blob/master/lib/main.dart): `lib/main.dart`
- [App root](https://github.com/majkownica2000/zapis_vah/blob/master/lib/app.dart): `lib/app.dart`
- [Route navigation](https://github.com/majkownica2000/zapis_vah/blob/master/lib/core/router/app_router.dart): `lib/core/router/app_router.dart`
- [Bottom navigation](https://github.com/majkownica2000/zapis_vah/blob/master/lib/core/widgets/scaffold_with_nav_bar.dart): `lib/core/widgets/scaffold_with_nav_bar.dart`

### Workout tracking

- [Workout home](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/presentation/home_screen.dart): `lib/features/workouts/presentation/home_screen.dart`
- [Active workout](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/presentation/workout_screen.dart): `lib/features/workouts/presentation/workout_screen.dart`
- [Workout detail](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/presentation/workout_detail_screen.dart): `lib/features/workouts/presentation/workout_detail_screen.dart`
- [Workout history](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/presentation/history_screen.dart): `lib/features/workouts/presentation/history_screen.dart`
- [Workout records](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/data/workout.dart): `lib/features/workouts/data/workout.dart`
- [Workout exercises](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/data/workout_exercise.dart): `lib/features/workouts/data/workout_exercise.dart`
- [Set entries](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/data/set_entry.dart): `lib/features/workouts/data/set_entry.dart`
- [Workout repository](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/workouts/data/workout_repository.dart): `lib/features/workouts/data/workout_repository.dart`

### Exercise library

- [Exercise library](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/exercises/presentation/exercises_screen.dart): `lib/features/exercises/presentation/exercises_screen.dart`
- [Exercise records](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/exercises/data/exercise.dart): `lib/features/exercises/data/exercise.dart`
- [Exercise repository](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/exercises/data/exercise_repository.dart): `lib/features/exercises/data/exercise_repository.dart`

### Preferences and storage

- [Settings screen](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/settings/presentation/settings_screen.dart): `lib/features/settings/presentation/settings_screen.dart`
- [Settings controller](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/settings/presentation/settings_controller.dart): `lib/features/settings/presentation/settings_controller.dart`
- [Settings repository](https://github.com/majkownica2000/zapis_vah/blob/master/lib/features/settings/data/settings_repository.dart): `lib/features/settings/data/settings_repository.dart`
- [App theme](https://github.com/majkownica2000/zapis_vah/blob/master/lib/core/theme/app_theme.dart): `lib/core/theme/app_theme.dart`
- [Local SQLite](https://github.com/majkownica2000/zapis_vah/blob/master/lib/core/db/database_helper.dart): `lib/core/db/database_helper.dart`
- [Backup service](https://github.com/majkownica2000/zapis_vah/blob/master/lib/core/services/backup_service.dart): `lib/core/services/backup_service.dart`

### Other components

- **Gym user**

## Connections

- Gym user → App entry: opens app (evidence: `README.md`)
- App entry → App root: starts (evidence: `README.md`)
- App root → Route navigation: configures routes (evidence: `README.md`)
- Route navigation → Bottom navigation: hosts navigation (evidence: `README.md`)
- Bottom navigation → Workout home: opens home (evidence: `README.md`)
- Bottom navigation → Workout history: opens history (evidence: `README.md`)
- Bottom navigation → Exercise library: opens library (evidence: `README.md`)
- Bottom navigation → Settings screen: opens settings (evidence: `README.md`)
- Workout home → Active workout: starts workout (evidence: `README.md`)
- Active workout → Exercise repository: adds library exercise (evidence: `README.md`)
- Active workout → Workout repository: saves workout (evidence: `README.md`)
- Active workout → Set entries: records sets (evidence: `README.md`)
- Workout history → Workout detail: opens details (evidence: `README.md`)
- Workout detail → Workout repository: edits or repeats (evidence: `README.md`)
- Exercise library → Exercise repository: manages library (evidence: `README.md`)
- Settings screen → Settings controller: changes preferences (evidence: `README.md`)
- Settings controller → Settings repository: stores preferences (evidence: `README.md`)
- Settings controller → App theme: selects theme (evidence: `README.md`)
- Workout repository → Local SQLite: uses SQLite (evidence: `README.md`)
- Exercise repository → Local SQLite: uses SQLite (evidence: `README.md`)
- Settings repository → Local SQLite: uses SQLite (evidence: `README.md`)
- Workout repository → Workout records: persists records
- Workout repository → Workout exercises: persists exercises
- Exercise repository → Exercise records: persists records
