User Story #667
Updated by Islam Mansoori about 1 month ago
As a Business # Partner (Travel Agent), Approval I want ## Objective Allow Super Admins to register my review and approve business account and know the approval status, So that I understand when I can start accessing partners before they receive B2B pricing and partner features. --- # Business Background Partner accounts are different from customer accounts. Every partner registration must be reviewed Partners register using a corporate email address and approved by a Super Admin before the account becomes active. Until approval, the partner must not have only gain access to any B2B functionality. after approval. --- # ## Functional Requirements ## ### 1. Partner Registration Confirmation Pending Approval After a partner successfully submits the registration form, display the following confirmation screen. registration, **Message** Display: > Your partner **Your registration has been submitted successfully. > Our team will review your application and for approval. We'll notify you once it your account has been approved. reviewed.** Display a button **Return to Login** --- ## ### 2. Pending Approval Login Status If a partner attempts to log in while their application is still under review, Possible statuses: Do not allow access. Display > Your partner account is currently under review. > You will receive a notification once your application has been approved. Buttons - Return to Login Pending - Contact Support Approved - Rejected --- ## ### 3. Approved Partner Pending Access Once approved, While approval is pending, The partner shall be able to log in normally. not have access to: After login, Display the Partner Dashboard. The navigation shall include - B2B Packages Pricing - Partner Quotes Dashboard - B2B Pricing --- ## 4. Rejected Application If the partner application has been rejected, Display > Unfortunately, your partner application was not approved. > Please contact our support team if you believe this is incorrect. Buttons - Contact Support - Return to Login --- ## 5. Suspended Partner Features If an approved partner is later suspended, Display: Display > Your **Your partner account has been temporarily suspended. > Please contact our support team for further assistance. Do not allow login. --- ## 6. Corporate Email Validation If the email address entered is not a business email address, awaiting approval.** Display > Please register using your official business email address. The registration cannot continue until a valid business email is provided. --- ## 7. Duplicate Registration If the business has already registered, Display > A partner account already exists for this business email address. Display button **Sign In** --- ## 8. Approval Status Display If the partner is signed in after approval, The profile page shall display Partner Status ### 4. Approved --- When approved, # User Messages Display: Pending Approval > **Congratulations! Your partner account is currently under review. Approved > Welcome to Halal Travels Club Partner Portal. Rejected > Unfortunately, your partner application was not approved. Suspended > Your partner account has been temporarily suspended. approved.** Duplicate > A partner account already exists for this business email address. --- # Acceptance Criteria ### Scenario 1 Given a new partner registers, When registration is completed, Then a confirmation message is displayed and the account remains pending approval. --- ### Scenario 2 Given a partner is pending approval, When attempting to log in, Then login is prevented and the pending approval message is displayed. --- ### Scenario 3 Given a partner has been approved, When logging in, Then the Partner Dashboard is displayed with B2B features. --- ### Scenario 4 Given a partner application has been rejected, When logging in, Then access is denied and the rejection message is displayed. --- ### Scenario 5 Given a suspended partner, When attempting to log in, Then access is denied with the suspension message. --- ## In Scope - Registration confirmation - Approval status screens - Approval messages - Partner dashboard visibility - Login restrictions --- ## Out of Scope - Admin approval actions - B2B pricing management - Partner profile management --- # Backend User Story (BE) ## Story Overview **Story ID:** AUTH-BE-PA-001 **Title:** Partner Approval Workflow **Epic:** Authentication & User Management **Sub Feature:** Partner Approval --- # Objective As the platform, I need to control the approval status of partner accounts, So that only approved business partners can access B2B pricing and partner functionality. --- # Business Rules Every partner registration shall begin with the status: **Pending Approval** Partner accounts cannot access B2B features until approved by a Super Admin. --- # Functional Requirements ## 1. Initial Status When a partner account is created, The system shall automatically assign the status Pending Approval. --- ## 2. Approval When a Super Admin approves the partner, The status shall become Approved. The partner shall immediately become eligible receive access to access: - Partner Dashboard - B2B Pricing - Partner Quotes features. --- ## 3. Rejection ### 5. Rejected When a Super Admin rejects the application, Display: The status shall become Rejected. The partner shall not be permitted to log in. Display > Unfortunately, your **Your partner application was not approved. Please contact our team for further assistance.** --- ## 4. Suspension A Super Admin may suspend an approved partner. When suspended, The partner shall no longer be able to access the platform. Display > Your partner account has been temporarily suspended. --- ## 5. ### 6. Duplicate Business Email Partner Registration If another registration is attempted using an existing partner business email, Display: The registration shall not be created. Display > A **A partner account already exists for this business email address. address.** --- ## 6. Corporate Email Requirement Partner registration shall only be accepted using an official business email address. If the requirement is not met, Display > Please register using your official business email address. --- ## 7. Status Changes Whenever a partner status changes, The latest status shall be applied immediately. If the partner is currently signed in, The updated status shall take effect the next time they access the platform. --- ## 8. Invalid Status If an account contains an unknown approval status, The partner shall not be granted access. Display > Your account status could not be verified. Please contact support. --- # Approval Statuses Supported statuses - Pending Approval - Approved - Rejected - Suspended No other status values shall be permitted. --- # Acceptance Criteria ### Scenario 1 Given a new partner registers, When registration completes, Then the account status becomes Pending Approval. --- ### Scenario 2 Given a pending partner, When attempting to log in, Then - Partners cannot access is denied. --- ### Scenario 3 Given an approved partner, When logging in, Then access is granted. --- ### Scenario 4 Given a rejected partner, When logging in, Then access is denied. --- ### Scenario 5 Given a suspended partner, When logging in, Then access is denied. --- ### Scenario 6 Given a duplicate business email, When registration is submitted, Then the registration is rejected with the duplicate account message. --- ## In Scope - Partner approval lifecycle B2B features until approved. - Partner status management Status is clearly communicated. - Login authorization - Corporate email validation - Duplicate Approval immediately enables partner prevention --- ## Out of Scope - Partner pricing configuration - Partner package management - Partner reporting - Super Admin permission management access.