GenialSmileAdam/SafeSpace

SafeSpace is a Campus Wide Wellness monitoring System for the Nile university of Nigeria Buildathon 2026 hosted by Collective Lab x GDG # Crisis Awareness Booking Management System **SafeSpace – Psychology Unit Management Platform** Nile University of Nigeria Buildathon 2026 --- ## Overview A full-stack web platform for the university Psychology Unit that replaces manual, paper-based counselling administration with a digital system. Students complete evidence-based wellness self-assessments (PHQ-9, GAD-7, Pulse), book counselling sessions with crisis-priority flagging, and track their progress over time. Counsellors view real-time risk scores, manage appointments, and access full student profiles with WRS trend charts. Admins oversee the entire system with deployment KPIs. **Live Frontend:** crisis-awareness-booking-system.vercel.app --- ## Problem Solved The Psychology Unit operated with no digital system — scheduling was manual, session notes were disconnected, crisis cases had no priority pathway, and counsellors spent most of their time on admin instead of student care. This platform automates that workflow end-to-end. --- ## Tech Stack | Layer | Technology | |---|---| | Frontend | React 18 + TypeScript + Vite | | Styling | Tailwind CSS + shadcn/ui (Radix UI) | | Charts | Recharts | | Routing | React Router v6 | | Backend | Python 3.12 + FastAPI (async) | | ORM | SQLAlchemy 2.0 (async) | | Database | PostgreSQL via Supabase | | Migrations | Alembic | | Auth | JWT (access) + HTTP-only refresh cookie | | Rate Limiting | SlowAPI | | AI / Insights | Groq API (optional) | | Notifications | Resend (email, optional) | | Hosting | Railway (backend) + Vercel (frontend) | --- ## Project Structure ``` / ├── frontend/ # React + Vite SPA │ ├── src/ │ │ ├── api/ # API client functions (per resource) │ │ ├── components/ # Reusable UI components │ │ │ ├── AppSidebar.tsx │ │ │ ├── CrisisBanner.tsx │ │ │ ├── FeedbackButton.tsx │ │ │ └── OnboardingSlides.tsx │ │ ├── context/ # AuthContext, WrsContext │ │ ├── pag …