Miscellaneous Fixes/Improvements for v0.3.3

[kryptodrex]

Fixes and Updates - v0.3.3 Planning

Release Goal

Ship a focused patch release that improves correctness, clarity, and UX in existing flows without introducing major new product surfaces.

---

v0.3.3 Patch Scope

Phase 1 - Calculation Correctness and Guardrails

Priority: Critical

• Fix Remaining amount behavior so it can go negative.
• Show a clear danger state when Remaining is below zero.
• Fix retirement contribution rounding to nearest hundredth.

Done Criteria:

• Remaining can display negative values correctly.
• Danger state appears consistently when Remaining < 0.
• Retirement contribution values are rounded to 2 decimals everywhere.

Phase 2 - Setup and Terminology UX Fixes

Priority: High

• In Setup Wizard, if currency is not USD, do not auto-default tax settings that assume USD-centric defaults.
• Fix glossary term component formatting so capitalization is preserved and terms are not unintentionally lowercased in the views.

Done Criteria:

• Non-USD setup no longer preloads inappropriate tax defaults.
• Glossary terms render with intended capitalization in all surfaces.
• Reset messaging is clear and lower-friction without changing underlying behavior.

Phase 3 - Plan Metadata Editing Improvements

Priority: High

• Add a dedicated modal for editing plan name and year.
• Year selection should provide: current plan year - 1, current plan year, current plan year + 1, plus Custom.
• Custom year input validation: min 2000, max current year + 10.

Done Criteria:

• Plan name/year can be edited in a modal flow.
• Preset year options + custom option are available.
• Validation prevents out-of-range years and provides actionable error messages.

Phase 4 - Account Editor Usability Adjustments

Priority: Medium

• Reorder Account editor layout so existing accounts appear first and Add New account controls appear at the bottom.
• Ensure Setup Wizard account step makes the pre-created account obvious in smaller window sizes.

Done Criteria:

• Existing accounts are immediately visible at top of editor.
• Add flow remains discoverable at bottom.
• Small-height viewport usability verified.

Phase 5 - Bills/Deductions Interaction Consistency (Patch-safe subset)

Priority: Medium

• Add Pause/Resume behavior to Deduction items, matching other item cards.
• Keep Add Deduction and Add Bill separate for v0.3.3 unless consolidation is trivial and low-risk.

Done Criteria:

• Deductions support paused state with matching card affordances.
• No regressions in tax-treatment handling for deductions.

Phase 6 - Pay Breakdown Information Architecture

Priority: Medium

• Move the "Your Pay Breakdown" visualization from Pay Breakdown tab to Key Metrics tab.
• Adjust the "visual flow" table in Pay Breakdown to have a title with a line under it similar to the After-Tax Allocations section, and rename it to something more fitting
• Place the moved visualization above "Money Flow Summary" in Key Metrics.
• Decide and implement one path for "Money Flow Summary" improvement vs removal.
• If retained: improve "Money Flow Summary" visualization for clarity and usefulness.
• If removed: ensure no redundant/confusing summary block remains after moving "Your Pay Breakdown".

Done Criteria:

• "Your Pay Breakdown" appears in Key Metrics above "Money Flow Summary".
• "Visual flow" table in Pay Breakdown is retitled and visually separated with a header and line.
• "Money Flow Summary" is either improved with clear value-add or intentionally removed.

---

Deferred Items from this patch (Likely Too Large for v0.3.3)

These are valuable, but likely too broad for a patch release and should be planned for a minor release stream.

• Consolidate Add Deduction + Add Bill into a unified Add Expense flow and modal (includes tax-treatment branching).
• Redesign Encryption Settings experience when accessed from an existing plan.
• Add estimated Bonus modeling (annual/quarterly/custom, percent or flat) and integrate into gross pay planning.
• Add optional display-level round-up controls for view-mode amounts.
• Standardize app-wide locale formatting by replacing hardcoded en-US number/date/currency formatting and using OS-locale defaults (Electron locale bridge already available).

Notes:

• Unified Expense flow is a workflow redesign, not just a patch tweak.
• Bonus modeling likely impacts data model, calculations, UI, and exports.
• Encryption settings redesign should include UX and security review together.