# plut0ne/appdelniente architecture

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

## Overview

L’App del Niente is a Flutter app for recording intentional idle time. Users choose a timed or free session, pause and resume it, then optionally add a note; saved sessions feed history and statistics, while settings provide theme and CSV import/export. The graph follows the README’s documented feature structure. Source excerpts did not include the Dart runtime, so several internal connections are shown as unverified rather than asserted as inspected calls.

Main entry points: [`noia/lib/pages/shell_page.dart`](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/shell_page.dart) (Tab shell), [`noia/lib/model/database_helper.dart`](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/model/database_helper.dart) (SQLite database), [`noia/lib/pages/active_session_page.dart`](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/active_session_page.dart) (Active session), [`noia/lib/router.dart`](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/router.dart) (Route setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App navigation"]
  node_entry["App entry<br/>[main.dart]"]
  node_router["Route setup<br/>[router.dart]"]
  node_shell["Tab shell<br/>[shell_page.dart]"]
  node_home["Home<br/>[home_page.dart]"]
end

subgraph group_sessions["Session workflow"]
  node_sessionpage["Active session"]
  node_sessionstate["Session state"]
  node_sessionglobal["Session global state"]
  node_summary["Session summary"]
end

subgraph group_records["Session records"]
  node_sessionmodel["Session model<br/>[session.dart]"]
  node_database[("SQLite database")]
end

subgraph group_insights["History and settings"]
  node_history["Recent history<br/>[history_page.dart]"]
  node_fullhistory["Full history"]
  node_stats["Statistics<br/>[stats_page.dart]"]
  node_settings["Settings<br/>[settings_page.dart]"]
  node_theme["Theme state"]
  node_csv["CSV transfer<br/>[csv_helper.dart]"]
  node_info["App information<br/>[info_page.dart]"]
end

node_user(("User"))

node_user -->|"opens app"| node_entry
node_entry -.->|"starts navigation"| node_router
node_router -->|"hosts tabs"| node_shell
node_router -->|"routes to"| node_sessionpage
node_user -->|"chooses session"| node_home
node_home -->|"starts session"| node_sessionpage
node_sessionpage -.->|"uses state"| node_sessionstate
node_sessionstate -.->|"uses global state"| node_sessionglobal
node_sessionpage -->|"ends with summary"| node_summary
node_summary -.->|"records note"| node_sessionmodel
node_sessionmodel -->|"persists session"| node_database
node_history -.->|"reads sessions"| node_database
node_fullhistory -->|"reads and deletes"| node_database
node_stats -.->|"aggregates sessions"| node_database
node_settings -->|"changes theme"| node_theme
node_settings -->|"imports and exports"| node_csv
node_csv -.->|"transfers sessions"| node_database
node_shell -.->|"shows tab"| node_history
node_shell -.->|"shows tab"| node_stats
node_shell -.->|"shows tab"| node_settings
node_shell -.->|"shows tab"| node_info

click node_entry "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/main.dart"
click node_router "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/router.dart"
click node_shell "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/shell_page.dart"
click node_home "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/home_page.dart"
click node_sessionpage "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/active_session_page.dart"
click node_sessionstate "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/provider/active_session_provider.dart"
click node_sessionglobal "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/provider/active_session_global_state.dart"
click node_sessionmodel "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/model/session.dart"
click node_database "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/model/database_helper.dart"
click node_summary "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/widgets/summary_dialog.dart"
click node_history "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/history_page.dart"
click node_fullhistory "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/full_history_page.dart"
click node_stats "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/stats_page.dart"
click node_settings "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/settings_page.dart"
click node_theme "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/provider/theme_provider.dart"
click node_csv "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/utils/csv_helper.dart"
click node_info "https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/info_page.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_router,node_shell,node_home,node_user toneBlue
class node_sessionpage,node_sessionstate,node_sessionglobal,node_summary toneAmber
class node_sessionmodel,node_database toneMint
class node_history,node_fullhistory,node_stats,node_settings,node_theme,node_csv,node_info toneRose
```

## Components

### App navigation

- [App entry](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/main.dart): `noia/lib/main.dart`
- [Route setup](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/router.dart): `noia/lib/router.dart`
- [Tab shell](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/shell_page.dart): `noia/lib/pages/shell_page.dart`
- [Home](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/home_page.dart): `noia/lib/pages/home_page.dart`

### Session workflow

- [Active session](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/active_session_page.dart): `noia/lib/pages/active_session_page.dart`
- [Session state](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/provider/active_session_provider.dart): `noia/lib/provider/active_session_provider.dart`
- [Session global state](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/provider/active_session_global_state.dart): `noia/lib/provider/active_session_global_state.dart`
- [Session summary](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/widgets/summary_dialog.dart): `noia/lib/widgets/summary_dialog.dart`

### Session records

- [Session model](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/model/session.dart): `noia/lib/model/session.dart`
- [SQLite database](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/model/database_helper.dart): `noia/lib/model/database_helper.dart`

### History and settings

- [Recent history](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/history_page.dart): `noia/lib/pages/history_page.dart`
- [Full history](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/full_history_page.dart): `noia/lib/pages/full_history_page.dart`
- [Statistics](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/stats_page.dart): `noia/lib/pages/stats_page.dart`
- [Settings](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/settings_page.dart): `noia/lib/pages/settings_page.dart`
- [Theme state](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/provider/theme_provider.dart): `noia/lib/provider/theme_provider.dart`
- [CSV transfer](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/utils/csv_helper.dart): `noia/lib/utils/csv_helper.dart`
- [App information](https://github.com/plut0ne/appdelniente/blob/main/noia/lib/pages/info_page.dart): `noia/lib/pages/info_page.dart`

### Other components

- **User**

## Connections

- User → App entry: opens app (evidence: `README.md`)
- App entry → Route setup: starts navigation
- Route setup → Tab shell: hosts tabs (evidence: `README.md`)
- Route setup → Active session: routes to (evidence: `README.md`)
- User → Home: chooses session (evidence: `README.md`)
- Home → Active session: starts session (evidence: `README.md`)
- Active session → Session state: uses state
- Session state → Session global state: uses global state
- Active session → Session summary: ends with summary (evidence: `README.md`)
- Session summary → Session model: records note
- Session model → SQLite database: persists session (evidence: `README.md`)
- Recent history → SQLite database: reads sessions
- Full history → SQLite database: reads and deletes (evidence: `README.md`)
- Statistics → SQLite database: aggregates sessions
- Settings → Theme state: changes theme (evidence: `README.md`)
- Settings → CSV transfer: imports and exports (evidence: `README.md`)
- CSV transfer → SQLite database: transfers sessions
- Tab shell → Recent history: shows tab
- Tab shell → Statistics: shows tab
- Tab shell → Settings: shows tab
- Tab shell → App information: shows tab
