Bayurzx/ravencry

RAVENCRY is a real-time alert system designed to help communities respond more quickly to kidnapping incidents in Nigeria. People can submit reports through WhatsApp, USSD feature phones, or a progressive web app, allowing the platform to work across both smartphones and basic mobile devices. # RAVENCRY **Real-time AI for Vigilance, Event Notification, and Crisis Response Yielding.** A Nigeria-native, multi-channel, AI-powered anti-kidnapping and missing persons rapid alert platform. Citizens report via WhatsApp, USSD (`*384*72836#`), Telegram, SMS, or PWA. Qwen AI triages in Hausa, Yoruba, Igbo, Pidgin, and English. Crucix sweeps OSINT sources. FLASH alerts broadcast via SMS, Telegram, and push to subscribers within 160km. > **Hackathon:** Qwen Cloud Hackathon · June 2026 > > **PWA:** ravencry-web.vercel.app --- ## Architecture **Full context:** diag_architect.md — service inventory, data flows, endpoints, DNS routing, architectural decisions, and judge-facing diagram checklist. **Data model ERD:** docs/data-model.mermaid (render with mermaid.live or `npx mmdc`) **Feature map:** features.md — hackathon → scale roadmap. **Build log:** hackathon_context.md — key decisions, debugging discoveries, and architectural rationale. --- ## Quick Start — Docker ```bash # 1. Clone + env git clone github.com && cd ravencry cp .env.example .env # Fill in .env — see "Secrets" section below # 2. Start local Postgres (dev DB) docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d dev-postgres # Run migrations + seed: see steps3_db_docker.md (3 min) # 3. Start the stack docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d docker compose ps # all services healthy ``` **Full dev DB guide:** steps3_db_docker.md ## Quick Start — Node (no Docker) ```bash # Each service runs independently: cd services/api && npm install && npm run dev # :3003 cd services/llm && npm install && npm run dev # :3002 cd services/crucix && npm install && npm run dev # :3001 cd services/telegram && npm install && npm run dev # :3005 cd services/sms && npm install && npm run dev # :3006 cd services/ussd && npm install && npm run dev # :3007 ``` Requires PostgreSQL 16 with PostGIS on `localhost:5 …