BridgePath QA Test Guide

L-01 — Landing page loads correctly

Verify landing page renders with all key sections

L-02 — School onboarding form submission

A new school submits their intake form

L-03 — Features page accessible

Navigate to the /features page

A-01 — Super Admin login and redirect

User with role=super_admin lands on Super Admin dashboard

A-02 — School Admin login and redirect

User with role=school_admin sees the school dashboard

A-03 — Teacher login redirects to Teacher Portal

User with role=teacher is sent to /portal/teacher

A-04 — Parent portal login via Access ID + PIN

Parent authenticates using their school-issued Access ID

A-05 — First-time parent PIN change

Parent with pin_changed=false is prompted to set a new PIN

A-06 — Suspended parent access is blocked

Parent with access_status=suspended cannot log in

A-07 — Teacher portal login via email + password

Teacher logs in via /portal-login with email and password

A-08 — Super Admin "View As Role" simulation

Super admin can simulate other role views

SA-01 — School list loads with stats

All schools are listed with key metrics

SA-02 — Create a new school

Super admin creates a school record

SA-03 — Suspend and reactivate a school

Billing status can be toggled

SA-04 — Post a platform-wide announcement

Super admin broadcasts a message

SA-05 — Export onboarding audit log as CSV

Data export functionality works from the Audit Log

SC-01 — Enroll a new student

School admin adds a student to the system

SC-02 — Create a new class

School admin sets up a class

SC-03 — View class detail page

Clicking a class shows its students and details

SC-04 — Add and manage a teacher

Teacher record creation with salary and bank info

SC-05 — Add a parent and link to student

Parent record created and linked via ParentStudentLink

AT-01 — Teacher marks daily attendance

Attendance recorded for all students in class

AT-02 — Attendance already taken today shows existing data

Re-opening attendance on same day shows today's records

AT-03 — School admin views attendance records

Admin can review attendance across all classes

HW-01 — Teacher creates a homework assignment

New homework assigned to a class

HW-02 — Parent sees homework in parent portal

Assigned homework is visible to the parent

HW-03 — Teacher archives a homework

Homework status changed to archived

GR-01 — Teacher records a grade

Grade entered for a student in gradebook

GR-02 — Filter grades by subject

Gradebook filter works correctly

GR-03 — Parent views child results

Results visible in parent portal academics tab

FE-01 — School admin creates a fee record for a student

Fee assigned to a student

FE-02 — Record a payment against a fee

Payment reduces outstanding balance

FE-03 — Parent sees outstanding fees

Fee balance visible in parent portal

AN-01 — Teacher creates announcement for Parents only

Announcement targeted at parents

AN-02 — Teacher creates urgent announcement for Everyone

Broadcast announcement

AN-03 — Parent sees announcement in Notices tab

Announcement visible to parent

MS-01 — Parent sends a message to a teacher

Message created from parent portal

MS-02 — Teacher receives and replies to parent message

Teacher sees message in Messages tab

MS-03 — Unread message count shows on teacher inbox

Unread badge reflects new messages

GV-01 — Parent submits a grievance

Concern submitted from parent portal

GV-02 — School admin reviews and responds to grievance

Admin acknowledges and adds a response message

ST-01 — School admin updates school profile

Name, logo, and contact info saved correctly

ST-02 — School admin sets bank payment details

Payment instructions configured for parents

ST-03 — Enable Pickup Log feature flag

Toggling features_enabled.pickup_log shows Pickup tab for teachers

PF-01 — Initial page load under 3 seconds

Measure load time for key pages

PF-02 — Student list loads with 100+ students

Large dataset renders without lag

PF-03 — Teacher portal loads class data quickly

Portal data fetching is efficient

PF-04 — Mobile responsiveness on 375px viewport

UI adapts correctly on mobile screen size

PF-05 — Multiple concurrent API calls do not cause race conditions

Parallel data fetching is stable

SEC-01 — Unauthenticated user cannot access protected routes

Protected routes redirect to login

SEC-02 — School admin cannot access super admin routes

Role-based route protection

SEC-03 — Parent cannot view another school's data

Data scoped to parent's school_id

SEC-04 — Invalid PIN does not authenticate

Wrong PIN returns error, no session set

SEC-05 — PIN brute force: verify no account lockout gaps

Multiple failed PIN attempts behavior

SEC-06 — Session storage cleared on logout

All session data wiped on logout

CW-01 — Sales generates contract PDF

Sales admin generates professional contract from lead

CW-02 — Sales notifies Ops team (OLD workflow)

Sales sends email notification to ops after contract signed

CW-03 — Ops views Contracts Pipeline tab

New central dashboard for all contract stages

CW-04 — Generate contract using backend function

Sales uses generateContract function to create professional PDF

CW-05 — Ops uploads contract to Adobe Sign

Manual Adobe Sign process (external to app)

CW-06 — Mark contract as sent via Adobe

Use sendContractViaAdobe backend function

CW-07 — Client signs contract via Adobe Sign

External e-signature process (outside app)

CW-08 — Ops saves signed contract to OneDrive

Long-term storage in company OneDrive

CW-09 — Update lead with OneDrive URL and mark as signed

Use markContractSigned backend function

CW-10 — Ops creates subscription from signed contract

Convert signed contract to active school subscription

CW-11 — Verify complete audit trail

All contract metadata properly logged in Lead entity

CW-12 — Sales sees converted status

Sales dashboard reflects ops has processed the lead

CW-13 — Create first invoice for new subscription

Ops generates initial invoice for school

CW-14 — View contract from OneDrive link

Access signed contract via stored URL

CW-15 — End-to-end contract workflow test

Complete flow from generation to provisioning

ADV-01 — School admin views and manages grievances

Grievance Management tab in School Admin dashboard

ADV-02 — School admin submits a support ticket

School Support tab for raising issues to BridgePath

ADV-03 — AI Professionalize on school announcement

AI button improves announcement body text

ADV-04 — School admin invites a teacher via email

Invite Teacher dialog sends platform invite

ADV-05 — Onboarding checklist guides new school setup

Checklist appears for new schools with setup_complete=false

SO-01 — Support flags a lead for sales follow-up

Support admin raises a flag on a lead to alert sales

SO-02 — Sales resolves a flagged lead

Remove flag with documented reason

SO-03 — Ops logs an offline / manual purchase

QuickLead dialog creates a lead without the website form

SO-04 — Ops edits an existing subscription

Subscription details can be updated after creation

SO-05 — Ops assigns and responds to a support ticket

Ops team ticket management via My Tickets tab

SO-06 — Sales admin manages assigned tickets

Sales team ticket view in Sales Dashboard

PP-01 — Parent views correct child profile when multiple children linked

URL param :studentId resolves to the correct child

PP-02 — Direct URL to /portal/student/:id works without auth redirect

Student profile page is accessible without Base44 platform login

PP-03 — PIN brute force triggers account lockout at 5 attempts

Rate limiting via portalLoginWithRateLimit backend function

PP-04 — Portal login URL param pre-selects role

/portal-login?role=parent skips role selection screen

PP-05 — Parent portal logout clears all session data

Verify sessionStorage fully cleared on logout

AC-01 — Color contrast meets WCAG AA standards

Text is readable against background colors

AC-02 — All form inputs have visible labels

Labels are associated with inputs

AC-03 — Keyboard navigation works on main flows

Core flows usable without a mouse

AC-04 — Images and icons have alt text or are decorative

Icons are labeled for screen readers

AC-05 — Modal dialogs trap focus correctly

Focus stays inside open dialogs

AC-06 — Mobile touch targets are at least 44x44px

Tap targets are large enough on mobile