โ† Back to paws-alert.com
System Architecture

PAWS Alert Infrastructure

Complete service map ยท All connected systems ยท Live deployment
๐ŸŒ
Domain Registrar
Namecheap
paws-alert.com purchased here. Nameservers pointed to Netlify DNS for full DNS control.
paws-alert.com
๐Ÿ“ฑ
SMS Carrier
Twilio
Toll-free number (865) 381-3222. Handles all inbound/outbound SMS. Webhook fires to backend on every text.
โณ Verification Pending
+18653813222
๐Ÿ—„๏ธ
Database
Neon PostgreSQL
Serverless Postgres. Stores staff, sections, students, alert logs, delivery receipts, SMS sessions, join codes.
neon.tech
ep-curly-cake-...neon.tech
๐Ÿ–ฅ๏ธ
Frontend Hosting
Render
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