# boubeinstein/swim-ti-yp-prototype architecture

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

- Interactive diagram: https://gitdiagram.com/boubeinstein/swim-ti-yp-prototype
- Repository: https://github.com/boubeinstein/swim-ti-yp-prototype

## Overview

This repository configures a SWIM-TI demo platform: ADS-B traffic is retrieved from OpenSky, published through a broker, and consumed by an Explorer map; the Subscription Manager exposes REST operations for topics and subscriptions and stores their metadata. The tree primarily contains service configuration rather than application implementation, so the graph follows the README’s documented relationships and does not infer internal behavior from unsampled files.

Main entry points: [`services/subscription_manager`](https://github.com/boubeinstein/swim-ti-yp-prototype/tree/master/services/subscription_manager) (Subscription Manager), [`services/swim_adsb`](https://github.com/boubeinstein/swim-ti-yp-prototype/tree/master/services/swim_adsb) (SWIM ADS-B), [`services/swim_explorer`](https://github.com/boubeinstein/swim-ti-yp-prototype/tree/master/services/swim_explorer) (SWIM Explorer), [`services/broker/rabbitmq/rabbitmq.conf`](https://github.com/boubeinstein/swim-ti-yp-prototype/blob/master/services/broker/rabbitmq/rabbitmq.conf) (RabbitMQ Broker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["Traffic Applications"]
  node_adsb["SWIM ADS-B"]
  node_explorer["SWIM Explorer"]
end

subgraph group_management["Subscription Management"]
  node_manager["Subscription Manager"]
  node_provision["Initial Provisioning"]
end

subgraph group_infrastructure["Platform Services"]
  node_rabbit["RabbitMQ Broker<br/>[rabbitmq.conf]"]
  node_postgres[("PostgreSQL Metadata")]
  node_nginx["Web Server<br/>[nginx.conf]"]
end

node_opensky(("OpenSky Network"))
node_client(("External Consumer"))

node_opensky -->|"provides traffic"| node_adsb
node_adsb -->|"publishes topics"| node_manager
node_adsb -->|"publishes traffic"| node_rabbit
node_client -->|"manages subscriptions"| node_manager
node_manager -->|"manages topics"| node_rabbit
node_manager -->|"stores metadata"| node_postgres
node_explorer -->|"subscribes to topics"| node_manager
node_explorer -->|"receives traffic"| node_rabbit
node_client -->|"views map"| node_explorer

click node_adsb "https://github.com/boubeinstein/swim-ti-yp-prototype/tree/master/services/swim_adsb"
click node_explorer "https://github.com/boubeinstein/swim-ti-yp-prototype/tree/master/services/swim_explorer"
click node_manager "https://github.com/boubeinstein/swim-ti-yp-prototype/tree/master/services/subscription_manager"
click node_provision "https://github.com/boubeinstein/swim-ti-yp-prototype/tree/master/services/subscription_manager/provision"
click node_rabbit "https://github.com/boubeinstein/swim-ti-yp-prototype/blob/master/services/broker/rabbitmq/rabbitmq.conf"
click node_postgres "https://github.com/boubeinstein/swim-ti-yp-prototype/tree/master/services/db/postgres"
click node_nginx "https://github.com/boubeinstein/swim-ti-yp-prototype/blob/master/services/web_server/nginx/conf.d/nginx.conf"

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_adsb,node_explorer toneBlue
class node_manager,node_provision toneAmber
class node_rabbit,node_postgres,node_nginx toneMint
class node_opensky,node_client toneIndigo
```

## Components

### Traffic Applications

- [SWIM ADS-B](https://github.com/boubeinstein/swim-ti-yp-prototype/tree/master/services/swim_adsb): `services/swim_adsb`
- [SWIM Explorer](https://github.com/boubeinstein/swim-ti-yp-prototype/tree/master/services/swim_explorer): `services/swim_explorer`

### Subscription Management

- [Subscription Manager](https://github.com/boubeinstein/swim-ti-yp-prototype/tree/master/services/subscription_manager): `services/subscription_manager`
- [Initial Provisioning](https://github.com/boubeinstein/swim-ti-yp-prototype/tree/master/services/subscription_manager/provision): `services/subscription_manager/provision`

### Platform Services

- [RabbitMQ Broker](https://github.com/boubeinstein/swim-ti-yp-prototype/blob/master/services/broker/rabbitmq/rabbitmq.conf): `services/broker/rabbitmq/rabbitmq.conf`
- [PostgreSQL Metadata](https://github.com/boubeinstein/swim-ti-yp-prototype/tree/master/services/db/postgres): `services/db/postgres`
- [Web Server](https://github.com/boubeinstein/swim-ti-yp-prototype/blob/master/services/web_server/nginx/conf.d/nginx.conf): `services/web_server/nginx/conf.d/nginx.conf`

### Other components

- **OpenSky Network**
- **External Consumer**

## Connections

- OpenSky Network → SWIM ADS-B: provides traffic (evidence: `README.md`)
- SWIM ADS-B → Subscription Manager: publishes topics (evidence: `README.md`)
- SWIM ADS-B → RabbitMQ Broker: publishes traffic (evidence: `README.md`)
- External Consumer → Subscription Manager: manages subscriptions (evidence: `README.md`)
- Subscription Manager → RabbitMQ Broker: manages topics (evidence: `README.md`)
- Subscription Manager → PostgreSQL Metadata: stores metadata (evidence: `README.md`)
- SWIM Explorer → Subscription Manager: subscribes to topics (evidence: `README.md`)
- SWIM Explorer → RabbitMQ Broker: receives traffic (evidence: `README.md`)
- External Consumer → SWIM Explorer: views map (evidence: `README.md`)
