How ngaboelyse/ubumweconect works
Ubumwe Connect is a multilingual social messaging and calling API. Users authenticate and manage profiles, then exchange conversations, files, and real-time events; separate routes support calls and translation. The main app mounts these API and WebSocket entry points, while services provide authentication, translation, voice, files, and notifications over shared persistence. The README is empty, so capabilities are inferred from the backend tree and source index. The Windows files show a native Flutter runner shell, but no application UI source is present.
Main entry points: main.py API App · conversations.py Conversation Routes · auth_service.py Authentication · translation_service.py Translation Engine
Components 24
API Runtime
- API App
backend/app/main.py - Settings
backend/app/config.py - Database Sessions
backend/app/database.py
Identity And Profiles
- User Records
backend/app/models/user.py - Auth Routes
backend/app/routers/auth.py - Authentication
backend/app/services/auth_service.py - Auth Guard
backend/app/middleware/auth_middleware.py - Profile Routes
backend/app/routers/users.py
Messaging And Calls
- Conversation Routes
backend/app/routers/conversations.py - Chat Records
backend/app/models/chat.py - WebSocket Events
backend/app/websocket/handlers.py - Connection Manager
backend/app/websocket/manager.py - Call Routes
backend/app/routers/calls.py - Call Records
backend/app/models/call.py - Notifications
backend/app/services/notification_service.py
Language And Media
- Translation Routes
backend/app/routers/translation.py - Translation Engine
backend/app/services/translation_service.py - Translation Cache
backend/app/models/translation.py - Voice Services
backend/app/services/voice_service.py - File Storage Service
backend/app/services/file_service.py
Other components
- API Client
- OpenAI
- AWS S3
- Windows Runner
frontend/windows/runner/win32_window.h
Connections 39
- API Client → API App: sends requests
backend/app/main.py - API App → Settings: configures
backend/app/main.py - API App → Database Sessions: starts database
backend/app/main.py - API App → Auth Routes: mounts routes
backend/app/main.py - API App → Profile Routes: mounts routes
backend/app/main.py - API App → Conversation Routes: mounts routes
backend/app/main.py - API App → Call Routes: mounts routes
backend/app/main.py - API App → Translation Routes: mounts routes
backend/app/main.py - API App → WebSocket Events: routes WebSocket
backend/app/main.py - Auth Routes → Authentication: calls
backend/app/routers/auth.py - Auth Routes → Database Sessions: uses sessions
backend/app/routers/auth.py - Authentication → User Records: queries users
backend/app/services/auth_service.py - Authentication → Settings: uses settings
backend/app/services/auth_service.py - Authentication → OpenAI: uses Firebase auth
- Auth Guard → Authentication: decodes tokens
backend/app/middleware/auth_middleware.py - Auth Guard → Database Sessions: gets sessions
backend/app/middleware/auth_middleware.py - Auth Guard → User Records: checks user
backend/app/middleware/auth_middleware.py - Profile Routes → File Storage Service: uploads files
backend/app/routers/users.py - Profile Routes → User Records: reads profiles
backend/app/routers/users.py - Conversation Routes → Chat Records: reads and writes
backend/app/routers/conversations.py - Conversation Routes → Translation Engine: translates messages
backend/app/routers/conversations.py - Conversation Routes → File Storage Service: uploads attachments
backend/app/routers/conversations.py - Conversation Routes → Notifications: sends notifications
backend/app/routers/conversations.py - Conversation Routes → Connection Manager: dispatches events
backend/app/routers/conversations.py - WebSocket Events → Connection Manager: dispatches events
backend/app/websocket/handlers.py - WebSocket Events → Authentication: validates tokens
backend/app/websocket/handlers.py - WebSocket Events → Database Sessions: updates status
backend/app/websocket/handlers.py - Call Routes → Call Records: reads and writes
backend/app/routers/calls.py - Call Routes → Connection Manager: sends call signals
backend/app/routers/calls.py - Call Routes → Notifications: sends notifications
backend/app/routers/calls.py - Translation Routes → Translation Engine: translates text
backend/app/routers/translation.py - Translation Routes → Voice Services: handles voice
backend/app/routers/translation.py - Translation Engine → Translation Cache: caches translations
backend/app/services/translation_service.py - Translation Engine → OpenAI: requests translations
backend/app/services/translation_service.py - Voice Services → Translation Engine: uses translation
backend/app/services/voice_service.py - Voice Services → File Storage Service: uses file service
backend/app/services/voice_service.py - File Storage Service → AWS S3: uploads and deletes
backend/app/services/file_service.py - Database Sessions → Settings: reads connection settings
backend/app/database.py - Windows Runner → API Client: hosts app shell