# sepse/sensors-for-healthy-cities architecture

> Architecture diagram of the GitHub repository sepse/sensors-for-healthy-cities, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sepse/sensors-for-healthy-cities
- Repository: https://github.com/sepse/sensors-for-healthy-cities

## Overview

##### Main Components
- Sensor Modules: Represent the two types of deployed sensors:
- Smart Citizen Kit (environmental sensors: air temperature, humidity, noise, light intensity, air pressure, UV, air quality, etc.)
- Raspberry Shake (seismic sensor for monitoring ground movements)
- Connectivity & Communication: Illustrate the wireless connectivity (typically via Wi-Fi) used by these sensor modules to transmit data.
- Data Aggregation/Platforms: Include the platforms where the data is collected and visualized:
- Smart Citizen Platform for environmental data
- Raspberry Shake Station View for seismic data
- Public / External Interfaces: Indicate that the collected data is openly accessible to the public and researchers, representing a front-end/user portal or API endpoints.
- Partner Organizations & Community: Optionally, show the involvement of partner organizations in each city as external actors that may influence deployment or provide additional context.

##### Relationships and Data Flows
- That the sensors are deployed in different geographical locations (Prishtina, Prizren, and Tirana) by labeling nodes or sections with city names if appropriate.

##### Architectural Patterns and Design Principles
- IoT Architecture: Emphasize that this is an Internet of Things (IoT) setup where physical devices (sensor modules) communicate with central or cloud-based platforms.
- Open Data Principle: Mark how data flows from closed sensor networks to open, publicly accessible platforms.
- Decentralization: Although the sensor modules are autonomous, they are part of an integrated data collection pipeline that aggregates data centrally for public display and research.

##### Relevant Technologies and Frameworks
- That the hardware platforms are open-source and based on community-supported designs (e.g., Raspberry Pi for Raspberry Shake).
- Mention that wireless technology (Wi-Fi) is central to sensor communication.
- Although the technical stack for data storage or processing isn’t described in detail via files, assume that modern web services (likely RESTful APIs) are used at the backend of the Smart Citizen and Raspberry Shake platforms.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Documentation Node
    Overview["Project Overview & System Architecture"]:::documentation

    %% Physical Layer
    subgraph "Physical Sensor Modules"
        SC["Smart Citizen Kit"]:::sensor
        RS["Raspberry Shake"]:::sensor
        direction TB
    end

    %% Communication Layer
    subgraph "Communication Layer"
        WC["Wireless Connectivity (Wi-Fi)"]:::connectivity
        direction TB
    end

    %% Aggregation & Service Layer
    subgraph "Data Aggregation/Platforms"
        SCP["Smart Citizen Platform"]:::aggregation
        RSS["Raspberry Shake Station View"]:::aggregation
        direction TB
    end

    %% Data Access Layer
    subgraph "Data Access Layer"
        PDA["Public Data Access"]:::access
        direction TB
    end

    %% Partner Organizations and Community (external)
    Partner["Partner Organizations & Community"]:::partner

    %% Connections
    %% From Documentation to Physical Sensors (context)
    Overview -->|"describes"| SC
    Overview -->|"describes"| RS

    %% Sensor Modules to Communication Layer
    SC -->|"transmits"| WC
    RS -->|"transmits"| WC

    %% Communication to Aggregation Platforms
    WC -->|"routes"| SCP
    WC -->|"routes"| RSS

    %% Aggregation Platforms to Public Data Access
    SCP -->|"exposes"| PDA
    RSS -->|"exposes"| PDA

    %% Partner influence on sensor deployment
    Partner ---|"supports"| SC
    Partner ---|"supports"| RS

    %% Click Events
    click Overview "https://github.com/sepse/sensors-for-healthy-cities/blob/main/README.md"

    %% Styles
    classDef sensor fill:#f9c,stroke:#333,stroke-width:2px;
    classDef connectivity fill:#ff9,stroke:#333,stroke-width:2px;
    classDef aggregation fill:#9cf,stroke:#333,stroke-width:2px;
    classDef access fill:#fc9,stroke:#333,stroke-width:2px;
    classDef partner fill:#c9f,stroke:#333,stroke-width:2px;
    classDef documentation fill:#ddd,stroke:#333,stroke-width:2px;
```
