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