How anindya357/unicircle works
UniCircle is a CUET digital-campus platform. Its user-facing scope spans campus discovery, identity, community, clubs and events, news, transport, resource sharing, notifications, and an AI assistant. The backend exposes feature APIs through a central router and persists domain data through SQLAlchemy/PostgreSQL; the frontend provides corresponding feature experiences. The README describes some capabilities as planned, and unsampled module internals are represented at their existing directory paths. Edges are limited to relationships visible in the README or SOURCE INDEX; frontend-to-backend wiring is not asserted.
Main entry points: api/router.py API entry router · models.py Campus data models · clubs/router.py Clubs and events · notifications Notifications
Components 32
Web experience
- Campus home
frontend/src/features/home/components/home-page.tsx - Identity experience
frontend/src/features/auth/components/auth-page.tsx - Campus explorer
frontend/src/features/campus-explorer/components/campus-explorer-page.tsx - Clubs and events
frontend/src/features/clubs-events/components/club-event-hub.tsx - Campus directory
frontend/src/features/directory/components/directory-page.tsx - Community forum
frontend/src/features/forum/components/forum-page.tsx - Campus news
frontend/src/features/news/components/news-page.tsx - Transport
frontend/src/features/transport/components/transport-page.tsx - Resource sharing
frontend/src/features/resources/components/resource-hub-page.tsx - AI assistant
frontend/src/features/assistant/components/campus-assistant-page.tsx - Notifications
frontend/src/features/notifications/components/notification-list.tsx
Campus API
- API entry router
backend/app/api/router.py - Authentication
backend/app/modules/auth/router.py - Clubs and events
backend/app/modules/clubs/router.py - Directory
backend/app/modules/directory/router.py - Forum
backend/app/modules/forum/router.py - News publishing
backend/app/modules/news/router.py - Transport
backend/app/modules/transport/router.py - Resource requests
backend/app/modules/resources/router.py - Campus information
backend/app/modules/campus - Assistant and ingestion
backend/app/modules/assistant - Notifications
backend/app/modules/notifications - Administration
backend/app/modules/admin - Knowledge ingestion
backend/app/modules/assistant/ingest.py
Platform services
- Access control
backend/app/core/auth.py - OTP and email
backend/app/core/otp.py - Audit trail
backend/app/core/audit.py
Persistence
- Database sessions
backend/app/db/session.py - Campus data models
backend/app/db/models.py
Other components
- Campus user
- PostgreSQL
- CUET source site
Connections 30
- Campus user → Campus home: uses
README.md - API entry router → Authentication: routes to
backend/app/api/router.py - API entry router → Clubs and events: routes to
backend/app/api/router.py - API entry router → Directory: routes to
backend/app/api/router.py - API entry router → Forum: routes to
backend/app/api/router.py - API entry router → News publishing: routes to
backend/app/api/router.py - API entry router → Transport: routes to
backend/app/api/router.py - API entry router → Resource requests: routes to
backend/app/api/router.py - API entry router → Campus information: routes to
backend/app/api/router.py - API entry router → Assistant and ingestion: routes to
backend/app/api/router.py - API entry router → Notifications: routes to
backend/app/api/router.py - API entry router → Administration: routes to
backend/app/api/router.py - Access control → Database sessions: gets sessions
backend/app/core/auth.py - Access control → Authentication: checks identity
backend/app/core/auth.py - OTP and email → Authentication: supports verification
- Clubs and events → Campus data models: reads and writes
backend/app/modules/clubs/router.py - Clubs and events → Database sessions: uses sessions
backend/app/modules/clubs/router.py - Directory → Campus data models: queries
backend/app/modules/directory/router.py - Forum → Campus data models: reads and writes
backend/app/modules/forum/router.py - News publishing → Campus data models: reads and writes
backend/app/modules/news/router.py - Transport → Campus data models: reads and writes
backend/app/modules/transport/router.py - Resource requests → Campus data models: reads and writes
backend/app/modules/resources/router.py - Assistant and ingestion → Campus data models: uses persisted data
backend/app/modules/assistant/ingest.py - Assistant and ingestion → Knowledge ingestion: includes ingestion
backend/app/modules/assistant/ingest.py - Knowledge ingestion → CUET source site: crawls sources
backend/app/modules/assistant/ingest.py - Database sessions → Campus data models: binds sessions
backend/app/db/session.py - Campus data models → PostgreSQL: stores records
README.md - News publishing → Notifications: publishes alerts
backend/app/modules/news/router.py - Clubs and events → Notifications: references repository
backend/app/modules/clubs/router.py - Notifications → Campus data models: uses notification records
backend/app/modules/notifications/repository.py