1. document purpose
This document is the business verification test (BVT) for the current Plans MVP release in Zeus. Its purpose is to give product, operations, QA, design, and stakeholders one practical checklist that answers two questions:- What Plans features are available to use right now?
- How do we verify that each feature works well enough for internal use, demos, and pilot validation?
2. current feature set available now
The current Plans MVP supports the following user-facing capabilities.Available now
| Capability | What the user can do now |
|---|---|
| Monthly plan creation | Create a monthly plan from expected income, fixed expenses, one primary goal, and lifestyle mode |
| Recommendation-driven allocation | Receive an allocation across fixed expenses, essential spending, goal contribution, and safe-to-spend |
| Plan activation | Activate a draft plan for the current month |
| In-month dashboard | View remaining safe-to-spend, daily guide, goal progress, warning state, and streak |
| Manual progress logging | Log discretionary spend and goal contribution directly from Plans |
| Daily transaction reminder | Enable one fixed-time daily reminder delivered to the in-app notifications inbox |
| Warning and rebalance | Receive a warning when pace drifts and accept one recommended corrective action |
| Month-end reflection | Review planned versus actual results after a month closes |
| Historical plans | Open prior months and inspect completed plan summaries |
Explicitly not part of this BVT
The following items are still outside the MVP verification scope:- Variable-income planning
- Multiple simultaneous plan goals
- Browser push notifications or email reminders
- AI-generated month-end summaries
- Advanced adaptive learning across repeated months
3. business readiness bar
The release is considered business-ready for internal use and pilot validation when all of the following are true:- A user can create and activate a monthly plan without external explanation.
- A user can understand their current monthly health within a few seconds of opening Plans.
- A user can turn on a daily reminder and receive it in the in-app inbox at the selected time.
- A user can accept a warning recommendation and see the plan update immediately.
- A user can reopen a completed month and understand what happened plus what to do next.
4. test prerequisites
Before running this BVT, the tester should have:- A valid user account with access to the web app
- At least one financial goal created
- Ability to create or edit transactions manually
- Access to the notifications inbox
- Ability to create a current-month plan and wait for or simulate a new month if month-end scenarios are being verified live
- Use one current-month test plan with a linked goal
- Use predictable amounts so planned versus actual changes are easy to validate
- Keep one second user account available if a clean-state test is needed
- Admin operators can use the manual Plans trigger in Settings > AI Insights to run plan jobs immediately for one user instead of waiting for cron timing during internal verification
Deterministic test data for BR-5, BR-6, and BR-7
Use the following sample data if the tester wants a repeatable path with minimal judgment:| Field | Suggested value |
|---|---|
| Expected monthly income | 3000 |
| Fixed expenses | 1200 |
| Primary goal monthly contribution target | 600 |
| Lifestyle mode | Balanced |
| Reminder time | 5 to 10 minutes ahead of current local time |
| Test intent | Suggested action |
|---|---|
| Trigger spend warning quickly | Log one large discretionary transaction that clearly consumes most of the current safe-to-spend allowance |
| Trigger goal warning | Keep discretionary spend low but do not log goal contributions until the plan falls materially behind target pace |
| Create month-end variance | End the month with discretionary actual above plan or goal actual below target |
- Run the daily plans cron job manually instead of waiting for the reminder time
- Or use the admin Plans manual trigger for the selected user to run the same lifecycle immediately
- Use an older active plan month to verify automatic month-end completion and reflection
5. end-to-end BVT scenarios
BVT-1 create and activate a plan
Purpose Verify that the user can create a recommendation-based monthly plan and activate it. Steps- Open Plans with no active plan for the current month.
- Start plan creation.
- Enter expected monthly income.
- Enter fixed expenses.
- Select one primary goal.
- Select a lifestyle mode.
- Submit the plan.
- Open the draft plan if needed and activate it.
- A plan is created for the current month.
- The plan includes fixed expenses, essential spending, goal contribution, and safe-to-spend.
- The plan can be activated successfully.
- The active plan appears on the Plans dashboard.
BVT-2 review active dashboard state
Purpose Verify that the active dashboard shows the user’s in-month control layer clearly. Steps- Open an active monthly plan.
- Review the top-level dashboard.
- Remaining safe-to-spend is visible.
- A daily safe-to-spend guide is visible.
- Goal contribution progress is visible.
- Current plan state is visible as on track, watch, or at risk.
- Streak count is visible.
- The dashboard is understandable without opening raw transactions first.
BVT-3 log manual plan progress
Purpose Verify that manual spending and saving updates keep the plan current. Steps- Open the active plan.
- Use the manual logging action.
- Add discretionary spending.
- Optionally add direct goal contribution.
- Save the update.
- The updated discretionary spend appears in the dashboard.
- Remaining safe-to-spend changes immediately.
- Daily guidance updates.
- Goal progress updates when savings are logged.
BVT-4 configure and receive the daily reminder
Purpose Verify BR-5: the user can enable a single daily reminder and receive it through the inbox. Recommended setup- Start from an active current-month plan
- Choose a reminder time a few minutes ahead of the current local time
- Keep Notifications and Transactions accessible in separate tabs if useful
- Open the active plan.
- Turn the reminder on.
- Select a reminder time.
- Save the reminder.
- Wait until the reminder time is reached, run the daily plans job in a test environment, or use the admin Plans manual trigger for that user.
- Open Notifications.
- Open the reminder CTA.
- Reminder settings save successfully.
- One reminder is created for that local day.
- The reminder appears in the notifications inbox.
- The CTA opens transaction input directly.
- Reopening Notifications the same day does not create duplicate reminders for the same plan/day.
- If the reminder is triggered by the job rather than real time, the business outcome is still considered valid as long as the user-visible reminder appears correctly
- The reminder is in-app only for MVP and does not require browser push or email delivery
BVT-5 trigger a warning and dismiss it
Purpose Verify that drift is surfaced clearly and can be dismissed without breaking the plan. Steps- Start from an active plan.
- Log enough discretionary spend or too little goal progress to push the plan off pace.
- Reopen Plans if needed.
- Dismiss the warning.
- A warning appears with clear plain-language explanation.
- The warning indicates why the plan is at risk or under watch.
- The user can dismiss the warning.
- The plan remains active after dismissal.
BVT-6 accept the recommended rebalance
Purpose Verify BR-6: the user can accept one corrective action and see the plan rebalanced. Recommended setup- Start from an active plan with a visible safe-to-spend value
- If a fast path is needed, log a large discretionary transaction early in the month so the pace breach is obvious
- Trigger a warning on an active plan.
- Choose
Accept recommendation.
- The plan updates immediately.
- For spending drift, remaining discretionary room becomes tighter.
- For goal drift, goal contribution target increases and discretionary room adjusts down.
- Daily guidance refreshes after the rebalance.
- The action feels like one clear correction, not a manual editing flow.
- The tester does not need the exact underlying formula to validate the feature
- The core pass condition is that Zeus identifies drift, recommends one clear action, and visibly updates the plan in a direction that matches the warning
BVT-7 month-end auto-close and summary
Purpose Verify BR-7: the prior month closes automatically and produces a useful reflection. Recommended setup- Use an active plan from a prior month if available
- If not, use a controlled environment where the daily plans job can be run after the calendar month changes
- Use an active plan from a prior month or move into a new month in a controlled test environment.
- Open Plans, run the daily plans job, or use the admin Plans manual trigger for that user.
- Open the completed plan from history.
- The prior month is no longer active.
- The prior month appears as completed.
- The plan detail view shows planned versus actual discretionary spend.
- The plan detail view shows planned versus actual goal contribution.
- The plan detail view shows one deterministic next-cycle suggestion.
- The summary should be understandable without reading raw transactions first
- The next-cycle suggestion should feel concrete and directionally correct even though it is rule-based rather than AI-generated
BVT-8 month-end notification
Purpose Verify that the user receives a post-cycle prompt to review the completed month. Steps- Complete BVT-7.
- Open Notifications.
- Open the month-end review CTA.
- One month-end notification appears for the completed plan.
- The CTA opens the plan summary.
- The notification does not duplicate once already sent for that completed plan.
BVT-9 review historical plans
Purpose Verify that completed plans remain useful after the current cycle changes. Steps- Open Plans with both a current plan and at least one completed historical plan.
- Review the historical list.
- Open one completed month.
- Historical plans are visible and identifiable by month.
- Completed plans show useful summary context.
- The user can inspect prior results without affecting the current month.
6. feature-by-feature acceptance checklist
| Feature | Pass condition |
|---|---|
| Plan creation | Recommendation is generated from user inputs and saved successfully |
| Plan activation | A draft becomes the active plan for the month |
| Safe-to-spend dashboard | Remaining monthly and daily guidance update after progress changes |
| Goal progress | Goal contribution target and actual progress are visible |
| Manual plan logging | Spending and savings logs affect plan state immediately |
| Reminder settings | User can enable, disable, and set one reminder time |
| Reminder delivery | One in-app reminder appears at the scheduled local time |
| Warning card | User sees one warning with explanation and clear choices |
| Rebalance accept | User can accept the recommendation and see updated values |
| Warning dismiss | User can dismiss the warning without breaking the active plan |
| Month-end closure | Prior active month transitions to completed automatically |
| Month-end summary | Completed plan shows planned versus actual plus one suggestion |
| Historical browsing | Users can reopen completed plans later |
7. edge cases to verify before pilot use
- User has no active plan for the current month but does have historical plans
- User creates a plan without linking a goal
- User enables a reminder and later disables it
- User logs spend only, save only, or both
- User dismisses a warning and later causes a new drift event
- User rebalances after a warning and the warning state clears
- User has a completed month but no month-end notification yet
- User opens the transaction CTA from a reminder more than once
8. recommended smoke path for demos
If a stakeholder demo needs the shortest convincing path, run this sequence:- Create and activate a plan
- Show current safe-to-spend and daily guide
- Turn on the daily reminder
- Log spending to trigger a warning
- Accept the rebalance recommendation
- Open a completed historical month and show the summary
- setup
- live guidance
- reminder
- intervention
- reflection
9. definition of pass
The current Plans MVP passes business verification when:- All end-to-end scenarios in section 5 succeed
- No duplicate reminder or month-end notifications appear in normal use
- Rebalance actions visibly change the active plan in a credible way
- Completed months remain understandable without additional explanation
- Stakeholders can use the feature set in a demo without needing hidden admin-only steps

