How pogg2k5/minisocial_beta works
Mini Social Network is a React/Django modular-monolith social app. Users restore or create an authenticated session, then use the web app’s feed, profiles, groups, chat, notifications, and moderation features through its API and realtime connection. Backend domain services implement identity, relationships, posts, media, groups, messaging, and moderation; a commit-aware event bus supports cross-module notifications. The README documents the broader capabilities, while sampled source and the SOURCE INDEX support only selected internal calls, so unsampled wiring is not inferred.
Main entry points: posts/services.py Posts and feed · events.py Event bus · users/services.py Profiles and friends · groups/services.py Groups and membership
Components 20
Web application
- Routes and session
frontend/src/App.jsx - API client
frontend/src/api/client.js - API endpoints
frontend/src/api/endpoints.js - Auth state
frontend/src/store/auth.js - Realtime hook
frontend/src/hooks/useRealtimeConnection.js - Social pages
frontend/src/pages
Identity and relationships
- Authentication
backend/apps/authentication/services.py - Profiles and friends
backend/apps/users/services.py
Community content
- Posts and feed
backend/apps/posts/services.py - Groups and membership
backend/apps/groups/services.py - Media processing
backend/apps/media_files/services.py - Object storage
backend/apps/media_files/storage.py
Realtime and operations
- Chat service
backend/apps/chat/services.py - Notifications
backend/apps/notifications/services.py - Admin moderation
backend/apps/admin_management/services.py - Event bus
backend/common/events.py - Redis client
backend/common/redis_client.py
Other components
- User
- MySQL database
- R2 or MinIO
Connections 29
- User → Routes and session: uses
frontend/src/App.jsx - Routes and session → Social pages: routes to
frontend/src/App.jsx - Routes and session → API client: refreshes session
frontend/src/App.jsx - API client → Auth state: reads and updates
frontend/src/api/client.js - API endpoints → API client: uses
frontend/src/api/endpoints.js - Realtime hook → API endpoints: queries presence
frontend/src/hooks/useRealtimeConnection.js - Realtime hook → Auth state: reads session
frontend/src/hooks/useRealtimeConnection.js - Realtime hook → Chat service: opens WebSocket
- Authentication → MySQL database: persists identity
- Profiles and friends → Authentication: queries users
backend/apps/users/services.py - Profiles and friends → Event bus: publishes events
backend/apps/users/services.py - Profiles and friends → MySQL database: persists relationships
- Posts and feed → Profiles and friends: uses user services
backend/apps/posts/services.py - Posts and feed → Groups and membership: uses group services
backend/apps/posts/services.py - Posts and feed → Media processing: uses media services
backend/apps/posts/services.py - Posts and feed → Redis client: caches feed
backend/apps/posts/services.py - Posts and feed → Event bus: publishes events
backend/apps/posts/services.py - Groups and membership → Profiles and friends: uses user services
backend/apps/groups/services.py - Groups and membership → Event bus: publishes events
backend/apps/groups/services.py - Media processing → Object storage: uses storage
backend/apps/media_files/services.py - Object storage → R2 or MinIO: stores media
- Chat service → Profiles and friends: checks relationships
backend/apps/chat/services.py - Chat service → Redis client: tracks presence
- Event bus → Notifications: dispatches events
backend/apps/notifications/listeners.py - Event bus → Admin moderation: dispatches events
backend/apps/admin_management/listeners.py - Event bus → Posts and feed: dispatches events
backend/apps/posts/listeners.py - Posts and feed → MySQL database: persists content
- Groups and membership → MySQL database: persists membership
- Chat service → MySQL database: persists messages