How vishnu-tppr/terax-ai works
Terax AI is documented as a cross-platform personal-safety app: a voice, gesture, or distress trigger starts emergency recording/location sharing and alerts trusted contacts. The available runtime evidence chiefly covers two backend surfaces: a Node SMS/location API and a FastAPI authentication, profile, contact, and incident API. The Flutter application source is absent from the supplied tree, so its documented capabilities are represented without invented implementation paths or backend call links; wiring between the two backends is also not established.
Main entry points: main.py FastAPI app · server.js SMS dispatch · supabase_helpers.py Supabase helpers · auth.py Authentication
Components 18
Safety app
- Flutter client
- Voice and SOS triggers
- Recording and tracking
- Background protection
Alert API
- Node API
backend/server.js - SMS dispatch
backend/server.js - Location sharing
backend/server.js - SMS history and status
backend/server.js
Account API
- FastAPI app
backend-python/app/main.py - Authentication
backend-python/app/routers/auth.py - Profiles
backend-python/app/routers/profile.py - Contacts
backend-python/app/routers/contacts.py - Incidents
backend-python/app/routers/incidents.py - Supabase helpers
backend-python/app/supabase_helpers.py
External services
- Twilio
- Supabase
Other components
- App user
- Trusted contacts
Connections 19
- App user → Flutter client: uses
- Flutter client → Voice and SOS triggers: activates
- Voice and SOS triggers → Recording and tracking: starts
- Voice and SOS triggers → Background protection: starts
- Node API → SMS dispatch: routes
- Node API → Location sharing: routes
- SMS dispatch → Twilio: sends SMS
- Location sharing → Twilio: sends SMS
- SMS dispatch → SMS history and status: writes history
- SMS history and status → SMS dispatch: serves status
- Twilio → Node API: posts webhook
- FastAPI app → Authentication: includes router
- FastAPI app → Profiles: includes router
- FastAPI app → Contacts: includes router
- FastAPI app → Incidents: includes router
- FastAPI app → Supabase helpers: checks health
- Authentication → Supabase helpers: calls helpers
- Supabase helpers → Supabase: accesses
- Recording and tracking → Trusted contacts: notifies