User Story 1 (Revised): Initial Setup & Onboarding with Incentive Welcome

As an EV owner who just got a FlowBankOS charger
I want to receive a welcome incentive
So that I feel rewarded for completing setup

Use Case Flow Extension

After success screen (charger added), display a welcome incentive card (e.g. “You earned 10 FlowPoints” or “Get $2 credit for your first 5 kWh”).

Prompt user to view Incentives Dashboard.

Acceptance Criteria

New users receive welcome incentive immediately after setup.

Incentive is credited/visible in the user’s balance/incentive wallet.

Incentive UI clearly explains how/when credit can be used (e.g. “applied next session”).

UI/UX Elements

Overlay/slide-in Welcome Incentive Banner on setup success screen.

Visual points wallet icon in app header or sidebar.

Tooltip or “How it works” modal explaining incentive terms.

User Story 2 (with Incentive Feedback): Real-Time Charging + Incentive Feedback

As an EV owner charging now
I want in-session feedback when I’m earning incentives
So that I’m motivated to keep charging or meet thresholds

Use Case Flow Extension

During session, the UI shows a progress bar for incentive eligibility (e.g. “5/10 kWh → next bonus”).

When threshold reached, show a “You earned X points” popup mid-session.

Show cumulative incentive in dashboard view.

Acceptance Criteria

Incentive meter updates in real time along with kWh count.

Popup/notification does not block or hinder essential controls.

Incentive credit is logged in history for that session.

UI/UX Elements

Incentive progress bar subtitle (below energy counter).

Popup toast “+10 points earned!” with icon.

Incentive summary widget on Dashboard (e.g. “You have 120 points, $1.50 value”).

User Story 3 (Modes) with Incentive Tie-Ins

As an EV owner choosing charge modes
I want incentives to be biased toward efficient modes
So that I’ll prefer “Eco” over full power modes sometimes

Use Case Flow Extension

Next to each mode, show a bonus indicator (e.g. “Earn +5 points for using Eco mode”).

Boost mode might explicitly say “No bonus for Boost mode” or “Reduced bonus” to disincentivize overuse.

Acceptance Criteria

Bonus indicators appear for modes (if applicable).

If user picks a mode with bonus, it should reflect in incentive count when session ends.

If mode changed mid-session, bonus adjustment is prorated and clearly shown.

UI/UX Elements

Badge or label next to Eco: “+5 pts” or “Bonus eligible”.

Grayed label for Boost: “No bonus”.

Tooltip: “Using Eco earns bonus points toward your next credit.”

User Story 4: History, Analytics & Incentive Statements

As an EV owner reviewing my usage
I want to see incentive history and state
So that I can understand how my rewards relate to my charging behavior

Use Case Flow Extension

In History List: add a column or badge “Points Earned”.

In Session Detail: show incentive earned, mode used, kWh thresholds.

In Analytics: graph “Points/month” alongside kWh usage.

Export includes incentive data in CSV/PDF.

Acceptance Criteria

Every session shows correct incentive earned.

Analytics allows filtering by incentive vs non-incentive usage.

Export includes incentive columns and totals.

UI/UX Elements

Points badge next to each session line.

Sidebar/section “Incentive Summary”: total points earned, cash equivalent.

Graph overlay: kWh vs points earned.

User Story 5: Multi-Location + Incentive Aggregation

As a user with multiple chargers
I want incentives aggregated across all locations
So that I get rewards no matter which charger I use

Use Case Flow Extension

Points wallet is shared across all chargers.

Incentive threshold progress tracks cumulatively across devices.

If a bonus threshold is nearly reached at one charger, show hint in others.

Acceptance Criteria

Incentives accumulate across chargers under the same account.

Threshold tracking is continuous, not per device (unless design requires).

UI shows contribution per charger toward global bonus.

UI/UX Elements

Incentive wallet always visible regardless of selected charger.

On charger cards: a small progress indicator (e.g. “+3 pts this station”).

Tooltip: “Your next bonus is X points; you’re 7/10 kWh away across all chargers.”

User Story 6: Shared Access + Incentive Sharing

As a family member using a shared charger
I want incentives to be fairly allocated
So that my usage is credited to me

Use Case Flow Extension

Each user logs their own session for points.

In shared sessions (e.g. two cars over day), incentive is split or assigned based on usage.

Owner/admin may set shared bonus rules (e.g. family challenge pool).

Acceptance Criteria

Incentives attributed to correct user.

Shared sessions handled fairly (by split, rule, or capture).

Users can see their own earned points separate from others.

UI/UX Elements

In Access screen: join user ID for incentives to track.

In shared session detail: show contribution breakdown (User A: 60%, User B: 40% → points split).

Family bonus banner “As a household you earned 30 extra points this month!”

User Story 7: Scheduling + Incentive Encouragement

As an EV owner scheduling charging windows
I want incentive nudges for preferred windows
So that I align my behavior to beneficial times

Use Case Flow Extension

In schedule UI, preferred slots (low-demand windows) show bonus highlighting (“+2 pts”).

If schedule set to non-preferred time, suggestion UI: “Switch to nights for bonus.”

UI warns when scheduled slot conflicts with incentive windows.

Acceptance Criteria

Bonus hints appear in schedule editor.

If user picks non-bonus slot, suggestion prompt shows tactfully.

Incentive logic accounts for scheduling (i.e. scheduled session retains eligibility).

UI/UX Elements

Time blocks colored differently for bonus windows (e.g. green shade).

Tooltip/popover: “Charge during 23:00–05:00 for bonus points.”

Conflict banner: “This schedule is outside bonus hours – no bonus.”

User Story 8: Incentive Center & Wallet

As an EV owner
I want a dedicated space to view and manage incentives
So that I understand my credit balance, usage, and redemption

Use Case Flow

Tap Wallet / Incentives in main menu.

View Points Balance, Cash Equivalent, History.

See ongoing tasks/challenges (e.g. “Charge 50 kWh this month for bonus 20 pts”).

Redeem/Apply credits (e.g. offset part of future session cost, or convert to gift vouchers if allowed).

Notification when new bonus earned or challenge completed.

Acceptance Criteria

Points balance updates immediately after session.

Redemption flows are secure and clear (e.g. “Use X pts to offset Y $”).

History shows timestamped incentive events (earned, redeemed).

UI/UX Elements

Wallet icon + badge in header showing new reward count.

Wallet screen: current points, equivalent $, upcoming bonuses, challenge list.

Redeem button with slider or input.

Notification banner: “You earned 5 pts — go to wallet to redeem.”

User Story 9: Incentive Notifications & Gamification

As an EV owner
I want notifications and gamified cues about incentives
So that I engage more and form habits

Use Case Flow

Push notification: “You’re 80% toward your Bonus!” or “Congrats! 10 pts earned.”

Daily/weekly summary: “You earned 40 pts this week.”

Occasional challenges: “Charge 30 sessions this month → 50 pts bonus.”

Acceptance Criteria

Incentive notifications do not override critical alerts.

Challenge reminders are optional (user opt-out).

Gamification does not mislead — must always reflect real points.

UI/UX Elements

Milestone banners (e.g. “Halfway to monthly bonus!”).

Challenge cards on home screen.

Leaderboard / status (optional): friend/family ranking (private/shared) — “Top charger this month”.

Integration Across Flows: Incentive Logic Summary
Flow	Incentive Touchpoint	UI Element
Onboarding	Welcome bonus	Banner/Overlay
Session	In-session progress bar	Subtitle bar under kWh
Mode choice	Bonus indicator on Eco/Standard	Badge “+pts”
History	Points earned per session	Badge/Icon in list
Multi-location	Wallet shared across chargers	Wallet icon always visible
Shared users	Attribution of points	Breakdown in session detail
Scheduling	Bonus-slot highlighting	Colored schedule blocks
Wallet center	Redeem + challenges	Dedicated screen
Notifications	Milestones & alerts	Push + in-app banners