# jimisha24/project-01-screen-and-scan architecture

> Architecture diagram of the GitHub repository jimisha24/project-01-screen-and-scan, 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/jimisha24/project-01-screen-and-scan
- Repository: https://github.com/jimisha24/project-01-screen-and-scan

## Overview

GlobalRadarPro is a financial and technical equity screening application. Users browse financial-ratio results, prohibited/non-compliant stocks, or institutional SMC/ICT setups; they can also request live prices and trigger or monitor technical refreshes. The Express API applies compliance screening and serves stored market data, while its refresh workflow fetches OHLC data and updates SQLite. README documents the dashboard’s sorting, search, watchlist, and CSV-export capabilities. Some route implementation is omitted, so links to technical analysis and browser behavior rely on documented capabilities where noted.

Main entry points: [`routes/apiRoutes.js`](https://github.com/jimisha24/project-01-screen-and-scan/blob/main/routes/apiRoutes.js) (API routes), [`server.js`](https://github.com/jimisha24/project-01-screen-and-scan/blob/main/server.js) (Express server), [`public/index.html`](https://github.com/jimisha24/project-01-screen-and-scan/blob/main/public/index.html) (Financial dashboard), [`public/prohibited.html`](https://github.com/jimisha24/project-01-screen-and-scan/blob/main/public/prohibited.html) (Prohibited stocks UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_dashboard["Financial dashboard<br/>[index.html]"]
  node_prohibited["Prohibited stocks UI<br/>[prohibited.html]"]
  node_technical["Technical screener UI<br/>[technical.html]"]
end

subgraph group_api["API and screening"]
  node_server["Express server<br/>[server.js]"]
  node_routes["API routes<br/>[apiRoutes.js]"]
end

subgraph group_market["Market analysis"]
  node_compliance["Compliance engine"]
  node_smc["SMC analysis<br/>[smcEngine.js]"]
  node_refresh["OHLC refresh<br/>[apiRoutes.js]"]
  node_formatters["Market formatters<br/>[formatters.js]"]
end

subgraph group_state["Market data and state"]
  node_sqlite[("Stock metrics")]
  node_yahoo["Yahoo Finance"]
  node_browserstate[("Browser watchlist")]
end

node_visitor(("Investor"))

node_visitor -->|"opens app"| node_server
node_server -->|"mounts API"| node_routes
node_server -->|"serves page"| node_dashboard
node_server -->|"serves page"| node_prohibited
node_server -->|"serves page"| node_technical
node_dashboard -.->|"requests screening"| node_routes
node_prohibited -.->|"requests exclusions"| node_routes
node_technical -.->|"requests setups"| node_routes
node_routes -->|"queries stocks"| node_sqlite
node_routes -->|"evaluates compliance"| node_compliance
node_routes -->|"formats results"| node_formatters
node_routes -.->|"evaluates setups"| node_smc
node_routes -->|"starts refresh"| node_refresh
node_refresh -.->|"fetches market data"| node_yahoo
node_refresh -->|"writes OHLC data"| node_sqlite
node_routes -->|"fetches live quote"| node_yahoo
node_dashboard -.->|"stores watchlist"| node_browserstate
node_dashboard -.->|"exports CSV"| node_routes

click node_dashboard "https://github.com/jimisha24/project-01-screen-and-scan/blob/main/public/index.html"
click node_prohibited "https://github.com/jimisha24/project-01-screen-and-scan/blob/main/public/prohibited.html"
click node_technical "https://github.com/jimisha24/project-01-screen-and-scan/blob/main/public/technical.html"
click node_server "https://github.com/jimisha24/project-01-screen-and-scan/blob/main/server.js"
click node_routes "https://github.com/jimisha24/project-01-screen-and-scan/blob/main/routes/apiRoutes.js"
click node_compliance "https://github.com/jimisha24/project-01-screen-and-scan/blob/main/services/complianceEngine.js"
click node_smc "https://github.com/jimisha24/project-01-screen-and-scan/blob/main/services/smcEngine.js"
click node_refresh "https://github.com/jimisha24/project-01-screen-and-scan/blob/main/routes/apiRoutes.js"
click node_formatters "https://github.com/jimisha24/project-01-screen-and-scan/blob/main/utils/formatters.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_dashboard,node_prohibited,node_technical toneBlue
class node_server,node_routes toneAmber
class node_compliance,node_smc,node_refresh,node_formatters toneMint
class node_sqlite,node_yahoo,node_browserstate toneRose
class node_visitor toneIndigo
```

## Components

### Web experience

- [Financial dashboard](https://github.com/jimisha24/project-01-screen-and-scan/blob/main/public/index.html): `public/index.html`
- [Prohibited stocks UI](https://github.com/jimisha24/project-01-screen-and-scan/blob/main/public/prohibited.html): `public/prohibited.html`
- [Technical screener UI](https://github.com/jimisha24/project-01-screen-and-scan/blob/main/public/technical.html): `public/technical.html`

### API and screening

- [Express server](https://github.com/jimisha24/project-01-screen-and-scan/blob/main/server.js): `server.js`
- [API routes](https://github.com/jimisha24/project-01-screen-and-scan/blob/main/routes/apiRoutes.js): `routes/apiRoutes.js`

### Market analysis

- [Compliance engine](https://github.com/jimisha24/project-01-screen-and-scan/blob/main/services/complianceEngine.js): `services/complianceEngine.js`
- [SMC analysis](https://github.com/jimisha24/project-01-screen-and-scan/blob/main/services/smcEngine.js): `services/smcEngine.js`
- [OHLC refresh](https://github.com/jimisha24/project-01-screen-and-scan/blob/main/routes/apiRoutes.js): `routes/apiRoutes.js`
- [Market formatters](https://github.com/jimisha24/project-01-screen-and-scan/blob/main/utils/formatters.js): `utils/formatters.js`

### Market data and state

- **Stock metrics**
- **Yahoo Finance**
- **Browser watchlist**

### Other components

- **Investor**

## Connections

- Investor → Express server: opens app (evidence: `server.js`)
- Express server → API routes: mounts API (evidence: `server.js`)
- Express server → Financial dashboard: serves page (evidence: `server.js`)
- Express server → Prohibited stocks UI: serves page (evidence: `server.js`)
- Express server → Technical screener UI: serves page (evidence: `server.js`)
- Financial dashboard → API routes: requests screening (evidence: `README.md`)
- Prohibited stocks UI → API routes: requests exclusions (evidence: `README.md`)
- Technical screener UI → API routes: requests setups (evidence: `README.md`)
- API routes → Stock metrics: queries stocks (evidence: `routes/apiRoutes.js`)
- API routes → Compliance engine: evaluates compliance (evidence: `routes/apiRoutes.js`)
- API routes → Market formatters: formats results (evidence: `routes/apiRoutes.js`)
- API routes → SMC analysis: evaluates setups (evidence: `routes/apiRoutes.js`)
- API routes → OHLC refresh: starts refresh (evidence: `routes/apiRoutes.js`)
- OHLC refresh → Yahoo Finance: fetches market data
- OHLC refresh → Stock metrics: writes OHLC data (evidence: `routes/apiRoutes.js`)
- API routes → Yahoo Finance: fetches live quote (evidence: `routes/apiRoutes.js`)
- Financial dashboard → Browser watchlist: stores watchlist (evidence: `README.md`)
- Financial dashboard → API routes: exports CSV (evidence: `README.md`)
