How 047harry/anits-campus-mesh works
CampusMesh is an Android offline-first campus communications app for emergencies and routine coordination when central infrastructure is unavailable. Users register a campus identity, then use SOS, authority bulletins, private chat, and a muster map; nearby devices relay traffic over Bluetooth or local-network UDP. Packets are prioritized and routed across hops, with encrypted chat and local persistence. The README documents several capabilities whose implementation files are present but unsampled; their internal wiring is therefore not asserted beyond documented relationships and visible references.
Main entry points: MainActivity.kt App entry · RadioCoordinator.kt Radio coordinator · RoutingDaemon.kt Multi-hop routing · MeshDatabase.kt Room database
Components 30
App and UI
- App entry
campus-mesh-android/app/src/main/java/in/anits/mesh/MainActivity.kt - Registration
campus-mesh-android/app/src/main/java/in/anits/mesh/ui/screens/RegistrationScreen.kt - SOS screen
campus-mesh-android/app/src/main/java/in/anits/mesh/ui/screens/SosScreen.kt - Bulletin feed
campus-mesh-android/app/src/main/java/in/anits/mesh/ui/screens/BulletinsScreen.kt - Mesh chat
campus-mesh-android/app/src/main/java/in/anits/mesh/ui/screens/ChatScreen.kt - Muster map
campus-mesh-android/app/src/main/java/in/anits/mesh/ui/screens/MusterMapScreen.kt - Profile settings
campus-mesh-android/app/src/main/java/in/anits/mesh/ui/screens/ProfileSettingsScreen.kt - Chat logic
campus-mesh-android/app/src/main/java/in/anits/mesh/viewmodel/ChatViewModel.kt - SOS logic
campus-mesh-android/app/src/main/java/in/anits/mesh/viewmodel/SosViewModel.kt - Bulletin logic
campus-mesh-android/app/src/main/java/in/anits/mesh/viewmodel/BulletinViewModel.kt
Identity and Trust
- Identity and directory
campus-mesh-android/app/src/main/java/in/anits/mesh/data/UserManager.kt - Cryptography
campus-mesh-android/app/src/main/java/in/anits/mesh/crypto/CryptoEngine.kt
Mesh Transport and Routing
- Packet model
campus-mesh-android/app/src/main/java/in/anits/mesh/model/MeshPacket.kt - Packet priorities
campus-mesh-android/app/src/main/java/in/anits/mesh/model/PacketType.kt - Packet serializer
campus-mesh-android/app/src/main/java/in/anits/mesh/protocol/PacketSerializer.kt - Radio coordinator
campus-mesh-android/app/src/main/java/in/anits/mesh/radio/RadioCoordinator.kt - UDP transport
campus-mesh-android/app/src/main/java/in/anits/mesh/radio/UdpMeshTransport.kt - BLE GATT transport
campus-mesh-android/app/src/main/java/in/anits/mesh/radio/BleGattMeshTransport.kt - Multi-hop routing
campus-mesh-android/app/src/main/java/in/anits/mesh/routing/RoutingDaemon.kt - Priority queue
campus-mesh-android/app/src/main/java/in/anits/mesh/routing/PriorityQueueManager.kt - Delivery acknowledgments
campus-mesh-android/app/src/main/java/in/anits/mesh/routing/AckManager.kt - Store and forward
campus-mesh-android/app/src/main/java/in/anits/mesh/routing/StoreAndForwardVault.kt - Radio service
campus-mesh-android/app/src/main/java/in/anits/mesh/radio/MeshRadioService.kt
Local Data
- Room database
campus-mesh-android/app/src/main/java/in/anits/mesh/data/MeshDatabase.kt - Message records
campus-mesh-android/app/src/main/java/in/anits/mesh/data/entity/MessageEntity.kt - Peer records
campus-mesh-android/app/src/main/java/in/anits/mesh/data/entity/PeerEntity.kt - Seen packet cache
campus-mesh-android/app/src/main/java/in/anits/mesh/data/entity/SeenCacheEntity.kt
Other components
- Campus user
- Nearby campus peers
- Cloud directory
Connections 35
- Campus user → App entry: uses
- App entry → Registration: shows when unregistered
campus-mesh-android/app/src/main/java/in/anits/mesh/MainActivity.kt - App entry → SOS screen: routes to
campus-mesh-android/app/src/main/java/in/anits/mesh/MainActivity.kt - App entry → Bulletin feed: routes to
campus-mesh-android/app/src/main/java/in/anits/mesh/MainActivity.kt - App entry → Mesh chat: routes to
campus-mesh-android/app/src/main/java/in/anits/mesh/MainActivity.kt - App entry → Muster map: routes to
campus-mesh-android/app/src/main/java/in/anits/mesh/MainActivity.kt - App entry → Profile settings: routes to
campus-mesh-android/app/src/main/java/in/anits/mesh/MainActivity.kt - App entry → Radio service: starts
campus-mesh-android/app/src/main/java/in/anits/mesh/MainActivity.kt - App entry → Identity and directory: checks registration
campus-mesh-android/app/src/main/java/in/anits/mesh/MainActivity.kt - Mesh chat → Chat logic: uses
campus-mesh-android/app/src/main/java/in/anits/mesh/ui/screens/ChatScreen.kt - Chat logic → Cryptography: encrypts messages
campus-mesh-android/app/src/main/java/in/anits/mesh/viewmodel/ChatViewModel.kt - Chat logic → Radio coordinator: transmits messages
campus-mesh-android/app/src/main/java/in/anits/mesh/viewmodel/ChatViewModel.kt - Chat logic → Room database: reads and writes
campus-mesh-android/app/src/main/java/in/anits/mesh/viewmodel/ChatViewModel.kt - Identity and directory → Cryptography: uses keys
campus-mesh-android/app/src/main/java/in/anits/mesh/data/UserManager.kt - Identity and directory → Cloud directory: syncs directory
campus-mesh-android/app/src/main/java/in/anits/mesh/data/UserManager.kt - Registration → Identity and directory: registers identity
campus-mesh-android/app/src/main/java/in/anits/mesh/MainActivity.kt - Radio service → Radio coordinator: starts services
campus-mesh-android/app/src/main/java/in/anits/mesh/radio/MeshRadioService.kt - Radio coordinator → UDP transport: broadcasts packets
campus-mesh-android/app/src/main/java/in/anits/mesh/radio/RadioCoordinator.kt - Radio coordinator → BLE GATT transport: dispatches packets
campus-mesh-android/app/src/main/java/in/anits/mesh/radio/RadioCoordinator.kt - Nearby campus peers → UDP transport: exchanges packets
- Nearby campus peers → BLE GATT transport: exchanges packets
- Multi-hop routing → Radio coordinator: dispatches relays
campus-mesh-android/app/src/main/java/in/anits/mesh/routing/RoutingDaemon.kt - Multi-hop routing → Priority queue: queues packets
campus-mesh-android/app/src/main/java/in/anits/mesh/routing/RoutingDaemon.kt - Multi-hop routing → Delivery acknowledgments: manages receipts
campus-mesh-android/app/src/main/java/in/anits/mesh/routing/RoutingDaemon.kt - Multi-hop routing → Room database: persists relayed data
campus-mesh-android/app/src/main/java/in/anits/mesh/routing/RoutingDaemon.kt - Multi-hop routing → Store and forward: stores for forwarding
- Priority queue → Packet priorities: orders by priority
campus-mesh-android/app/src/main/java/in/anits/mesh/routing/PriorityQueueManager.kt - Packet model → Packet priorities: uses packet type
campus-mesh-android/app/src/main/java/in/anits/mesh/model/MeshPacket.kt - Packet serializer → Packet model: encodes packets
campus-mesh-android/app/src/main/java/in/anits/mesh/protocol/PacketSerializer.kt - Radio coordinator → Packet serializer: serializes packets
- Room database → Message records: stores
campus-mesh-android/app/src/main/java/in/anits/mesh/data/MeshDatabase.kt - Room database → Peer records: stores
campus-mesh-android/app/src/main/java/in/anits/mesh/data/MeshDatabase.kt - Room database → Seen packet cache: stores
campus-mesh-android/app/src/main/java/in/anits/mesh/data/MeshDatabase.kt - Bulletin feed → Bulletin logic: uses
campus-mesh-android/app/src/main/java/in/anits/mesh/ui/screens/BulletinsScreen.kt - SOS screen → SOS logic: uses