gigachad8909-dotcom/watchman-ng

Security Intelligence Platform for Nigeria - Real-time tactical mapping, AI-powered incident analysis, route safety, and threat intelligence # Watchman NG — Security Intelligence Platform Real-time AI-powered security intelligence for Nigeria. Tactical map, live incident feed, daily AI briefs, proximity alerts, PDF export, and user reporting. --- ## Quick Start (One Command) ### Prerequisites - Node.js 20+ - PostgreSQL 16 (via Homebrew: `brew install postgresql@16`) - An OpenAI API key ### 1. Clone & Install ```bash git clone cd Watchman-ng npm install ``` ### 2. Configure Environment ```bash cd backend cp .env.example .env ``` Edit `backend/.env`: ``` DATABASE_URL=postgresql://yourusername@localhost:5432/Watchman_ng OPENAI_API_KEY=sk-your-key-here OPENAI_BASE_URL=api.openai.com OPENAI_MODEL=gpt-4o-mini ``` ### 3. Setup Database ```bash brew services start postgresql@16 createdb Watchman_ng npm run db:migrate ``` ### 4. Start Everything ```bash npm run dev ``` That's it. One command starts both backend + frontend: - **Frontend** → localhost - **Backend** → localhost The scraper begins pulling from 170+ Nigerian news sources immediately. Incidents appear on the map within minutes. --- ## Stack | Layer | Tech | |-------|------| | Frontend | React 18 · TypeScript · Vite · Tailwind · Leaflet · Zustand · Socket.io | | Backend | Node.js · Express · TypeScript · PostgreSQL · Socket.io | | AI | OpenAI GPT-4o-mini (incident extraction + classification) | | Geocoding | Nominatim (OpenStreetMap) — free, no API key needed | | Infrastructure | Single `npm run dev` command | --- ## Features - **Tactical Map** — Clustered incident markers with drill-down from state → district → street level. Smooth Google Earth-style zoom with no white flash. Home button to reset view. - **Live Intel Feed** — 170+ Nigerian RSS sources, AI-extracted, deduplicated, color-coded by incident type. Wide panel with time/state filters. - **Daily Intelligence Brief** — Full detailed brief with date navigation (Today / Yesterday / custom), threat level, key developments with actual …