OvApp — Rider Feature Documentation¶
OvApp provides Riders with tools to manage battery swaps, track swap history, view charging stations, manage account balance, and control their subscriptions.
This document walks through the Rider experience and explains how features behave both online and offline.
Access Model¶
- Riders must log in to OvApp to access Rider features.
- All swaps, balances, and subscriptions are tied to the Rider profile.
- After login, Riders use the bottom navigation bar:
- Home
- Stations
- Activity
- Profile
🔐 Authentication ensures accurate tracking of swaps and payments.
Home¶
{ width="320" }
The Home screen is the Rider’s primary dashboard.
Key Sections¶
Welcome & Identity¶
- Displays a greeting (e.g. Good afternoon, Rider Name)
- Confirms the active Rider account
My Bike Card¶
Shows vehicle and swap information: - Vehicle name/model (e.g. E-Trike 3X) - Status (Pending / Active) - Vehicle ID - Last swap time - Total swaps completed
Account Balance¶
- Displays current balance (XOF)
- Primary action: Top Up
- Updates automatically after swaps or payments
Quick Actions¶
- Find Station — opens Stations map
- My QR Code — used for identification and swaps
Nearby Stations¶
- Mini map preview with nearby station markers
- Action: View Map
Stations¶
{ width="320" }
The Stations screen allows Riders to locate nearby battery swap stations.
Features¶
- Shows Rider’s current position
- Displays station markers
- Interactive map (zoom, pan, select)
Expected Behavior¶
- Requires location permission
- Displays fallback or prompt if GPS is disabled
- Updates dynamically with location changes
Activity¶
{ width="320" }
The Activity screen shows the Rider’s historical actions.
Filters¶
- All
- Swaps
- Payments
- Top-ups
Empty State¶
- Displays: No activities found when no records exist
Typical Records¶
- Battery swaps
- Balance top-ups
- Subscription payments
Profile Overview¶
{ width="320" }
The Profile Overview summarizes the Rider’s account.
Displayed Information¶
- Rider avatar initials
- Full name
- Rider identifier (phone or account ID)
- Energy Service status (e.g. Pending)
- Account balance
- Swaps this month
- Active plan and validity date
Primary action: - Account Details
Profile Menu¶
{ width="320" }
The Profile Menu provides access to account and configuration settings.
Menu Items¶
- Account Details — personal information and preferences
- My Vehicle — vehicle identity and registration details
- Subscription Plan — view and manage plan and billing
- Payment Methods — linked payment option (e.g. MTN Mobile Money)
- Help & Support — FAQs and contact support
Offline Functionality¶
OvApp supports limited Rider functionality when offline.
Available Offline¶
- Viewing cached account balance
- Viewing cached activity history
- Viewing cached station data
- Displaying My QR Code
Syncing¶
- Actions performed offline are queued
- Data syncs automatically when internet connectivity is restored
Validation & Edge Cases¶
- Currency formatting must be consistent (XOF)
- Pending and active statuses must be visually distinct
- Empty states must provide clear messaging
- Location permissions must be handled gracefully
- Network failures must show retry or fallback UI
- Bottom navigation must always highlight the active tab
Summary of Key Sections:¶
- Support Tickets: Allows Riders to manage and track issues with the app or devices.
- Charging Stations: Lets Riders find nearby swap stations using maps.
- Transactions: Keeps track of all Rider payments and battery swaps.
- Product Subscriptions: Provides access to services and their details like cost, code, and status.
- Profile Management: Allows Riders to keep their personal details up-to-date.
- Offline Functionality: Ensures Riders can use key features without connectivity.
Conclusion¶
OvApp provides Riders with a comprehensive toolkit for battery swapping, managing their transactions, locating nearby swap stations, and accessing support. Whether online or offline, OvApp ensures Riders can always manage their services and track their activities effectively.