# shanmugaraj711-dotcom/demand_radar architecture

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

## Overview

Demand Radar is a localhost research and outreach app. A user explores a topic in Radar: suggestion collection and phrase analysis produce filtered keyword results, with optional place validation, competing-app research, and an AI brief. The user can then find or import businesses, enrich their websites, review scored leads, and manage follow-ups and funnel stages; WhatsApp is opened for manual sending. The graph preserves these documented branches. Several server routes and frontend calls were not excerpted, so server ownership links are based on the SOURCE INDEX imports; UI-to-server interaction is documented at a product level.

Main entry points: [`server.js`](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/server.js) (HTTP server), [`lib/leads.js`](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/leads.js) (Lead scoring), [`lib/suggest.js`](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/suggest.js) (Suggestion collector), [`lib/geo.js`](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/geo.js) (Place geocoder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_radar["Topic research"]
  node_ui["Radar interface<br/>[app.js]"]
  node_suggest["Suggestion collector<br/>[suggest.js]"]
  node_intent["Phrase analysis<br/>[intent.js]"]
  node_geo["Place geocoder<br/>[geo.js]"]
  node_apps["App Store research<br/>[apps.js]"]
  node_ai["AI brief<br/>[ai.js]"]
end

subgraph group_prospects["Business leads"]
  node_places["Places search<br/>[places.js]"]
  node_csv["CSV import<br/>[csv.js]"]
  node_leads["Lead scoring<br/>[leads.js]"]
  node_enrich["Website enrichment<br/>[enrich.js]"]
end

subgraph group_outreach["Follow-up workflow"]
  node_messages["Message rendering<br/>[messages.js]"]
end

subgraph group_runtime["App runtime"]
  node_server["HTTP server<br/>[server.js]"]
  node_pages["App page<br/>[index.html]"]
  node_settings["Settings<br/>[settings.js]"]
  node_jobs["Background jobs<br/>[jobs.js]"]
  node_db[("SQLite store<br/>[db.js]")]
  node_util["Shared utilities<br/>[util.js]"]
end

node_user(("Local user"))
node_searchengines{{"Suggestion services"}}
node_nominatim{{"OpenStreetMap Nominatim"}}
node_itunes{{"Apple App Store"}}
node_googleplaces{{"Google Places API"}}
node_businesssites{{"Business websites"}}
node_anthropic{{"Anthropic API"}}
node_whatsapp{{"WhatsApp"}}

node_user -->|"uses"| node_ui
node_ui -->|"displays"| node_pages
node_ui -.->|"requests results"| node_server
node_server -->|"dispatches"| node_suggest
node_server -->|"uses"| node_intent
node_server -->|"uses"| node_geo
node_server -->|"queries"| node_apps
node_server -->|"requests brief"| node_ai
node_server -->|"searches businesses"| node_places
node_server -->|"imports leads"| node_csv
node_server -->|"manages leads"| node_leads
node_server -->|"checks websites"| node_enrich
node_server -->|"renders follow-ups"| node_messages
node_server -->|"loads settings"| node_settings
node_server -->|"uses jobs"| node_jobs
node_server -->|"reads and writes"| node_db
node_suggest -->|"fetches suggestions"| node_searchengines
node_suggest -->|"classifies phrases"| node_intent
node_suggest -->|"uses helpers"| node_util
node_geo -->|"geocodes places"| node_nominatim
node_geo -->|"caches results"| node_db
node_geo -->|"uses helpers"| node_util
node_apps -->|"searches apps"| node_itunes
node_places -->|"searches businesses"| node_googleplaces
node_enrich -->|"reads websites"| node_businesssites
node_ai -.->|"generates brief"| node_anthropic
node_leads -->|"stores lead data"| node_db
node_leads -->|"uses helpers"| node_util
node_messages -->|"uses cadence"| node_leads
node_settings -->|"stores preferences"| node_db
node_server -->|"applies enrichment"| node_leads
node_server -->|"opens message link"| node_whatsapp

click node_ui "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/public/app.js"
click node_server "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/server.js"
click node_pages "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/public/index.html"
click node_suggest "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/suggest.js"
click node_intent "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/intent.js"
click node_geo "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/geo.js"
click node_apps "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/apps.js"
click node_ai "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/ai.js"
click node_places "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/places.js"
click node_csv "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/csv.js"
click node_leads "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/leads.js"
click node_enrich "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/enrich.js"
click node_messages "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/messages.js"
click node_settings "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/settings.js"
click node_jobs "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/jobs.js"
click node_db "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/db.js"
click node_util "https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/util.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_ui,node_suggest,node_intent,node_geo,node_apps,node_ai,node_user toneBlue
class node_places,node_csv,node_leads,node_enrich toneAmber
class node_messages,node_googleplaces,node_anthropic toneMint
class node_server,node_pages,node_settings,node_jobs,node_db,node_util toneRose
class node_searchengines,node_nominatim,node_itunes,node_businesssites,node_whatsapp toneIndigo
```

## Components

### Topic research

- [Radar interface](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/public/app.js): `public/app.js`
- [Suggestion collector](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/suggest.js): `lib/suggest.js`
- [Phrase analysis](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/intent.js): `lib/intent.js`
- [Place geocoder](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/geo.js): `lib/geo.js`
- [App Store research](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/apps.js): `lib/apps.js`
- [AI brief](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/ai.js): `lib/ai.js`

### Business leads

- [Places search](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/places.js): `lib/places.js`
- [CSV import](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/csv.js): `lib/csv.js`
- [Lead scoring](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/leads.js): `lib/leads.js`
- [Website enrichment](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/enrich.js): `lib/enrich.js`

### Follow-up workflow

- [Message rendering](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/messages.js): `lib/messages.js`

### App runtime

- [HTTP server](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/server.js): `server.js`
- [App page](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/public/index.html): `public/index.html`
- [Settings](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/settings.js): `lib/settings.js`
- [Background jobs](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/jobs.js): `lib/jobs.js`
- [SQLite store](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/db.js): `lib/db.js`
- [Shared utilities](https://github.com/shanmugaraj711-dotcom/demand_radar/blob/main/lib/util.js): `lib/util.js`

### Other components

- **Local user**
- **Suggestion services**
- **OpenStreetMap Nominatim**
- **Apple App Store**
- **Google Places API**
- **Business websites**
- **Anthropic API**
- **WhatsApp**

## Connections

- Local user → Radar interface: uses (evidence: `README.md`)
- Radar interface → App page: displays (evidence: `README.md`)
- Radar interface → HTTP server: requests results
- HTTP server → Suggestion collector: dispatches (evidence: `server.js`)
- HTTP server → Phrase analysis: uses (evidence: `server.js`)
- HTTP server → Place geocoder: uses (evidence: `server.js`)
- HTTP server → App Store research: queries (evidence: `server.js`)
- HTTP server → AI brief: requests brief (evidence: `server.js`)
- HTTP server → Places search: searches businesses (evidence: `server.js`)
- HTTP server → CSV import: imports leads (evidence: `server.js`)
- HTTP server → Lead scoring: manages leads (evidence: `server.js`)
- HTTP server → Website enrichment: checks websites (evidence: `server.js`)
- HTTP server → Message rendering: renders follow-ups (evidence: `server.js`)
- HTTP server → Settings: loads settings (evidence: `server.js`)
- HTTP server → Background jobs: uses jobs (evidence: `server.js`)
- HTTP server → SQLite store: reads and writes (evidence: `server.js`)
- Suggestion collector → Suggestion services: fetches suggestions (evidence: `lib/suggest.js`)
- Suggestion collector → Phrase analysis: classifies phrases (evidence: `lib/suggest.js`)
- Suggestion collector → Shared utilities: uses helpers (evidence: `lib/suggest.js`)
- Place geocoder → OpenStreetMap Nominatim: geocodes places (evidence: `lib/geo.js`)
- Place geocoder → SQLite store: caches results (evidence: `lib/geo.js`)
- Place geocoder → Shared utilities: uses helpers (evidence: `lib/geo.js`)
- App Store research → Apple App Store: searches apps (evidence: `lib/apps.js`)
- Places search → Google Places API: searches businesses (evidence: `lib/places.js`)
- Website enrichment → Business websites: reads websites (evidence: `lib/enrich.js`)
- AI brief → Anthropic API: generates brief (evidence: `README.md`)
- Lead scoring → SQLite store: stores lead data (evidence: `lib/leads.js`)
- Lead scoring → Shared utilities: uses helpers (evidence: `lib/leads.js`)
- Message rendering → Lead scoring: uses cadence (evidence: `lib/messages.js`)
- Settings → SQLite store: stores preferences (evidence: `lib/settings.js`)
- HTTP server → Lead scoring: applies enrichment (evidence: `server.js`)
- HTTP server → WhatsApp: opens message link (evidence: `README.md`)
