How gaikawadaprasad/gatesphere works
GateSphere is a multi-tenant residential community operations platform, with role-specific web experiences backed by a FastAPI service. A typical workflow starts when a resident, guard, or administrator uses a role-based page to request an operation; the API routes it to a domain service, which enforces community scope and updates application data. The documented product also covers billing, communications, amenities, staff, deliveries, dashboards, and audit. Domain modules and several integrations are clear from the tree and README; detailed wiring for unsampled modules is therefore shown only at the application boundary.
Main entry points: router.py API router · session.py Application database · main.py FastAPI application · app Role-based web app
Components 25
Web experience
- Role-based web app
frontend/app - API client
frontend/lib/api.ts
API and access
- FastAPI application
backend/app/main.py - API router
backend/app/api/router.py - Authentication
backend/app/modules/auth - Roles and permissions
backend/app/modules/rbac
Community operations
- Tenant onboarding
backend/app/modules/onboarding - Residents and units
backend/app/modules/residents - Visitor lifecycle
backend/app/modules/visitors - Gate operations
backend/app/modules/gate - Domestic staff
backend/app/modules/domestic_staff - Deliveries and vehicles
backend/app/modules/deliveries - Facilities and complaints
backend/app/modules/amenities - Incidents and emergencies
backend/app/modules/incidents
Finance and oversight
- Maintenance billing
backend/app/modules/billing - Announcements and polls
backend/app/modules/communication - Dashboards and reporting
backend/app/modules/dashboards - Audit trail
backend/app/modules/audit
Shared platform
- Application database
backend/app/db/session.py - Upload handling
backend/app/modules/uploads - S3-compatible storage
backend/app/services/storage.py - Notifications
backend/app/modules/notifications - Background jobs
backend/app/core/celery_app.py - Redis
backend/app/core/redis.py
Other components
- Community users
Connections 26
- Community users → Role-based web app: uses
- Role-based web app → API client: requests data
- API client → FastAPI application: sends API requests
- FastAPI application → API router: dispatches routes
- API router → Authentication: routes auth
- API router → Roles and permissions: routes access
- API router → Tenant onboarding: routes onboarding
- API router → Residents and units: routes resident operations
- API router → Visitor lifecycle: routes visitor operations
- API router → Gate operations: routes gate operations
- API router → Domestic staff: routes staff operations
- API router → Deliveries and vehicles: routes deliveries
- API router → Facilities and complaints: routes facility operations
- API router → Incidents and emergencies: routes incidents
- API router → Maintenance billing: routes billing
- API router → Announcements and polls: routes communication
- API router → Dashboards and reporting: routes dashboards
- API router → Audit trail: routes audit queries
- Upload handling → S3-compatible storage: stores objects
- Announcements and polls → Background jobs: queues broadcast work
- Background jobs → Notifications: dispatches notification work
- Audit trail → Application database: reads audit data
- Dashboards and reporting → Application database: reads operational data
- Visitor lifecycle → Application database: persists visitor records
- Maintenance billing → Application database: persists invoices and payments
- FastAPI application → Redis: checks readiness