How b-acharekar/phone-tracker-backend works
This Flask backend serves two Phone Tracker Android variants, identifying installations by Android device ID and routing each variant to an isolated Firebase service. The main workflow registers an installation, authenticates REST and Socket.IO activity, and supports friend connections, groups, profiles, feedback, and location sharing. Live location telemetry is delivered over Socket.IO while Firestore receives throttled snapshots; profile avatars use Firebase Storage. The graph reflects README capabilities even where route source was not sampled; those unsampled links are omitted or marked unverified.
Main entry points: __init__.py App factory · auth.py Device authentication · friends.py Friend requests · profile.py Profile APIs
Components 16
Application entry
- Flask app
app.py - App factory
phone_tracker_backend/__init__.py
Identity and services
- Runtime settings
phone_tracker_backend/config.py - Firebase registry
phone_tracker_backend/services/firebase_service.py - Firestore
- Firebase Storage
- Device authentication
phone_tracker_backend/auth.py - Installation registration
phone_tracker_backend/routes/installations.py
Connections and groups
- Friend requests
phone_tracker_backend/routes/friends.py - Group management
phone_tracker_backend/routes/groups.py
Location sharing
- Sharing preferences
phone_tracker_backend/routes/sharing.py - Socket location channel
phone_tracker_backend/realtime.py
Profiles and feedback
- Profile APIs
phone_tracker_backend/routes/profile.py - Profile formatting
phone_tracker_backend/profile_utils.py - Feedback API
phone_tracker_backend/routes/feedback.py
Other components
- Android clients
Connections 34
- Android clients → Flask app: starts requests
README.md - Flask app → App factory: creates app
app.py - App factory → Runtime settings: loads settings
phone_tracker_backend/__init__.py - App factory → Firebase registry: registers service
phone_tracker_backend/__init__.py - App factory → Installation registration: registers routes
phone_tracker_backend/__init__.py - App factory → Friend requests: registers routes
phone_tracker_backend/__init__.py - App factory → Group management: registers routes
phone_tracker_backend/__init__.py - App factory → Profile APIs: registers routes
phone_tracker_backend/__init__.py - App factory → Sharing preferences: registers routes
phone_tracker_backend/__init__.py - App factory → Feedback API: registers routes
phone_tracker_backend/__init__.py - App factory → Socket location channel: registers channel
phone_tracker_backend/__init__.py - Installation registration → Firebase registry: selects service
phone_tracker_backend/routes/installations.py - Firebase registry → Firestore: creates clients
phone_tracker_backend/services/firebase_service.py - Device authentication → Firebase registry: selects service
phone_tracker_backend/auth.py - Friend requests → Device authentication: requires device
phone_tracker_backend/routes/friends.py - Group management → Device authentication: requires device
phone_tracker_backend/routes/groups.py - Profile APIs → Device authentication: requires device
phone_tracker_backend/routes/profile.py - Sharing preferences → Device authentication: requires device
phone_tracker_backend/routes/sharing.py - Feedback API → Device authentication: requires device
phone_tracker_backend/routes/feedback.py - Friend requests → Socket location channel: updates sessions
phone_tracker_backend/routes/friends.py - Socket location channel → Profile formatting: formats profiles
phone_tracker_backend/realtime.py - Friend requests → Profile formatting: formats profiles
phone_tracker_backend/routes/friends.py - Group management → Profile formatting: formats profiles
phone_tracker_backend/routes/groups.py - Profile APIs → Profile formatting: formats profiles
phone_tracker_backend/routes/profile.py - Installation registration → Profile formatting: formats profiles
phone_tracker_backend/routes/installations.py - Installation registration → Firestore: writes installation
- Friend requests → Firestore: reads and writes
phone_tracker_backend/routes/friends.py - Group management → Firestore: reads and writes
phone_tracker_backend/routes/groups.py - Feedback API → Firestore: stores feedback
phone_tracker_backend/routes/feedback.py - Socket location channel → Firestore: stores snapshots
phone_tracker_backend/realtime.py - Socket location channel → Android clients: emits locations
README.md - Profile APIs → Firebase Storage: uploads avatar
phone_tracker_backend/routes/profile.py - Profile APIs → Firestore: saves avatar URL
phone_tracker_backend/routes/profile.py - Sharing preferences → Firestore: updates preferences