Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix yearly schedule templates #3511

Merged

Conversation

JukeboxRhino
Copy link
Contributor

Current behavior of template goals set to a schedule with frequency yearly are broken once the category is fully funded. This means budgeting into future months does not work as expected, in this case the full yearly amount is budgeted in the month following the transaction (instead of 1/12 the amount). The function that handles calculating the base savings amount has been updated to take yearly schedules into account.

Example of previous broken behavior:
image
image

The same budget file with the fix applied and templates re-ran:
image

@actual-github-bot actual-github-bot bot changed the title Fix yearly schedule templates [WIP] Fix yearly schedule templates Sep 26, 2024
Copy link
Contributor

coderabbitai bot commented Sep 26, 2024

Walkthrough

This pull request adds a new test case to the goalsSchedule function, which verifies its behavior when a yearly recurring schedule is set and the balance exceeds the target budget. Additionally, the getSinkingBaseContributionTotal function has been modified to improve the calculation of base contributions based on target frequency, specifically converting yearly contributions to a monthly figure. The goalsSchedule function has also been updated to reflect these changes in budget calculations.

Changes

Files Change Summary
packages/loot-core/src/server/budget/goals/goalsSchedule.test.ts
packages/loot-core/src/server/budget/goals/goalsSchedule.ts
Added a test case for the goalsSchedule function to check behavior with yearly schedules and exceeding balances.
Modified getSinkingBaseContributionTotal to adjust total base contribution calculations based on target frequency.

📜 Recent review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Files that changed from the base of the PR and between bb2e08e and 97932c3.

⛔ Files ignored due to path filters (1)
  • upcoming-release-notes/3511.md is excluded by !**/*.md
📒 Files selected for processing (2)
  • packages/loot-core/src/server/budget/goals/goalsSchedule.test.ts (1 hunks)
  • packages/loot-core/src/server/budget/goals/goalsSchedule.ts (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (2)
  • packages/loot-core/src/server/budget/goals/goalsSchedule.test.ts
  • packages/loot-core/src/server/budget/goals/goalsSchedule.ts

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link

netlify bot commented Sep 26, 2024

Deploy Preview for actualbudget ready!

Name Link
🔨 Latest commit 97932c3
🔍 Latest deploy log https://app.netlify.com/sites/actualbudget/deploys/66fdd874fe8a2d0008a38317
😎 Deploy Preview https://deploy-preview-3511.demo.actualbudget.org
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link
Contributor

github-actions bot commented Sep 26, 2024

Bundle Stats — desktop-client

Hey there, this message comes from a GitHub action that helps you and reviewers to understand how these changes affect the size of this project's bundle.

As this PR is updated, I'll keep you updated on how the bundle size is impacted.

Total

Files count Total bundle size % Changed
9 5.29 MB 0%

Changeset

No files were changed

View detailed bundle breakdown

Added

No assets were added

Removed

No assets were removed

Bigger

No assets were bigger

Smaller

No assets were smaller

Unchanged

Asset File Size % Changed
static/js/indexeddb-main-thread-worker-e59fee74.js 13.5 kB 0%
static/js/resize-observer.js 18.37 kB 0%
static/js/usePreviewTransactions.js 1.64 kB 0%
static/js/AppliedFilters.js 20.96 kB 0%
static/js/BackgroundImage.js 122.29 kB 0%
static/js/narrow.js 81.98 kB 0%
static/js/wide.js 225.26 kB 0%
static/js/ReportRouter.js 1.5 MB 0%
static/js/index.js 3.31 MB 0%

Copy link
Contributor

github-actions bot commented Sep 26, 2024

Bundle Stats — loot-core

Hey there, this message comes from a GitHub action that helps you and reviewers to understand how these changes affect the size of this project's bundle.

As this PR is updated, I'll keep you updated on how the bundle size is impacted.

Total

Files count Total bundle size % Changed
1 1.19 MB → 1.19 MB (+51 B) +0.00%
Changeset
File Δ Size
packages/loot-core/src/server/budget/goals/goalsSchedule.ts 📈 +137 B (+1.83%) 7.32 kB → 7.45 kB
View detailed bundle breakdown

Added

No assets were added

Removed

No assets were removed

Bigger

Asset File Size % Changed
kcab.worker.js 1.19 MB → 1.19 MB (+51 B) +0.00%

Smaller

No assets were smaller

Unchanged

No assets were unchanged

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Outside diff range and nitpick comments (3)
packages/loot-core/src/server/budget/goals/goalsSchedule.test.ts (2)

86-148: Good addition of a test case for yearly recurring schedules.

This test case effectively verifies the behavior of the goalsSchedule function for yearly recurring schedules when the balance meets the target. The setup and assertions are clear and align with the expected behavior.

Consider the following improvements to enhance test coverage:

  1. Add test cases for different months within the yearly cycle to ensure consistent behavior throughout the year.
  2. Include edge cases such as:
    • The first month of the cycle (August in this case)
    • The last month before the next cycle (July)
    • A month where the balance is slightly below or above the target

These additional tests will help ensure the function behaves correctly across various scenarios.

Consider updating the test description to be more specific:

-  it('should return correct budget when yearly recurring schedule set and balance is greater than target', async () => {
+  it('should return 1/12 of yearly budget when balance meets the target in a non-starting month', async () => {

This description more accurately reflects the specific scenario being tested.


86-148: Overall assessment: Good progress, but consider expanding test coverage

The new test case aligns well with the PR objectives, addressing the issue of yearly schedule templates when the category is fully funded. It verifies that the budgeting is correctly distributed (1/12 of the amount) across the year instead of allocating the full yearly amount in a single month.

To further strengthen the implementation and ensure robustness:

  1. Consider adding more test cases as suggested earlier to cover various scenarios throughout the yearly cycle.
  2. Ensure that the goalsSchedule function itself (not visible in this file) correctly handles all edge cases and variations of yearly schedules.
  3. If possible, include a test case that demonstrates the previous incorrect behavior (full yearly amount allocated in a single month) to clearly show the fix's impact.

These additions would provide more comprehensive coverage and increase confidence in the fix for yearly schedule templates.

packages/loot-core/src/server/budget/goals/goalsSchedule.ts (1)

169-173: LGTM! Consider adding a comment for clarity.

The changes correctly address the issue with yearly schedule templates by converting yearly amounts to monthly contributions. This fix aligns well with the PR objectives.

Consider adding a brief comment explaining the reasoning behind dividing by 12 for yearly frequencies. This would improve code readability and maintainability. For example:

 let monthlyAmount = t[ll].target / t[ll].target_interval;
 if (t[ll].target_frequency === 'yearly') {
+  // Convert yearly amount to monthly by dividing by 12
   monthlyAmount /= 12;
 }
 total += monthlyAmount;
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Files that changed from the base of the PR and between 4373f4d and 5eb6d4a.

⛔ Files ignored due to path filters (1)
  • upcoming-release-notes/3511.md is excluded by !**/*.md
📒 Files selected for processing (2)
  • packages/loot-core/src/server/budget/goals/goalsSchedule.test.ts (1 hunks)
  • packages/loot-core/src/server/budget/goals/goalsSchedule.ts (1 hunks)
🔇 Additional comments (2)
packages/loot-core/src/server/budget/goals/goalsSchedule.ts (2)

Line range hint 1-253: Summary of changes and impact

The modifications in this file are focused and effective:

  1. The getSinkingBaseContributionTotal function has been updated to handle yearly schedules correctly.
  2. These changes address the PR objective of fixing yearly schedule templates when the associated category is fully funded.
  3. The fix ensures that yearly amounts are properly distributed as monthly contributions.
  4. No other functions were modified, maintaining the overall structure and functionality of the file.

The changes appear to be minimal, targeted, and should resolve the reported issue without introducing new complexities or dependencies.


169-173: Verify the impact on the goalsSchedule function

The changes in getSinkingBaseContributionTotal correctly address the issue with yearly schedule templates. This fix ensures that the totalSinkingBaseContribution calculated in the goalsSchedule function will now be more accurately distributed for yearly schedules.

To confirm the correct implementation and usage, let's verify the goalsSchedule function:

This will help ensure that the goalsSchedule function correctly utilizes the updated getSinkingBaseContributionTotal for both yearly and non-yearly frequencies.

✅ Verification successful

Impact on the goalsSchedule Function Verified

The updates to getSinkingBaseContributionTotal correctly integrate with the goalsSchedule function, ensuring that yearly schedule templates now distribute the budget accurately across all months.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Verify the usage of getSinkingBaseContributionTotal in goalsSchedule

# Test: Check if goalsSchedule uses getSinkingBaseContributionTotal
rg --type typescript -A 10 'getSinkingBaseContributionTotal' packages/loot-core/src/server/budget/goals/goalsSchedule.ts

# Test: Verify if goalsSchedule handles both yearly and non-yearly frequencies
rg --type typescript -A 20 'goalsSchedule' packages/loot-core/src/server/budget/goals/goalsSchedule.ts

Length of output: 293


Script:

#!/bin/bash
# Description: Verify the usage of getSinkingBaseContributionTotal in goalsSchedule without specifying file type

# Test: Check if goalsSchedule uses getSinkingBaseContributionTotal
rg 'getSinkingBaseContributionTotal' packages/loot-core/src/server/budget/goals/goalsSchedule.ts --context 10

# Test: Verify if goalsSchedule handles both yearly and non-yearly frequencies
rg 'goalsSchedule' packages/loot-core/src/server/budget/goals/goalsSchedule.ts --context 20

Length of output: 2519

@JukeboxRhino JukeboxRhino changed the title [WIP] Fix yearly schedule templates Fix yearly schedule templates Sep 26, 2024
@JukeboxRhino JukeboxRhino force-pushed the fix/yearly-schedule-templates branch 2 times, most recently from d7d99f5 to bb2e08e Compare October 1, 2024 13:21
@youngcw
Copy link
Contributor

youngcw commented Oct 3, 2024

As far as I can tell this works fine, and doesn't break anything else. We will have to wait and see if any complaints come up about issues.

@youngcw youngcw merged commit d0caf9f into actualbudget:master Oct 3, 2024
19 checks passed
@JukeboxRhino JukeboxRhino deleted the fix/yearly-schedule-templates branch October 3, 2024 18:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants