Customer Journey

Flow 1: Sign In And Dashboard

Objective

Authenticate customer and load operational summary.

Steps

1. Open https://customer.kifwa.cfhub.net
2. Click Sign In and authenticate in Keycloak
3. Land on dashboard root route (/)
4. Confirm recent activities and shipment cards render

Core APIs

• GET /users/me
• GET /customers/dashboard/stats
• GET /customers/dashboard/recent-activity
• GET /customers/shipments/recent

Recovery Checks

• Redirect loop: verify Keycloak redirect URI and origin
• Empty dashboard: inspect bearer token and stats endpoint payload

Flow 2: Company Discovery

Objective

Find and validate company profile/compliance before engagement.

Steps

1. Open Search route (/search)
2. Apply query/location/service filters
3. Open company detail and compliance panel
4. Continue with selected company

Core APIs

• GET /customers/company/search
• GET /customers/company/{companyId}
• GET /customers/company/{companyId}/compliance
• POST /customers/company-search/track

Flow 3: Shipment Tracking

Objective

Track shipment milestones and current status.

Steps

1. Open Track Shipment (/track-shipment)
2. Enter shipment id/reference
3. Review timeline and latest status update

Core APIs

• GET /shipments/{shipmentId}/tracking
• GET /shipments/{shipmentId}/detail

Flow 4: Ratings And Complaints

Objective

Capture service quality and formal complaints.

Steps

1. Open Feedback/Complaints
2. Submit rating for service/company
3. Raise complaint with evidence
4. Follow complaint progress and dispute if needed

Core APIs

• POST /ratings
• GET /ratings/customer
• POST /complaints
• GET /complaints/my-complaints
• GET /complaints/{complaintId}/progress
• POST /complaints/{complaintId}/dispute