# sabratech/raven-messenger architecture

> Architecture diagram of the GitHub repository sabratech/raven-messenger, 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/sabratech/raven-messenger
- Repository: https://github.com/sabratech/raven-messenger
- Video tour (about a minute): https://gitdiagram.com/sabratech/raven-messenger/video

## Overview

Raven is an Android messaging app for account access, friend management, profiles, and one-to-one text and photo conversations. Its user-facing workflow is to sign in, find or add a friend, then exchange messages; the README also documents password recovery, push notifications, end-to-end encryption, emoji prediction, and Smart Reply. Firebase Cloud Functions provide documented database-triggered notifications and welcome email. Source excerpts establish those function-to-service relationships and the native Smart Reply bridge; Android-side wiring is not shown, so those links are omitted or marked unverified.

Main entry points: [`app/src/main/java/com/example/space/ravenmessenger/ui/activities/ChatActivity.java`](https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/ui/activities/ChatActivity.java) (One-to-one chat), [`Firebase Cloud Functions/index.js`](https://github.com/sabratech/raven-messenger/blob/master/Firebase%20Cloud%20Functions/index.js) (Database-triggered functions), [`app/src/main/java/com/example/space/ravenmessenger/smartreply/SmartReplyClient.java`](https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/smartreply/SmartReplyClient.java) (Smart Reply), [`Server (REST API)/Server.java`](https://github.com/sabratech/raven-messenger/blob/master/Server%20(REST%20API)/Server.java) (Emoji REST endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Android app"]
  node_account["Account access<br/>[LoginActivity.java]"]
  node_registration["Registration and recovery"]
  node_friends["Friend discovery"]
  node_profile["User profiles"]
end

subgraph group_messaging["Messaging and intelligence"]
  node_chat["One-to-one chat<br/>[ChatActivity.java]"]
  node_encryption["Message encryption<br/>[CipherHandler.java]"]
  node_emoji["Emoji prediction"]
  node_smartreply["Smart Reply"]
  node_smartreplyjni["Native prediction bridge<br/>[smartreply_jni.cc]"]
  node_notifications["Notification handling"]
end

subgraph group_backend["Firebase functions"]
  node_firebase[("Firebase database")]
  node_functions["Database-triggered functions<br/>[index.js]"]
  node_push["Push messaging"]
  node_email["Email delivery"]
end

subgraph group_emoji["Emoji service"]
  node_emojiapi["Emoji REST endpoint<br/>[Server.java]"]
  node_python["Python predictor"]
end

node_user(("Messenger user"))

node_user -->|"signs in"| node_account
node_user -->|"registers or recovers"| node_registration
node_user -->|"finds friends"| node_friends
node_user -->|"edits profile"| node_profile
node_user -->|"sends messages"| node_chat
node_chat -.->|"encrypts messages"| node_encryption
node_chat -.->|"predicts emoji"| node_emoji
node_chat -.->|"requests suggestions"| node_smartreply
node_smartreply -->|"calls native bridge"| node_smartreplyjni
node_firebase -->|"triggers functions"| node_functions
node_functions -->|"reads user data"| node_firebase
node_functions -->|"sends device alerts"| node_push
node_functions -->|"sends welcome email"| node_email
node_push -.->|"delivers alerts"| node_notifications
node_chat -.->|"stores messages"| node_firebase
node_emojiapi -->|"runs predictor"| node_python

click node_account "https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/ui/activities/LoginActivity.java"
click node_registration "https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/ui/activities/SignUpActivity.java"
click node_friends "https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/ui/activities/AllUsersActivity.java"
click node_profile "https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/ui/fragments/MyProfileFragment.java"
click node_chat "https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/ui/activities/ChatActivity.java"
click node_encryption "https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/encryption/CipherHandler.java"
click node_emoji "https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/data/EmojiPrediction.java"
click node_smartreply "https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/smartreply/SmartReplyClient.java"
click node_smartreplyjni "https://github.com/sabratech/raven-messenger/blob/master/app/src/main/smartreply_jni.cc"
click node_notifications "https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/services/NotificationService.java"
click node_functions "https://github.com/sabratech/raven-messenger/blob/master/Firebase%20Cloud%20Functions/index.js"
click node_emojiapi "https://github.com/sabratech/raven-messenger/blob/master/Server%20(REST%20API)/Server.java"

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_account,node_registration,node_friends,node_profile,node_user toneBlue
class node_chat,node_encryption,node_emoji,node_smartreply,node_smartreplyjni,node_notifications toneAmber
class node_firebase,node_functions,node_push,node_email toneMint
class node_emojiapi,node_python toneRose
```

## Components

### Android app

- [Account access](https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/ui/activities/LoginActivity.java): `app/src/main/java/com/example/space/ravenmessenger/ui/activities/LoginActivity.java`
- [Registration and recovery](https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/ui/activities/SignUpActivity.java): `app/src/main/java/com/example/space/ravenmessenger/ui/activities/SignUpActivity.java`
- [Friend discovery](https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/ui/activities/AllUsersActivity.java): `app/src/main/java/com/example/space/ravenmessenger/ui/activities/AllUsersActivity.java`
- [User profiles](https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/ui/fragments/MyProfileFragment.java): `app/src/main/java/com/example/space/ravenmessenger/ui/fragments/MyProfileFragment.java`

### Messaging and intelligence

- [One-to-one chat](https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/ui/activities/ChatActivity.java): `app/src/main/java/com/example/space/ravenmessenger/ui/activities/ChatActivity.java`
- [Message encryption](https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/encryption/CipherHandler.java): `app/src/main/java/com/example/space/ravenmessenger/encryption/CipherHandler.java`
- [Emoji prediction](https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/data/EmojiPrediction.java): `app/src/main/java/com/example/space/ravenmessenger/data/EmojiPrediction.java`
- [Smart Reply](https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/smartreply/SmartReplyClient.java): `app/src/main/java/com/example/space/ravenmessenger/smartreply/SmartReplyClient.java`
- [Native prediction bridge](https://github.com/sabratech/raven-messenger/blob/master/app/src/main/smartreply_jni.cc): `app/src/main/smartreply_jni.cc`
- [Notification handling](https://github.com/sabratech/raven-messenger/blob/master/app/src/main/java/com/example/space/ravenmessenger/services/NotificationService.java): `app/src/main/java/com/example/space/ravenmessenger/services/NotificationService.java`

### Firebase functions

- **Firebase database**
- [Database-triggered functions](https://github.com/sabratech/raven-messenger/blob/master/Firebase%20Cloud%20Functions/index.js): `Firebase Cloud Functions/index.js`
- **Push messaging**
- **Email delivery**

### Emoji service

- [Emoji REST endpoint](https://github.com/sabratech/raven-messenger/blob/master/Server%20(REST%20API)/Server.java): `Server (REST API)/Server.java`
- **Python predictor**

### Other components

- **Messenger user**

## Connections

- Messenger user → Account access: signs in (evidence: `README.md`)
- Messenger user → Registration and recovery: registers or recovers (evidence: `README.md`)
- Messenger user → Friend discovery: finds friends (evidence: `README.md`)
- Messenger user → User profiles: edits profile (evidence: `README.md`)
- Messenger user → One-to-one chat: sends messages (evidence: `README.md`)
- One-to-one chat → Message encryption: encrypts messages
- One-to-one chat → Emoji prediction: predicts emoji
- One-to-one chat → Smart Reply: requests suggestions
- Smart Reply → Native prediction bridge: calls native bridge (evidence: `app/src/main/smartreply_jni.cc`)
- Firebase database → Database-triggered functions: triggers functions (evidence: `Firebase Cloud Functions/index.js`)
- Database-triggered functions → Firebase database: reads user data (evidence: `Firebase Cloud Functions/index.js`)
- Database-triggered functions → Push messaging: sends device alerts (evidence: `Firebase Cloud Functions/index.js`)
- Database-triggered functions → Email delivery: sends welcome email (evidence: `Firebase Cloud Functions/index.js`)
- Push messaging → Notification handling: delivers alerts
- One-to-one chat → Firebase database: stores messages
- Emoji REST endpoint → Python predictor: runs predictor (evidence: `Server (REST API)/Server.java`)
