# b-acharekar/phone-tracker-backend architecture

> Architecture diagram of the GitHub repository b-acharekar/phone-tracker-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/b-acharekar/phone-tracker-backend
- Repository: https://github.com/b-acharekar/phone-tracker-backend

## Overview

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: [`phone_tracker_backend/__init__.py`](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/__init__.py) (App factory), [`phone_tracker_backend/auth.py`](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/auth.py) (Device authentication), [`phone_tracker_backend/routes/friends.py`](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/routes/friends.py) (Friend requests), [`phone_tracker_backend/routes/profile.py`](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/routes/profile.py) (Profile APIs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_app["Flask app<br/>[app.py]"]
  node_factory["App factory<br/>[__init__.py]"]
end

subgraph group_identity["Identity and services"]
  node_config["Runtime settings<br/>[config.py]"]
  node_registry["Firebase registry"]
  node_firestore[("Firestore")]
  node_storage[("Firebase Storage")]
  node_auth["Device authentication<br/>[auth.py]"]
  node_installations["Installation registration<br/>[installations.py]"]
end

subgraph group_social["Connections and groups"]
  node_friends["Friend requests<br/>[friends.py]"]
  node_groups["Group management<br/>[groups.py]"]
end

subgraph group_location["Location sharing"]
  node_sharing["Sharing preferences<br/>[sharing.py]"]
  node_realtime["Socket location channel<br/>[realtime.py]"]
end

subgraph group_account["Profiles and feedback"]
  node_profiles["Profile APIs<br/>[profile.py]"]
  node_profile_utils["Profile formatting<br/>[profile_utils.py]"]
  node_feedback["Feedback API<br/>[feedback.py]"]
end

node_android(("Android clients"))

node_android -.->|"starts requests"| node_app
node_app -->|"creates app"| node_factory
node_factory -->|"loads settings"| node_config
node_factory -->|"registers service"| node_registry
node_factory -->|"registers routes"| node_installations
node_factory -->|"registers routes"| node_friends
node_factory -->|"registers routes"| node_groups
node_factory -->|"registers routes"| node_profiles
node_factory -->|"registers routes"| node_sharing
node_factory -->|"registers routes"| node_feedback
node_factory -->|"registers channel"| node_realtime
node_installations -->|"selects service"| node_registry
node_registry -->|"creates clients"| node_firestore
node_auth -->|"selects service"| node_registry
node_friends -->|"requires device"| node_auth
node_groups -->|"requires device"| node_auth
node_profiles -->|"requires device"| node_auth
node_sharing -->|"requires device"| node_auth
node_feedback -->|"requires device"| node_auth
node_friends -->|"updates sessions"| node_realtime
node_realtime -->|"formats profiles"| node_profile_utils
node_friends -->|"formats profiles"| node_profile_utils
node_groups -->|"formats profiles"| node_profile_utils
node_profiles -->|"formats profiles"| node_profile_utils
node_installations -->|"formats profiles"| node_profile_utils
node_installations -->|"writes installation"| node_firestore
node_friends -->|"reads and writes"| node_firestore
node_groups -->|"reads and writes"| node_firestore
node_feedback -->|"stores feedback"| node_firestore
node_realtime -->|"stores snapshots"| node_firestore
node_realtime -.->|"emits locations"| node_android
node_profiles -->|"uploads avatar"| node_storage
node_profiles -->|"saves avatar URL"| node_firestore
node_sharing -.->|"updates preferences"| node_firestore

click node_app "https://github.com/b-acharekar/phone-tracker-backend/blob/main/app.py"
click node_factory "https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/__init__.py"
click node_config "https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/config.py"
click node_registry "https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/services/firebase_service.py"
click node_auth "https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/auth.py"
click node_installations "https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/routes/installations.py"
click node_friends "https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/routes/friends.py"
click node_groups "https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/routes/groups.py"
click node_sharing "https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/routes/sharing.py"
click node_realtime "https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/realtime.py"
click node_profiles "https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/routes/profile.py"
click node_profile_utils "https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/profile_utils.py"
click node_feedback "https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/routes/feedback.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_factory,node_android toneBlue
class node_config,node_registry,node_firestore,node_storage,node_auth,node_installations toneAmber
class node_friends,node_groups toneMint
class node_sharing,node_realtime toneRose
class node_profiles,node_profile_utils,node_feedback toneIndigo
```

## Components

### Application entry

- [Flask app](https://github.com/b-acharekar/phone-tracker-backend/blob/main/app.py): `app.py`
- [App factory](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/__init__.py): `phone_tracker_backend/__init__.py`

### Identity and services

- [Runtime settings](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/config.py): `phone_tracker_backend/config.py`
- [Firebase registry](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/services/firebase_service.py): `phone_tracker_backend/services/firebase_service.py`
- **Firestore**
- **Firebase Storage**
- [Device authentication](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/auth.py): `phone_tracker_backend/auth.py`
- [Installation registration](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/routes/installations.py): `phone_tracker_backend/routes/installations.py`

### Connections and groups

- [Friend requests](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/routes/friends.py): `phone_tracker_backend/routes/friends.py`
- [Group management](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/routes/groups.py): `phone_tracker_backend/routes/groups.py`

### Location sharing

- [Sharing preferences](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/routes/sharing.py): `phone_tracker_backend/routes/sharing.py`
- [Socket location channel](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/realtime.py): `phone_tracker_backend/realtime.py`

### Profiles and feedback

- [Profile APIs](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/routes/profile.py): `phone_tracker_backend/routes/profile.py`
- [Profile formatting](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/profile_utils.py): `phone_tracker_backend/profile_utils.py`
- [Feedback API](https://github.com/b-acharekar/phone-tracker-backend/blob/main/phone_tracker_backend/routes/feedback.py): `phone_tracker_backend/routes/feedback.py`

### Other components

- **Android clients**

## Connections

- Android clients → Flask app: starts requests (evidence: `README.md`)
- Flask app → App factory: creates app (evidence: `app.py`)
- App factory → Runtime settings: loads settings (evidence: `phone_tracker_backend/__init__.py`)
- App factory → Firebase registry: registers service (evidence: `phone_tracker_backend/__init__.py`)
- App factory → Installation registration: registers routes (evidence: `phone_tracker_backend/__init__.py`)
- App factory → Friend requests: registers routes (evidence: `phone_tracker_backend/__init__.py`)
- App factory → Group management: registers routes (evidence: `phone_tracker_backend/__init__.py`)
- App factory → Profile APIs: registers routes (evidence: `phone_tracker_backend/__init__.py`)
- App factory → Sharing preferences: registers routes (evidence: `phone_tracker_backend/__init__.py`)
- App factory → Feedback API: registers routes (evidence: `phone_tracker_backend/__init__.py`)
- App factory → Socket location channel: registers channel (evidence: `phone_tracker_backend/__init__.py`)
- Installation registration → Firebase registry: selects service (evidence: `phone_tracker_backend/routes/installations.py`)
- Firebase registry → Firestore: creates clients (evidence: `phone_tracker_backend/services/firebase_service.py`)
- Device authentication → Firebase registry: selects service (evidence: `phone_tracker_backend/auth.py`)
- Friend requests → Device authentication: requires device (evidence: `phone_tracker_backend/routes/friends.py`)
- Group management → Device authentication: requires device (evidence: `phone_tracker_backend/routes/groups.py`)
- Profile APIs → Device authentication: requires device (evidence: `phone_tracker_backend/routes/profile.py`)
- Sharing preferences → Device authentication: requires device (evidence: `phone_tracker_backend/routes/sharing.py`)
- Feedback API → Device authentication: requires device (evidence: `phone_tracker_backend/routes/feedback.py`)
- Friend requests → Socket location channel: updates sessions (evidence: `phone_tracker_backend/routes/friends.py`)
- Socket location channel → Profile formatting: formats profiles (evidence: `phone_tracker_backend/realtime.py`)
- Friend requests → Profile formatting: formats profiles (evidence: `phone_tracker_backend/routes/friends.py`)
- Group management → Profile formatting: formats profiles (evidence: `phone_tracker_backend/routes/groups.py`)
- Profile APIs → Profile formatting: formats profiles (evidence: `phone_tracker_backend/routes/profile.py`)
- Installation registration → Profile formatting: formats profiles (evidence: `phone_tracker_backend/routes/installations.py`)
- Installation registration → Firestore: writes installation
- Friend requests → Firestore: reads and writes (evidence: `phone_tracker_backend/routes/friends.py`)
- Group management → Firestore: reads and writes (evidence: `phone_tracker_backend/routes/groups.py`)
- Feedback API → Firestore: stores feedback (evidence: `phone_tracker_backend/routes/feedback.py`)
- Socket location channel → Firestore: stores snapshots (evidence: `phone_tracker_backend/realtime.py`)
- Socket location channel → Android clients: emits locations (evidence: `README.md`)
- Profile APIs → Firebase Storage: uploads avatar (evidence: `phone_tracker_backend/routes/profile.py`)
- Profile APIs → Firestore: saves avatar URL (evidence: `phone_tracker_backend/routes/profile.py`)
- Sharing preferences → Firestore: updates preferences
