How ankit-basu/sheshield works
SheShield is a campus-safety product with web and React Native clients backed by PHP APIs and MySQL. Its main user journey spans sign-in, incident reporting and follow-up, SOS, campus safety mapping, safe spaces, and companion-walk requests; administrators review incidents and verify or assign walkers. The graph groups features by domain and includes authentication, persistence, and email as internal layers. Some endpoint implementations and mobile screens were not sampled, so those feature connections rely on README documentation rather than inferred call chains.
Main entry points: index.tsx Mobile app · session_bootstrap.php Session and tokens · firebase-login.php Authentication API · create.php Incident reporting
Components 25
User applications
- Web experience
views/pages/_layout.php - Mobile app
mobile/src/app/(tabs)/index.tsx - Mobile sign-in
mobile/src/components/AuthForm.tsx - Web navigation
views/pages/sidebar.php - Mobile text UI
mobile/src/components/Text.tsx
Identity and profiles
- Authentication API
api/auth/firebase-login.php - User accounts
app/models/User.php - Session and tokens
app/middleware/session_bootstrap.php - Profile management
api/user/update_profile.php
Incident response
- Admin console
admin/index.php - Incident reporting
api/incidents/create.php - Incident records
app/models/Incident.php - Incident administration
admin/view_incident.php
Campus safety
- Emergency SOS
api/emergency/alert.php - Campus safety map
mobile/src/app/(tabs)/map.tsx - Safe spaces
api/safespaces/save_zone.php
Walk companion
- Walk requests
api/walks/create_request.php - Walker verification
api/walks/admin_action.php - Walk email notices
api/walks/send_walk_email.php
Shared platform
- Email delivery
app/helpers/mailer.php - PHPMailer transport
app/lib/PHPMailer/PHPMailer.php - PDO database
app/config/database.php - MySQLi database
database/mysqli_db.php - Database adapter
app/models/mysqli_db.php
Other components
- Campus user
Connections 29
- Campus user → Web experience: uses
- Campus user → Mobile app: uses
- Web experience → Web navigation: renders
views/pages/_layout.php - Mobile sign-in → Authentication API: signs in
- Mobile app → Authentication API: uses API
- Mobile app → Incident reporting: submits reports
- Mobile app → Walk requests: requests walks
- Mobile app → Emergency SOS: sends alerts
- Authentication API → User accounts: authenticates
api/auth/firebase-login.php - Authentication API → Session and tokens: issues tokens
api/auth/firebase-login.php - Session and tokens → PDO database: reads tokens
app/middleware/session_bootstrap.php - Profile management → Session and tokens: requires identity
- Incident reporting → Session and tokens: starts session
api/incidents/create.php - Incident reporting → Incident records: creates report
api/incidents/create.php - Incident records → PDO database: stores incidents
- Admin console → Incident administration: opens details
admin/index.php - Admin console → Incident records: loads incidents
admin/index.php - Admin console → Incident reporting: updates status
admin/index.php - Campus user → Emergency SOS: requests help
- Campus user → Campus safety map: views campus
- Campus user → Safe spaces: marks zones
- Walk requests → Session and tokens: checks identity
- Walker verification → Walk requests: assigns walkers
- Walk requests → Walk email notices: sends confirmation
api/walks/send_walk_email.php - Walk email notices → Email delivery: sends mail
api/walks/send_walk_email.php - Email delivery → PHPMailer transport: uses SMTP
app/helpers/mailer.php - Database adapter → MySQLi database: gets connection
app/models/mysqli_db.php - MySQLi database → PDO database: loads schema config
- Web experience → Mobile text UI: shares UI patterns