# kasimertugrul/sedisko architecture

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

- Interactive diagram: https://gitdiagram.com/kasimertugrul/sedisko
- Repository: https://github.com/kasimertugrul/sedisko

## Overview

Kitaplığım is a Flutter app for tracking a home book collection by shelf, reading status, dates, and current page. Its main workflow is scanning an ISBN, retrieving book details from Open Library, and keeping the resulting book data locally; users can then organize, search, sort, and update books and reading progress. The README describes the architecture and storage choices, but the sampled source does not include the Dart implementation, so runtime links below are documented relationships rather than inspected calls. Native host and plugin-registration components are shown as platform support, not as product logic.

Main entry points: [`lib/presentation/pages/shell_page.dart`](https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/shell_page.dart) (Navigation shell), [`lib/presentation/pages/book_form_page.dart`](https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/book_form_page.dart) (Book form), [`lib/data/repositories/book_repository_impl.dart`](https://github.com/kasimertugrul/sedisko/blob/main/lib/data/repositories/book_repository_impl.dart) (Book repository), [`lib/presentation/pages/book_detail_page.dart`](https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/book_detail_page.dart) (Book details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["App experience"]
  node_app["App startup<br/>[main.dart]"]
  node_routes["App routes<br/>[app_pages.dart]"]
  node_shell["Navigation shell<br/>[shell_page.dart]"]
  node_home["Home feed<br/>[home_page.dart]"]
  node_shelves["Shelf views<br/>[shelves_page.dart]"]
  node_authors["Author views<br/>[authors_page.dart]"]
  node_detail["Book details"]
  node_form["Book form"]
  node_scanner["ISBN scanner<br/>[scanner_page.dart]"]
  node_settings["Settings<br/>[settings_page.dart]"]
  node_library_controller["Library state"]
  node_form_controller["Form state"]
  node_scanner_controller["Scanner state"]
end

subgraph group_domain["Library services"]
  node_reading_stats["Reading statistics<br/>[reading_stats.dart]"]
  node_sort["Book sorting<br/>[book_sort.dart]"]
  node_feed["Home sections<br/>[home_feed.dart]"]
  node_goals["Reading goals<br/>[reading_goal.dart]"]
end

subgraph group_data["Book data"]
  node_book_model["Book records<br/>[book_model.dart]"]
  node_reading_log["Reading log"]
  node_repository["Book repository"]
  node_local[("Local storage")]
  node_remote["Open Library API"]
  node_photo_picker["Cover photo picker"]
  node_photo_store[("Cover photo store")]
end

subgraph group_platform["Platform hosts"]
  node_android_host["Android host<br/>[MainActivity.kt]"]
  node_ios_host["iOS host<br/>[AppDelegate.swift]"]
  node_linux_host["Linux application host<br/>[my_application.cc]"]
  node_linux_header["Linux host interface<br/>[my_application.h]"]
  node_linux_plugins["Linux plugin registration"]
  node_mac_plugins["macOS plugin registration"]
  node_windows_entry["Windows app entry<br/>[main.cpp]"]
  node_windows_flutter["Windows Flutter host<br/>[flutter_window.cpp]"]
end

node_reader(("Reader"))
node_open_library["Open Library"]

node_reader -.->|"opens"| node_app
node_app -.->|"starts"| node_shell
node_shell -.->|"shows"| node_home
node_shell -.->|"navigates"| node_shelves
node_shell -.->|"navigates"| node_authors
node_reader -.->|"scans ISBN"| node_scanner
node_scanner -.->|"uses"| node_scanner_controller
node_scanner_controller -.->|"looks up"| node_remote
node_remote -.->|"requests details"| node_open_library
node_reader -.->|"adds or edits"| node_form
node_form -.->|"uses"| node_form_controller
node_form_controller -.->|"saves books"| node_repository
node_library_controller -.->|"manages books"| node_repository
node_repository -.->|"persists books"| node_local
node_local -.->|"stores records"| node_book_model
node_book_model -.->|"includes log"| node_reading_log
node_library_controller -.->|"sorts books"| node_sort
node_home -.->|"shows sections"| node_feed
node_detail -.->|"shows stats"| node_reading_stats
node_detail -.->|"tracks goals"| node_goals
node_reader -.->|"configures app"| node_settings
node_form -.->|"selects photo"| node_photo_picker
node_photo_picker -.->|"stores photo"| node_photo_store
node_linux_host -->|"uses interface"| node_linux_header
node_linux_host -->|"registers plugins"| node_linux_plugins
node_windows_entry -->|"creates window"| node_windows_flutter

click node_app "https://github.com/kasimertugrul/sedisko/blob/main/lib/main.dart"
click node_routes "https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/routes/app_pages.dart"
click node_shell "https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/shell_page.dart"
click node_home "https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/home_page.dart"
click node_shelves "https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/shelves_page.dart"
click node_authors "https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/authors_page.dart"
click node_detail "https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/book_detail_page.dart"
click node_form "https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/book_form_page.dart"
click node_scanner "https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/scanner_page.dart"
click node_settings "https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/settings_page.dart"
click node_library_controller "https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/controllers/library_controller.dart"
click node_form_controller "https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/controllers/book_form_controller.dart"
click node_scanner_controller "https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/controllers/scanner_controller.dart"
click node_reading_stats "https://github.com/kasimertugrul/sedisko/blob/main/lib/domain/services/reading_stats.dart"
click node_sort "https://github.com/kasimertugrul/sedisko/blob/main/lib/domain/services/book_sort.dart"
click node_feed "https://github.com/kasimertugrul/sedisko/blob/main/lib/domain/services/home_feed.dart"
click node_goals "https://github.com/kasimertugrul/sedisko/blob/main/lib/domain/services/reading_goal.dart"
click node_book_model "https://github.com/kasimertugrul/sedisko/blob/main/lib/data/models/book_model.dart"
click node_reading_log "https://github.com/kasimertugrul/sedisko/blob/main/lib/data/models/reading_log_entry.dart"
click node_repository "https://github.com/kasimertugrul/sedisko/blob/main/lib/data/repositories/book_repository_impl.dart"
click node_local "https://github.com/kasimertugrul/sedisko/blob/main/lib/data/datasources/book_local_datasource.dart"
click node_remote "https://github.com/kasimertugrul/sedisko/blob/main/lib/data/datasources/open_library_remote_datasource.dart"
click node_photo_picker "https://github.com/kasimertugrul/sedisko/blob/main/lib/data/services/book_photo_picker.dart"
click node_photo_store "https://github.com/kasimertugrul/sedisko/blob/main/lib/data/services/cover_photo_store.dart"
click node_android_host "https://github.com/kasimertugrul/sedisko/blob/main/android/app/src/main/kotlin/com/example/sedisko/MainActivity.kt"
click node_ios_host "https://github.com/kasimertugrul/sedisko/blob/main/ios/Runner/AppDelegate.swift"
click node_linux_host "https://github.com/kasimertugrul/sedisko/blob/main/linux/runner/my_application.cc"
click node_linux_header "https://github.com/kasimertugrul/sedisko/blob/main/linux/runner/my_application.h"
click node_linux_plugins "https://github.com/kasimertugrul/sedisko/blob/main/linux/flutter/generated_plugin_registrant.h"
click node_mac_plugins "https://github.com/kasimertugrul/sedisko/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift"
click node_windows_entry "https://github.com/kasimertugrul/sedisko/blob/main/windows/runner/main.cpp"
click node_windows_flutter "https://github.com/kasimertugrul/sedisko/blob/main/windows/runner/flutter_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_routes,node_shell,node_home,node_shelves,node_authors,node_detail,node_form,node_scanner,node_settings,node_library_controller,node_form_controller,node_scanner_controller toneBlue
class node_reading_stats,node_sort,node_feed,node_goals toneAmber
class node_book_model,node_reading_log,node_repository,node_local,node_remote,node_photo_picker,node_photo_store toneMint
class node_android_host,node_ios_host,node_linux_host,node_linux_header,node_linux_plugins,node_mac_plugins,node_windows_entry,node_windows_flutter toneRose
class node_reader,node_open_library toneIndigo
```

## Components

### App experience

- [App startup](https://github.com/kasimertugrul/sedisko/blob/main/lib/main.dart): `lib/main.dart`
- [App routes](https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/routes/app_pages.dart): `lib/presentation/routes/app_pages.dart`
- [Navigation shell](https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/shell_page.dart): `lib/presentation/pages/shell_page.dart`
- [Home feed](https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/home_page.dart): `lib/presentation/pages/home_page.dart`
- [Shelf views](https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/shelves_page.dart): `lib/presentation/pages/shelves_page.dart`
- [Author views](https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/authors_page.dart): `lib/presentation/pages/authors_page.dart`
- [Book details](https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/book_detail_page.dart): `lib/presentation/pages/book_detail_page.dart`
- [Book form](https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/book_form_page.dart): `lib/presentation/pages/book_form_page.dart`
- [ISBN scanner](https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/scanner_page.dart): `lib/presentation/pages/scanner_page.dart`
- [Settings](https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/pages/settings_page.dart): `lib/presentation/pages/settings_page.dart`
- [Library state](https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/controllers/library_controller.dart): `lib/presentation/controllers/library_controller.dart`
- [Form state](https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/controllers/book_form_controller.dart): `lib/presentation/controllers/book_form_controller.dart`
- [Scanner state](https://github.com/kasimertugrul/sedisko/blob/main/lib/presentation/controllers/scanner_controller.dart): `lib/presentation/controllers/scanner_controller.dart`

### Library services

- [Reading statistics](https://github.com/kasimertugrul/sedisko/blob/main/lib/domain/services/reading_stats.dart): `lib/domain/services/reading_stats.dart`
- [Book sorting](https://github.com/kasimertugrul/sedisko/blob/main/lib/domain/services/book_sort.dart): `lib/domain/services/book_sort.dart`
- [Home sections](https://github.com/kasimertugrul/sedisko/blob/main/lib/domain/services/home_feed.dart): `lib/domain/services/home_feed.dart`
- [Reading goals](https://github.com/kasimertugrul/sedisko/blob/main/lib/domain/services/reading_goal.dart): `lib/domain/services/reading_goal.dart`

### Book data

- [Book records](https://github.com/kasimertugrul/sedisko/blob/main/lib/data/models/book_model.dart): `lib/data/models/book_model.dart`
- [Reading log](https://github.com/kasimertugrul/sedisko/blob/main/lib/data/models/reading_log_entry.dart): `lib/data/models/reading_log_entry.dart`
- [Book repository](https://github.com/kasimertugrul/sedisko/blob/main/lib/data/repositories/book_repository_impl.dart): `lib/data/repositories/book_repository_impl.dart`
- [Local storage](https://github.com/kasimertugrul/sedisko/blob/main/lib/data/datasources/book_local_datasource.dart): `lib/data/datasources/book_local_datasource.dart`
- [Open Library API](https://github.com/kasimertugrul/sedisko/blob/main/lib/data/datasources/open_library_remote_datasource.dart): `lib/data/datasources/open_library_remote_datasource.dart`
- [Cover photo picker](https://github.com/kasimertugrul/sedisko/blob/main/lib/data/services/book_photo_picker.dart): `lib/data/services/book_photo_picker.dart`
- [Cover photo store](https://github.com/kasimertugrul/sedisko/blob/main/lib/data/services/cover_photo_store.dart): `lib/data/services/cover_photo_store.dart`

### Platform hosts

- [Android host](https://github.com/kasimertugrul/sedisko/blob/main/android/app/src/main/kotlin/com/example/sedisko/MainActivity.kt): `android/app/src/main/kotlin/com/example/sedisko/MainActivity.kt`
- [iOS host](https://github.com/kasimertugrul/sedisko/blob/main/ios/Runner/AppDelegate.swift): `ios/Runner/AppDelegate.swift`
- [Linux application host](https://github.com/kasimertugrul/sedisko/blob/main/linux/runner/my_application.cc): `linux/runner/my_application.cc`
- [Linux host interface](https://github.com/kasimertugrul/sedisko/blob/main/linux/runner/my_application.h): `linux/runner/my_application.h`
- [Linux plugin registration](https://github.com/kasimertugrul/sedisko/blob/main/linux/flutter/generated_plugin_registrant.h): `linux/flutter/generated_plugin_registrant.h`
- [macOS plugin registration](https://github.com/kasimertugrul/sedisko/blob/main/macos/Flutter/GeneratedPluginRegistrant.swift): `macos/Flutter/GeneratedPluginRegistrant.swift`
- [Windows app entry](https://github.com/kasimertugrul/sedisko/blob/main/windows/runner/main.cpp): `windows/runner/main.cpp`
- [Windows Flutter host](https://github.com/kasimertugrul/sedisko/blob/main/windows/runner/flutter_window.cpp): `windows/runner/flutter_window.cpp`

### Other components

- **Reader**
- **Open Library**

## Connections

- Reader → App startup: opens (evidence: `README.md`)
- App startup → Navigation shell: starts
- Navigation shell → Home feed: shows (evidence: `README.md`)
- Navigation shell → Shelf views: navigates (evidence: `README.md`)
- Navigation shell → Author views: navigates (evidence: `README.md`)
- Reader → ISBN scanner: scans ISBN (evidence: `README.md`)
- ISBN scanner → Scanner state: uses
- Scanner state → Open Library API: looks up (evidence: `README.md`)
- Open Library API → Open Library: requests details (evidence: `README.md`)
- Reader → Book form: adds or edits (evidence: `README.md`)
- Book form → Form state: uses
- Form state → Book repository: saves books (evidence: `README.md`)
- Library state → Book repository: manages books (evidence: `README.md`)
- Book repository → Local storage: persists books (evidence: `README.md`)
- Local storage → Book records: stores records (evidence: `README.md`)
- Book records → Reading log: includes log (evidence: `README.md`)
- Library state → Book sorting: sorts books (evidence: `README.md`)
- Home feed → Home sections: shows sections (evidence: `README.md`)
- Book details → Reading statistics: shows stats (evidence: `README.md`)
- Book details → Reading goals: tracks goals (evidence: `README.md`)
- Reader → Settings: configures app (evidence: `README.md`)
- Book form → Cover photo picker: selects photo
- Cover photo picker → Cover photo store: stores photo
- Linux application host → Linux host interface: uses interface (evidence: `linux/runner/my_application.cc`)
- Linux application host → Linux plugin registration: registers plugins (evidence: `linux/runner/my_application.cc`)
- Windows app entry → Windows Flutter host: creates window (evidence: `windows/runner/main.cpp`)
