How dr-skaragiannis/nex works
NEX is an exposure-intelligence product: users review assets, findings, and scan history, configure provider credentials, and submit OSINT searches that discover exposed services and persist scan results. The combined deployment serves the dashboard and API from Next.js, with PostgreSQL/Drizzle storage; an optional proxy mode delegates API requests to the preserved FastAPI/SQLite backend. The map emphasizes integrated runtime paths and documented legacy capabilities; some unsampled provider and page internals are represented by their source directories.
Main entry points: repository.ts Inventory repository · route.ts NEX API routes · App.tsx Dashboard router · scan.ts Live scan engine
Components 20
Dashboard
- Next.js pages
src/app/page.tsx - Dashboard router
src/dashboard/App.tsx - Exposure views
src/dashboard/pages - Provider settings
src/dashboard/pages/Settings.tsx - Dashboard API client
src/dashboard/lib/api.ts
Integrated API
- NEX API routes
src/app/api/nex/[...path]/route.ts - Live scan engine
src/server/scan.ts - OSINT providers
src/server/scan.ts
Data and risk
- Risk estimation
src/server/risk.ts - Inventory repository
src/server/repository.ts - PostgreSQL database
src/db/index.ts - Data schema
src/db/schema.ts - Initial snapshot
src/server/initial.ts
Optional FastAPI
- FastAPI service
cyber-exposure-backend/src/main.py - Assets, scans, findings
cyber-exposure-backend/src/routers - SQLite database
cyber-exposure-backend/src/database.py - OSINT adapters
cyber-exposure-backend/src/services - Proxy rotation
cyber-exposure-backend/src/services/proxy_manager.py
Other components
- Operator
- OSINT services
Connections 24
- Operator → Next.js pages: opens dashboard
README.md - Next.js pages → Dashboard router: renders
src/app/page.tsx - Dashboard router → Exposure views: routes to
src/dashboard/App.tsx - Dashboard router → Provider settings: routes to
src/dashboard/App.tsx - Exposure views → Dashboard API client: requests data
README.md - Provider settings → Dashboard API client: tests credentials
README.md - Dashboard API client → NEX API routes: calls same-origin API
README.md - NEX API routes → Live scan engine: runs scans
src/app/api/nex/[...path]/route.ts - NEX API routes → Inventory repository: reads and updates
src/app/api/nex/[...path]/route.ts - NEX API routes → Risk estimation: estimates risk
src/app/api/nex/[...path]/route.ts - Live scan engine → Inventory repository: persists scan results
src/server/scan.ts - Live scan engine → OSINT providers: searches providers
src/server/scan.ts - OSINT providers → OSINT services: queries OSINT
README.md - Inventory repository → PostgreSQL database: reads and writes
src/server/repository.ts - Inventory repository → Data schema: uses tables
src/server/repository.ts - Inventory repository → Risk estimation: calculates scores
src/server/repository.ts - Initial snapshot → Inventory repository: seeds inventory
src/server/initial.ts - NEX API routes → FastAPI service: optionally proxies
README.md - FastAPI service → Assets, scans, findings: registers routes
cyber-exposure-backend/src/main.py - FastAPI service → SQLite database: initializes and queries
cyber-exposure-backend/src/main.py - Assets, scans, findings → SQLite database: uses database
cyber-exposure-backend/src/routers/assets.py - Assets, scans, findings → OSINT adapters: uses scan services
README.md - OSINT adapters → OSINT services: searches providers
README.md - OSINT adapters → Proxy rotation: may route requests
cyber-exposure-backend/src/services/shodan_client.py