# kothakula-sagar/india-ptl-ftl-maps architecture

> Architecture diagram of the GitHub repository kothakula-sagar/india-ptl-ftl-maps, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kothakula-sagar/india-ptl-ftl-maps
- Repository: https://github.com/kothakula-sagar/india-ptl-ftl-maps

## Overview

Abra Freight Atlas is a browser-based freight advertising planner. Users search and filter curated Indian industrial areas, inspect a selected area’s freight and campaign guidance, adjust a Meta Ads pin radius, and optionally save areas for CSV export. The runtime is a small static JavaScript app: `app.js` owns the interactions and `data.js` supplies area records. The README documents these capabilities; the shown source supports the relationships below. The external map tiles and browser facilities are integrations, not repository modules.

Main entry points: [`app.js`](https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js) (Planner UI), [`data.js`](https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/data.js) (Area catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_planning["Area planning"]
  node_planner["Planner UI<br/>[app.js]"]
  node_area_data["Area catalog<br/>[data.js]"]
  node_area_filter["Search and filters<br/>[app.js]"]
  node_area_list["Location list<br/>[app.js]"]
  node_area_detail["Area guidance<br/>[app.js]"]
end

subgraph group_map["Map and targeting"]
  node_map_view["Interactive map<br/>[app.js]"]
  node_radius["Radius targeting<br/>[app.js]"]
end

subgraph group_shortlist["Saved planning"]
  node_shortlist_store[("Saved shortlist<br/>[app.js]")]
  node_radius_store[("Saved radii<br/>[app.js]")]
  node_csv_export["CSV export<br/>[app.js]"]
end

node_osm_tiles["OSM HOT tiles"]
node_user(("Planner user"))
node_browser[("Browser storage")]
node_clipboard["Clipboard"]

node_user -->|"uses"| node_planner
node_planner -->|"reads"| node_area_data
node_planner -->|"applies"| node_area_filter
node_area_filter -->|"filters for"| node_area_list
node_area_list -->|"selects"| node_area_detail
node_area_list -->|"renders markers"| node_map_view
node_area_detail -->|"configures"| node_radius
node_map_view -->|"loads tiles"| node_osm_tiles
node_planner -->|"reads and writes"| node_shortlist_store
node_planner -->|"reads and writes"| node_radius_store
node_planner -->|"uses local storage"| node_browser
node_planner -->|"exports"| node_csv_export
node_area_detail -->|"copies pin"| node_clipboard

click node_planner "https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js"
click node_area_data "https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/data.js"
click node_area_filter "https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js"
click node_area_list "https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js"
click node_area_detail "https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js"
click node_map_view "https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js"
click node_radius "https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js"
click node_shortlist_store "https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js"
click node_radius_store "https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js"
click node_csv_export "https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.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_planner,node_area_data,node_area_filter,node_area_list,node_area_detail,node_user toneBlue
class node_map_view,node_radius,node_browser toneAmber
class node_shortlist_store,node_radius_store,node_csv_export toneMint
class node_osm_tiles,node_clipboard toneIndigo
```

## Components

### Area planning

- [Planner UI](https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js): `app.js`
- [Area catalog](https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/data.js): `data.js`
- [Search and filters](https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js): `app.js`
- [Location list](https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js): `app.js`
- [Area guidance](https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js): `app.js`

### Map and targeting

- [Interactive map](https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js): `app.js`
- [Radius targeting](https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js): `app.js`

### Saved planning

- [Saved shortlist](https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js): `app.js`
- [Saved radii](https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js): `app.js`
- [CSV export](https://github.com/kothakula-sagar/india-ptl-ftl-maps/blob/main/app.js): `app.js`

### Other components

- **OSM HOT tiles**
- **Planner user**
- **Browser storage**
- **Clipboard**

## Connections

- Planner user → Planner UI: uses (evidence: `README.md`)
- Planner UI → Area catalog: reads (evidence: `app.js`)
- Planner UI → Search and filters: applies (evidence: `app.js`)
- Search and filters → Location list: filters for (evidence: `app.js`)
- Location list → Area guidance: selects (evidence: `app.js`)
- Location list → Interactive map: renders markers (evidence: `app.js`)
- Area guidance → Radius targeting: configures (evidence: `app.js`)
- Interactive map → OSM HOT tiles: loads tiles (evidence: `app.js`)
- Planner UI → Saved shortlist: reads and writes (evidence: `app.js`)
- Planner UI → Saved radii: reads and writes (evidence: `app.js`)
- Planner UI → Browser storage: uses local storage (evidence: `app.js`)
- Planner UI → CSV export: exports (evidence: `app.js`)
- Area guidance → Clipboard: copies pin (evidence: `app.js`)
