# lipomoea/kanameishi architecture

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

## Overview

Kanameishi is a seismic early-warning and earthquake-information visualization app, presented as a map-based web/desktop client. Its main workflow is to receive configured alert, earthquake, station, and tsunami data; maintain live status; and render events and monitoring networks on the map. Settings and access capabilities control which sources and features are enabled. The README documents several provider and alert capabilities whose detailed adapters were not sampled, so those links are documented at the product level; implementation-level links are limited to indexed imports and excerpts.

Main entry points: [`src/stores/status.js`](https://github.com/lipomoea/kanameishi/blob/dev/src/stores/status.js) (Live Event State), [`src/views/HomeView.vue`](https://github.com/lipomoea/kanameishi/blob/dev/src/views/HomeView.vue) (Home View), [`src/components/MainMapComponent.vue`](https://github.com/lipomoea/kanameishi/blob/dev/src/components/MainMapComponent.vue) (Live Map), [`src/stores/settings.js`](https://github.com/lipomoea/kanameishi/blob/dev/src/stores/settings.js) (Settings State)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Map and Views"]
  node_home["Home View<br/>[HomeView.vue]"]
  node_map["Live Map"]
  node_eqviews["Earthquake Views"]
  node_statusview["Status View"]
  node_settingsview["Settings UI"]
  node_sourcemgr["Source Manager"]
end

subgraph group_feeds["Alerts and Information"]
  node_status["Live Event State<br/>[status.js]"]
  node_networkfeeds["Alert and Quake Feeds<br/>[status.js]"]
  node_tsunami["Tsunami Information<br/>[JmaTsunami.vue]"]
  node_typhoon["Typhoon Information"]
end

subgraph group_stations["Station Monitoring"]
  node_nied["NIED Monitor<br/>[NiedNet.vue]"]
  node_palert["Palert Monitor<br/>[PalertNet.vue]"]
  node_hypofinder["Hypocenter Inference<br/>[FindHypocenter.js]"]
  node_niedworker["NIED Worker"]
  node_palertworker["Palert Worker"]
end

subgraph group_config["Settings and State"]
  node_settings["Settings State<br/>[settings.js]"]
  node_access["Access Capabilities<br/>[access.js]"]
  node_http["HTTP Client<br/>[Http.js]"]
end

subgraph group_domain["Domain Support"]
  node_sources["Source Catalog<br/>[DataSources.js]"]
  node_regions["Intensity Locations<br/>[JmaSeisIntLoc.js]"]
end

node_user(("User"))
node_providers(("Documented Data Providers"))

node_user -->|"opens app"| node_home
node_home -->|"renders"| node_map
node_home -->|"renders"| node_statusview
node_map -->|"reads events"| node_status
node_map -->|"renders"| node_eqviews
node_settingsview -->|"opens manager"| node_sourcemgr
node_sourcemgr -->|"updates sources"| node_settings
node_settings -->|"checks capabilities"| node_access
node_settings -->|"uses catalog"| node_sources
node_status -->|"maintains feeds"| node_networkfeeds
node_status -->|"requests data"| node_http
node_nied -->|"requests data"| node_http
node_nied -->|"dispatches work"| node_niedworker
node_niedworker -->|"uses inference"| node_hypofinder
node_palert -.->|"dispatches work"| node_palertworker
node_palertworker -->|"uses inference"| node_hypofinder
node_status -->|"uses locations"| node_regions
node_providers -.->|"supply documented data"| node_networkfeeds
node_providers -.->|"supply tsunami alerts"| node_tsunami
node_providers -.->|"supply station data"| node_nied
node_providers -.->|"supply station data"| node_palert

click node_home "https://github.com/lipomoea/kanameishi/blob/dev/src/views/HomeView.vue"
click node_map "https://github.com/lipomoea/kanameishi/blob/dev/src/components/MainMapComponent.vue"
click node_eqviews "https://github.com/lipomoea/kanameishi/blob/dev/src/components/EqlistComponent.vue"
click node_statusview "https://github.com/lipomoea/kanameishi/blob/dev/src/components/StatusComponent.vue"
click node_settingsview "https://github.com/lipomoea/kanameishi/blob/dev/src/components/SettingsComponent.vue"
click node_sourcemgr "https://github.com/lipomoea/kanameishi/blob/dev/src/components/components/DataSourceManager.vue"
click node_status "https://github.com/lipomoea/kanameishi/blob/dev/src/stores/status.js"
click node_networkfeeds "https://github.com/lipomoea/kanameishi/blob/dev/src/stores/status.js"
click node_tsunami "https://github.com/lipomoea/kanameishi/blob/dev/src/components/components/JmaTsunami.vue"
click node_typhoon "https://github.com/lipomoea/kanameishi/blob/dev/src/components/TyphoonComponent.vue"
click node_nied "https://github.com/lipomoea/kanameishi/blob/dev/src/components/components/NiedNet.vue"
click node_palert "https://github.com/lipomoea/kanameishi/blob/dev/src/components/components/PalertNet.vue"
click node_hypofinder "https://github.com/lipomoea/kanameishi/blob/dev/src/classes/FindHypocenter.js"
click node_niedworker "https://github.com/lipomoea/kanameishi/blob/dev/src/workers/FindNiedHypocenterWorker.js"
click node_palertworker "https://github.com/lipomoea/kanameishi/blob/dev/src/workers/FindPalertHypocenterWorker.js"
click node_settings "https://github.com/lipomoea/kanameishi/blob/dev/src/stores/settings.js"
click node_access "https://github.com/lipomoea/kanameishi/blob/dev/src/stores/access.js"
click node_http "https://github.com/lipomoea/kanameishi/blob/dev/src/classes/Http.js"
click node_sources "https://github.com/lipomoea/kanameishi/blob/dev/src/utils/DataSources.js"
click node_regions "https://github.com/lipomoea/kanameishi/blob/dev/src/utils/JmaSeisIntLoc.js"

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_home,node_map,node_eqviews,node_statusview,node_settingsview,node_sourcemgr,node_user toneBlue
class node_status,node_networkfeeds,node_tsunami,node_typhoon toneAmber
class node_nied,node_palert,node_hypofinder,node_niedworker,node_palertworker toneMint
class node_settings,node_access,node_http toneRose
class node_sources,node_regions,node_providers toneIndigo
```

## Components

### Map and Views

- [Home View](https://github.com/lipomoea/kanameishi/blob/dev/src/views/HomeView.vue): `src/views/HomeView.vue`
- [Live Map](https://github.com/lipomoea/kanameishi/blob/dev/src/components/MainMapComponent.vue): `src/components/MainMapComponent.vue`
- [Earthquake Views](https://github.com/lipomoea/kanameishi/blob/dev/src/components/EqlistComponent.vue): `src/components/EqlistComponent.vue`
- [Status View](https://github.com/lipomoea/kanameishi/blob/dev/src/components/StatusComponent.vue): `src/components/StatusComponent.vue`
- [Settings UI](https://github.com/lipomoea/kanameishi/blob/dev/src/components/SettingsComponent.vue): `src/components/SettingsComponent.vue`
- [Source Manager](https://github.com/lipomoea/kanameishi/blob/dev/src/components/components/DataSourceManager.vue): `src/components/components/DataSourceManager.vue`

### Alerts and Information

- [Live Event State](https://github.com/lipomoea/kanameishi/blob/dev/src/stores/status.js): `src/stores/status.js`
- [Alert and Quake Feeds](https://github.com/lipomoea/kanameishi/blob/dev/src/stores/status.js): `src/stores/status.js`
- [Tsunami Information](https://github.com/lipomoea/kanameishi/blob/dev/src/components/components/JmaTsunami.vue): `src/components/components/JmaTsunami.vue`
- [Typhoon Information](https://github.com/lipomoea/kanameishi/blob/dev/src/components/TyphoonComponent.vue): `src/components/TyphoonComponent.vue`

### Station Monitoring

- [NIED Monitor](https://github.com/lipomoea/kanameishi/blob/dev/src/components/components/NiedNet.vue): `src/components/components/NiedNet.vue`
- [Palert Monitor](https://github.com/lipomoea/kanameishi/blob/dev/src/components/components/PalertNet.vue): `src/components/components/PalertNet.vue`
- [Hypocenter Inference](https://github.com/lipomoea/kanameishi/blob/dev/src/classes/FindHypocenter.js): `src/classes/FindHypocenter.js`
- [NIED Worker](https://github.com/lipomoea/kanameishi/blob/dev/src/workers/FindNiedHypocenterWorker.js): `src/workers/FindNiedHypocenterWorker.js`
- [Palert Worker](https://github.com/lipomoea/kanameishi/blob/dev/src/workers/FindPalertHypocenterWorker.js): `src/workers/FindPalertHypocenterWorker.js`

### Settings and State

- [Settings State](https://github.com/lipomoea/kanameishi/blob/dev/src/stores/settings.js): `src/stores/settings.js`
- [Access Capabilities](https://github.com/lipomoea/kanameishi/blob/dev/src/stores/access.js): `src/stores/access.js`
- [HTTP Client](https://github.com/lipomoea/kanameishi/blob/dev/src/classes/Http.js): `src/classes/Http.js`

### Domain Support

- [Source Catalog](https://github.com/lipomoea/kanameishi/blob/dev/src/utils/DataSources.js): `src/utils/DataSources.js`
- [Intensity Locations](https://github.com/lipomoea/kanameishi/blob/dev/src/utils/JmaSeisIntLoc.js): `src/utils/JmaSeisIntLoc.js`

### Other components

- **User**
- **Documented Data Providers**

## Connections

- User → Home View: opens app (evidence: `src/views/HomeView.vue`)
- Home View → Live Map: renders (evidence: `src/views/HomeView.vue`)
- Home View → Status View: renders (evidence: `src/views/HomeView.vue`)
- Live Map → Live Event State: reads events (evidence: `src/components/MainMapComponent.vue`)
- Live Map → Earthquake Views: renders (evidence: `src/components/MainMapComponent.vue`)
- Settings UI → Source Manager: opens manager (evidence: `src/components/SettingsComponent.vue`)
- Source Manager → Settings State: updates sources (evidence: `src/components/components/DataSourceManager.vue`)
- Settings State → Access Capabilities: checks capabilities (evidence: `src/stores/settings.js`)
- Settings State → Source Catalog: uses catalog (evidence: `src/stores/settings.js`)
- Live Event State → Alert and Quake Feeds: maintains feeds (evidence: `src/stores/status.js`)
- Live Event State → HTTP Client: requests data (evidence: `src/stores/status.js`)
- NIED Monitor → HTTP Client: requests data (evidence: `src/components/components/NiedNet.vue`)
- NIED Monitor → NIED Worker: dispatches work (evidence: `src/components/components/NiedNet.vue`)
- NIED Worker → Hypocenter Inference: uses inference (evidence: `src/workers/FindNiedHypocenterWorker.js`)
- Palert Monitor → Palert Worker: dispatches work
- Palert Worker → Hypocenter Inference: uses inference (evidence: `src/workers/FindPalertHypocenterWorker.js`)
- Live Event State → Intensity Locations: uses locations (evidence: `src/stores/status.js`)
- Documented Data Providers → Alert and Quake Feeds: supply documented data (evidence: `README.md`)
- Documented Data Providers → Tsunami Information: supply tsunami alerts (evidence: `README.md`)
- Documented Data Providers → NIED Monitor: supply station data (evidence: `README.md`)
- Documented Data Providers → Palert Monitor: supply station data (evidence: `README.md`)
