# davy-bitencourt/sysyphus-learning-app architecture

> Architecture diagram of the GitHub repository davy-bitencourt/sysyphus-learning-app, 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/davy-bitencourt/sysyphus-learning-app
- Repository: https://github.com/davy-bitencourt/sysyphus-learning-app

## Overview

Sysyphus is a cross-platform Flutter study app. The main user journey is to work with question banks, study questions, save session and review history locally, and inspect statistics. Its other visible product branches include pack transfer, media, settings, and device synchronization. The README describes the product and SQLite/DAO capabilities; Dart implementations were not excerpted, so most internal links are omitted or marked unverified. Native desktop host components are included, but are not part of the study workflow.

Main entry points: [`lib/data/DAO`](https://github.com/davy-bitencourt/sysyphus-learning-app/tree/main/lib/data/DAO) (Entity DAOs), [`lib/screens/questions_screen.dart`](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/questions_screen.dart) (Question study), [`lib/screens/session_edit_screen.dart`](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/session_edit_screen.dart) (Study sessions), [`lib/screens/statistic_screen.dart`](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/statistic_screen.dart) (Statistics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_study["Study workflow"]
  node_app["App entry<br/>[main.dart]"]
  node_home["Home<br/>[home.dart]"]
  node_banks["Question banks"]
  node_questions["Question study"]
  node_sessions["Study sessions"]
  node_statistics["Statistics"]
  node_detailed_stats["Detailed statistics"]
end

subgraph group_data["Local data"]
  node_database[("SQLite database")]
  node_daos["Entity DAOs"]
  node_schemas["Data schemas"]
  node_accounts["Profile and account<br/>[account_dao.dart]"]
  node_reviews["Review history<br/>[revlog_dao.dart]"]
end

subgraph group_features["App capabilities"]
  node_transfer["Pack transfer<br/>[pack_transfer.dart]"]
  node_pack_import["Pack import/export<br/>[pack_importer.dart]"]
  node_sync_settings["Sync settings"]
  node_sync_engine["Sync engine<br/>[sync_engine.dart]"]
  node_media["Media storage"]
end

subgraph group_hosts["Desktop hosts"]
  node_linux_host["Linux Flutter host<br/>[my_application.cc]"]
  node_linux_host_api["Linux host declaration<br/>[my_application.h]"]
  node_windows_host["Windows Flutter host<br/>[flutter_window.cpp]"]
  node_windows_window["Win32 window<br/>[win32_window.cpp]"]
end

node_user(("Learner"))

node_user -->|"chooses banks"| node_banks
node_user -->|"tests knowledge"| node_questions
node_questions -.->|"records session"| node_sessions
node_sessions -.->|"records reviews"| node_reviews
node_user -.->|"views progress"| node_statistics
node_statistics -.->|"opens detail"| node_detailed_stats
node_banks -.->|"accesses data"| node_daos
node_questions -.->|"accesses data"| node_daos
node_sessions -.->|"accesses data"| node_daos
node_statistics -.->|"reads history"| node_daos
node_daos -.->|"reads and writes"| node_database
node_daos -.->|"uses schemas"| node_schemas
node_transfer -.->|"handles packs"| node_pack_import
node_sync_settings -.->|"configures sync"| node_sync_engine
node_sync_engine -.->|"syncs local data"| node_database
node_questions -.->|"uses media"| node_media
node_linux_host -->|"implements API"| node_linux_host_api
node_windows_host -->|"inherits window"| node_windows_window

click node_app "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/main.dart"
click node_home "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/home.dart"
click node_banks "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/question_bank_screen.dart"
click node_questions "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/questions_screen.dart"
click node_sessions "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/session_edit_screen.dart"
click node_statistics "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/statistic_screen.dart"
click node_detailed_stats "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/detailed_statistics_screen.dart"
click node_database "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/data/database_helper.dart"
click node_daos "https://github.com/davy-bitencourt/sysyphus-learning-app/tree/main/lib/data/DAO"
click node_schemas "https://github.com/davy-bitencourt/sysyphus-learning-app/tree/main/lib/data/schema"
click node_accounts "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/data/DAO/account_dao.dart"
click node_reviews "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/data/DAO/revlog_dao.dart"
click node_transfer "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/pack_transfer.dart"
click node_pack_import "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/data/transfer/pack_importer.dart"
click node_sync_settings "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/sync_settings_screen.dart"
click node_sync_engine "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/data/sync/sync_engine.dart"
click node_media "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/data/services/media_storage_service.dart"
click node_linux_host "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/linux/runner/my_application.cc"
click node_linux_host_api "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/linux/runner/my_application.h"
click node_windows_host "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/windows/runner/flutter_window.cpp"
click node_windows_window "https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/windows/runner/win32_window.cpp"

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_home,node_banks,node_questions,node_sessions,node_statistics,node_detailed_stats toneBlue
class node_database,node_daos,node_schemas,node_accounts,node_reviews toneAmber
class node_transfer,node_pack_import,node_sync_settings,node_sync_engine,node_media toneMint
class node_linux_host,node_linux_host_api,node_windows_host,node_windows_window toneRose
class node_user toneIndigo
```

## Components

### Study workflow

- [App entry](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/main.dart): `lib/main.dart`
- [Home](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/home.dart): `lib/screens/home.dart`
- [Question banks](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/question_bank_screen.dart): `lib/screens/question_bank_screen.dart`
- [Question study](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/questions_screen.dart): `lib/screens/questions_screen.dart`
- [Study sessions](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/session_edit_screen.dart): `lib/screens/session_edit_screen.dart`
- [Statistics](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/statistic_screen.dart): `lib/screens/statistic_screen.dart`
- [Detailed statistics](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/detailed_statistics_screen.dart): `lib/screens/detailed_statistics_screen.dart`

### Local data

- [SQLite database](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/data/database_helper.dart): `lib/data/database_helper.dart`
- [Entity DAOs](https://github.com/davy-bitencourt/sysyphus-learning-app/tree/main/lib/data/DAO): `lib/data/DAO`
- [Data schemas](https://github.com/davy-bitencourt/sysyphus-learning-app/tree/main/lib/data/schema): `lib/data/schema`
- [Profile and account](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/data/DAO/account_dao.dart): `lib/data/DAO/account_dao.dart`
- [Review history](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/data/DAO/revlog_dao.dart): `lib/data/DAO/revlog_dao.dart`

### App capabilities

- [Pack transfer](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/pack_transfer.dart): `lib/screens/pack_transfer.dart`
- [Pack import/export](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/data/transfer/pack_importer.dart): `lib/data/transfer/pack_importer.dart`
- [Sync settings](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/screens/sync_settings_screen.dart): `lib/screens/sync_settings_screen.dart`
- [Sync engine](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/data/sync/sync_engine.dart): `lib/data/sync/sync_engine.dart`
- [Media storage](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/lib/data/services/media_storage_service.dart): `lib/data/services/media_storage_service.dart`

### Desktop hosts

- [Linux Flutter host](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/linux/runner/my_application.cc): `linux/runner/my_application.cc`
- [Linux host declaration](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/linux/runner/my_application.h): `linux/runner/my_application.h`
- [Windows Flutter host](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/windows/runner/flutter_window.cpp): `windows/runner/flutter_window.cpp`
- [Win32 window](https://github.com/davy-bitencourt/sysyphus-learning-app/blob/main/windows/runner/win32_window.cpp): `windows/runner/win32_window.cpp`

### Other components

- **Learner**

## Connections

- Learner → Question banks: chooses banks (evidence: `README.md`)
- Learner → Question study: tests knowledge (evidence: `README.md`)
- Question study → Study sessions: records session
- Study sessions → Review history: records reviews
- Learner → Statistics: views progress
- Statistics → Detailed statistics: opens detail
- Question banks → Entity DAOs: accesses data
- Question study → Entity DAOs: accesses data
- Study sessions → Entity DAOs: accesses data
- Statistics → Entity DAOs: reads history
- Entity DAOs → SQLite database: reads and writes
- Entity DAOs → Data schemas: uses schemas
- Pack transfer → Pack import/export: handles packs
- Sync settings → Sync engine: configures sync
- Sync engine → SQLite database: syncs local data
- Question study → Media storage: uses media
- Linux Flutter host → Linux host declaration: implements API (evidence: `linux/runner/my_application.cc`)
- Windows Flutter host → Win32 window: inherits window (evidence: `windows/runner/flutter_window.cpp`)
