Skip to main content

Supply Routes

🎯 Overview​

Each supply 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 for supplier accounts

βœ… Validators: None (public route)

Login​

🌐 URL: /login
πŸ“„ Current Page: login

πŸ”§ Handler: handleAuthLoginRoute

  • Captures intended URL from query parameters
  • Sets up login form state for suppliers
  • Handles post-login redirects to supplier dashboard

βœ… Validators: isUserNotLoggedIn

  • Redirects already authenticated users away from login

Logout​

🌐 URL: /logout
πŸ“„ Current Page: logout

πŸ”§ Handler: handleAuthLogoutRoute

  • Clears supplier 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 supplier dashboard overview
  • Displays key metrics and recent activity
  • Shows job postings and application analytics

βœ… Validators: isUserNotLoggedIn

  • Ensures only authenticated suppliers access dashboard

🏒 Organization Management Routes​

My Organization​

🌐 URL: /my-organization
πŸ“„ Current Page: organization_show_supply

πŸ”§ Handler: handleMyOrganizationSupplyRoute

  • Shows detailed view of supplier's own organization
  • Displays company profile and settings
  • Enables organization data management

βœ… Validators:

  • isUserLoggedIn - Validates authentication
  • updateLoggedInUser - Refreshes current user data
  • selectTenantFromOrganizationValidator - Ensures proper tenant context
  • isOrganizationActiveValidator - Validates organization status

Organization Sign Up​

🌐 URL: /organization/sign-up
πŸ“„ Current Page: organization_signup

πŸ”§ Handler: handleOrganizationSignUpRoute

  • Organization registration form for new suppliers
  • Collects company information and setup data
  • Initiates organization onboarding process

βœ… Validators: scrollTo (scroll to top)

Organization Sign Up Complete​

🌐 URL: /organization/sign-up-complete
πŸ“„ Current Page: organization_signup_complete

πŸ”§ Handler: handleOrganizationSignUpCompleteRoute

  • Confirmation page after organization registration
  • Displays next steps for new organizations
  • Provides access to organization dashboard

βœ… Validators: scrollTo (scroll to top)

Organization Update​

🌐 URL: /organization/:orgId/edit
πŸ“„ Current Page: organization_update

πŸ”§ Handler: handleOrganizationUpdateRoute

  • Organization profile editing interface
  • Updates company information and settings
  • Manages organization details and branding

βœ… Validators:

  • isUserLoggedIn - Validates authentication
  • updateLoggedInUser - Refreshes current user data
  • selectTenantFromOrganizationValidator - Ensures proper tenant context
  • isOrganizationActiveValidator - Validates organization status

Organization Registration​

🌐 URL: /organization/registration
πŸ“„ Current Page: organization_registration

πŸ”§ Handler: handleOrganizationRegistrationRoute

  • Organization registration process
  • Handles organization setup and verification
  • Manages registration workflow

βœ… Validators:

  • isUserLoggedIn - Validates authentication
  • updateLoggedInUser - Refreshes current user data
  • selectTenantFromOrganizationValidator - Ensures proper tenant context

πŸ’Ό Product/Job Management Routes​

Products List​

🌐 URL: /products
πŸ“„ Current Page: supply_products_list

πŸ”§ Handler: handleSupplyProductsListRoute

  • Lists all job positions created by the organization
  • Shows product/job posting management interface
  • Displays posting status and application metrics

βœ… Validators:

  • isUserLoggedIn - Validates authentication
  • updateLoggedInUser - Refreshes current user data
  • selectTenantFromOrganizationValidator - Ensures proper tenant context
  • isOrganizationActiveValidator - Validates organization status

Product Details​

🌐 URL: /products/:productId
πŸ“„ Current Page: supply_product

πŸ”§ Handler: handleSupplyProductByIdRoute

  • Shows detailed view of specific job posting
  • Displays applications and candidate information
  • Enables job posting management

βœ… Validators:

  • isUserLoggedIn - Validates authentication
  • updateLoggedInUser - Refreshes current user data
  • selectTenantFromOrganizationValidator - Ensures proper tenant context
  • isOrganizationActiveValidator - Validates organization status

Create Product​

🌐 URL: /products/create
πŸ“„ Current Page: supply_product_create

πŸ”§ Handler: handleSupplyProductCreateRoute

  • Job posting creation form
  • Sets up new job position with requirements
  • Configures posting settings and visibility

βœ… Validators:

  • isUserLoggedIn - Validates authentication
  • updateLoggedInUser - Refreshes current user data
  • selectTenantFromOrganizationValidator - Ensures proper tenant context
  • isOrganizationActiveValidator - Validates organization status

Update Product​

🌐 URL: /products/:productId/update
πŸ“„ Current Page: supply_product_update

πŸ”§ Handler: handleSupplyProductUpdateRoute

  • Job posting editing interface
  • Updates job requirements and descriptions
  • Manages posting status and settings

βœ… Validators:

  • isUserLoggedIn - Validates authentication
  • updateLoggedInUser - Refreshes current user data
  • selectTenantFromOrganizationValidator - Ensures proper tenant context
  • isOrganizationActiveValidator - Validates organization status

πŸ“‹ Application Management Routes​

Applications List​

🌐 URL: /job-applications
πŸ“„ Current Page: orders

πŸ”§ Handler: handleOrderListByOrganizationRoute

  • Lists all applications received by organization
  • Shows application status and candidate information
  • Provides application management tools

βœ… Validators:

  • isUserLoggedIn - Validates authentication
  • updateLoggedInUser - Refreshes current user data
  • selectTenantFromOrganizationValidator - Ensures proper tenant context
  • isOrganizationActiveValidator - Validates organization status

Application Details​

🌐 URL: /job-applications/:orderId
πŸ“„ Current Page: order_by_id

πŸ”§ Handler: handleOrdersByIdRoute

  • Detailed view of specific job application
  • Shows candidate profile and application details
  • Enables application review and response actions

βœ… Validators:

  • isUserLoggedIn - Validates authentication
  • updateLoggedInUser - Refreshes current user data
  • selectTenantFromOrganizationValidator - Ensures proper tenant context
  • isOrganizationActiveValidator - Validates organization status

πŸ‘₯ Team Management Routes​

Members List​

🌐 URL: /members
πŸ“„ Current Page: members_list

πŸ”§ Handler: handleMembersListForSupplyRoute

  • Lists organization team members
  • Shows member roles and permissions
  • Provides team management functionality

βœ… Validators:

  • isUserLoggedIn - Validates authentication
  • updateLoggedInUser - Refreshes current user data
  • selectTenantFromOrganizationValidator - Ensures proper tenant context
  • isOrganizationActiveValidator - Validates organization status

πŸ’¬ Messaging Routes​

Messages​

🌐 URL: /messages
πŸ“„ Current Page: topics_and_messages_list

πŸ”§ Handler: handleTopicsAndMessagesListRoute

  • Organization messaging interface
  • Shows conversations with candidates
  • Enables communication management

βœ… Validators:

  • isUserLoggedIn - Validates authentication
  • updateLoggedInUser - Refreshes current user data
  • selectTenantFromOrganizationValidator - Ensures proper tenant context
  • isOrganizationActiveValidator - Validates organization status

πŸ’³ Payment & Billing Routes​

Payment Required​

🌐 URL: /payment-required
πŸ“„ Current Page: payment_required

πŸ”§ Handler: handlePaymentRequiredRoute

  • Payment setup page for organizations
  • Shows billing requirements and plans
  • Handles payment method configuration

βœ… Validators: scrollTo (scroll to top)

Invoices​

🌐 URL: /invoices
πŸ“„ Current Page: invoices

πŸ”§ Handler: handleInvoicesRoute

  • Organization billing and invoice history
  • Shows payment records and receipts
  • Manages billing information

βœ… Validators:

  • isUserLoggedIn - Validates authentication
  • updateLoggedInUser - Refreshes current user data
  • selectTenantFromOrganizationValidator - Ensures proper tenant context
  • isOrganizationActiveValidator - Validates organization status

βš™οΈ Settings Routes​

Main Settings​

🌐 URL: /settings
πŸ“„ Current Page: user_settings

πŸ”§ Handler: handleSettingsRoute

  • User account settings for suppliers
  • Personal profile management
  • Account preferences and security

βœ… Validators:

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

Change Email​

🌐 URL: /settings/change-email
πŸ“„ Current Page: change_email_settings

πŸ”§ Handler: handleSettingsChangeEmailRoute

  • Email address update for supplier accounts
  • Initiates email verification process
  • Handles email change workflow

βœ… Validators:

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

Change Name​

🌐 URL: /settings/change-name
πŸ“„ Current Page: change_name_settings

πŸ”§ Handler: handleSettingsChangeNameRoute

  • Name update functionality
  • Updates user display name
  • Handles profile name changes

βœ… Validators:

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

Change Password​

🌐 URL: /settings/change-password
πŸ“„ Current Page: change_password_settings

πŸ”§ Handler: handleSettingsChangePasswordRoute

  • Secure password update interface
  • Validates current password
  • Implements password security requirements

βœ… 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

  • Phone number update functionality
  • Validates phone number format
  • Updates contact information

βœ… Validators:

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

Payment Settings​

🌐 URL: /settings/payment
πŸ“„ Current Page: settings_payment

πŸ”§ Handler: handleSettingsPaymentRoute

  • Organization payment and billing settings
  • Manages payment methods and plans
  • Handles subscription management

βœ… Validators:

  • isUserLoggedIn - Validates authentication
  • updateLoggedInUser - Refreshes current user data
  • selectTenantFromOrganizationValidator - Ensures proper tenant context
  • isOrganizationActiveValidator - Validates organization status

Verify Email Change Success​

🌐 URL: /settings/verify-change-email-success/:verifyChangeEmailToken
πŸ“„ Current Page: verify_change_email_success

πŸ”§ Handler: handleSettingsVerifyChangeEmailSuccessRoute

  • Confirms email address change for suppliers
  • Processes email verification tokens
  • Updates 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

  • Password reset request for supplier accounts
  • Initiates password recovery email
  • Validates supplier account existence

βœ… Validators: None (public route)

Submit New Password​

🌐 URL: /reset-password-submit/:resetPasswordToken
πŸ“„ Current Page: reset_password_submit

πŸ”§ Handler: handleResetPasswordSubmitRoute

  • New password submission form
  • Validates reset tokens from URL
  • Processes password reset completion

βœ… Validators: scrollTo (scroll to top)

Password Reset Success​

🌐 URL: /reset-password-success
πŸ“„ Current Page: reset_password_success

πŸ”§ Handler: handleResetPasswordSuccessRoute

  • Password reset confirmation page
  • Provides login redirect options
  • Clears reset session data

βœ… Validators: scrollTo (scroll to top)

πŸ”§ Validator Functions Reference​

ValidatorPurpose
isUserLoggedInβœ… Validates authentication, redirects to login if needed
isUserNotLoggedInβ†ͺ️ Redirects authenticated users from login/signup pages
updateLoggedInUserπŸ”„ Refreshes current user data from API
selectTenantFromOrganizationValidator🏒 Ensures proper organization tenant context
isOrganizationActiveValidatorβœ… Validates organization active status
scrollTo⬆️ Scrolls page to top on route navigation

🎨 Route Flow Pattern​

🌐 URL Request β†’ βœ… Validators β†’ πŸ”§ Handler β†’ πŸ“Š State Update β†’ 🎯 Page Render

Supply routes are optimized for employers with organization management, team collaboration, and advanced payment processing capabilities.