How muthugopi/authentication works
Authenticate is a React/Express authentication and user-management application. Users navigate the frontend to register, log in, view profiles, and access public messaging or administration features; frontend pages communicate with the backend, whose routes dispatch to controllers and persistence models. The backend also includes role authorization, account promotion, contact/message handling, and activity analytics. The README documents cookie-based sessions and Passport local authentication, while the sampled login flow also issues JWTs; unsampled page/API details are represented only where the README or source index supports them.
Main entry points: App.jsx Router shell · api.js API endpoint config · user.model.mjs User records · index.mjs Express application
Components 31
Frontend experience
- Router shell
frontend/src/App.jsx - Landing
frontend/src/pages/Landing.jsx - Registration
frontend/src/pages/Register.jsx - Login
frontend/src/pages/Login.jsx - Profile
frontend/src/pages/Profile.jsx - Admin panel
frontend/src/pages/AdminPanel.jsx - Admin verification
frontend/src/pages/MakeMeAdmin.jsx - Public messages
frontend/src/pages/PublicMessage.jsx - API endpoint config
frontend/src/config/api.js
HTTP backend
- Express application
backend/src/index.mjs - Auth routes
backend/src/routes/auth.routes.mjs - User routes
backend/src/routes/user.routes.mjs - Public routes
backend/src/routes/public.routes.mjs - Message routes
backend/src/routes/message.routes.mjs - Contact routes
backend/src/routes/contact.routes.mjs - User operations
backend/src/controllers/user.controller.mjs - Message operations
backend/src/controllers/message.controller.mjs - Contact operations
backend/src/controllers/contact.controller.mjs
Identity and roles
- Authentication controller
backend/src/controllers/auth.controller.mjs - Role promotion
backend/src/controllers/makeMeAdmin.controller.mjs - Token authentication
backend/src/middlewares/auth.middleware.mjs - Role authorization
backend/src/middlewares/authorize.middleware.mjs - Local strategy
backend/src/utils/passport.mjs - Password hashing
backend/src/utils/hash.mjs
Persistence and activity
- Activity analytics
backend/src/controllers/logs.controller.mjs - User records
backend/src/models/user.model.mjs - Message records
backend/src/models/message.model.mjs - Contact records
backend/src/models/contact.model.mjs - Activity log
backend/src/models/activityLog.model.mjs - MySQL connection
backend/src/config/db.mjs
Other components
- User
Connections 48
- User → Router shell: uses
frontend/src/App.jsx - Router shell → Landing: routes to
frontend/src/App.jsx - Router shell → Registration: routes to
frontend/src/App.jsx - Router shell → Login: routes to
frontend/src/App.jsx - Router shell → Profile: routes to
frontend/src/App.jsx - Router shell → Admin panel: routes to
frontend/src/App.jsx - Router shell → Admin verification: routes to
frontend/src/App.jsx - Router shell → Public messages: routes to
frontend/src/App.jsx - Landing → API endpoint config: reads config
frontend/src/pages/Landing.jsx - Registration → API endpoint config: reads config
frontend/src/pages/Register.jsx - Login → API endpoint config: reads config
frontend/src/pages/Login.jsx - Profile → API endpoint config: reads config
frontend/src/pages/Profile.jsx - Admin panel → API endpoint config: reads config
frontend/src/pages/AdminPanel.jsx - Admin verification → API endpoint config: reads config
frontend/src/pages/MakeMeAdmin.jsx - Public messages → API endpoint config: reads config
frontend/src/pages/PublicMessage.jsx - API endpoint config → Express application: communicates with
- Express application → Auth routes: mounts
backend/src/index.mjs - Express application → Public routes: mounts
backend/src/index.mjs - Express application → Message routes: mounts
backend/src/index.mjs - Express application → User routes: mounts
backend/src/index.mjs - Express application → Contact routes: mounts
backend/src/index.mjs - Auth routes → Authentication controller: dispatches
backend/src/routes/auth.routes.mjs - Auth routes → Role promotion: dispatches
backend/src/routes/auth.routes.mjs - Auth routes → Role authorization: guards route
backend/src/routes/auth.routes.mjs - User routes → User operations: dispatches
backend/src/routes/user.routes.mjs - User routes → Token authentication: guards route
backend/src/routes/user.routes.mjs - User routes → Role authorization: guards route
backend/src/routes/user.routes.mjs - Public routes → Activity analytics: dispatches
backend/src/routes/public.routes.mjs - Public routes → Role authorization: guards analytics
backend/src/routes/public.routes.mjs - Public routes → User records: counts records
backend/src/routes/public.routes.mjs - Message routes → Message operations: dispatches
backend/src/routes/message.routes.mjs - Contact routes → Contact operations: dispatches
backend/src/routes/contact.routes.mjs - Contact routes → Role authorization: guards route
backend/src/routes/contact.routes.mjs - Authentication controller → Local strategy: authenticates with
backend/src/controllers/auth.controller.mjs - Authentication controller → Password hashing: hashes password
backend/src/controllers/auth.controller.mjs - Authentication controller → User records: reads and writes
backend/src/controllers/auth.controller.mjs - Authentication controller → Activity log: records events
backend/src/controllers/auth.controller.mjs - Role promotion → User records: updates roles
backend/src/controllers/makeMeAdmin.controller.mjs - Local strategy → User records: looks up account
backend/src/utils/passport.mjs - Local strategy → Password hashing: checks password
backend/src/utils/passport.mjs - User operations → User records: manages records
backend/src/controllers/user.controller.mjs - Message operations → Message records: manages records
backend/src/controllers/message.controller.mjs - Contact operations → Contact records: manages records
backend/src/controllers/contact.controller.mjs - Activity analytics → Activity log: reads and writes
backend/src/controllers/logs.controller.mjs - Activity analytics → User records: reads accounts
backend/src/controllers/logs.controller.mjs - User records → MySQL connection: uses connection
backend/src/models/user.model.mjs - Message records → MySQL connection: uses connection
backend/src/models/message.model.mjs - Contact records → MySQL connection: uses connection
backend/src/models/contact.model.mjs