FAS 2.0 — Test Scenarios (v5)

Direct URL to any step loads without prior steps complete

Steps

Open /apply/step/7 from fresh session

Expected

Step 7 renders; no redirect

Invalid step id

Steps

Open /apply/step/0, /apply/step/11, /apply/step/abc

Expected

"Invalid step." inline message; no crash

Errors hidden before first Next

Steps

Load step 1, leave required fields blank

Expected

No error UI shown

Errors appear after first Next

Steps

Click Next with blanks

Expected

Inline errors render for every required field

Reactive error clearing

Steps

After errors visible, fill a required field

Expected

That field's error disappears live

Auto-save on Next

Steps

Fill step 1 valid, click Next

Expected

saveApplicationDraft called; advances to step 2; lastSavedAt updated

Auto-save server failure

Steps

Force draft save error

Expected

Toast error; navigation blocked; user stays on step

Draft hydration

Steps

Fill some fields, reload page

Expected

Fields restored from fas2:draft:v1 localStorage

Draft reset post-submit

Steps

Complete + submit

Expected

After 100 ms, localStorage cleared; new visit shows fresh draft

Default country code

Steps

Open fresh draft

Expected

countryCode defaults to "Singapore (+65)"

Stepper checkmarks

Steps

Complete steps 1–3 in order

Expected

Stepper shows ticks for 1, 2, 3

Edit-from-Review jump

Steps

At step 10, click Edit on Income

Expected

Lands on step 3 with data intact

Banner visible when nothing verified

Steps

New session, step 1

Expected

"Save time — prefill with Singpass" banner shows

Banner hidden after prefill

Steps

Complete Singpass flow

Expected

Banner disappears (verifiedCount > 0)

QR → scanned → consent → success flow

Steps

Open modal, wait

Expected

Auto transitions: 4 s to scanned, 1.2 s to consent; user clicks Consent → success

QR expiry countdown

Steps

Open modal

Expected

120 s countdown visible, decrements each second

Escape key closes modal

Steps

Open modal, press Esc

Expected

Modal dismisses; no fields prefilled

Persona picker

Steps

Pick each demo persona

Expected

Fields prefilled per persona payload

Consent screen lists 8 scopes

Steps

Reach consent stage

Expected

All 8 scopes shown (name/NRIC, DOB/gender/nationality, address, contact, marital/family, employment, income NOA, HDB ownership)

Verified badge

Steps

After prefill

Expected

Blue "Verified by Singpass" badge on every prefilled field

Unlock verified field

Steps

Click lock icon on a verified field

Expected

Badge removed; field becomes editable

Household not prefilled

Steps

Complete Singpass

Expected

household[] remains empty

Re-trigger prefill overwrites

Steps

Run Singpass twice with different personas

Expected

Fields update to second persona

All valid Singapore Citizen

Steps

Fill all required with valid NRIC S1234567D, valid SG mobile, valid email

Expected

Next succeeds → step 2

Valid PR

Steps

Citizenship = "Singapore PR", everything else valid

Expected

Next succeeds

Student requires school

Steps

Student status = "Full-time Student", school = "NUS"

Expected

Validates

fullName

Steps

Negative — required field empties (BR-001 to BR-018)

Expected

"Required"

nric

Steps

Negative — required field empties (BR-001 to BR-018)

Expected

"Required"

dob

Steps

Negative — required field empties (BR-001 to BR-018)

Expected

"Required"

gender

Steps

Negative — required field empties (BR-001 to BR-018)

Expected

"Required"

nationality

Steps

Negative — required field empties (BR-001 to BR-018)

Expected

"Required"

citizenship

Steps

Negative — required field empties (BR-001 to BR-018)

Expected

"Required"

maritalStatus

Steps

Negative — required field empties (BR-001 to BR-018)

Expected

"Required"

highestQualification

Steps

Negative — required field empties (BR-001 to BR-018)

Expected

"Required"

studentStatus

Steps

Negative — required field empties (BR-001 to BR-018)

Expected

"Required"

countryCode

Steps

Negative — required field empties (BR-001 to BR-018)

Expected

"Required"

mobile

Steps

Negative — required field empties (BR-001 to BR-018)

Expected

"Required"

email

Steps

Negative — required field empties (BR-001 to BR-018)

Expected

"Required"

preferredContact

Steps

Negative — required field empties (BR-001 to BR-018)

Expected

"Required"

preferredLanguage

Steps

Negative — required field empties (BR-001 to BR-018)

Expected

"Required"

NRIC bad checksum

Steps

S1234567A

Expected

"Please enter a valid NRIC number."

NRIC wrong prefix

Steps

A1234567J

Expected

Invalid NRIC

NRIC short

Steps

S123J

Expected

Invalid NRIC

NRIC FIN valid

Steps

F1234567N (recompute valid letter)

Expected

Accepted

NRIC M-series valid/invalid

Steps

Valid M vs random M

Expected

Validated by M-series checksum

DOB in future

Steps

tomorrow

Expected

"Date of birth cannot be in the future."

DOB very old

Steps

1900-01-01

Expected

Accepted (age auto-calc shows)

Citizenship = Foreigner

Steps

Select Foreigner

Expected

Inline + red eligibility block; Next blocked; "Exit Application" / "Contact Support" actions

Student = Full-time but school empty

Steps

studentStatus = Full-time, school blank

Expected

"Required" on school

Student = "Not a Student"

Steps

school field hidden

Expected

No school validation runs

Email malformed

Steps

foo@bar, foo bar@x.com, @x.com

Expected

"Please enter a valid email address."

SG mobile invalid prefix

Steps

12345678

Expected

"Please enter a valid mobile number…"

SG mobile valid

Steps

91234567, 81234567, 61234567

Expected

Accepted

SG mobile wrong length

Steps

9123456 (7 digits)

Expected

Invalid

MY mobile 9–10 digits

Steps

123456789, 1234567890

Expected

Accepted

MY mobile 8 digits

Steps

12345678

Expected

Invalid

ID mobile 9–12 digits

Steps

123456789, 123456789012

Expected

Accepted

Other country code length 7–15

Steps

1234567 and 123456789012345

Expected

Accepted; outside range invalid

Mobile contains letters

Steps

9abc4567

Expected

Invalid (digits only)

NRIC history lookup (on blur, after checksum passes)

Steps

"Resume draft" navigates to step 3

Expected

Blue banner with ref + last edited

NRIC history lookup (on blur, after checksum passes)

Steps

Informational only

Expected

Red banner — "Duplicate submissions are not allowed."

NRIC history lookup (on blur, after checksum passes)

Steps

Proceed allowed

Expected

Grey banner with grant details

NRIC history lookup (on blur, after checksum passes)

Steps

Informational only

Expected

Amber warning re: active grant

NRIC history lookup (on blur, after checksum passes)

Steps

None

Expected

Green: "No existing applications…"

All fields valid, mailing same as residential

Steps

Positive

Expected

Next succeeds

Mailing different

Steps

Positive

Expected

Toggle off → mailing fields appear → fill all → Next succeeds

OneMap auto-fill happy path

Steps

Positive

Expected

Type valid SG postal 238801, click Auto-fill

postal

Steps

Negative — required

Expected

"Required"

blockNo

Steps

Negative — required

Expected

"Required"

streetName

Steps

Negative — required

Expected

"Required"

floorNo

Steps

Negative — required

Expected

"Required"

unitNo

Steps

Negative — required

Expected

"Required"

housingType

Steps

Negative — required

Expected

"Required"

ownership

Steps

Negative — required

Expected

"Required"

mailing fields when checkbox unchecked

Steps

Negative — required

Expected

"Required" on each mailing field

Postal not 6 digits

Steps

12345, 1234567

Expected

"Enter a valid 6-digit postal code"

Postal non-numeric

Steps

12A456

Expected

Field rejects letters (maxLength + numeric only)

Floor with letters

Steps

12A

Expected

"Enter digits only (e.g. 12)"

Floor > 3 digits

Steps

1234

Expected

Field rejects (maxLength 3)

Unit with symbol

Steps

12-A, #345

Expected

"Letters/numbers only…"

Unit > 5 chars

Steps

12ABCD

Expected

Field rejects (maxLength 5)

Mailing postal invalid when toggled

Steps

mailing not 6 digits

Expected

"Enter a valid 6-digit postal code"

Auto-fill button disabled when postal not 6 digits

Steps

OneMap

Expected

Type 12345

OneMap returns empty

Steps

OneMap

Expected

Use 000000

OneMap API failure

Steps

OneMap

Expected

Mock network error

Enter key in postal triggers lookup

Steps

OneMap

Expected

Press Enter

residentialAddress auto-compose

Steps

Composed address

Expected

Fill all sub-fields

mailingAddress auto-compose

Steps

Composed address

Expected

Same for mailing

Employed full happy path

Steps

Positive

Expected

Status=Employed, type=Full Time, work=Active, gross=5000

Self-employed

Steps

Positive

Expected

Status=Self-employed + all required

Retired

Steps

Positive

Expected

Status=Retired

Unemployed clears fields

Steps

Positive

Expected

Switch to Unemployed

Non-employment income only

Steps

Positive

Expected

Unemployed + rental 800 + allowance 200

employmentStatus empty

Steps

Negative

Expected

"Required"

employmentType empty (non-Unemployed)

Steps

Negative

Expected

"Required"

workStatus empty (non-Unemployed)

Steps

Negative

Expected

"Required"

grossIncome empty (non-Unemployed)

Steps

Negative

Expected

"Required"

BR-203: Employed + grossIncome = 0

Steps

Negative

Expected

"Monthly income must be greater than 0 for employed applicants."

BR-203: Employed + grossIncome negative

Steps

Negative

Expected

Same error (number input min 0 also blocks)

Non-numeric income

Steps

Negative

Expected

Field rejects

Total income auto-calc with household

Steps

Negative

Expected

Add 2 household members with incomes 1000 + 500 not Unemployed/Student

Household Student/Unemployed excluded

Steps

Negative

Expected

Add student with income field hidden

ownership = Owner shows mortgage Q

Steps

Conditional mortgage

Expected

hasMortgage required

ownership = Co-Owner

Steps

Conditional mortgage

Expected

Same as Owner

ownership = Tenant

Steps

Conditional mortgage

Expected

Mortgage Q hidden; not validated

ownership = Staying With Family / Others

Steps

Conditional mortgage

Expected

Mortgage Q hidden

hasMortgage = Yes, amount empty

Steps

Conditional mortgage

Expected

"Enter the monthly mortgage amount."

hasMortgage = Yes, amount = 0

Steps

Conditional mortgage

Expected

Same error (must be > 0)

hasMortgage = No clears amount

Steps

Conditional mortgage

Expected

Switch from Yes→No

loanType empty

Steps

Loans

Expected

"Please select a loan type, or choose None if you have no other loans."

loanType = None

Steps

Loans

Expected

loanAmount cleared; no further loan validation

loanType ≠ None, loanAmount empty/0

Steps

Loans

Expected

"Enter the monthly loan amount (must be greater than 0)."

Switch loanType from Personal→None

Steps

Loans

Expected

loanAmount auto-cleared

All expense fields filled

Steps

Total expenses auto-calc

Expected

Total = sum of mortgage(if Yes) + rental + utilities + medical + education + loan + other

Negative numbers blocked

Steps

Total expenses auto-calc

Expected

Field min 0

All optional expenses blank

Steps

Total expenses auto-calc

Expected

Total = 0 + any mortgage

hasMedicalCondition = No happy path

Steps

Expected

All medical sub-fields hidden; Next succeeds

hasMedicalCondition empty

Steps

Expected

"Required"

hasMedicalCondition = Yes, all sub-fields shown

Steps

Expected

disabilityType + mobilityStatus required

disabilityType empty when Yes

Steps

Expected

"Required"

mobilityStatus empty when Yes

Steps

Expected

"Required"

Free text fields (medicalCondition, chronicIllness, medicalRemarks) optional

Steps

Expected

Empty allowed when Yes

Switch Yes→No clears all sub-fields

Steps

Expected

Verify cleared

disabilityType ≠ None or any condition text → advisory banner

Steps

Expected

"You may upload supporting medical/disability documents in Supporting Documents." appears

All 8 disabilityType options selectable

Steps

Expected

Including "Others"

applicant maritalStatus = Married, no household members

Steps

Marital-status driven

Expected

Top-level error "please input your spouse details"

applicant maritalStatus = Single, Spouse option disabled in dropdown

Steps

Marital-status driven

Expected

Cannot select Spouse

Add 2 spouses

Steps

Marital-status driven

Expected

Second one's relationship dropdown has Spouse disabled; if forced → "Only one spouse can be declared…"

Set relationship=Spouse with empty maritalStatus

Steps

Marital-status driven

Expected

Auto-populates "Married"

name

Steps

Per-member required

Expected

"Required"

relationship

Steps

Per-member required

Expected

"Required"

dob

Steps

Per-member required

Expected

"Required"

gender

Steps

Per-member required

Expected

"Required"

maritalStatus

Steps

Per-member required

Expected

"Required"

employmentStatus

Steps

Per-member required

Expected

"Required"

nric (non-Foreigner)

Steps

Per-member required

Expected

"NRIC is required."

nric (Foreigner)

Steps

Per-member required

Expected

"Passport No. is required."

livingTogether

Steps

Per-member required

Expected

"Required"

monthlyIncome when status ≠ Unemployed/Student

Steps

Per-member required

Expected

"Required"

hasMedicalCondition

Steps

Per-member required

Expected

"Required"

disabilityType/mobilityStatus when hasMedicalCondition=Yes

Steps

Per-member required

Expected

"Required"

NRIC invalid checksum

Steps

Per-member format

Expected

"Please enter a valid NRIC number."

Passport No. (Foreigner)

Steps

Per-member format

Expected

Up to 20 chars alphanumeric accepted

BR-203 on member income

Steps

Per-member format

Expected

Employed member with income 0 → "Monthly income must be greater than 0 for employed applicants."

Spouse + applicant Single conflict

Steps

Per-member format

Expected

"A spouse cannot be added when applicant marital status is Single."

Add unlimited members

Steps

UX

Expected

1, 5, 20 members supported

Remove a member

Steps

UX

Expected

Row + all errors cleared

Member nationality switch hides/shows passport label

Steps

UX

Expected

Foreigner shows "Passport No." else "NRIC"

Member income hidden when Unemployed/Student

Steps

UX

Expected

Field disappears

Occupation hidden when Student

Steps

UX

Expected

Field disappears

receivingAssistance empty

Steps

Expected

"Please answer whether you are receiving other assistance."

receivingAssistance = No

Steps

Expected

Grants section hidden; Next succeeds

Switch No→Yes

Steps

Expected

One empty grant row auto-added

Yes + zero grants (force)

Steps

Expected

"Please add at least one grant."

Grant name empty

Steps

Expected

"Required"

Grant type empty

Steps

Expected

"Required"

Grant agency empty

Steps

Expected

"Required"

Grant description optional

Steps

Expected

Empty allowed

Grant amount optional

Steps

Expected

Empty allowed

Add multiple grants

Steps

Expected

Each validated independently

Remove a grant

Steps

Expected

Row removed; errors recalculated

No documents uploaded

Steps

Mandatory docs

Expected

"Missing Required Documents:" list with Front NRIC, Back NRIC, Applicant Photo

Only Front NRIC uploaded

Steps

Mandatory docs

Expected

Missing Back NRIC + Applicant Photo listed

All 3 mandatory uploaded

Steps

Mandatory docs

Expected

Validates

Re-upload Front NRIC

Steps

Mandatory docs

Expected

Replaces existing file (single-slot)

Conditional doc visibility

Steps

Conditional doc visibility

Expected

Conditional doc visibility

Steps

Conditional doc visibility

Expected

Conditional doc visibility

Steps

Conditional doc visibility

Expected

Conditional doc visibility

Steps

Conditional doc visibility

Expected

Conditional doc visibility

Steps

Conditional doc visibility

Expected

hasOtherIncome + no upload + no checkbox

Steps

Other income docs declaration

Expected

"Please upload Other Income Supporting Documents, or tick the declaration below."

Check noOtherIncomeDocs, leave reason blank

Steps

Other income docs declaration

Expected

"Please provide a reason for non-submission."

Check + reason provided

Steps

Other income docs declaration

Expected

Validates

Upload file → validation passes regardless of checkbox

Steps

Other income docs declaration

Expected

Positive

Medical condition declared but no medical doc

Steps

Medical docs gate

Expected

"Please upload at least one of: Medical Certificate, Medical Report, or Specialist Memo."

Upload one of the three

Steps

Medical docs gate

Expected

Validates

Upload .pdf

Steps

File upload constraints (BR-119–122)

Expected

Accepted

Upload .jpg / .jpeg / .png

Steps

File upload constraints (BR-119–122)

Expected

Accepted

Upload .docx / .heic / .zip / .exe

Steps

File upload constraints (BR-119–122)

Expected

Toast: "{filename}: unsupported file type. Allowed: PDF, JPG, JPEG, PNG."

Upload exactly 5 MB

Steps

File upload constraints (BR-119–122)

Expected

Accepted (boundary)

Upload > 5 MB

Steps

File upload constraints (BR-119–122)

Expected

Toast: "{filename}: exceeds 5 MB limit…"

Multi-file slot append

Steps

File upload constraints (BR-119–122)

Expected

Add 2nd, 3rd files to non-identity slots

Image resized for AI vision

Steps

File upload constraints (BR-119–122)

Expected

Verify dataURL passed

PDF > 5 MB

Steps

File upload constraints (BR-119–122)

Expected

Cannot upload; size-rejected

sourceOfApplication empty

Steps

Source of application

Expected

"Required"

Source = Walk In or Self Serviced Portal

Steps

Source of application

Expected

Referral fields hidden

Source = Referred

Steps

Source of application

Expected

All 8 referral fields shown

referralAgencyName

Steps

Referral required when Source=Referred (each empty)

Expected

"Required"

referralOfficerName

Steps

Referral required when Source=Referred (each empty)

Expected

"Required"

referralOfficerContact

Steps

Referral required when Source=Referred (each empty)

Expected

"Required"

referralOfficerEmail

Steps

Referral required when Source=Referred (each empty)

Expected

"Required"

referralServiceFor

Steps

Referral required when Source=Referred (each empty)

Expected

"Required"

referralReferenceNo

Steps

Referral required when Source=Referred (each empty)

Expected

"Required"

referralDescription

Steps

Referral required when Source=Referred (each empty)

Expected

"Required"

referralReportedDate

Steps

Referral required when Source=Referred (each empty)

Expected

"Required"

referralSocialReportName

Steps

Referral required when Source=Referred (each empty)

Expected

Optional (name only stored)

All 3 checkboxes unchecked

Steps

Declarations + signature

Expected

"All declarations must be acknowledged"

Only 2 of 3 checked

Steps

Declarations + signature

Expected

Same error

All checked + signature filled

Steps

Declarations + signature

Expected

Validates

Signature empty

Steps

Declarations + signature

Expected

"Required"

All steps shown with Edit links

Steps

Read-only summary + financial calcs

Expected

Each Edit jumps to correct step

Total income calc

Steps

Read-only summary + financial calcs

Expected

= grossIncome (if not Unemployed) + 4 non-employment + Σ member income (excluding Unemployed/Student)

Total expenses calc

Steps

Read-only summary + financial calcs

Expected

= mortgage (if hasMortgage=Yes) + rental + utilities + medical + education + loan + other

Net surplus negative shown red

Steps

Read-only summary + financial calcs

Expected

Total income < total expenses → red

Per capita income

Steps

Read-only summary + financial calcs

Expected

= total income / (1 + household.length)

Household size

Steps

Read-only summary + financial calcs

Expected

= 1 + household.length

Married + no Spouse in household

Steps

Married-no-spouse warning

Expected

Amber non-blocking warning shown; Submit still works

Step 1 missing field

Steps

Final cross-step re-validation (clicking Submit at step 10)

Expected

Redirect to step 1 + toast "Please complete Personal Particulars before submitting."

Step 4 invalid mortgage

Steps

Final cross-step re-validation (clicking Submit at step 10)

Expected

Redirect to step 4 + matching toast

Step 8 missing mandatory doc

Steps

Final cross-step re-validation (clicking Submit at step 10)

Expected

Redirect to step 8 + matching toast

Step 9 declarations off

Steps

Final cross-step re-validation (clicking Submit at step 10)

Expected

Redirect to step 9 + toast

All steps valid

Steps

Final cross-step re-validation (clicking Submit at step 10)

Expected

AiDocValidationModal opens

Modal opens on Submit

Steps

Expected

Phase = "checking", animated checklist

Checklist labels tick every ~900 ms

Steps

Expected

Visual progression

Front/Back NRIC missing → local structural fail

Steps

Expected

Result entry status="missing", action button "Re-upload" → step 8

AI returns all ok

Steps

Expected

Phase=review, single "Submit Application" button (no confirm phase)

AI returns warn

Steps

Expected

Phase=review with ⚠️; button label "Proceed Anyway"

"Proceed Anyway"

Steps

Expected

Opens confirm phase → "Confirm & Submit"

AI server throws

Steps

Expected

Single warn entry: "The AI check could not complete. Please review your documents before submitting."

Re-upload from modal

Steps

Expected

Jumps to step 8; modal closes

Modal cannot be bypassed

Steps

Expected

No path to submit outside modal

First-time submit (id=null)

Steps

Expected

submitApplication({id:null, draft})

Submit after prior auto-save

Steps

Expected

applicationId passed (upsert)

Success

Steps

Expected

All 10 steps marked complete; toast "Application submitted successfully"; navigate /success/{caseNumber}; draft reset 100 ms later

Failure

Steps

Expected

Toast "Submission failed. Please try again."; submitting flag resets; user stays on modal

Double-click Submit guard

Steps

Expected

Second click ignored while submitting

Duplicate NRIC seeded "pending"

Steps

Expected

Server-side guard expected; client banner already warned at step 1

Browser back during submit

Steps

Expected

Submission still completes; success page reachable

Reference number displayed

Steps

Expected

From URL param

Timestamp shown

Steps

Expected

new Date().toLocaleString()

Applicant name

Steps

Expected

From readDraftSnapshot() (may be empty post-reset)

Status text

Steps

Expected

"Submitted — Pending Review"

Download PDF

Steps

Expected

jsPDF generates acknowledgement-{refId}.pdf with ref/time/name/status

Post-submission messaging

Steps

Expected

24h SMS/email, officer contact, 14 working day outcome

Contact info visible

Steps

Expected

1800-222-0000 + support@fas.gov.sg

Refresh after reset

Steps

Expected

Page still renders from URL only

Floating button always visible

Steps

Expected

On every /apply/* and /citizen page

Citizen welcome

Steps

Expected

"Hi! I can help you check eligibility, understand required documents and track your application status."

Citizen suggested prompts

Steps

Expected

3 prompts: "Check my eligibility" / "Required documents" / "Track my application"

Officer/manager/director/admin prompts

Steps

Expected

NOT shown on citizen routes