How akhzari-itshield/socialapp-serverfull works
SocialApp Server is a FastAPI social-messaging backend. A client requests an OTP, verifies it to obtain a JWT, then uses authenticated APIs for profiles, chats, messages, files, and folders; WebSockets support live messaging, presence, and call signaling. Admin APIs and a Jinja-based web panel provide user, chat, and system management. The graph includes documented capabilities whose router implementations were not sampled; those links are documented or left unasserted. Evidence for unsampled modules is limited to the source index and README.
Main entry points: database.py DB sessions · main.py FastAPI app · auth_router.py OTP endpoints · auth.py JWT and user auth
Components 21
API entry
- FastAPI app
main.py - Settings
config.py - API schemas
schemas.py - DB sessions
database.py - Domain records
models.py - SQL database
Identity and access
- OTP endpoints
routers/auth_router.py - JWT and user auth
auth.py - User profiles
routers/users_router.py
Messaging
- Chats and membership
routers/chats_router.py - Messages
routers/messages_router.py - Chat folders
routers/folders_router.py
Realtime and calls
- Call sessions
routers/calls_router.py - WebSocket routes
routers/ws_router.py - Connection manager
ws_manager.py
Files and management
- Files and media
routers/files_router.py - Admin API
routers/admin_router.py - Web admin panel
routers/panel_router.py - Panel templates
templates
Other components
- Clients
- SMS provider
Connections 44
- Clients → FastAPI app: sends requests
readme.md - FastAPI app → OTP endpoints: registers
main.py - FastAPI app → User profiles: registers
main.py - FastAPI app → Chats and membership: registers
main.py - FastAPI app → Messages: registers
main.py - FastAPI app → Files and media: registers
main.py - FastAPI app → Call sessions: registers
main.py - FastAPI app → WebSocket routes: registers
main.py - FastAPI app → Admin API: registers
main.py - FastAPI app → Web admin panel: registers
main.py - FastAPI app → Chat folders: registers
main.py - FastAPI app → DB sessions: creates tables
main.py - DB sessions → Settings: reads config
database.py - DB sessions → SQL database: connects
database.py - Domain records → DB sessions: uses base
models.py - OTP endpoints → JWT and user auth: generates token
routers/auth_router.py - OTP endpoints → DB sessions: queries records
routers/auth_router.py - OTP endpoints → Settings: reads OTP expiry
routers/auth_router.py - OTP endpoints → API schemas: validates input
routers/auth_router.py - OTP endpoints → SMS provider: would send OTP
routers/auth_router.py - User profiles → JWT and user auth: requires user auth
routers/users_router.py - User profiles → DB sessions: queries records
routers/users_router.py - User profiles → Settings: reads upload config
routers/users_router.py - Chats and membership → JWT and user auth: requires user auth
routers/chats_router.py - Chats and membership → DB sessions: queries records
routers/chats_router.py - Chats and membership → Connection manager: checks presence
routers/chats_router.py - Messages → JWT and user auth: requires user auth
routers/messages_router.py - Messages → DB sessions: stores and reads
routers/messages_router.py - Messages → Connection manager: dispatches events
routers/messages_router.py - Chat folders → DB sessions: queries records
routers/folders_router.py - Chat folders → JWT and user auth: requires user auth
routers/folders_router.py - Files and media → DB sessions: stores metadata
routers/files_router.py - Files and media → Settings: reads upload config
routers/files_router.py - Call sessions → DB sessions: records sessions
routers/calls_router.py - Call sessions → JWT and user auth: requires user auth
routers/calls_router.py - WebSocket routes → Connection manager: manages connections
routers/ws_router.py - WebSocket routes → DB sessions: queries records
routers/ws_router.py - WebSocket routes → Clients: signals WebRTC
readme.md - Admin API → DB sessions: queries records
routers/admin_router.py - Admin API → Settings: reads config
routers/admin_router.py - Admin API → Connection manager: broadcasts messages
routers/admin_router.py - Web admin panel → DB sessions: queries records
routers/panel_router.py - Web admin panel → Panel templates: renders pages
readme.md - Clients → Web admin panel: uses admin UI
readme.md