iNewsAfrica1001/PoliSmart

PoliSmart Africa AI Repository # PoliSmart Africa AI Production operators should begin with the PoliSmart Africa AI V1 Administrator Guide. PoliSmart Africa AI is an AI-powered political campaign intelligence and management platform designed for African political and governance environments and operated by SentinelAI LLC. The Version 1 application includes a strict TypeScript React client, responsive authenticated workspace, public onboarding and legal pages, and server-side campaign operations, intelligence, and governance services. The server includes PostgreSQL-backed authentication, tenant RBAC, campaigns, leadership, initiatives, activities, dependent tasks, events, volunteers, assignments, participation, configurable geographic hierarchies, approved aggregate Afrobarometer intelligence, and an evidence-grounded AI Assistant. Production runs through the documented Vercel, Neon, Microsoft Graph, OpenAI, and private object-storage architecture. ## Technology - React 19 and Vite 7 - Strict TypeScript - ESLint and Prettier - Existing Express, Prisma, Socket.IO, PWA, and Capacitor infrastructure retained for incremental migration ## Local installation Requirements: current Node.js LTS and npm 10 or newer. ```bash npm install npm run dev ``` Open `127.0.0.1`. The API listens on `127.0.0.1`. Optionally copy `.env.example` to `.env`. All example values are local placeholders. Never add real credentials to source control. The login screen uses the server authentication API. A PostgreSQL database and migrated account are required. ## Database Set `DATABASE_URL` and `SESSION_SECRET` in `.env`, then run: ```bash npm run db:generate npm run db:migrate npm run db:seed ``` The seed creates fictional data only: **Sentinel Demo Campaign**, country **Kisiwa**, and a campaign explicitly marked `[DEMO]`. The `.example.invalid` account is not deliverable and its password must never be reused outside local demonstration. New tenant tables use UUID primary keys, foreign keys …