# giorgipeikrishvili081-del/kolia architecture

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

- Interactive diagram: https://gitdiagram.com/giorgipeikrishvili081-del/kolia
- Repository: https://github.com/giorgipeikrishvili081-del/kolia

## Overview

Kolia is a Flutter field-research app for recording BTK forms, vegetation and soil observations, and map locations, then turning field data into shareable documents. Its documented workflow supports offline capture with later Firebase sync, plus optional plant identification and Google Drive/Docs export. The README describes these capabilities and the broad UI/service split; Dart implementation excerpts were not provided, so links between specific screens and services are limited to relationships the README states.

Main entry points: [`lib/screens/btk_form_page.dart`](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/btk_form_page.dart) (BTK Forms), [`lib/screens/map_picker_page.dart`](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/map_picker_page.dart) (Map Research), [`lib/screens/plant_id_page.dart`](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/plant_id_page.dart) (Plant ID UI), [`lib/screens/export_page.dart`](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/export_page.dart) (Export UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_fieldwork["Field Research"]
  node_btk["BTK Forms<br/>[btk_form_page.dart]"]
  node_maps["Map Research"]
  node_mapview["Map Viewer"]
  node_drafts["Drafts<br/>[drafts_page.dart]"]
  node_plantui["Plant ID UI<br/>[plant_id_page.dart]"]
  node_canvas["Field Sketches"]
  node_exportui["Export UI<br/>[export_page.dart]"]
end

subgraph group_appcore["App Core"]
  node_entry["App Entry<br/>[main.dart]"]
  node_appstate["Global State<br/>[app_state.dart]"]
end

subgraph group_storage["Data &amp; Sync"]
  node_localdb[("SQLite Store")]
  node_sync["Sync Service<br/>[sync_service.dart]"]
  node_mapstore["Map Storage"]
end

subgraph group_integrations["External Integrations"]
  node_firebase[("Firebase")]
  node_drive["Drive &amp; Docs"]
  node_plantservice["Plant ID Service"]
  node_plantnet["Pl@ntNet API"]
  node_exportservice["File Export"]
end

node_researcher(("Researcher"))

node_researcher -->|"opens app"| node_entry
node_researcher -->|"records forms"| node_btk
node_researcher -->|"pins locations"| node_maps
node_entry -->|"initializes state"| node_appstate
node_btk -->|"stores observations"| node_localdb
node_maps -.->|"stores map data"| node_mapstore
node_localdb -->|"supplies offline data"| node_sync
node_sync -->|"syncs when online"| node_firebase
node_researcher -->|"submits specimen photo"| node_plantui
node_plantui -.->|"requests identification"| node_plantservice
node_plantservice -->|"gets suggestions"| node_plantnet
node_researcher -->|"exports observations"| node_exportui
node_exportui -.->|"starts document export"| node_exportservice
node_exportservice -->|"creates documents"| node_drive
node_researcher -.->|"reviews drafts"| node_drafts
node_researcher -.->|"draws sketches"| node_canvas
node_researcher -.->|"views map"| node_mapview

click node_entry "https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/main.dart"
click node_btk "https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/btk_form_page.dart"
click node_maps "https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/map_picker_page.dart"
click node_mapview "https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/map_viewer_page.dart"
click node_drafts "https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/drafts_page.dart"
click node_plantui "https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/plant_id_page.dart"
click node_canvas "https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/widgets/drawing_canvas.dart"
click node_exportui "https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/export_page.dart"
click node_appstate "https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/services/app_state.dart"
click node_localdb "https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/services/database_helper.dart"
click node_sync "https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/services/sync_service.dart"
click node_mapstore "https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/services/map_storage_service.dart"
click node_plantservice "https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/services/plant_id_service.dart"
click node_exportservice "https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/services/file_export_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_btk,node_maps,node_mapview,node_drafts,node_plantui,node_canvas,node_exportui toneBlue
class node_entry,node_appstate toneAmber
class node_localdb,node_sync,node_mapstore toneMint
class node_firebase,node_drive,node_plantservice,node_plantnet,node_exportservice toneRose
class node_researcher toneIndigo
```

## Components

### Field Research

- [BTK Forms](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/btk_form_page.dart): `lib/screens/btk_form_page.dart`
- [Map Research](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/map_picker_page.dart): `lib/screens/map_picker_page.dart`
- [Map Viewer](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/map_viewer_page.dart): `lib/screens/map_viewer_page.dart`
- [Drafts](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/drafts_page.dart): `lib/screens/drafts_page.dart`
- [Plant ID UI](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/plant_id_page.dart): `lib/screens/plant_id_page.dart`
- [Field Sketches](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/widgets/drawing_canvas.dart): `lib/widgets/drawing_canvas.dart`
- [Export UI](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/screens/export_page.dart): `lib/screens/export_page.dart`

### App Core

- [App Entry](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/main.dart): `lib/main.dart`
- [Global State](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/services/app_state.dart): `lib/services/app_state.dart`

### Data & Sync

- [SQLite Store](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/services/database_helper.dart): `lib/services/database_helper.dart`
- [Sync Service](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/services/sync_service.dart): `lib/services/sync_service.dart`
- [Map Storage](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/services/map_storage_service.dart): `lib/services/map_storage_service.dart`

### External Integrations

- **Firebase**
- **Drive & Docs**
- [Plant ID Service](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/services/plant_id_service.dart): `lib/services/plant_id_service.dart`
- **Pl@ntNet API**
- [File Export](https://github.com/giorgipeikrishvili081-del/kolia/blob/main/lib/services/file_export_service.dart): `lib/services/file_export_service.dart`

### Other components

- **Researcher**

## Connections

- Researcher → App Entry: opens app
- Researcher → BTK Forms: records forms (evidence: `README.md`)
- Researcher → Map Research: pins locations (evidence: `README.md`)
- App Entry → Global State: initializes state (evidence: `README.md`)
- BTK Forms → SQLite Store: stores observations (evidence: `README.md`)
- Map Research → Map Storage: stores map data
- SQLite Store → Sync Service: supplies offline data (evidence: `README.md`)
- Sync Service → Firebase: syncs when online (evidence: `README.md`)
- Researcher → Plant ID UI: submits specimen photo (evidence: `README.md`)
- Plant ID UI → Plant ID Service: requests identification
- Plant ID Service → Pl@ntNet API: gets suggestions (evidence: `README.md`)
- Researcher → Export UI: exports observations (evidence: `README.md`)
- Export UI → File Export: starts document export
- File Export → Drive & Docs: creates documents (evidence: `README.md`)
- Researcher → Drafts: reviews drafts
- Researcher → Field Sketches: draws sketches
- Researcher → Map Viewer: views map
