How bhumika2906/sams works
SAMS is an Expo mobile admission app backed by an Express API and MongoDB. Applicants register and verify accounts, complete and submit applications, respond to seat offers, pay admission fees, and receive a checklist and QR pass; faculty verify checklist items, while administrators manage rounds and allotment and management views statistics. The graph preserves these documented capabilities. Sampled route excerpts show parts of application, allotment, payment, and verification behavior; some other feature links are documented in the README rather than verified in source excerpts.
Main entry points: client.ts API client · models Admission records · app.ts Express API · allotment.service.ts Merit allotment
Components 24
Mobile app
- Sign-in and registration
mobile/app/(auth)/login.tsx - Application and admission
mobile/app/(applicant)/application.tsx - Round and allotment tools
mobile/app/(admin)/allotment.tsx - Scan and checklist
mobile/app/(faculty)/checklist.tsx - Management dashboard
mobile/app/(management)/index.tsx - Session state
mobile/src/context/AuthContext.tsx - API client
mobile/src/api/client.ts - Token storage
mobile/src/storage/token.ts
API and access
- Express API
server/src/app.ts - Authentication
server/src/routes/auth.routes.ts
Admission lifecycle
- Application workflow
server/src/routes/application.routes.ts - Rounds and allotment
server/src/routes/round.routes.ts - Merit allotment
server/src/services/allotment.service.ts - Admission records
server/src/models
Verification and oversight
- Payment and verification
server/src/routes/payment-verify.routes.ts - Management statistics
server/src/routes/management.routes.ts - Notifications
server/src/services/notification.service.ts
Shared domain
- Domain types and rules
shared/src/enums.ts
Other components
- Applicants
- Faculty verifiers
- Administrators
- Management
- MongoDB
- Local upload storage
Connections 34
- Applicants → Sign-in and registration: starts session
- Applicants → Application and admission: manages application
- Administrators → Round and allotment tools: manages rounds
- Faculty verifiers → Scan and checklist: verifies checklist
- Management → Management dashboard: views statistics
- Sign-in and registration → Session state: uses session
mobile/app/(auth)/login.tsx - Application and admission → API client: calls API
mobile/app/(applicant)/application.tsx - Round and allotment tools → API client: calls API
mobile/app/(admin)/allotment.tsx - Scan and checklist → API client: calls API
mobile/app/(faculty)/checklist.tsx - Management dashboard → API client: calls API
mobile/app/(management)/index.tsx - Session state → API client: sends auth requests
mobile/src/context/AuthContext.tsx - Session state → Token storage: persists session
mobile/src/context/AuthContext.tsx - API client → Token storage: reads bearer token
mobile/src/api/client.ts - API client → Express API: sends HTTP requests
- Express API → Authentication: mounts routes
server/src/app.ts - Express API → Application workflow: mounts routes
server/src/app.ts - Express API → Rounds and allotment: mounts routes
server/src/app.ts - Express API → Payment and verification: mounts routes
server/src/app.ts - Express API → Management statistics: mounts routes
server/src/app.ts - Authentication → Notifications: sends notifications
server/src/routes/auth.routes.ts - Application workflow → Merit allotment: resolves progress
server/src/routes/application.routes.ts - Rounds and allotment → Merit allotment: runs allocation
server/src/routes/round.routes.ts - Management statistics → Merit allotment: uses allocation
server/src/routes/management.routes.ts - Application workflow → Admission records: reads and writes
server/src/routes/application.routes.ts - Rounds and allotment → Admission records: reads and writes
server/src/routes/round.routes.ts - Payment and verification → Admission records: records payments
server/src/routes/payment-verify.routes.ts - Authentication → Admission records: reads and writes users
server/src/routes/auth.routes.ts - Merit allotment → Admission records: updates allotments
server/src/services/allotment.service.ts - Notifications → Admission records: stores notifications
server/src/services/notification.service.ts - Admission records → MongoDB: persists records
- Application workflow → Local upload storage: stores documents
- Authentication → Domain types and rules: uses shared contracts
server/src/routes/auth.routes.ts - Merit allotment → Domain types and rules: uses admission states
server/src/services/allotment.service.ts - Payment and verification → Domain types and rules: uses verification states
server/src/routes/payment-verify.routes.ts