# xspanger3770/zejfseisserver architecture

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

- Interactive diagram: https://gitdiagram.com/xspanger3770/zejfseisserver
- Repository: https://github.com/xspanger3770/zejfseisserver

## Overview

ZejfSeisServer is a C command-line seismometer collector and TCP broadcaster. The operator configures the serial device, network endpoint, and sample rate; the runtime starts serial acquisition and the server, aligns incoming samples to log IDs, queues them, stores hourly data, and serves live or historical requests to remote clients. The README documents real-time viewing and historical browsing. The graph reflects sampled calls and documented capabilities; some queue-to-storage internals and protocol details are not fully excerpted, so uncertain links are omitted.

Main entry points: [`src/server.c`](https://github.com/xspanger3770/zejfseisserver/blob/main/src/server.c) (TCP server), [`src/scheduler.c`](https://github.com/xspanger3770/zejfseisserver/blob/main/src/scheduler.c) (Runtime scheduler), [`src/data.c`](https://github.com/xspanger3770/zejfseisserver/blob/main/src/data.c) (Hourly data manager), [`src/serial_reader.c`](https://github.com/xspanger3770/zejfseisserver/blob/main/src/serial_reader.c) (Serial reader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Runtime control"]
  node_main["CLI entry<br/>[main.c]"]
  node_scheduler["Runtime scheduler<br/>[scheduler.c]"]
end

subgraph group_acquisition["Serial acquisition"]
  node_serial["Serial reader<br/>[serial_reader.c]"]
  node_queue["Sample queue<br/>[serial_reader.c]"]
end

subgraph group_data["Data management"]
  node_data["Hourly data manager<br/>[data.c]"]
  node_disk[("Hourly data files")]
end

subgraph group_network["TCP service"]
  node_server["TCP server<br/>[server.c]"]
end

subgraph group_shared["Shared utilities"]
  node_arraylist["Array list<br/>[arraylist.c]"]
  node_strings["String helpers<br/>[my_string.c]"]
  node_time["Time utilities<br/>[time_utils.c]"]
  node_comutils["Communication helpers<br/>[com_utils.c]"]
end

node_operator(("Operator"))
node_arduino["Arduino seismometer"]
node_clients(("Remote clients"))

node_operator -->|"configures"| node_main
node_main -->|"starts runtime"| node_scheduler
node_scheduler -->|"initializes"| node_data
node_scheduler -->|"starts reader"| node_serial
node_scheduler -->|"starts server"| node_server
node_arduino -->|"sends samples"| node_serial
node_serial -->|"sets sample rate"| node_arduino
node_serial -->|"enqueues logs"| node_queue
node_queue -->|"notifies updates"| node_server
node_server -->|"accepts client logs"| node_queue
node_server -->|"reads log values"| node_data
node_data -->|"loads and saves"| node_disk
node_server -->|"serves live and history"| node_clients
node_scheduler -.->|"tracks clients"| node_arraylist
node_server -->|"manages client lists"| node_arraylist
node_data -->|"builds storage paths"| node_strings
node_data -->|"uses timestamps"| node_time
node_server -->|"uses protocol helpers"| node_comutils

click node_main "https://github.com/xspanger3770/zejfseisserver/blob/main/src/main.c"
click node_scheduler "https://github.com/xspanger3770/zejfseisserver/blob/main/src/scheduler.c"
click node_serial "https://github.com/xspanger3770/zejfseisserver/blob/main/src/serial_reader.c"
click node_queue "https://github.com/xspanger3770/zejfseisserver/blob/main/src/serial_reader.c"
click node_data "https://github.com/xspanger3770/zejfseisserver/blob/main/src/data.c"
click node_server "https://github.com/xspanger3770/zejfseisserver/blob/main/src/server.c"
click node_arraylist "https://github.com/xspanger3770/zejfseisserver/blob/main/src/arraylist.c"
click node_strings "https://github.com/xspanger3770/zejfseisserver/blob/main/src/my_string.c"
click node_time "https://github.com/xspanger3770/zejfseisserver/blob/main/src/time_utils.c"
click node_comutils "https://github.com/xspanger3770/zejfseisserver/blob/main/src/com_utils.c"

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_main,node_scheduler,node_clients toneBlue
class node_serial,node_queue toneAmber
class node_data,node_disk toneMint
class node_server toneRose
class node_arraylist,node_strings,node_time,node_comutils,node_operator,node_arduino toneIndigo
```

## Components

### Runtime control

- [CLI entry](https://github.com/xspanger3770/zejfseisserver/blob/main/src/main.c): `src/main.c`
- [Runtime scheduler](https://github.com/xspanger3770/zejfseisserver/blob/main/src/scheduler.c): `src/scheduler.c`

### Serial acquisition

- [Serial reader](https://github.com/xspanger3770/zejfseisserver/blob/main/src/serial_reader.c): `src/serial_reader.c`
- [Sample queue](https://github.com/xspanger3770/zejfseisserver/blob/main/src/serial_reader.c): `src/serial_reader.c`

### Data management

- [Hourly data manager](https://github.com/xspanger3770/zejfseisserver/blob/main/src/data.c): `src/data.c`
- **Hourly data files**

### TCP service

- [TCP server](https://github.com/xspanger3770/zejfseisserver/blob/main/src/server.c): `src/server.c`

### Shared utilities

- [Array list](https://github.com/xspanger3770/zejfseisserver/blob/main/src/arraylist.c): `src/arraylist.c`
- [String helpers](https://github.com/xspanger3770/zejfseisserver/blob/main/src/my_string.c): `src/my_string.c`
- [Time utilities](https://github.com/xspanger3770/zejfseisserver/blob/main/src/time_utils.c): `src/time_utils.c`
- [Communication helpers](https://github.com/xspanger3770/zejfseisserver/blob/main/src/com_utils.c): `src/com_utils.c`

### Other components

- **Operator**
- **Arduino seismometer**
- **Remote clients**

## Connections

- Operator → CLI entry: configures (evidence: `README.md`)
- CLI entry → Runtime scheduler: starts runtime (evidence: `src/main.c`)
- Runtime scheduler → Hourly data manager: initializes (evidence: `src/scheduler.c`)
- Runtime scheduler → Serial reader: starts reader (evidence: `src/scheduler.c`)
- Runtime scheduler → TCP server: starts server (evidence: `src/scheduler.c`)
- Arduino seismometer → Serial reader: sends samples (evidence: `README.md`)
- Serial reader → Arduino seismometer: sets sample rate (evidence: `src/serial_reader.c`)
- Serial reader → Sample queue: enqueues logs (evidence: `src/serial_reader.c`)
- Sample queue → TCP server: notifies updates (evidence: `src/serial_reader.c`)
- TCP server → Sample queue: accepts client logs (evidence: `src/server.c`)
- TCP server → Hourly data manager: reads log values (evidence: `src/server.c`)
- Hourly data manager → Hourly data files: loads and saves (evidence: `src/data.c`)
- TCP server → Remote clients: serves live and history (evidence: `README.md`)
- Runtime scheduler → Array list: tracks clients
- TCP server → Array list: manages client lists (evidence: `src/server.c`)
- Hourly data manager → String helpers: builds storage paths (evidence: `src/data.c`)
- Hourly data manager → Time utilities: uses timestamps (evidence: `src/data.c`)
- TCP server → Communication helpers: uses protocol helpers (evidence: `src/server.c`)
