How onoyima/sos-connect works
SOS Connect is an institution-based communications and safety product: members use web or mobile clients for chat, calls, status, and SOS, with the mobile app able to carry traffic offline over a device mesh and deliver it when connectivity returns. Institutions connect their records for sign-in and organizational sync; administrators manage membership, permissions, and platform billing. The graph preserves these documented capabilities and the sampled chat, access-control, and mesh-ingest layers. Some feature paths are represented by their controller or subsystem directory because their implementation was not excerpted.
Main entry points: _layout.tsx Mobile app · MessageService.php Message service · OrgUnit.php Institution directory · ConversationController.php Conversation API
Components 26
Member clients
- Web app
resources/js/app.tsx - Mobile app
mobile/app/_layout.tsx - Chat screens
mobile/app/chat/[id].tsx
Application server
- API routes
routes/api.php - Conversation API
app/Http/Controllers/Api/ConversationController.php - Message service
app/Services/Chat/MessageService.php - Conversation data
app/Models/Conversation.php - Message data
app/Models/Message.php - Realtime and push
app/Events/MessageCreated.php - Calls
app/Http/Controllers/Api/CallController.php - Status and safety
app/Http/Controllers/Api/StatusController.php - Mesh ingest
app/Services/Mesh/MeshIngest.php - Push delivery
app/Jobs/SendPush.php
Institution operations
- Institution records
connector/src/Directory.php - Records connector
app/Services/Connector/ConnectorClient.php - Org structure
app/Services/Structure/StructureSync.php - Member access
app/Http/Controllers/Web/MemberAccessController.php - Roles and permissions
app/Services/Access/RoleManager.php - Institution directory
app/Models/OrgUnit.php - Institution settings
app/Models/Institution.php
Offline delivery
- Mobile mesh
mobile/src/mesh/MeshManager.ts - Nearby transport
mobile/modules/mesh-nearby/src/index.ts - Campus relay
edge-node/src/index.mjs
Platform services
- Subscriptions
app/Services/Billing/Billing.php - Platform billing
app/Http/Controllers/Web/PlatformBillingController.php
Other components
- Member
Connections 30
- Member → Mobile app: uses
README.md - Member → Web app: uses
README.md - Mobile app → API routes: online requests
README.md - Web app → API routes: API access
- Chat screens → Mobile app: renders within
- API routes → Conversation API: routes requests
- Conversation API → Message service: delegates messaging
app/Http/Controllers/Api/ConversationController.php - Conversation API → Conversation data: queries conversations
app/Http/Controllers/Api/ConversationController.php - Message service → Message data: creates messages
app/Services/Chat/MessageService.php - Message service → Conversation data: checks conversation
app/Services/Chat/MessageService.php - Message service → Realtime and push: dispatches event
app/Services/Chat/MessageService.php - Message service → Push delivery: queues notifications
app/Services/Chat/MessageService.php - Mobile app → Calls: supports calls
README.md - Mobile app → Status and safety: uses safety features
README.md - Status and safety → Push delivery: queues alerts
app/Http/Controllers/Api/StatusController.php - Mobile app → Mobile mesh: offline messaging
README.md - Mobile mesh → Nearby transport: uses nearby transport
mobile/src/mesh/MeshManager.ts - Mobile mesh → Campus relay: optional relay
README.md - Mesh ingest → Message service: ingests messages
app/Services/Mesh/MeshIngest.php - Mesh ingest → Status and safety: ingests safety data
app/Services/Mesh/MeshIngest.php - Mobile app → Records connector: sign-in and sync
README.md - Records connector → Institution records: reads records
app/Services/Connector/ConnectorClient.php - Records connector → Org structure: provides directory data
- Org structure → Institution directory: syncs units
- Member access → Roles and permissions: manages roles
app/Http/Controllers/Web/MemberAccessController.php - Member access → Institution directory: uses areas
app/Http/Controllers/Web/MemberAccessController.php - Roles and permissions → Institution directory: scopes assignments
app/Services/Access/RoleManager.php - Institution settings → Subscriptions: starts trial
app/Models/Institution.php - Platform billing → Subscriptions: manages plans
app/Http/Controllers/Web/PlatformBillingController.php - Institution settings → Institution directory: owns units
app/Models/Institution.php