How ahmedalbadry1/saraha-app works
This is an Express API for account authentication and user profiles. Clients sign up, verify email through an OTP, and log in with credentials or Google; authenticated requests can rotate tokens or access and update profiles. The sampled code shows controllers delegating to services, which use shared security utilities and repositories. The README is empty, so capabilities are based on the sampled source; database and mail transport details are not fully shown.
Main entry points: auth.service.js Auth service · main.js Express app · user.repo.js User repository · auth.controller.js Auth routes
Components 21
API runtime
- Express app
src/main.js
Identity flows
- Auth routes
src/modules/auth/auth.controller.js - Auth validation
src/modules/auth/auth.validation.js - Auth service
src/modules/auth/auth.service.js
User profiles
- User routes
src/modules/user/user.controller.js - User service
src/modules/user/user.service.js
Shared services
- Authentication
src/common/middleware/authntication.js - Role authorization
src/common/middleware/authorization.js - Request middleware
src/common/middleware - Tokens and crypto
src/common/security - Errors and responses
src/common/utils - Email sender
src/common/email/nodemailer.js - Configuration
src/config/config.service.js
Persistence
- DB connection
src/DB/connection.js - User repository
src/DB/repo/user.repo.js - Message repository
src/DB/repo/message.repo.js - Repository operations
src/DB/repo/base.repo.js - User model
src/DB/model/user.model.js - OTP message model
src/DB/model/message.model.js
Other components
- API client
- Google identity
Connections 27
- API client → Express app: sends requests
src/main.js - Express app → DB connection: connects database
src/main.js - Express app → Auth routes: mounts /auth
src/main.js - Express app → User routes: mounts /user
src/main.js - Express app → Request middleware: handles errors
src/main.js - Auth routes → Auth validation: validates input
src/modules/auth/auth.controller.js - Auth routes → Auth service: dispatches auth
src/modules/auth/auth.controller.js - Auth routes → Authentication: guards token routes
src/modules/auth/auth.controller.js - User routes → User service: dispatches profile
src/modules/user/user.controller.js - User routes → Authentication: authenticates requests
src/modules/user/user.controller.js - User routes → Role authorization: checks role
src/modules/user/user.controller.js - Auth service → User repository: reads and writes users
src/modules/auth/auth.service.js - Auth service → Message repository: manages OTP records
src/modules/auth/auth.service.js - Auth service → Tokens and crypto: hashes and issues tokens
src/modules/auth/auth.service.js - Auth service → Email sender: sends verification email
src/modules/auth/auth.service.js - Auth service → Configuration: reads auth settings
src/modules/auth/auth.service.js - Auth service → Google identity: verifies Google identity
src/modules/auth/auth.service.js - User service → User repository: reads and updates users
src/modules/user/user.service.js - User service → Tokens and crypto: encrypts profile phone
src/modules/user/user.service.js - Authentication → User repository: loads authenticated user
src/common/middleware/authntication.js - Authentication → Tokens and crypto: verifies token
src/common/middleware/authntication.js - User repository → Repository operations: uses repository operations
src/DB/repo/user.repo.js - Message repository → Repository operations: uses repository operations
src/DB/repo/message.repo.js - User repository → User model: queries model
src/DB/repo/user.repo.js - Message repository → OTP message model: queries model
src/DB/repo/message.repo.js - DB connection → Configuration: reads DB settings
src/DB/connection.js - Email sender → Configuration: reads mail settings
src/common/email/nodemailer.js