How jasontm17/nexachat_appj works
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: MainActivity.java Android app · SyncEngine.java Offline sync · StompClient.java STOMP and presence · RagLlmAnswerService.java Chat RAG
Components 19
Android client
- Android app
android/app/src/main/java/com/nexachat/MainActivity.java - Contacts discovery
android/app/src/main/java/com/nexachat/feature/contacts/UserSearchFragment.java - Offline sync
android/app/src/main/java/com/nexachat/data/SyncEngine.java - Local database
android/app/src/main/java/com/nexachat/core/database/AppDatabase.java
Backend services
- Messaging
server/src/main/java/com/nexachat/message/MessageService.java - Conversations
server/src/main/java/com/nexachat/conversation/Conversation.java - Media storage
server/src/main/java/com/nexachat/attachment/StorageService.java
Realtime and calls
- STOMP and presence
android/app/src/main/java/com/nexachat/core/network/stomp/StompClient.java - Voice calls
android/app/src/main/java/com/nexachat/call/core/CallManager.java - WebRTC media
android/app/src/main/java/com/nexachat/call/media/WebRtcMediaEngine.java - Firebase bridge
server/src/main/java/com/nexachat/firebase/projection/FirebaseAuthorizationProjectionService.java
AI features
- AI summaries
server/src/main/java/com/nexachat/summary/SummaryService.java - Chat RAG
server/src/main/java/com/nexachat/rag/RagLlmAnswerService.java - RAG embeddings
server/src/main/java/com/nexachat/rag/RagEmbeddingService.java
Identity and security
- Authentication
server/src/main/java/com/nexachat/auth/AuthService.java - E2EE
android/app/src/main/java/com/nexachat/core/crypto/E2eeCrypto.java
Other components
- Chat user
- External AI model
- Firebase RTDB
Connections 20
- Chat user → Android app: uses
README.md - Android app → Authentication: authenticates via
README.md - Android app → Contacts discovery: discovers contacts
README.md - Android app → Offline sync: syncs messages
README.md - Offline sync → Local database: persists locally
android/app/src/main/java/com/nexachat/data/SyncEngine.java - Offline sync → Messaging: requests updates
README.md - Android app → Conversations: chats in
README.md - Android app → E2EE: protects messages
README.md - Android app → Media storage: sends media
README.md - Android app → STOMP and presence: connects via
README.md - STOMP and presence → Messaging: carries chat events
README.md - Android app → Voice calls: starts calls
README.md - Voice calls → WebRTC media: uses media engine
android/app/src/main/java/com/nexachat/call/core/CallManager.java - Android app → AI summaries: requests summaries
README.md - Android app → Chat RAG: asks this chat
README.md - Chat RAG → RAG embeddings: retrieves context
- Chat RAG → External AI model: generates answer
server/src/main/java/com/nexachat/rag/RagLlmAnswerService.java - AI summaries → External AI model: uses with consent
README.md - Firebase bridge → Firebase RTDB: projects authorization
server/src/main/java/com/nexachat/firebase/projection/FirebaseAuthorizationProjectionService.java - STOMP and presence → Firebase bridge: optional fallback
README.md