# jasontm17/nexachat_appj architecture

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

- Interactive diagram: https://gitdiagram.com/jasontm17/nexachat_appj
- Repository: https://github.com/jasontm17/nexachat_appj

## Overview

NexaChat is an Android messaging client backed by a Spring Boot modular monolith. Users authenticate, discover contacts, open direct or group conversations, and exchange messages that remain available offline; the app also supports media, realtime events, and voice calls. Separate product branches provide end-to-end encryption, consent-gated summaries and chat RAG, and optional Firebase ephemeral state. The README establishes these capabilities and the broad client/server architecture; sampled source adds detail for sync, calls, and RAG, but most feature wiring was not inspected.

Main entry points: [`android/app/src/main/java/com/nexachat/MainActivity.java`](https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/MainActivity.java) (Android app), [`android/app/src/main/java/com/nexachat/data/SyncEngine.java`](https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/data/SyncEngine.java) (Offline sync), [`android/app/src/main/java/com/nexachat/core/network/stomp/StompClient.java`](https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/core/network/stomp/StompClient.java) (STOMP and presence), [`server/src/main/java/com/nexachat/rag/RagLlmAnswerService.java`](https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/rag/RagLlmAnswerService.java) (Chat RAG)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Android client"]
  node_android["Android app<br/>[MainActivity.java]"]
  node_contacts["Contacts discovery"]
  node_sync["Offline sync<br/>[SyncEngine.java]"]
  node_room[("Local database<br/>[AppDatabase.java]")]
end

subgraph group_server["Backend services"]
  node_messages["Messaging"]
  node_conversations[("Conversations<br/>[Conversation.java]")]
  node_attachments["Media storage"]
end

subgraph group_realtime["Realtime and calls"]
  node_realtime["STOMP and presence<br/>[StompClient.java]"]
  node_calls["Voice calls<br/>[CallManager.java]"]
  node_webrtc["WebRTC media"]
  node_firebase["Firebase bridge"]
end

subgraph group_ai["AI features"]
  node_summary["AI summaries"]
  node_rag["Chat RAG"]
  node_embeddings["RAG embeddings"]
end

subgraph group_security["Identity and security"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_crypto["E2EE<br/>[E2eeCrypto.java]"]
end

node_user(("Chat user"))
node_external_llm["External AI model"]
node_external_firebase["Firebase RTDB"]

node_user -->|"uses"| node_android
node_android -->|"authenticates via"| node_auth
node_android -->|"discovers contacts"| node_contacts
node_android -->|"syncs messages"| node_sync
node_sync -->|"persists locally"| node_room
node_sync -->|"requests updates"| node_messages
node_android -->|"chats in"| node_conversations
node_android -->|"protects messages"| node_crypto
node_android -->|"sends media"| node_attachments
node_android -->|"connects via"| node_realtime
node_realtime -->|"carries chat events"| node_messages
node_android -->|"starts calls"| node_calls
node_calls -->|"uses media engine"| node_webrtc
node_android -->|"requests summaries"| node_summary
node_android -->|"asks this chat"| node_rag
node_rag -.->|"retrieves context"| node_embeddings
node_rag -->|"generates answer"| node_external_llm
node_summary -.->|"uses with consent"| node_external_llm
node_firebase -.->|"projects authorization"| node_external_firebase
node_realtime -.->|"optional fallback"| node_firebase

click node_android "https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/MainActivity.java"
click node_auth "https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/auth/AuthService.java"
click node_contacts "https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/feature/contacts/UserSearchFragment.java"
click node_sync "https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/data/SyncEngine.java"
click node_room "https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/core/database/AppDatabase.java"
click node_crypto "https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/core/crypto/E2eeCrypto.java"
click node_messages "https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/message/MessageService.java"
click node_conversations "https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/conversation/Conversation.java"
click node_attachments "https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/attachment/StorageService.java"
click node_realtime "https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/core/network/stomp/StompClient.java"
click node_calls "https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/call/core/CallManager.java"
click node_webrtc "https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/call/media/WebRtcMediaEngine.java"
click node_summary "https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/summary/SummaryService.java"
click node_rag "https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/rag/RagLlmAnswerService.java"
click node_embeddings "https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/rag/RagEmbeddingService.java"
click node_firebase "https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/firebase/projection/FirebaseAuthorizationProjectionService.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_android,node_contacts,node_sync,node_room,node_user toneBlue
class node_messages,node_conversations,node_attachments toneAmber
class node_realtime,node_calls,node_webrtc,node_firebase toneMint
class node_summary,node_rag,node_embeddings toneRose
class node_auth,node_crypto,node_external_llm,node_external_firebase toneIndigo
```

## Components

### Android client

- [Android app](https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/MainActivity.java): `android/app/src/main/java/com/nexachat/MainActivity.java`
- [Contacts discovery](https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/feature/contacts/UserSearchFragment.java): `android/app/src/main/java/com/nexachat/feature/contacts/UserSearchFragment.java`
- [Offline sync](https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/data/SyncEngine.java): `android/app/src/main/java/com/nexachat/data/SyncEngine.java`
- [Local database](https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/core/database/AppDatabase.java): `android/app/src/main/java/com/nexachat/core/database/AppDatabase.java`

### Backend services

- [Messaging](https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/message/MessageService.java): `server/src/main/java/com/nexachat/message/MessageService.java`
- [Conversations](https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/conversation/Conversation.java): `server/src/main/java/com/nexachat/conversation/Conversation.java`
- [Media storage](https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/attachment/StorageService.java): `server/src/main/java/com/nexachat/attachment/StorageService.java`

### Realtime and calls

- [STOMP and presence](https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/core/network/stomp/StompClient.java): `android/app/src/main/java/com/nexachat/core/network/stomp/StompClient.java`
- [Voice calls](https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/call/core/CallManager.java): `android/app/src/main/java/com/nexachat/call/core/CallManager.java`
- [WebRTC media](https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/call/media/WebRtcMediaEngine.java): `android/app/src/main/java/com/nexachat/call/media/WebRtcMediaEngine.java`
- [Firebase bridge](https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/firebase/projection/FirebaseAuthorizationProjectionService.java): `server/src/main/java/com/nexachat/firebase/projection/FirebaseAuthorizationProjectionService.java`

### AI features

- [AI summaries](https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/summary/SummaryService.java): `server/src/main/java/com/nexachat/summary/SummaryService.java`
- [Chat RAG](https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/rag/RagLlmAnswerService.java): `server/src/main/java/com/nexachat/rag/RagLlmAnswerService.java`
- [RAG embeddings](https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/rag/RagEmbeddingService.java): `server/src/main/java/com/nexachat/rag/RagEmbeddingService.java`

### Identity and security

- [Authentication](https://github.com/jasontm17/nexachat_appj/blob/main/server/src/main/java/com/nexachat/auth/AuthService.java): `server/src/main/java/com/nexachat/auth/AuthService.java`
- [E2EE](https://github.com/jasontm17/nexachat_appj/blob/main/android/app/src/main/java/com/nexachat/core/crypto/E2eeCrypto.java): `android/app/src/main/java/com/nexachat/core/crypto/E2eeCrypto.java`

### Other components

- **Chat user**
- **External AI model**
- **Firebase RTDB**

## Connections

- Chat user → Android app: uses (evidence: `README.md`)
- Android app → Authentication: authenticates via (evidence: `README.md`)
- Android app → Contacts discovery: discovers contacts (evidence: `README.md`)
- Android app → Offline sync: syncs messages (evidence: `README.md`)
- Offline sync → Local database: persists locally (evidence: `android/app/src/main/java/com/nexachat/data/SyncEngine.java`)
- Offline sync → Messaging: requests updates (evidence: `README.md`)
- Android app → Conversations: chats in (evidence: `README.md`)
- Android app → E2EE: protects messages (evidence: `README.md`)
- Android app → Media storage: sends media (evidence: `README.md`)
- Android app → STOMP and presence: connects via (evidence: `README.md`)
- STOMP and presence → Messaging: carries chat events (evidence: `README.md`)
- Android app → Voice calls: starts calls (evidence: `README.md`)
- Voice calls → WebRTC media: uses media engine (evidence: `android/app/src/main/java/com/nexachat/call/core/CallManager.java`)
- Android app → AI summaries: requests summaries (evidence: `README.md`)
- Android app → Chat RAG: asks this chat (evidence: `README.md`)
- Chat RAG → RAG embeddings: retrieves context
- Chat RAG → External AI model: generates answer (evidence: `server/src/main/java/com/nexachat/rag/RagLlmAnswerService.java`)
- AI summaries → External AI model: uses with consent (evidence: `README.md`)
- Firebase bridge → Firebase RTDB: projects authorization (evidence: `server/src/main/java/com/nexachat/firebase/projection/FirebaseAuthorizationProjectionService.java`)
- STOMP and presence → Firebase bridge: optional fallback (evidence: `README.md`)
