Hosts the React staff dashboard. Static site deployment. Auto-deploys on GitHub push.
Static Site
app.paws-alert.com
๐พ
Core System
PAWS Alert
Emergency Notification System Pellissippi State Community College
โ๏ธ
Backend Hosting
Render
Hosts the FastAPI Python backend. Web service with auto-deploy. Runs the SMS webhook, API, and alert scheduler.
Web Service
staffalert.onrender.com
๐
Landing Page
Netlify
Hosts paws-alert.com consent/landing page. Also manages DNS for all subdomains including app.paws-alert.com CNAME.
DNS + Hosting
paws-alert.com
๐ป
Version Control
GitHub
Two repos โ frontend and backend. Push to main triggers auto-deploy on Render. Netlify also pulls from GitHub.
2 Repositories
๐ค
AI Engine
Claude API
Powers the SMS staff conversation flow. Staff texts the number, Claude guides them through sending alerts, getting join codes, and checking stats.
claude-sonnet
api.anthropic.com
Data Flow Explained
FLOW 01
Student SMS Enrollment
Student texts JOIN CS101 XK9P2M โ Twilio receives it โ fires webhook to Render backend โ backend validates join code against Neon DB โ enrolls student โ Twilio sends confirmation back to student's phone
FLOW 02
Staff Dashboard Alert
Staff logs into app.paws-alert.com (Render frontend) โ selects section + message โ React calls Render backend API โ backend queries Neon for recipients โ loops through Twilio to send SMS to every enrolled student โ logs delivery receipts back to Neon
FLOW 03
Staff SMS Interaction
Staff texts any message โ Twilio webhook โ backend checks if number is registered staff in Neon โ if yes, Claude API guides conversation โ staff picks section + priority + message โ backend fires broadcast via Twilio โ result texted back to staff
FLOW 04
Deploy Pipeline
Code pushed to GitHub โ Render auto-detects push โ builds and deploys backend (FastAPI) and frontend (React/Vite) โ Netlify auto-deploys consent page from its own GitHub repo โ live within ~2 minutes
FLOW 05
DNS Resolution
paws-alert.com bought on Namecheap โ nameservers pointed to Netlify โ Netlify manages all DNS records โ paws-alert.com serves consent page โ app.paws-alert.com CNAME points to Render frontend โ api subdomain points to Render backend
FLOW 06
Scheduled Alerts
Staff schedules alert via dashboard โ stored in Neon with UTC timestamp โ APScheduler on Render backend checks every 60 seconds โ when time is due fires broadcast via Twilio โ updates status in Neon โ logs delivery receipts
๐ข
7
SERVICES
๐
2
DEPLOYMENTS
๐ฆ
2
GITHUB REPOS
๐๏ธ
1
DATABASE
๐ฑ
1
SMS PROVIDER
PAWS ALERT ยท PELLISSIPPI STATE COMMUNITY COLLEGE ยท ENS v2.0