How abolfazlabdollahii/collegegram works
Collegegram is a social-networking application: people register and verify accounts, then create and discover posts, interact with other users, and receive notifications. The web client exposes authenticated profile, post, search, explore, saved-post, friendship, and notification screens; the API mounts corresponding route families. Sampled controllers show post and user operations delegated to services, while authentication services use repositories and OTP/verification services. The tree documents search indexing and realtime support, but their detailed runtime wiring was not sampled.
Main entry points: app.ts API app · auth.service.ts Auth service · AppRoutes.tsx App routes · user.controller.ts User controller
Components 30
Web client
- Web entry
apps/web/src/main.tsx - App routes
apps/web/src/routes/AppRoutes.tsx - Social screens
apps/web/src/pages - Web API clients
apps/web/src/api - Auth context
apps/web/src/context/AuthProvider.tsx
API application
- API app
apps/api/src/app.ts - Auth routes
apps/api/src/routes/v1/auth.route.ts - User routes
apps/api/src/routes/v1/user.route.ts - Post routes
apps/api/src/routes/v1/post.route.ts - Notification routes
apps/api/src/routes/v1/notification.route.ts - Search routes
apps/api/src/routes/v1/search.route.ts - Close-friend routes
apps/api/src/routes/v1/closeFriend.route.ts - Auth controller
apps/api/src/controllers/auth.controller.ts - User controller
apps/api/src/controllers/user.controller.ts - Post controller
apps/api/src/controllers/post.controller.ts
Social domain
- Auth service
apps/api/src/services/auth.service.ts - User service
apps/api/src/services/user.service.ts - Post service
apps/api/src/services/post.service.ts - Comment service
apps/api/src/services/comment.service.ts - Notification service
apps/api/src/services/notification.service.ts - Search services
apps/api/src/services
Persistence and integrations
- Auth repository
apps/api/src/repositories/auth.repository.ts - Post repository
apps/api/src/repositories/post.repository.ts - User repository
apps/api/src/repositories/user.repository.ts - Mongo models
apps/api/src/db/models
Other components
- User
- Elasticsearch
- Redis
- Email provider
- Socket clients
Connections 31
- User → Web entry: uses
- Web entry → App routes: renders
- App routes → Social screens: selects
- App routes → Auth context: protects
- Social screens → Web API clients: requests
- Web API clients → API app: HTTP calls
- API app → Auth routes: mounts
- API app → User routes: mounts
- API app → Post routes: mounts
- API app → Notification routes: mounts
- API app → Search routes: mounts
- API app → Close-friend routes: mounts
- Auth routes → Auth controller: routes to
- User routes → User controller: routes to
- Post routes → Post controller: routes to
- Auth controller → Auth service: delegates
- Auth service → Auth repository: queries
- Auth repository → Mongo models: reads/writes
- User controller → User service: delegates
- User controller → Post service: delegates
- Post controller → Post service: delegates
- Post controller → Comment service: delegates
- Post service → Post repository: uses
- Post repository → Mongo models: reads/writes
- User service → User repository: uses
- User repository → Mongo models: reads/writes
- Auth service → Email provider: sends mail
- Auth service → Elasticsearch: indexes
- Search services → Elasticsearch: searches
- Notification service → Socket clients: notifies
- Notification service → Redis: uses