# eemeli/konopas architecture

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

- Interactive diagram: https://gitdiagram.com/eemeli/konopas
- Repository: https://github.com/eemeli/konopas

## Overview

KonOpas is a browser-based mobile event programme guide. The main workflow is event organizers supplying programme and participant data, the app constructing schedule and people views, and attendees filtering items and saving starred selections. The README also documents optional server sync and a Google Sheets-to-KonOpas data utility. Source excerpts establish app-to-view and sheet-conversion calls; some view internals and external server capabilities are documented but not fully sampled, so uncertain links are omitted.

Main entry points: [`src/app.js`](https://github.com/eemeli/konopas/blob/master/src/app.js) (App controller), [`util/lib/gdrive2json.php`](https://github.com/eemeli/konopas/blob/master/util/lib/gdrive2json.php) (Sheet converter), [`util/read-from-gdrive.php`](https://github.com/eemeli/konopas/blob/master/util/read-from-gdrive.php) (Data publisher), [`src/server.js`](https://github.com/eemeli/konopas/blob/master/src/server.js) (Sync service client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser guide"]
  node_app["App controller<br/>[app.js]"]
  node_store[("Local preferences<br/>[util.js]")]
  node_server["Sync service client<br/>[server.js]"]
end

subgraph group_features["Programme features"]
  node_schedule["Programme model<br/>[prog.js]"]
  node_item["Item display<br/>[item.js]"]
  node_people["Participant view<br/>[part.js]"]
  node_saved["Starred items<br/>[stars.js]"]
  node_info["Event information<br/>[info.js]"]
end

subgraph group_data["Data preparation"]
  node_importer["Sheet converter<br/>[gdrive2json.php]"]
  node_fetch["URL fetcher<br/>[url_fetch.php]"]
  node_csv["CSV parser<br/>[parsecsv.lib.php]"]
  node_publish["Data publisher"]
  node_manifest["Cache manifest updater"]
end

node_attendee(("Attendee"))
node_remote["KonOpas server"]
node_sheets["Google Sheets"]
node_eventdata["Programme and people data"]

node_attendee -->|"uses"| node_app
node_app -->|"constructs"| node_schedule
node_app -->|"constructs"| node_people
node_app -->|"shows"| node_info
node_app -->|"shows"| node_saved
node_schedule -->|"renders items"| node_item
node_item -->|"reads stars"| node_saved
node_app -->|"creates"| node_store
node_app -->|"creates optionally"| node_server
node_server -.->|"syncs with"| node_remote
node_saved -.->|"syncs selections"| node_server
node_sheets -->|"provides CSV"| node_importer
node_importer -->|"fetches sheet"| node_fetch
node_importer -->|"parses rows"| node_csv
node_publish -->|"converts data"| node_importer
node_publish -->|"updates cache"| node_manifest
node_publish -->|"writes files"| node_eventdata
node_eventdata -.->|"loads as input"| node_app

click node_app "https://github.com/eemeli/konopas/blob/master/src/app.js"
click node_schedule "https://github.com/eemeli/konopas/blob/master/src/prog.js"
click node_item "https://github.com/eemeli/konopas/blob/master/src/item.js"
click node_people "https://github.com/eemeli/konopas/blob/master/src/part.js"
click node_saved "https://github.com/eemeli/konopas/blob/master/src/stars.js"
click node_info "https://github.com/eemeli/konopas/blob/master/src/info.js"
click node_store "https://github.com/eemeli/konopas/blob/master/src/util.js"
click node_server "https://github.com/eemeli/konopas/blob/master/src/server.js"
click node_importer "https://github.com/eemeli/konopas/blob/master/util/lib/gdrive2json.php"
click node_fetch "https://github.com/eemeli/konopas/blob/master/util/lib/url_fetch.php"
click node_csv "https://github.com/eemeli/konopas/blob/master/util/lib/parsecsv.lib.php"
click node_publish "https://github.com/eemeli/konopas/blob/master/util/read-from-gdrive.php"
click node_manifest "https://github.com/eemeli/konopas/blob/master/util/update-cache-manifest.php"

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_store,node_server toneBlue
class node_schedule,node_item,node_people,node_saved,node_info toneAmber
class node_importer,node_fetch,node_csv,node_publish,node_manifest,node_remote toneMint
class node_attendee,node_sheets,node_eventdata toneIndigo
```

## Components

### Browser guide

- [App controller](https://github.com/eemeli/konopas/blob/master/src/app.js): `src/app.js`
- [Local preferences](https://github.com/eemeli/konopas/blob/master/src/util.js): `src/util.js`
- [Sync service client](https://github.com/eemeli/konopas/blob/master/src/server.js): `src/server.js`

### Programme features

- [Programme model](https://github.com/eemeli/konopas/blob/master/src/prog.js): `src/prog.js`
- [Item display](https://github.com/eemeli/konopas/blob/master/src/item.js): `src/item.js`
- [Participant view](https://github.com/eemeli/konopas/blob/master/src/part.js): `src/part.js`
- [Starred items](https://github.com/eemeli/konopas/blob/master/src/stars.js): `src/stars.js`
- [Event information](https://github.com/eemeli/konopas/blob/master/src/info.js): `src/info.js`

### Data preparation

- [Sheet converter](https://github.com/eemeli/konopas/blob/master/util/lib/gdrive2json.php): `util/lib/gdrive2json.php`
- [URL fetcher](https://github.com/eemeli/konopas/blob/master/util/lib/url_fetch.php): `util/lib/url_fetch.php`
- [CSV parser](https://github.com/eemeli/konopas/blob/master/util/lib/parsecsv.lib.php): `util/lib/parsecsv.lib.php`
- [Data publisher](https://github.com/eemeli/konopas/blob/master/util/read-from-gdrive.php): `util/read-from-gdrive.php`
- [Cache manifest updater](https://github.com/eemeli/konopas/blob/master/util/update-cache-manifest.php): `util/update-cache-manifest.php`

### Other components

- **Attendee**
- **KonOpas server**
- **Google Sheets**
- **Programme and people data**

## Connections

- Attendee → App controller: uses (evidence: `README.md`)
- App controller → Programme model: constructs (evidence: `src/app.js`)
- App controller → Participant view: constructs (evidence: `src/app.js`)
- App controller → Event information: shows (evidence: `src/app.js`)
- App controller → Starred items: shows (evidence: `src/app.js`)
- Programme model → Item display: renders items (evidence: `src/item.js`)
- Item display → Starred items: reads stars (evidence: `src/item.js`)
- App controller → Local preferences: creates (evidence: `src/app.js`)
- App controller → Sync service client: creates optionally (evidence: `src/app.js`)
- Sync service client → KonOpas server: syncs with (evidence: `README.md`)
- Starred items → Sync service client: syncs selections (evidence: `README.md`)
- Google Sheets → Sheet converter: provides CSV (evidence: `util/lib/gdrive2json.php`)
- Sheet converter → URL fetcher: fetches sheet (evidence: `util/lib/gdrive2json.php`)
- Sheet converter → CSV parser: parses rows (evidence: `util/lib/gdrive2json.php`)
- Data publisher → Sheet converter: converts data (evidence: `util/read-from-gdrive.php`)
- Data publisher → Cache manifest updater: updates cache (evidence: `util/read-from-gdrive.php`)
- Data publisher → Programme and people data: writes files (evidence: `util/read-from-gdrive.php`)
- Programme and people data → App controller: loads as input (evidence: `README.md`)
