# rhofm/avs architecture

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

## Overview

Atleet Volg Systeem is a local web application for tracking athletes and supporting athletics coaching. Coaches use its UI to manage athlete profiles and group activity, review performance and development, plan training and competitions, and build competition teams; importers bring in results and schedules. Feature modules use shared models and a centralized SQL storage layer; the README describes eight encrypted databases. The graph preserves the documented product areas, but unsampled routes and several subsystem connections are not asserted as direct calls.

Main entry points: [`src/db/queries.py`](https://github.com/rhofm/avs/blob/dev/src/db/queries.py) (Encrypted data access), [`src/ploeg/paginas.py`](https://github.com/rhofm/avs/blob/dev/src/ploeg/paginas.py) (Team management), [`src/ui/app.py`](https://github.com/rhofm/avs/blob/dev/src/ui/app.py) (Local web app), [`src/testen/resultaten.py`](https://github.com/rhofm/avs/blob/dev/src/testen/resultaten.py) (Athlete testing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Application interface"]
  node_webapp["Local web app<br/>[app.py]"]
end

subgraph group_athletes["Athlete tracking"]
  node_athlete_pages["Athlete pages<br/>[landingspagina.py]"]
  node_athlete_management["Athlete management<br/>[beheer.py]"]
  node_performance["Performance records<br/>[prestaties.py]"]
  node_athlete_import["Athlete result import"]
end

subgraph group_groups["Groups and development"]
  node_group_features["Group activity"]
  node_group_goals["Group goals<br/>[doelen.py]"]
  node_group_roster["Group schedules<br/>[rooster.py]"]
  node_learning_lines["Learning pathways"]
  node_test_results["Athlete testing<br/>[resultaten.py]"]
  node_test_templates["Test templates<br/>[sjabloon.py]"]
  node_test_formulas["Scoring formulas<br/>[formule.py]"]
end

subgraph group_competition["Competition planning"]
  node_meet_planning["Meet planning<br/>[planning.py]"]
  node_meet_import["Schedule and result import"]
  node_meet_detail["Meet entries and detail<br/>[detail.py]"]
  node_team_pages["Team management<br/>[paginas.py]"]
  node_team_rules["Team rules<br/>[regels.py]"]
  node_team_scoring["Team scoring<br/>[punten.py]"]
  node_team_optimizer["Lineup optimizer<br/>[optimaliseer.py]"]
end

subgraph group_platform["Shared services"]
  node_import_framework["Importer framework<br/>[base.py]"]
  node_results_importers["Results importers<br/>[atletieknu_prs.py]"]
  node_meet_importers["Meet importers"]
  node_models["Domain models"]
  node_storage["Encrypted data access<br/>[queries.py]"]
  node_database_files[("Encrypted databases<br/>[init_db.py]")]
end

node_coach(("Coach"))

node_coach -->|"uses"| node_webapp
node_webapp -->|"routes to"| node_athlete_pages
node_webapp -->|"routes to"| node_athlete_management
node_webapp -->|"routes to"| node_group_features
node_athlete_pages -->|"reads data"| node_storage
node_athlete_management -->|"manages data"| node_storage
node_performance -->|"reads data"| node_storage
node_athlete_import -->|"saves results"| node_storage
node_athlete_import -->|"uses"| node_results_importers
node_results_importers -->|"extends"| node_import_framework
node_meet_importers -->|"extends"| node_import_framework
node_group_goals -->|"reads data"| node_storage
node_group_roster -->|"reads data"| node_storage
node_learning_lines -->|"reads data"| node_storage
node_test_results -->|"uses templates"| node_test_templates
node_test_results -->|"uses formulas"| node_test_formulas
node_test_results -->|"reads data"| node_storage
node_meet_import -->|"uses planning"| node_meet_planning
node_meet_import -->|"uses"| node_import_framework
node_meet_import -->|"uses"| node_meet_importers
node_meet_detail -->|"uses planning"| node_meet_planning
node_team_pages -->|"uses rules"| node_team_rules
node_team_pages -->|"uses scoring"| node_team_scoring
node_team_pages -->|"uses optimizer"| node_team_optimizer
node_team_rules -->|"uses scoring"| node_team_scoring
node_team_pages -->|"reads data"| node_storage
node_storage -->|"initializes"| node_database_files
node_storage -->|"maps records"| node_models

click node_webapp "https://github.com/rhofm/avs/blob/dev/src/ui/app.py"
click node_athlete_pages "https://github.com/rhofm/avs/blob/dev/src/atleten/landingspagina.py"
click node_athlete_management "https://github.com/rhofm/avs/blob/dev/src/atleten/beheer.py"
click node_performance "https://github.com/rhofm/avs/blob/dev/src/atleten/prestaties.py"
click node_athlete_import "https://github.com/rhofm/avs/blob/dev/src/atleten/importeer_atletieknu.py"
click node_import_framework "https://github.com/rhofm/avs/blob/dev/src/importers/base.py"
click node_results_importers "https://github.com/rhofm/avs/blob/dev/src/importers/atletieknu_prs.py"
click node_meet_importers "https://github.com/rhofm/avs/blob/dev/src/importers/atletieknu_wedstrijd.py"
click node_group_features "https://github.com/rhofm/avs/tree/dev/src/groepen"
click node_group_goals "https://github.com/rhofm/avs/blob/dev/src/groepen/doelen.py"
click node_group_roster "https://github.com/rhofm/avs/blob/dev/src/groepen/rooster.py"
click node_learning_lines "https://github.com/rhofm/avs/tree/dev/src/leerlijnen"
click node_test_results "https://github.com/rhofm/avs/blob/dev/src/testen/resultaten.py"
click node_test_templates "https://github.com/rhofm/avs/blob/dev/src/testen/sjabloon.py"
click node_test_formulas "https://github.com/rhofm/avs/blob/dev/src/testen/formule.py"
click node_meet_planning "https://github.com/rhofm/avs/blob/dev/src/wedstrijden/planning.py"
click node_meet_import "https://github.com/rhofm/avs/blob/dev/src/wedstrijden/tijdschema_import.py"
click node_meet_detail "https://github.com/rhofm/avs/blob/dev/src/wedstrijden/detail.py"
click node_team_pages "https://github.com/rhofm/avs/blob/dev/src/ploeg/paginas.py"
click node_team_rules "https://github.com/rhofm/avs/blob/dev/src/ploeg/regels.py"
click node_team_scoring "https://github.com/rhofm/avs/blob/dev/src/ploeg/punten.py"
click node_team_optimizer "https://github.com/rhofm/avs/blob/dev/src/ploeg/optimaliseer.py"
click node_models "https://github.com/rhofm/avs/tree/dev/src/models"
click node_storage "https://github.com/rhofm/avs/blob/dev/src/db/queries.py"
click node_database_files "https://github.com/rhofm/avs/blob/dev/src/db/init_db.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_webapp toneBlue
class node_athlete_pages,node_athlete_management,node_performance,node_athlete_import toneAmber
class node_group_features,node_group_goals,node_group_roster,node_learning_lines,node_test_results,node_test_templates,node_test_formulas toneMint
class node_meet_planning,node_meet_import,node_meet_detail,node_team_pages,node_team_rules,node_team_scoring,node_team_optimizer toneRose
class node_import_framework,node_results_importers,node_meet_importers,node_models,node_storage,node_database_files,node_coach toneIndigo
```

## Components

### Application interface

- [Local web app](https://github.com/rhofm/avs/blob/dev/src/ui/app.py): `src/ui/app.py`

### Athlete tracking

- [Athlete pages](https://github.com/rhofm/avs/blob/dev/src/atleten/landingspagina.py): `src/atleten/landingspagina.py`
- [Athlete management](https://github.com/rhofm/avs/blob/dev/src/atleten/beheer.py): `src/atleten/beheer.py`
- [Performance records](https://github.com/rhofm/avs/blob/dev/src/atleten/prestaties.py): `src/atleten/prestaties.py`
- [Athlete result import](https://github.com/rhofm/avs/blob/dev/src/atleten/importeer_atletieknu.py): `src/atleten/importeer_atletieknu.py`

### Groups and development

- [Group activity](https://github.com/rhofm/avs/tree/dev/src/groepen): `src/groepen`
- [Group goals](https://github.com/rhofm/avs/blob/dev/src/groepen/doelen.py): `src/groepen/doelen.py`
- [Group schedules](https://github.com/rhofm/avs/blob/dev/src/groepen/rooster.py): `src/groepen/rooster.py`
- [Learning pathways](https://github.com/rhofm/avs/tree/dev/src/leerlijnen): `src/leerlijnen`
- [Athlete testing](https://github.com/rhofm/avs/blob/dev/src/testen/resultaten.py): `src/testen/resultaten.py`
- [Test templates](https://github.com/rhofm/avs/blob/dev/src/testen/sjabloon.py): `src/testen/sjabloon.py`
- [Scoring formulas](https://github.com/rhofm/avs/blob/dev/src/testen/formule.py): `src/testen/formule.py`

### Competition planning

- [Meet planning](https://github.com/rhofm/avs/blob/dev/src/wedstrijden/planning.py): `src/wedstrijden/planning.py`
- [Schedule and result import](https://github.com/rhofm/avs/blob/dev/src/wedstrijden/tijdschema_import.py): `src/wedstrijden/tijdschema_import.py`
- [Meet entries and detail](https://github.com/rhofm/avs/blob/dev/src/wedstrijden/detail.py): `src/wedstrijden/detail.py`
- [Team management](https://github.com/rhofm/avs/blob/dev/src/ploeg/paginas.py): `src/ploeg/paginas.py`
- [Team rules](https://github.com/rhofm/avs/blob/dev/src/ploeg/regels.py): `src/ploeg/regels.py`
- [Team scoring](https://github.com/rhofm/avs/blob/dev/src/ploeg/punten.py): `src/ploeg/punten.py`
- [Lineup optimizer](https://github.com/rhofm/avs/blob/dev/src/ploeg/optimaliseer.py): `src/ploeg/optimaliseer.py`

### Shared services

- [Importer framework](https://github.com/rhofm/avs/blob/dev/src/importers/base.py): `src/importers/base.py`
- [Results importers](https://github.com/rhofm/avs/blob/dev/src/importers/atletieknu_prs.py): `src/importers/atletieknu_prs.py`
- [Meet importers](https://github.com/rhofm/avs/blob/dev/src/importers/atletieknu_wedstrijd.py): `src/importers/atletieknu_wedstrijd.py`
- [Domain models](https://github.com/rhofm/avs/tree/dev/src/models): `src/models`
- [Encrypted data access](https://github.com/rhofm/avs/blob/dev/src/db/queries.py): `src/db/queries.py`
- [Encrypted databases](https://github.com/rhofm/avs/blob/dev/src/db/init_db.py): `src/db/init_db.py`

### Other components

- **Coach**

## Connections

- Coach → Local web app: uses
- Local web app → Athlete pages: routes to (evidence: `src/ui/app.py`)
- Local web app → Athlete management: routes to (evidence: `src/ui/app.py`)
- Local web app → Group activity: routes to (evidence: `src/ui/app.py`)
- Athlete pages → Encrypted data access: reads data (evidence: `src/atleten/landingspagina.py`)
- Athlete management → Encrypted data access: manages data (evidence: `src/atleten/beheer.py`)
- Performance records → Encrypted data access: reads data (evidence: `src/atleten/prestaties.py`)
- Athlete result import → Encrypted data access: saves results (evidence: `src/atleten/importeer_atletieknu.py`)
- Athlete result import → Results importers: uses (evidence: `src/atleten/importeer_atletieknu.py`)
- Results importers → Importer framework: extends (evidence: `src/importers/atletieknu_prs.py`)
- Meet importers → Importer framework: extends (evidence: `src/importers/atletieknu_wedstrijd.py`)
- Group goals → Encrypted data access: reads data (evidence: `src/groepen/doelen.py`)
- Group schedules → Encrypted data access: reads data (evidence: `src/groepen/rooster.py`)
- Learning pathways → Encrypted data access: reads data (evidence: `src/leerlijnen/voortgang.py`)
- Athlete testing → Test templates: uses templates (evidence: `src/testen/resultaten.py`)
- Athlete testing → Scoring formulas: uses formulas (evidence: `src/testen/resultaten.py`)
- Athlete testing → Encrypted data access: reads data (evidence: `src/testen/resultaten.py`)
- Schedule and result import → Meet planning: uses planning (evidence: `src/wedstrijden/tijdschema_import.py`)
- Schedule and result import → Importer framework: uses (evidence: `src/wedstrijden/tijdschema_import.py`)
- Schedule and result import → Meet importers: uses (evidence: `src/wedstrijden/tijdschema_import.py`)
- Meet entries and detail → Meet planning: uses planning (evidence: `src/wedstrijden/detail.py`)
- Team management → Team rules: uses rules (evidence: `src/ploeg/paginas.py`)
- Team management → Team scoring: uses scoring (evidence: `src/ploeg/paginas.py`)
- Team management → Lineup optimizer: uses optimizer (evidence: `src/ploeg/paginas.py`)
- Team rules → Team scoring: uses scoring (evidence: `src/ploeg/regels.py`)
- Team management → Encrypted data access: reads data (evidence: `src/ploeg/paginas.py`)
- Encrypted data access → Encrypted databases: initializes (evidence: `src/db/queries.py`)
- Encrypted data access → Domain models: maps records (evidence: `src/db/queries.py`)
