Admin Routes

🎯 Overview

Each admin route follows: URL → Validators → Handler → State Update

---

🔐 Authentication Routes

Accept Invitation

🌐 URL: /auth/accept-invitation/:invitationId/:token
📄 Current Page: accept_invitation

🔧 Handler: handleAcceptInvitation

• Processes invitation tokens from URL parameters
• Validates invitation ID and token
• Accepts organization invitations

✅ Validators: None (public route)

---

Login

🌐 URL: /login
📄 Current Page: login

🔧 Handler: handleAuthLoginRoute

• Captures intended URL from query parameters
• Sets up login form state
• Handles post-login redirects

✅ Validators: isUserNotLoggedIn

• Redirects already authenticated users away from login

---

Logout

🌐 URL: /logout
📄 Current Page: logout

🔧 Handler: handleAuthLogoutRoute

• Clears user session and authentication data
• Invalidates auth tokens
• Redirects to login page

✅ Validators: None

---

🏠 Dashboard Routes

Home Dashboard

🌐 URL: /home
📄 Current Page: home

🔧 Handler: handleHomeRoute

• Loads dashboard overview data
• Fetches recent products, categories, and attributes
• Displays admin dashboard with key metrics

✅ Validators: isUserNotLoggedIn

• Ensures only authenticated users access dashboard

---

👥 User Management Routes

Users List

🌐 URL: /users
📄 Current Page: users_list

🔧 Handler: handleUsersListRoute

• Fetches paginated list of all users
• Supports search by name/email
• Loads user pagination data

✅ Validators:

• isUserLoggedIn - Validates authentication
• updateLoggedInUser - Refreshes current user data

---

User Details

🌐 URL: /users/:userId
📄 Current Page: user_show

🔧 Handler: handleUserByIdRoute

• Loads specific user profile details
• Fetches associated categories and attributes
• Displays comprehensive user information

✅ Validators:

• isUserLoggedIn - Validates authentication
• updateLoggedInUser - Refreshes current user data

---

Members List

🌐 URL: /members
📄 Current Page: members_list

🔧 Handler: handleMembersListForAdminRoute

• Lists organization members across all organizations
• Provides admin-level member management
• Loads member pagination data

✅ Validators:

• isUserLoggedIn - Validates authentication
• updateLoggedInUser - Refreshes current user data

---

🏢 Organization Management Routes

Organizations List

🌐 URL: /organizations
📄 Current Page: organization_list

🔧 Handler: handleOrganizationListRoute

• Fetches all organizations with pagination
• Orders by creation date (newest first)
• Displays organization overview data

✅ Validators:

• isUserLoggedIn - Validates authentication
• updateLoggedInUser - Refreshes current user data

---

Organization Details

🌐 URL: /organizations/:orgId
📄 Current Page: organization_show_admin

🔧 Handler: handleSingleOrganizationAdminRoute

• Loads detailed organization information
• Provides admin view of organization data
• Enables organization management actions

✅ Validators:

• isUserLoggedIn - Validates authentication
• updateLoggedInUser - Refreshes current user data

---

Organization Applications List

🌐 URL: /applications
📄 Current Page: organization_applications_list

🔧 Handler: handleOrganizationApplicationsListRoute

• Lists organization applications with status filtering
• Supports filtering by review status (waiting_for_review, all, etc.)
• Loads application pagination data

✅ Validators:

• isUserLoggedIn - Validates authentication
• updateLoggedInUser - Refreshes current user data

---

Organization Application Details

🌐 URL: /applications/:applicationId
📄 Current Page: organization_application_show_admin

🔧 Handler: handleSingleOrganizationApplicationAdminRoute

• Shows detailed view of organization application
• Enables admin review and approval actions
• Loads application-specific data

✅ Validators:

• isUserLoggedIn - Validates authentication
• updateLoggedInUser - Refreshes current user data

---

⚙️ Settings Routes

Main Settings

🌐 URL: /settings
📄 Current Page: user_settings

🔧 Handler: handleSettingsRoute

• Loads current user settings data
• Displays user profile information
• Provides access to setting modification options

✅ Validators:

• isUserLoggedIn - Validates authentication
• updateLoggedInUser - Refreshes current user data

---

Change Email

🌐 URL: /settings/change-email
📄 Current Page: change_email_settings

🔧 Handler: handleSettingsChangeEmailRoute

• Loads email change form
• Handles email update requests
• Initiates email verification process

✅ Validators:

• isUserLoggedIn - Validates authentication
• updateLoggedInUser - Refreshes current user data

---

Change Name

🌐 URL: /settings/change-name
📄 Current Page: change_name_settings

🔧 Handler: handleSettingsChangeNameRoute

• Provides name update functionality
• Loads current user name data
• Handles name change submissions

✅ Validators:

• isUserLoggedIn - Validates authentication
• updateLoggedInUser - Refreshes current user data

---

Change Password

🌐 URL: /settings/change-password
📄 Current Page: change_password_settings

🔧 Handler: handleSettingsChangePasswordRoute

• Provides secure password update form
• Validates current password
• Handles new password submission

✅ Validators:

• isUserLoggedIn - Validates authentication
• updateLoggedInUser - Refreshes current user data

---

Change Phone Number

🌐 URL: /settings/change-phone-number
📄 Current Page: change_phone_number_settings

🔧 Handler: handleSettingsChangePhoneNumberRoute

• Enables phone number updates
• Validates phone number format
• Updates user contact information

✅ Validators:

• isUserLoggedIn - Validates authentication
• updateLoggedInUser - Refreshes current user data

---

Verify Email Change

🌐 URL: /settings/verify-change-email-success/:verifyChangeEmailToken
📄 Current Page: verify_change_email_success

🔧 Handler: handleSettingsVerifyChangeEmailSuccessRoute

• Processes email verification tokens
• Confirms email address changes
• Updates user email verification status

✅ Validators:

• isUserLoggedIn - Validates authentication
• updateLoggedInUser - Refreshes current user data

---

🔑 Password Reset Routes

Request Password Reset

🌐 URL: /reset-password-request
📄 Current Page: reset_password_request

🔧 Handler: handleResetPasswordRequestRoute

• Provides password reset request form
• Initiates password reset email
• Sets up reset token generation

✅ Validators: None (public route)

---

Submit New Password

🌐 URL: /reset-password-submit/:resetPasswordToken
📄 Current Page: reset_password_submit

🔧 Handler: handleResetPasswordSubmitRoute

• Validates reset tokens from URL
• Provides new password submission form
• Processes password reset completion

✅ Validators: scrollTo (scroll to top)

---

Password Reset Success

🌐 URL: /reset-password-success
📄 Current Page: reset_password_success

🔧 Handler: handleResetPasswordSuccessRoute

• Displays password reset confirmation
• Provides login redirect options
• Clears reset tokens

✅ Validators: scrollTo (scroll to top)

---

🔧 Validator Functions Reference

Validator	Purpose
isUserLoggedIn	✅ Validates authentication, redirects to login if needed
isUserNotLoggedIn	↪️ Redirects authenticated users from login/signup pages
updateLoggedInUser	🔄 Refreshes current user data from API
scrollTo	⬆️ Scrolls page to top on route navigation

---

🎨 Route Flow Pattern

🌐 URL Request → ✅ Validators → 🔧 Handler → 📊 State Update → 🎯 Page Render

Every admin route follows this consistent pattern for reliability and maintainability.