Release 1 Oct

[isharax9]

This pull request introduces a comprehensive "Envelope Budgeting" system, enabling users to visually track, transfer, and fill budget envelopes (categories) on a monthly basis. It adds new database structures, API endpoints, service logic, and automated tests to support envelope transfers, payday allocation, and envelope status tracking.

Envelope Budgeting System Enhancements:

• Database schema changes:

  • Added new fields to the User model for payday and household budgeting options, and notification preferences. [1] [2]
  • Introduced a new EnvelopeTransfer model/table to record transfers between budget envelopes, with supporting indexes and foreign key constraints. [1] [2]

• API endpoints and controller logic:

  • Added endpoints for retrieving envelope breakdowns (/envelopes), transferring funds between envelopes (/transfer), and batch filling envelopes (/fill-envelopes). Corresponding controller methods were implemented to handle these actions. [1] [2] [3]

• Envelope service logic:

  • Implemented getEnvelopes to calculate per-category envelope status, remaining cash, and recent transfer history for a given month/year.
  • Implemented transferEnvelopeFunds to move funds between envelopes atomically, updating limits and recording the transfer with audit logging.
  • Implemented fillEnvelopes for batch allocation of funds to envelopes, supporting both "set" and "add" modes, with audit logging.

• Validation and schema updates:

  • Added Zod schemas for envelope transfer and fill operations, ensuring strong input validation for new endpoints.

• Automated tests:

  • Added a new test suite (budgetGoals.envelopes.test.ts) covering envelope status calculations and atomic transfers between categories.

These changes lay the foundation for robust envelope-based budgeting, supporting user-friendly fund allocation, transfer, and tracking features.