# anastasisch/seismicevents architecture

> Architecture diagram of the GitHub repository anastasisch/seismicevents, 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/anastasisch/seismicevents
- Repository: https://github.com/anastasisch/seismicevents

## Overview

This ASP.NET service ingests live seismic events from the Seismic Portal, buffers and batches them by region, compresses event data with metadata, and stores it in SQLite. Its HTTP endpoints query either raw events or compressed chunks, filtering by region or depth; compressed results are decompressed before being returned. The source also includes a NASA FIRMS polling service and satellite-scan DTO, but its activation and runtime connections are not shown. Edges reflect excerpts or SOURCE INDEX references; unverified integration is dashed.

Main entry points: [`SeismicEvents/Data/SeismicEventsFireEventsDbContext.cs`](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Data/SeismicEventsFireEventsDbContext.cs) (EF database context), [`SeismicEvents/Services/FlushSeismicInMemoryTable.cs`](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Services/FlushSeismicInMemoryTable.cs) (Batch and flush), [`SeismicEvents/Program.cs`](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Program.cs) (Service host), [`SeismicEvents/Services/SeismicPortalClientWS.cs`](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Services/SeismicPortalClientWS.cs) (Seismic Portal client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Live ingestion"]
  node_client["Seismic Portal client"]
  node_portalqueue["Live event queue"]
  node_flush["Batch and flush"]
  node_regionalqueue["Regional batch queues"]
  node_nasa["NASA FIRMS poller"]
  node_app["Service host<br/>[Program.cs]"]
end

subgraph group_storage["Persistence"]
  node_efcontext["EF database context"]
  node_dappercontext["Dapper connection"]
  node_sqlite[("SQLite database<br/>[SeismicEvents.db]")]
end

subgraph group_query["Query API"]
  node_rawapi["Raw event queries"]
  node_compressedapi["Compressed event queries"]
end

subgraph group_domain["Event data"]
  node_satellite["Satellite scan DTO<br/>[SateliteScanDTO.cs]"]
  node_compressed["Compressed event model"]
  node_eventmodel["Stored event model"]
  node_portalmessage["Portal message DTO"]
  node_seismicdata["Seismic data DTO<br/>[SeismicData.cs]"]
  node_geometry["Geometry DTO<br/>[SeismicGeometry.cs]"]
  node_propertiesdto["Event properties DTO"]
  node_utils["Compression and metadata"]
end

node_caller(("API caller"))
node_portal(("Seismic Portal"))
node_nasaexternal(("NASA FIRMS"))

node_app -->|"registers"| node_client
node_app -->|"registers"| node_flush
node_app -->|"configures"| node_efcontext
node_app -->|"registers"| node_dappercontext
node_client -->|"connects"| node_portal
node_client -->|"enqueues"| node_portalqueue
node_client -->|"deserializes"| node_portalmessage
node_portalmessage -->|"contains"| node_seismicdata
node_seismicdata -->|"uses"| node_geometry
node_flush -->|"dequeues"| node_portalqueue
node_flush -->|"batches"| node_regionalqueue
node_flush -->|"compresses and updates"| node_utils
node_flush -->|"writes chunks"| node_efcontext
node_efcontext -->|"maps"| node_compressed
node_efcontext -->|"maps"| node_eventmodel
node_efcontext -.->|"persists via"| node_sqlite
node_dappercontext -->|"opens connection"| node_sqlite
node_caller -->|"requests"| node_rawapi
node_caller -->|"requests"| node_compressedapi
node_rawapi -->|"queries raw events"| node_efcontext
node_rawapi -->|"queries raw events"| node_dappercontext
node_compressedapi -->|"reads chunks"| node_efcontext
node_compressedapi -->|"reads chunks"| node_dappercontext
node_compressedapi -->|"decompresses"| node_utils
node_utils -->|"serializes events"| node_propertiesdto
node_nasa -->|"deserializes"| node_satellite
node_nasa -.->|"polls"| node_nasaexternal

click node_client "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Services/SeismicPortalClientWS.cs"
click node_portalqueue "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Services/SeismicPortalClientWS.cs"
click node_flush "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Services/FlushSeismicInMemoryTable.cs"
click node_regionalqueue "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/DTOs/InMemoryFlushQueue.cs"
click node_nasa "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Services/PollingNASAFirms.cs"
click node_satellite "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/DTOs/SateliteScanDTO.cs"
click node_efcontext "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Data/SeismicEventsFireEventsDbContext.cs"
click node_dappercontext "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Data/SeismicEventsDapperDbContext.cs"
click node_sqlite "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/SeismicEvents.db"
click node_compressed "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Models/SeismicCompressedProperties.cs"
click node_eventmodel "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Models/SeismicProperties.cs"
click node_portalmessage "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/DTOs/SeismicPortalMessage.cs"
click node_seismicdata "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/DTOs/SeismicData.cs"
click node_geometry "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/DTOs/SeismicGeometry.cs"
click node_propertiesdto "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/DTOs/SeismicProperties.cs"
click node_utils "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Utils/SeismicEventsUtils.cs"
click node_rawapi "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Controllers/FindSeismicEventRawController.cs"
click node_compressedapi "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Controllers/FindSeismicEventsController.cs"
click node_app "https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Program.cs"

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_client,node_portalqueue,node_flush,node_regionalqueue,node_nasa,node_app toneBlue
class node_efcontext,node_dappercontext,node_sqlite toneAmber
class node_rawapi,node_compressedapi,node_caller toneMint
class node_satellite,node_compressed,node_eventmodel,node_portalmessage,node_seismicdata,node_geometry,node_propertiesdto,node_utils toneRose
class node_portal,node_nasaexternal toneIndigo
```

## Components

### Live ingestion

- [Seismic Portal client](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Services/SeismicPortalClientWS.cs): `SeismicEvents/Services/SeismicPortalClientWS.cs`
- [Live event queue](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Services/SeismicPortalClientWS.cs): `SeismicEvents/Services/SeismicPortalClientWS.cs`
- [Batch and flush](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Services/FlushSeismicInMemoryTable.cs): `SeismicEvents/Services/FlushSeismicInMemoryTable.cs`
- [Regional batch queues](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/DTOs/InMemoryFlushQueue.cs): `SeismicEvents/DTOs/InMemoryFlushQueue.cs`
- [NASA FIRMS poller](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Services/PollingNASAFirms.cs): `SeismicEvents/Services/PollingNASAFirms.cs`
- [Service host](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Program.cs): `SeismicEvents/Program.cs`

### Persistence

- [EF database context](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Data/SeismicEventsFireEventsDbContext.cs): `SeismicEvents/Data/SeismicEventsFireEventsDbContext.cs`
- [Dapper connection](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Data/SeismicEventsDapperDbContext.cs): `SeismicEvents/Data/SeismicEventsDapperDbContext.cs`
- [SQLite database](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/SeismicEvents.db): `SeismicEvents/SeismicEvents.db`

### Query API

- [Raw event queries](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Controllers/FindSeismicEventRawController.cs): `SeismicEvents/Controllers/FindSeismicEventRawController.cs`
- [Compressed event queries](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Controllers/FindSeismicEventsController.cs): `SeismicEvents/Controllers/FindSeismicEventsController.cs`

### Event data

- [Satellite scan DTO](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/DTOs/SateliteScanDTO.cs): `SeismicEvents/DTOs/SateliteScanDTO.cs`
- [Compressed event model](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Models/SeismicCompressedProperties.cs): `SeismicEvents/Models/SeismicCompressedProperties.cs`
- [Stored event model](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Models/SeismicProperties.cs): `SeismicEvents/Models/SeismicProperties.cs`
- [Portal message DTO](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/DTOs/SeismicPortalMessage.cs): `SeismicEvents/DTOs/SeismicPortalMessage.cs`
- [Seismic data DTO](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/DTOs/SeismicData.cs): `SeismicEvents/DTOs/SeismicData.cs`
- [Geometry DTO](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/DTOs/SeismicGeometry.cs): `SeismicEvents/DTOs/SeismicGeometry.cs`
- [Event properties DTO](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/DTOs/SeismicProperties.cs): `SeismicEvents/DTOs/SeismicProperties.cs`
- [Compression and metadata](https://github.com/anastasisch/seismicevents/blob/master/SeismicEvents/Utils/SeismicEventsUtils.cs): `SeismicEvents/Utils/SeismicEventsUtils.cs`

### Other components

- **API caller**
- **Seismic Portal**
- **NASA FIRMS**

## Connections

- Service host → Seismic Portal client: registers (evidence: `SeismicEvents/Program.cs`)
- Service host → Batch and flush: registers (evidence: `SeismicEvents/Program.cs`)
- Service host → EF database context: configures (evidence: `SeismicEvents/Program.cs`)
- Service host → Dapper connection: registers (evidence: `SeismicEvents/Program.cs`)
- Seismic Portal client → Seismic Portal: connects (evidence: `SeismicEvents/Services/SeismicPortalClientWS.cs`)
- Seismic Portal client → Live event queue: enqueues (evidence: `SeismicEvents/Services/SeismicPortalClientWS.cs`)
- Seismic Portal client → Portal message DTO: deserializes (evidence: `SeismicEvents/Services/SeismicPortalClientWS.cs`)
- Portal message DTO → Seismic data DTO: contains (evidence: `SeismicEvents/DTOs/SeismicPortalMessage.cs`)
- Seismic data DTO → Geometry DTO: uses (evidence: `SeismicEvents/DTOs/SeismicData.cs`)
- Batch and flush → Live event queue: dequeues (evidence: `SeismicEvents/Services/FlushSeismicInMemoryTable.cs`)
- Batch and flush → Regional batch queues: batches (evidence: `SeismicEvents/Services/FlushSeismicInMemoryTable.cs`)
- Batch and flush → Compression and metadata: compresses and updates (evidence: `SeismicEvents/Services/FlushSeismicInMemoryTable.cs`)
- Batch and flush → EF database context: writes chunks (evidence: `SeismicEvents/Services/FlushSeismicInMemoryTable.cs`)
- EF database context → Compressed event model: maps (evidence: `SeismicEvents/Data/SeismicEventsFireEventsDbContext.cs`)
- EF database context → Stored event model: maps (evidence: `SeismicEvents/Data/SeismicEventsFireEventsDbContext.cs`)
- EF database context → SQLite database: persists via
- Dapper connection → SQLite database: opens connection (evidence: `SeismicEvents/Data/SeismicEventsDapperDbContext.cs`)
- API caller → Raw event queries: requests (evidence: `SeismicEvents/Controllers/FindSeismicEventRawController.cs`)
- API caller → Compressed event queries: requests (evidence: `SeismicEvents/Controllers/FindSeismicEventsController.cs`)
- Raw event queries → EF database context: queries raw events (evidence: `SeismicEvents/Controllers/FindSeismicEventRawController.cs`)
- Raw event queries → Dapper connection: queries raw events (evidence: `SeismicEvents/Controllers/FindSeismicEventRawController.cs`)
- Compressed event queries → EF database context: reads chunks (evidence: `SeismicEvents/Controllers/FindSeismicEventsController.cs`)
- Compressed event queries → Dapper connection: reads chunks (evidence: `SeismicEvents/Controllers/FindSeismicEventsController.cs`)
- Compressed event queries → Compression and metadata: decompresses (evidence: `SeismicEvents/Controllers/FindSeismicEventsController.cs`)
- Compression and metadata → Event properties DTO: serializes events (evidence: `SeismicEvents/Utils/SeismicEventsUtils.cs`)
- NASA FIRMS poller → Satellite scan DTO: deserializes (evidence: `SeismicEvents/Services/PollingNASAFirms.cs`)
- NASA FIRMS poller → NASA FIRMS: polls
