How andervicario/umbra works
Umbra is an Android encrypted-messaging client whose main workflow is session-aware startup, sign-in or registration, contact selection, and conversation messaging. Its documented scope is HTTPS-backed communication; the sampled runtime also shows WebSocket notifications, encrypted local message/contact storage, scheduled messages, location sharing, and chat backup. Edges are limited to relationships shown in excerpts, SOURCE INDEX references, or the README; unsampled feature internals are represented by their exact enclosing directories.
Main entry points: ApiService.java REST endpoints · ListContacts.java Contact list · Conversation.java Conversation · BackgroundWebSocketService.java Message receiver
Components 25
App entry and identity
- Session startup
app/src/main/java/com/av19/ui/SplashActivity.java - Sign in
app/src/main/java/com/av19/ui/LoginMenu.java - Registration
app/src/main/java/com/av19/ui/RegisterMenu.java
Contacts and conversations
- Contact list
app/src/main/java/com/av19/ui/ListContacts.java - Contact management
app/src/main/java/com/av19/ui/AddContactForm.java - Edit contact
app/src/main/java/com/av19/ui/EditContactDialogFragment.java - Contact collection
app/src/main/java/com/av19/models/ContactList.java - Contact model
app/src/main/java/com/av19/models/Contact.java - Contact rows
app/src/main/java/com/av19/adapters/ContactsAdapter.java - Conversation
app/src/main/java/com/av19/ui/Conversation.java - Message rows
app/src/main/java/com/av19/adapters/MessagesAdapter.java - Location sharing
app/src/main/java/com/av19/ui/AddLocationMenu.java - Profile updates
app/src/main/java/com/av19/ui/ListContacts.java
Messaging transport
- REST endpoints
app/src/main/java/com/av19/utils/ApiService.java - HTTPS client
app/src/main/java/com/av19/utils/RetrofitClient.java - Message receiver
app/src/main/java/com/av19/utils/BackgroundWebSocketService.java - WebSocket client
app/src/main/java/com/av19/utils/WebSocketClient.java - Scheduled send
app/src/main/java/com/av19/utils/MessageSchedulerReceiver.java - Message queue
app/src/main/java/com/av19/models/MessageQueue.java - API payloads
app/src/main/java/com/av19/models/api
Local state and tools
- Encrypted database
app/src/main/java/com/av19/utils/DatabaseHelper.java - Message model
app/src/main/java/com/av19/models/Message.java - Message widget
app/src/main/java/com/av19/widgets/MessageWidget.java
Other components
- User
- Umbra server
Connections 34
- User → Session startup: opens app
app/src/main/java/com/av19/ui/SplashActivity.java - Session startup → Contact list: routes session
app/src/main/java/com/av19/ui/SplashActivity.java - Session startup → Sign in: routes guest
app/src/main/java/com/av19/ui/SplashActivity.java - Sign in → Registration: opens registration
app/src/main/java/com/av19/ui/LoginMenu.java - User → Sign in: authenticates
README.md - Sign in → REST endpoints: submits credentials
app/src/main/java/com/av19/ui/LoginMenu.java - Registration → REST endpoints: creates account
app/src/main/java/com/av19/ui/RegisterMenu.java - Contact list → Contact rows: renders contacts
app/src/main/java/com/av19/ui/ListContacts.java - Contact rows → Contact model: displays
app/src/main/java/com/av19/adapters/ContactsAdapter.java - Contact list → Contact collection: loads contacts
app/src/main/java/com/av19/ui/ListContacts.java - Contact collection → Encrypted database: reads contacts
app/src/main/java/com/av19/models/ContactList.java - Contact management → Contact collection: adds contact
- Contact list → Edit contact: opens editor
app/src/main/java/com/av19/ui/ListContacts.java - Contact list → Conversation: opens chat
- Conversation → Message rows: renders messages
app/src/main/java/com/av19/ui/Conversation.java - Conversation → Encrypted database: stores messages
app/src/main/java/com/av19/ui/Conversation.java - Conversation → REST endpoints: sends messages
app/src/main/java/com/av19/ui/Conversation.java - Conversation → Location sharing: opens location
app/src/main/java/com/av19/ui/Conversation.java - Location sharing → User: selects location
- HTTPS client → REST endpoints: configures client
app/src/main/java/com/av19/utils/RetrofitClient.java - REST endpoints → Umbra server: HTTPS requests
README.md - Message receiver → REST endpoints: fetches messages
app/src/main/java/com/av19/utils/BackgroundWebSocketService.java - Message receiver → WebSocket client: connects listener
app/src/main/java/com/av19/utils/BackgroundWebSocketService.java - WebSocket client → Umbra server: push events
app/src/main/java/com/av19/utils/WebSocketClient.java - Message receiver → Encrypted database: stores received
app/src/main/java/com/av19/utils/BackgroundWebSocketService.java - Message receiver → Message widget: updates widget
app/src/main/java/com/av19/utils/BackgroundWebSocketService.java - Conversation → Scheduled send: schedules send
app/src/main/java/com/av19/ui/Conversation.java - Scheduled send → REST endpoints: sends later
app/src/main/java/com/av19/utils/MessageSchedulerReceiver.java - Contact list → Profile updates: updates profile
app/src/main/java/com/av19/ui/ListContacts.java - Profile updates → REST endpoints: uploads picture
app/src/main/java/com/av19/ui/ListContacts.java - REST endpoints → API payloads: uses payloads
app/src/main/java/com/av19/utils/ApiService.java - Contact collection → Message model: loads messages
app/src/main/java/com/av19/models/ContactList.java - Message rows → Message model: displays
app/src/main/java/com/av19/adapters/MessagesAdapter.java - Message queue → Message model: holds messages
app/src/main/java/com/av19/models/MessageQueue.java