How loyzkie2005/campushub works
CampusHub is a campus marketplace and facilities-booking platform, with Django handling web application rules and a separate FastAPI service handling messaging. Users and administrators reach marketplace, facility and account workflows through the Django application; the chat client uses its own HTTP/WebSocket service. The map preserves the documented marketplace, booking, service, reporting and account capabilities. Some subsystem paths are directory-level because their individual entry points were not sampled; unsampled relationships are omitted rather than inferred.
Main entry points: conversations.py Conversation routes · websocket.py Realtime routes · urls.py Django application · models.py Marketplace records
Components 26
Accounts and access
- Accounts and roles
backend/core/accounts - Account records
backend/core/accounts/models.py
Marketplace
- Marketplace APIs
backend/core/api/views.py - Marketplace records
backend/core/api/models.py - Inventory services
backend/core/modules/marketplace/services/inventory.py - Inventory records sync
backend/core/modules/marketplace/services/inventory_records.py - Order fulfillment
backend/core/modules/marketplace/services/fulfillment.py
Facilities and services
- Facility workflows
backend/core/modules/facilities - Facility and booking records
backend/core/api/models.py - Service configuration
backend/core/modules/facilities/services/service_configuration.py - Service catalog
backend/core/modules/facilities/services/catalog.py - Operating schedules
backend/core/modules/facilities/services/operating_schedule.py - Rental configuration
backend/core/modules/facilities/services/rental_configuration.py - Reports and analytics
backend/core/modules/reports
Messaging
- Chat service
backend/chat_service/app/main.py - Chat authentication
backend/chat_service/app/auth.py - Conversation routes
backend/chat_service/app/routers/conversations.py - Realtime routes
backend/chat_service/app/routers/websocket.py - Presence routes
backend/chat_service/app/routers/presence.py - Conversation logic
backend/chat_service/app/services.py - Chat database
backend/chat_service/app/database.py - Realtime connections
backend/chat_service/app/realtime.py
Other components
- Campus users
- Django application
backend/core/core/urls.py - Chat clients
- Firebase messaging
Connections 30
- Campus users → Django application: uses
- Django application → Accounts and roles: handles accounts
- Accounts and roles → Account records: manages
backend/core/accounts/models.py - Django application → Marketplace APIs: routes requests
- Marketplace APIs → Marketplace records: uses records
backend/core/api/views.py - Marketplace records → Inventory records sync: syncs inventory
backend/core/api/models.py - Inventory services → Marketplace records: reads and updates
backend/core/modules/marketplace/services/inventory.py - Marketplace APIs → Order fulfillment: uses fulfillment
backend/core/api/views.py - Order fulfillment → Marketplace records: updates orders
backend/core/modules/marketplace/services/fulfillment.py - Django application → Facility workflows: serves bookings
- Facility workflows → Facility and booking records: uses records
backend/core/modules/facilities/mobile_services.py - Service configuration → Service catalog: uses labels
backend/core/modules/facilities/services/service_configuration.py - Service configuration → Operating schedules: validates hours
backend/core/modules/facilities/services/service_configuration.py - Service configuration → Rental configuration: uses configuration
backend/core/modules/facilities/services/service_configuration.py - Django application → Reports and analytics: provides reporting
- Chat clients → Chat service: connects
- Chat service → Conversation routes: registers routes
backend/chat_service/app/main.py - Chat service → Realtime routes: registers routes
backend/chat_service/app/main.py - Chat service → Presence routes: registers routes
backend/chat_service/app/main.py - Conversation routes → Chat authentication: authenticates
backend/chat_service/app/routers/conversations.py - Conversation routes → Conversation logic: calls logic
backend/chat_service/app/routers/conversations.py - Conversation routes → Chat database: uses session
backend/chat_service/app/routers/conversations.py - Conversation routes → Realtime connections: broadcasts events
backend/chat_service/app/routers/conversations.py - Realtime routes → Chat authentication: decodes token
backend/chat_service/app/routers/websocket.py - Realtime routes → Conversation logic: calls logic
backend/chat_service/app/routers/websocket.py - Realtime routes → Chat database: opens session
backend/chat_service/app/routers/websocket.py - Realtime routes → Realtime connections: broadcasts events
backend/chat_service/app/routers/websocket.py - Presence routes → Chat authentication: authenticates
backend/chat_service/app/routers/presence.py - Presence routes → Realtime connections: uses connections
backend/chat_service/app/routers/presence.py - Marketplace records → Firebase messaging: queues review pushes
backend/core/api/models.py