# ringmast4r/surveillance-capabilities-map architecture

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

- Interactive diagram: https://gitdiagram.com/ringmast4r/surveillance-capabilities-map
- Repository: https://github.com/ringmast4r/surveillance-capabilities-map

## Overview

This is a static web application for exploring police surveillance capabilities across the United States. The principal workflow is to open the map, inspect locations, and narrow results by technology or search terms; users can also explore and export raw data and view FBI/DHS flight paths. The README documents integration of the listed datasets, but no source excerpts were provided, so links describe documented product behavior rather than verified implementation calls.

Main entry points: [`surveillance-map-final.html`](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-map-final.html) (Web map), [`atlas-of-surveillance.csv`](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/atlas-of-surveillance.csv) (EFF Atlas data), [`surveillance-contracts.csv`](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-contracts.csv) (Federal contracts), [`surveillance-grants.csv`](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-grants.csv) (Federal grants)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Map application"]
  node_app["Web map"]
  node_interactive_map["Interactive map"]
  node_flight_view["Flight paths"]
end

subgraph group_exploration["Data exploration"]
  node_technology_filter["Technology filters"]
  node_search["Location search"]
  node_data_explorer["Data explorer"]
  node_csv_export["CSV export"]
end

subgraph group_datasets["Surveillance data"]
  node_atlas_data["EFF Atlas data"]
  node_contracts["Federal contracts"]
  node_grants["Federal grants"]
  node_equipment["1033 equipment<br/>[wapo-1033-data.csv]"]
  node_flights["Flight data<br/>[flight_paths.json]"]
  node_city_coords["City coordinates<br/>[city_coords.json]"]
end

node_user(("Map user"))

node_user -->|"opens"| node_app
node_app -->|"provides"| node_interactive_map
node_app -->|"provides"| node_technology_filter
node_app -->|"provides"| node_search
node_app -->|"provides"| node_data_explorer
node_data_explorer -->|"exports"| node_csv_export
node_app -->|"visualizes"| node_flight_view
node_atlas_data -->|"integrated by"| node_app
node_contracts -->|"integrated by"| node_app
node_grants -->|"integrated by"| node_app
node_equipment -->|"integrated by"| node_app
node_flights -->|"visualized in"| node_flight_view
node_city_coords -->|"supports geocoding"| node_app

click node_app "https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-map-final.html"
click node_interactive_map "https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-map-final.html"
click node_flight_view "https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-map-final.html"
click node_technology_filter "https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-map-final.html"
click node_search "https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-map-final.html"
click node_data_explorer "https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-map-final.html"
click node_csv_export "https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-map-final.html"
click node_atlas_data "https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/atlas-of-surveillance.csv"
click node_contracts "https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-contracts.csv"
click node_grants "https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-grants.csv"
click node_equipment "https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/wapo-1033-data.csv"
click node_flights "https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/flight_paths.json"
click node_city_coords "https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/city_coords.json"

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_app,node_interactive_map,node_flight_view,node_user toneBlue
class node_technology_filter,node_search,node_data_explorer,node_csv_export toneAmber
class node_atlas_data,node_contracts,node_grants,node_equipment,node_flights,node_city_coords toneMint
```

## Components

### Map application

- [Web map](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-map-final.html): `surveillance-map-final.html`
- [Interactive map](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-map-final.html): `surveillance-map-final.html`
- [Flight paths](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-map-final.html): `surveillance-map-final.html`

### Data exploration

- [Technology filters](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-map-final.html): `surveillance-map-final.html`
- [Location search](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-map-final.html): `surveillance-map-final.html`
- [Data explorer](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-map-final.html): `surveillance-map-final.html`
- [CSV export](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-map-final.html): `surveillance-map-final.html`

### Surveillance data

- [EFF Atlas data](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/atlas-of-surveillance.csv): `atlas-of-surveillance.csv`
- [Federal contracts](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-contracts.csv): `surveillance-contracts.csv`
- [Federal grants](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/surveillance-grants.csv): `surveillance-grants.csv`
- [1033 equipment](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/wapo-1033-data.csv): `wapo-1033-data.csv`
- [Flight data](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/flight_paths.json): `flight_paths.json`
- [City coordinates](https://github.com/ringmast4r/surveillance-capabilities-map/blob/main/city_coords.json): `city_coords.json`

### Other components

- **Map user**

## Connections

- Map user → Web map: opens (evidence: `README.md`)
- Web map → Interactive map: provides (evidence: `README.md`)
- Web map → Technology filters: provides (evidence: `README.md`)
- Web map → Location search: provides (evidence: `README.md`)
- Web map → Data explorer: provides (evidence: `README.md`)
- Data explorer → CSV export: exports (evidence: `README.md`)
- Web map → Flight paths: visualizes (evidence: `README.md`)
- EFF Atlas data → Web map: integrated by (evidence: `README.md`)
- Federal contracts → Web map: integrated by (evidence: `README.md`)
- Federal grants → Web map: integrated by (evidence: `README.md`)
- 1033 equipment → Web map: integrated by (evidence: `README.md`)
- Flight data → Flight paths: visualized in (evidence: `README.md`)
- City coordinates → Web map: supports geocoding (evidence: `README.md`)
