Files
sure/test/controllers/goals_controller_test.rb
T
Nate Mendes 20b15442b4 feat(forms): parse pasted formatted amounts in money fields (#3300)
* feat(forms): parse pasted formatted amounts in money fields

Number inputs silently reject pasted values like "20,000 " or
"1.234,56", leaving the field blank. Money fields now intercept the
paste, run it through parseLocaleFloat (spaces stripped, thousands and
locale decimal separators handled), and insert the plain number — so
amounts copy cleanly out of statements and spreadsheets.

* fix(forms): reject non-amount pastes and honour currency precision

parseLocaleFloat coerces unparseable text to 0, so the finite check in
pasteAmount never fired. Pasting "$1,234.56" — or any stray text — wrote
0.00 over the field instead of falling through to the browser, which is
worse than the blank field the feature set out to fix. The clipboard text
is now validated first by a new parse_amount_paste util, which also strips
a leading or trailing currency symbol so statement formats parse, and
reads parenthesised amounts as negative rather than dropping the sign.

The precision fallback was hard-coded to 2 while the field renders with
the selected currency's default precision, so pasting into a BTC or KWD
amount lost digits. It is derived from the input's step instead, which
already tracks the live currency selection.

Dispatch change alongside input: auto_submit_form listens for change on
number inputs, so an auto-submitting money field never saved a pasted
value.

* fix(forms): read the sign before stripping the currency symbol

The currency strip ran before the sign was read and accepted any
non-digit run, so "$-500" parsed as +500 and "USD (1,200.00)" as +1200.
Since the handler also dispatches change, an auto-submitting money field
could post a debit as a credit. The same permissive strip turned prose
like "memo 500" into 500.

The text is matched against a strict grammar instead: an optional sign,
an optional currency symbol or code of at most three characters on either
side, and a number. The sign is read first so it survives the strip, and
parentheses still mark a negative with the currency allowed outside them.
Anything that does not fit returns null and the browser handles the paste.

* fix(forms): accept only symbols and ISO codes as currency markers

The currency token matched any one-to-three character non-digit run, so
"fee 500" and "500 tax" parsed as 500 rather than falling through to the
browser. With the change event this handler dispatches, an auto-submit
form could save an amount lifted out of prose.

A marker is now either a letter-free symbol or a three-letter uppercase
ISO code. Lowercase prose no longer matches. The cost is that markers
containing letters, "R$" and "kr" among them, are no longer stripped and
those pastes fall through untouched — the safe direction, since accepting
them means accepting "fee 500" too. Telling them apart would need the
server's currency list, which a paste event cannot wait for.

* fix(forms): strip only currency symbols from config/currencies.yml

Matching a currency marker by shape accepted anything shaped like one:
"TAX" satisfied the three-uppercase-letter branch and "***" satisfied the
symbol branch, so "TAX 500" and "*** 500" both parsed as 500 and could be
written into the field.

The marker is now one of the 29 letter-free symbols this app already
declares in config/currencies.yml, so the allowlist is the supported set
rather than a shape. Lettered markers, "USD" and "kr" and "R$" among them,
are no longer stripped: telling them from prose needs the currency list,
which a paste event cannot wait for, and leaving the field untouched is
the safer of the two failures.

* fix(forms): reject multi-cell pastes and keep step="any" precision

Three parsing gaps, all reachable from a normal paste.

Internal whitespace was allowed anywhere inside the digit run, so two
adjacent spreadsheet cells arrived as one amount: "100\t200" parsed as
100200 and "1,234.56\t500" as 1234.565. Only the spaces locales actually
use to group digits are accepted now (space, no-break space, narrow
no-break space), so "1 234,56" still parses and a tab- or newline-joined
paste falls through to the browser.

#pastePrecision fell back to two decimals whenever the step was not
numeric, and Number("any") is NaN. Four money fields render step="any"
with no precision — the trade amount, price and fee on trades/show and
the fee on trades/_form — so a sub-cent crypto price pasted there was
truncated to "0.00". A step that declares no precision now writes the
parsed value unrounded rather than rounding it to a guess.

The doc comment still used "USD (1,200.00)" as its worked example, which
stopped parsing when currency markers were narrowed to letter-free
symbols.

The cases now import the shipped parser instead of a hand-copied
duplicate, rewriting its importmap specifier to a file URL so Node can
resolve it. That deletes the copy that could drift, and the three new
multi-cell cases fail against the previous parse_amount_paste.js with
"actual: 100200, expected: null".

Verified with node --test test/javascript/. Ruby and lint checks are
unchanged by this commit; biome runs in CI.
2026-09-05 06:11:56 +02:00

1101 lines
42 KiB
Ruby

require "test_helper"
class GoalsControllerTest < ActionDispatch::IntegrationTest
include EntriesTestHelper
setup do
@user = users(:family_admin)
@user.update!(preferences: (@user.preferences || {}).merge("preview_features_enabled" => true))
sign_in @user
@goal = goals(:vacation_italy)
@depository = accounts(:depository)
@connected = accounts(:connected)
ensure_tailwind_build
end
test "redirects users without preview access" do
@user.update!(preferences: (@user.preferences || {}).merge("preview_features_enabled" => false))
get goals_url
assert_redirected_to root_path
assert_match(/preview/i, flash[:alert])
end
test "index renders with active filter by default" do
get goals_url
assert_response :success
assert_match(/Goals/i, response.body)
end
test "index honors state filter" do
get goals_url(state: "paused")
assert_response :success
end
test "show renders the goal" do
get goal_url(@goal)
assert_response :success
assert_match(@goal.name, response.body)
end
test "new renders the modal form" do
get new_goal_url
assert_response :success
end
test "the target amount field keeps its own action alongside the paste handler" do
get new_goal_url
assert_response :success
assert_select "input[data-money-field-target=?][data-action=?]", "amount",
"input->goal-form#suggestedChanged paste->money-field#pasteAmount"
end
test "create persists a goal with linked accounts" do
# Fresh accounts: the goal fixtures already claim @depository and
# @connected in full, and GoalAccount refuses a second whole-balance
# link on a contested account. Blank allocations here keep this test on
# the default "dedicate the whole balance" path.
first = unclaimed_account("Holiday Pot")
second = unclaimed_account("House Pot")
assert_difference -> { Goal.count } => 1,
-> { GoalAccount.count } => 2 do
post goals_url, params: {
goal: {
name: "New goal",
target_amount: "1000",
target_date: 3.months.from_now.to_date.iso8601,
color: "#4da568",
account_ids: [ first.id, second.id ]
}
}
end
goal = Goal.order(created_at: :desc).first
assert_redirected_to goal_path(goal)
end
test "create rejects missing account_ids" do
assert_no_difference "Goal.count" do
post goals_url, params: {
goal: {
name: "Bad goal",
target_amount: "1000",
color: "#4da568"
}
}
end
assert_response :unprocessable_entity
end
test "create rejects foreign accounts" do
other_family = Family.create!(name: "Other", currency: "USD", locale: "en", country: "US", timezone: "UTC")
foreign = Account.create!(family: other_family, accountable: Depository.new, name: "Foreign", currency: "USD", balance: 100)
assert_no_difference "Goal.count" do
post goals_url, params: {
goal: {
name: "Foreign goal",
target_amount: "1000",
color: "#4da568",
account_ids: [ foreign.id ]
}
}
end
assert_response :unprocessable_entity
end
test "new form excludes same-family accounts not shared with the current user" do
# Regression for #2168: funding-account picker leaked accounts owned by
# other family members that were never shared with the current user.
private_account = Account.create!(
family: @user.family,
owner: users(:family_member),
accountable: Depository.new,
name: "Member Private Checking",
currency: "USD",
balance: 100
)
get new_goal_url
assert_response :success
assert_no_match(/Member Private Checking/, response.body)
assert_no_match(/goal_account_ids_#{private_account.id}/, response.body)
end
# A goal can be backed by an account the viewer is not allowed to see. Both
# halves of that leak matter: the dialog naming it, and a direct POST moving
# its earmark — the figures afterwards saying how much was in it.
test "the consumption dialog does not name a linked account the viewer cannot see" do
private_account = private_linked_account
get consume_goal_url(@goal)
assert_response :success
assert_no_match(/Member Private Checking/, response.body)
assert_no_match(/#{private_account.id}/, response.body)
end
test "consumption is refused against a linked account the viewer cannot see" do
private_account = private_linked_account
link = @goal.goal_accounts.find_by(account_id: private_account.id)
post consume_goal_url(@goal), params: { amount: "100", account_id: private_account.id }
assert_redirected_to goal_path(@goal)
assert_equal 0, @goal.reload.consumed_amount
assert_equal 500, link.reload.allocated_amount
end
# The outflow panel is the third door onto a private backing account: it
# would list its transactions, naming the account, its spending and roughly
# its size to someone with no access to it.
test "the outflow panel does not surface a spend on an account the viewer cannot see" do
private_account = private_linked_account
private_account.entries.create!(
name: "Private Spend", date: Date.current, amount: 400,
currency: private_account.currency, entryable: Transaction.new
)
get goal_url(@goal)
assert_response :success
assert_no_match(/Private Spend/, response.body)
end
test "create rejects a same-family account not shared with the current user" do
private_account = Account.create!(
family: @user.family,
owner: users(:family_member),
accountable: Depository.new,
name: "Member Private Checking",
currency: "USD",
balance: 100
)
assert_no_difference "Goal.count" do
post goals_url, params: {
goal: {
name: "Sneaky goal",
target_amount: "1000",
color: "#4da568",
account_ids: [ private_account.id ]
}
}
end
assert_response :unprocessable_entity
end
test "update modifies identity fields" do
patch goal_url(@goal), params: { goal: { name: "Renamed" } }
assert_redirected_to goal_path(@goal)
assert_equal "Renamed", @goal.reload.name
end
test "update without account_ids leaves linked accounts intact" do
before = @goal.goal_accounts.pluck(:account_id).sort
patch goal_url(@goal), params: { goal: { name: "Still here" } }
assert_redirected_to goal_path(@goal)
assert_equal before, @goal.reload.goal_accounts.pluck(:account_id).sort
end
test "update with account_ids syncs linked accounts (add + remove)" do
patch goal_url(@goal), params: { goal: { account_ids: [ @connected.id ] } }
assert_redirected_to goal_path(@goal)
assert_equal [ @connected.id ], @goal.reload.goal_accounts.pluck(:account_id)
end
test "update preserves a linked account the current user cannot access" do
# Regression for #2172 review: a family goal can be linked to a private
# account owned by another member. That account is never rendered in the
# picker, so its absence from the submitted set must not unlink it.
private_account = Account.create!(
family: @user.family,
owner: users(:family_member),
accountable: Depository.new,
name: "Member Private Checking",
currency: @goal.currency,
balance: 100
)
@goal.goal_accounts.create!(account: private_account)
patch goal_url(@goal), params: { goal: { account_ids: [ @depository.id ] } }
assert_redirected_to goal_path(@goal)
linked = @goal.reload.goal_accounts.pluck(:account_id)
assert_includes linked, private_account.id, "inaccessible private link must be preserved"
assert_includes linked, @depository.id
end
test "update with empty account_ids re-renders with error" do
patch goal_url(@goal), params: { goal: { account_ids: [ "" ] } }
assert_response :unprocessable_entity
assert_not_empty @goal.reload.goal_accounts
end
test "update rejects a cross-currency account attachment" do
# Regression: sync_linked_accounts! used to call goal_accounts.create!
# directly, bypassing Goal#linked_accounts_must_match_goal_currency.
eur_account = Account.create!(
family: @goal.family,
accountable: Depository.new,
name: "EUR Checking",
currency: "EUR",
balance: 100
)
before_ids = @goal.goal_accounts.pluck(:account_id).sort
patch goal_url(@goal), params: { goal: { account_ids: [ eur_account.id ] } }
assert_response :unprocessable_entity
assert_equal before_ids, @goal.reload.goal_accounts.pluck(:account_id).sort
end
test "pause/resume/complete/archive/unarchive flow" do
fresh = goals(:emergency_fund)
patch pause_goal_url(fresh)
assert fresh.reload.paused?
patch resume_goal_url(fresh)
assert fresh.reload.active?
patch complete_goal_url(fresh)
assert fresh.reload.completed?
patch archive_goal_url(fresh)
assert fresh.reload.archived?
patch unarchive_goal_url(fresh)
assert fresh.reload.active?
end
# The reported bug: Delete rendered only when the goal was archived, so an
# active goal had no delete affordance anywhere in the UI. The kebab is the
# only route to it, so assert the form is actually in the markup per state —
# a 200 alone would not have caught the original miss.
test "show exposes delete for a goal in every state" do
delete_form = "form[action='#{goal_path(@goal)}'] input[name='_method'][value='delete']"
%w[active paused completed archived].each do |state|
@goal.update_column(:state, state)
get goal_url(@goal)
assert_response :success
assert_select delete_form, 1, "no delete affordance on a #{state} goal"
end
end
# A goal whose last funding account is deleted survives with zero links and
# fails `must_have_at_least_one_linked_account` from then on. Editing is the
# only way back, so update must validate the accounts the user SUBMITTED,
# not the stale (empty) set already on the record.
test "an orphaned goal can be repaired by re-linking an account" do
orphan = orphaned_goal
rescue_account = unclaimed_account("Rescue Pot")
patch goal_url(orphan), params: {
goal: { name: orphan.name, target_amount: orphan.target_amount, account_ids: [ rescue_account.id ] }
}
assert_redirected_to goal_path(orphan)
assert_equal [ rescue_account.id ], orphan.reload.goal_accounts.pluck(:account_id)
assert orphan.valid?
end
# AASM's bang event returns false rather than raising when the post-transition
# save fails validation. The controller used to discard that, flashing
# "Goal archived." while the state never moved.
test "a transition that fails validation reports the error, not success" do
orphan = orphaned_goal
patch archive_goal_url(orphan)
assert_redirected_to goal_path(orphan)
assert_nil flash[:notice]
assert_match(/at least one account/i, flash[:alert])
assert_equal "active", orphan.reload.state
end
test "destroy deletes an active goal and cascades to its links and pledges" do
assert_difference -> { Goal.count } => -1,
-> { GoalAccount.count } => -2,
-> { GoalPledge.count } => -2 do
delete goal_url(@goal)
end
assert_redirected_to goals_path
end
test "destroy deletes an archived goal" do
@goal.archive!
assert_difference "Goal.count", -1 do
delete goal_url(@goal)
end
assert_redirected_to goals_path
end
# The one thing a goal delete reaches outside its own tables: a matched
# pledge stamps `extra["goal"]["pledge_id"]` onto the transaction it claimed,
# and GoalPledge#clear_matched_transaction_extra must unstamp it on the way
# out. The transaction itself must survive untouched.
test "destroy unstamps the transaction a matched pledge claimed" do
txn = create_transaction(account: @connected, amount: -300).entryable
pledge = goal_pledges(:matched_transfer)
txn.update!(extra: { "goal" => { "pledge_id" => pledge.id } })
pledge.update_column(:matched_transaction_id, txn.id)
delete goal_url(@goal)
assert_redirected_to goals_path
assert Transaction.exists?(txn.id), "deleting a goal must not delete the transaction"
assert_nil txn.reload.extra.dig("goal", "pledge_id")
end
test "index KPI swaps to 'All caught up' when every tracked goal is reached" do
family = users(:family_admin).family
family.goals.destroy_all
# Real reached state: target $1 against the depository fixture's
# $5000 balance. Stubbing :status hides whether the controller
# actually reads the right method on each goal.
build_goal(family, "Wedding", target_amount: 1, target_date: 1.year.from_now)
get goals_url
assert_response :success
assert_match(/All caught up/i, response.body)
assert_match(/1\s*reached/i, response.body)
end
test "index KPI 'on track' denominator excludes no-target-date goals" do
family = users(:family_admin).family
family.goals.destroy_all
# One trackable goal (has target_date) + one open-ended (no target_date).
# The trackable one should be the only thing in the denominator;
# open-ended goals can't be off pace because they have no required pace.
build_goal(family, "House", target_amount: 1_000_000, target_date: 1.year.from_now)
build_goal(family, "Emergency", target_amount: 1_000_000, target_date: nil)
get goals_url
assert_response :success
# Expect "0 of 1" — the open-ended goal stays out of the fraction
# even though it's active.
assert_match(/0\s*of\s*1/i, response.body)
assert_match(/without a deadline/i, response.body)
end
# The form reads its ticks from a separate local, not from the built links,
# so a failed create rendered every account unchecked while the amounts the
# user typed survived — an error telling them to enter an amount, on a form
# whose accounts had silently cleared.
test "a rejected creation keeps the accounts the user ticked" do
account = Account.create!(
family: @user.family, accountable: Depository.new,
name: "Contested Pot", currency: @user.family.currency, balance: 3_000
)
holder = @user.family.goals.create!(name: "Holder", target_amount: 5_000, currency: @user.family.currency) do |g|
g.goal_accounts.build(account: account)
end
assert holder.persisted?
post goals_url, params: {
goal: {
name: "Second claim", target_amount: 5_000,
account_ids: [ account.id ], allocations: { account.id.to_s => "" }
}
}
assert_response :unprocessable_entity
assert_select "input[type=checkbox][name='goal[account_ids][]'][value=?][checked]", account.id
end
# --- Lot B2: closing a reached goal ---
# The panel used to say "Goal closed at ..." for a goal that was merely at
# 100%, and offer Archive — the gesture that does NOT release the money.
test "a one_off goal at 100 percent is offered closing, not archiving" do
goal = fully_funded_goal
get goal_url(goal)
assert_response :success
assert_match I18n.t("goals.show.celebration.close_cta"), response.body
assert_match I18n.t("goals.show.celebration.close_hint"), response.body
assert_no_match(/#{Regexp.escape(I18n.t("goals.show.celebration.archive_cta"))}/, response.body)
end
test "a goal below 100 percent is offered no closing action" do
goal = fully_funded_goal
goal.update!(target_amount: 10_000)
get goal_url(goal)
assert_response :success
assert_no_match(/#{Regexp.escape(I18n.t("goals.show.celebration.close_cta"))}/, response.body)
end
# Reaching the target is the normal state of a reserve, not a prompt to
# close it — and B3 forbids `complete` for them outright.
test "a maintained goal at 100 percent is never offered closing" do
goal = fully_funded_goal
goal.update_column(:kind, "maintained")
get goal_url(goal)
assert_response :success
assert_no_match(/#{Regexp.escape(I18n.t("goals.show.celebration.close_cta"))}/, response.body)
end
test "a completed goal shows the amount and date it froze" do
goal = fully_funded_goal
goal.complete!
get goal_url(goal)
assert_response :success
assert_match I18n.t("goals.show.celebration.frozen",
date: I18n.l(goal.reload.completed_at.to_date, format: :long),
amount: goal.current_balance_money.format(precision: 0)),
response.body
assert_no_match(/#{Regexp.escape(I18n.t("goals.show.celebration.close_cta"))}/, response.body)
end
test "an archived goal is offered no closing action" do
goal = fully_funded_goal
goal.archive!
get goal_url(goal)
assert_response :success
assert_no_match(/#{Regexp.escape(I18n.t("goals.show.celebration.close_cta"))}/, response.body)
end
# --- Lot B3a: reserves ---
test "create accepts the maintained kind" do
account = unclaimed_account("Reserve Pot")
assert_difference -> { Goal.count }, 1 do
post goals_url, params: {
goal: { name: "Emergency", target_amount: "6000", color: "#4da568", kind: "maintained", account_ids: [ account.id ] }
}
end
assert Goal.order(created_at: :desc).first.maintained?
end
# The AASM guard refuses the transition; the controller must report that
# rather than claim success or blow up.
test "completing a reserve is refused at the controller too" do
goal = fully_funded_goal
goal.update_column(:kind, "maintained")
patch complete_goal_url(goal)
assert_redirected_to goal_path(goal)
assert_match(/./, flash[:alert].to_s)
assert_equal "active", goal.reload.state
end
test "a funded reserve reads as intact, with nothing to do" do
goal = fully_funded_goal
goal.update_column(:kind, "maintained")
get goal_url(goal)
assert_response :success
assert_match I18n.t("goals.show.celebration.heading_reserve"), response.body
assert_no_match(/#{Regexp.escape(I18n.t("goals.show.celebration.close_cta"))}/, response.body)
assert_no_match(/#{Regexp.escape(I18n.t("goals.show.celebration.archive_cta"))}/, response.body)
end
# A reserve has no deadline and no pace benchmark, so it can never land in
# the on-track numerator. Leaving it in the denominator made a family with
# one reserve read "0 of 1 on track" for a goal working exactly as intended.
test "a reserve stays out of the on-track denominator" do
@user.family.goals.where.not(state: "archived").find_each(&:archive!)
account = Account.create!(
family: @user.family, accountable: Depository.new,
name: "Reserve Pot", currency: @user.family.currency, balance: 1_000
)
@user.family.goals.create!(
name: "Precaution", target_amount: 6_000, currency: @user.family.currency, kind: "maintained"
) { |g| g.goal_accounts.build(account: account) }
get goals_url
assert_response :success
# The tile prints "<on track> of <tracked total>". The reserve must not
# appear in the denominator: before this, the page read "0 of 1".
assert_no_match(/0 of 1/, response.body)
assert_match(/0 of 0/, response.body)
end
# A brand-new reserve is depleted with a zero balance, which used to match the
# generic "make your first transfer" branch first. It is still a reserve short
# of its floor, and the shortfall panel is what says so.
test "a reserve with nothing in it yet gets the shortfall panel" do
account = Account.create!(
family: @user.family, accountable: Depository.new,
name: "Empty Reserve Pot", currency: @user.family.currency, balance: 0
)
goal = @user.family.goals.create!(
name: "Precaution", target_amount: 6_000, currency: @user.family.currency, kind: "maintained"
) { |g| g.goal_accounts.build(account: account) }
get goal_url(goal)
assert_response :success
assert_match I18n.t("goals.show.reserve_shortfall.heading"), response.body
assert_no_match(/#{Regexp.escape(I18n.t("goals.show.empty.heading"))}/, response.body)
end
# --- Lot B6: earmark headroom in the form ---
test "the new form renders each account's balance and what other goals hold" do
account = unclaimed_account("Headroom Pot")
@user.family.goals.create!(name: "Neighbour", target_amount: 5_000, currency: "USD") do |g|
g.goal_accounts.build(account: account, allocated_amount: 400)
end
get new_goal_url
assert_response :success
assert_select "[data-balance][data-earmarked-by-others]", minimum: 1
assert_match 'data-earmarked-by-others="400.0"', response.body
end
# The N+1 this lot exists to avoid: the form lists every fundable account,
# so reading the pool per account would scale with the account list.
test "the form reads the shared pool exactly once, however many accounts" do
3.times { |i| unclaimed_account("Pool Pot #{i}") }
assert_equal 1, count_pool_queries { get new_goal_url }
assert_response :success
end
# The acceptance criterion of this lot: reopening a goal must not count its
# own earmark, or re-entering the same figure would trip a message about a
# setup the user has not touched.
test "the edit form does not count the edited goal's own earmark" do
account = unclaimed_account("Reopen Pot")
goal = @user.family.goals.create!(name: "Reopened", target_amount: 5_000, currency: "USD") do |g|
g.goal_accounts.build(account: account, allocated_amount: 5_000)
end
get edit_goal_url(goal)
assert_response :success
assert_match 'data-earmarked-by-others="0.0"', response.body
assert_no_match(/data-earmarked-by-others="5000/, response.body)
end
# The error paths re-render the same form, so they need the pool too —
# without it the row helper is handed nil and the render blows up.
test "the pool is available again when create re-renders after an error" do
unclaimed_account("Error Pot")
post goals_url, params: { goal: { name: "No accounts", target_amount: "1000", color: "#4da568" } }
assert_response :unprocessable_entity
assert_select "[data-balance][data-earmarked-by-others]", minimum: 1
end
# --- Lot B4: recording a partial spend ---
test "recording a spend keeps the goal at full progress and frees the earmark" do
account = Account.create!(
family: @user.family, accountable: Depository.new,
name: "Trip Pot", currency: @user.family.currency, balance: 5_000
)
goal = @user.family.goals.create!(name: "Trip", target_amount: 5_000, currency: @user.family.currency) do |g|
g.goal_accounts.build(account: account, allocated_amount: 5_000)
end
post consume_goal_url(goal), params: { amount: 2_000 }
assert_redirected_to goal_url(goal)
assert_equal 2_000, goal.reload.consumed_amount
assert_equal 3_000, goal.goal_accounts.first.reload.allocated_amount
end
test "a refused spend says which rule refused it" do
account = Account.create!(
family: @user.family, accountable: Depository.new,
name: "Reserve Pot", currency: @user.family.currency, balance: 4_000
)
reserve = @user.family.goals.create!(
name: "Precaution", target_amount: 6_000, currency: @user.family.currency, kind: "maintained"
) { |g| g.goal_accounts.build(account: account) }
post consume_goal_url(reserve), params: { amount: 1_000 }
assert_redirected_to goal_url(reserve)
assert_equal I18n.t("goals.consume.errors.maintained"), flash[:alert]
assert_equal 0, reserve.reload.consumed_amount
end
# A blank account id means "this goal has one link". An id resolving to
# nothing must not fall back to that, or a single-link goal would record a
# spend against an account the user never named.
test "an unknown account id is refused rather than falling through" do
account = Account.create!(
family: @user.family, accountable: Depository.new,
name: "Trip Pot", currency: @user.family.currency, balance: 5_000
)
goal = @user.family.goals.create!(name: "Trip", target_amount: 5_000, currency: @user.family.currency) do |g|
g.goal_accounts.build(account: account, allocated_amount: 5_000)
end
post consume_goal_url(goal), params: { amount: 1_000, account_id: SecureRandom.uuid }
assert_equal I18n.t("goals.consume.errors.account_not_linked"), flash[:alert]
assert_equal 0, goal.reload.consumed_amount
end
# --- Lot B5: attributing an outflow the app spotted ---
test "the goal page offers an outflow nothing has claimed" do
goal, entry = goal_with_outflow
get goal_url(goal)
assert_response :success
assert_match I18n.t("goals.unattributed_outflows.heading"), response.body
assert_match entry.name, response.body
end
test "attributing an outflow takes its amount and stops offering it" do
goal, entry = goal_with_outflow
post consume_goal_url(goal), params: { transaction_id: entry.entryable_id }
assert_redirected_to goal_url(goal)
assert_equal entry.amount.to_d, goal.reload.consumed_amount
get goal_url(goal)
assert_no_match I18n.t("goals.unattributed_outflows.heading"), response.body
end
# The stamp is what makes this idempotent: replaying the same attribution
# must not credit the goal twice for one spend.
test "the same outflow cannot be attributed twice" do
goal, entry = goal_with_outflow
post consume_goal_url(goal), params: { transaction_id: entry.entryable_id }
recorded = goal.reload.consumed_amount
post consume_goal_url(goal), params: { transaction_id: entry.entryable_id }
assert_equal recorded, goal.reload.consumed_amount
assert_equal I18n.t("goals.consume.errors.transaction_not_found"), flash[:alert]
end
# The months mode could not be created from the UI at all. The form makes the
# amount read-only, so it submits empty; `target_amount` is required and
# validations run before any save callback, so the derivation that fills it
# never ran. Every existing test set the amount explicitly, which is why the
# model looked fine.
test "a months-of-expenses reserve can be created without typing an amount" do
account = unclaimed_account("Reserve Pot")
IncomeStatement.any_instance.stubs(:median_expense).returns(500)
assert_difference -> { Goal.count }, 1 do
post goals_url, params: { goal: {
name: "Precaution", color: "#4da568", kind: "maintained",
target_mode: "months_of_expenses", target_months: "6",
target_amount: "", account_ids: [ account.id ]
} }
end
goal = Goal.order(created_at: :desc).first
assert_equal 3_000, goal.target_amount.to_d, "the floor was not derived from the months"
assert goal.maintained?
end
# A fixed reserve still needs one, and still says so. Asserted on the error the
# form puts in front of the user, not on the status alone: a 422 for some
# unrelated reason would otherwise keep this green while the guard it names
# had quietly gone.
test "a fixed-amount goal still requires the amount" do
account = unclaimed_account("Fixed Pot")
assert_no_difference -> { Goal.count } do
post goals_url, params: { goal: {
name: "No amount", color: "#4da568",
target_amount: "", account_ids: [ account.id ]
} }
end
assert_response :unprocessable_entity
# The paragraph is in the markup either way; `hidden` is what decides
# whether it is shown, so its absence is the assertion.
assert_select "[data-goal-form-target=amountError]:not(.hidden)", 1,
"the form did not surface the missing-amount error"
end
# The surface the user actually reads: the figure beside the ring, and the
# line saying part of it has been used. Asserted on the rendered page rather
# than the model, because the contradiction was a display bug — the model
# has always counted both halves.
test "the goal page reports the used portion as part of the total" do
goal = spent_goal_for_display
get goal_url(goal)
assert_response :success
assert_includes response.body, I18n.t("goals.show.ring.including_used",
amount: goal.consumed_amount_money.format(precision: 0))
# The headline figure specifically, not "somewhere on the page": the
# account balance still appears in the funding breakdown below, which is
# where that question belongs.
headline = css_select("p.text-xl.font-medium.text-primary").map(&:text).map(&:strip)
assert_includes headline, goal.progress_amount_money.format(precision: 0)
assert_not_includes headline, goal.current_balance_money.format(precision: 0)
end
test "a goal that has spent nothing says nothing about it" do
account = unclaimed_account("Quiet Pot")
goal = @user.family.goals.create!(name: "Quiet", target_amount: 1_000, currency: "USD") do |g|
g.goal_accounts.build(account: account, allocated_amount: 1_000)
end
get goal_url(goal)
assert_response :success
assert_no_match(/already used|déjà utilisés/, response.body)
end
# The ring announced the account balance while the visible headline beside it
# reported the progress total: same ring, two different numbers depending on
# whether you could see it.
test "the ring announces the same total the headline shows" do
goal = spent_goal_for_display
get goal_url(goal)
assert_response :success
label = css_select("[role=progressbar]").first["aria-label"]
assert_includes label, goal.progress_amount_money.format
assert_not_includes label, goal.current_balance_money.format
assert_includes label, goal.consumed_amount_money.format
end
test "a goal with nothing used keeps the plain wording" do
account = unclaimed_account("Plain Pot")
goal = @user.family.goals.create!(name: "Plain", target_amount: 1_000, currency: "USD") do |g|
g.goal_accounts.build(account: account, allocated_amount: 1_000)
end
get goal_url(goal)
label = css_select("[role=progressbar]").first["aria-label"]
assert_no_match(/already used|déjà utilisés/, label)
end
# A reserve holds a balance rather than reaching an amount. "Target balance"
# is what this kind of app calls that, and it keeps the noun the rest of the
# page already uses 55 times — rather than inventing a "level" or a "floor"
# that nothing else in the domain says.
test "the form carries both the amount and the balance wording" do
unclaimed_account("Vocab Pot")
get new_goal_url
assert_response :success
assert_includes response.body, I18n.t("goals.form.fields.target_amount")
assert_includes response.body, I18n.t("goals.form.fields.target_balance")
end
# In months mode the balance is worked out, not typed. A read-only input
# still reads as something to fill in, beside the months that are the real
# question, so the figure is presented as a result instead.
test "the form carries the derived balance as a result, not a field" do
unclaimed_account("Derived Pot")
get new_goal_url
assert_response :success
assert_select "[data-goal-kind-target=amountDerived]", 1
assert_includes response.body, I18n.t("goals.form.fields.target_balance_pending")
end
test "editing a months reserve shows the balance it currently holds" do
account = unclaimed_account("Existing Pot")
IncomeStatement.any_instance.stubs(:median_expense).returns(500)
goal = @user.family.goals.create!(
name: "Precaution", target_amount: 3_000, currency: "USD", kind: "maintained",
target_mode: "months_of_expenses", target_months: 6
) { |g| g.goal_accounts.build(account: account, allocated_amount: 3_000) }
get edit_goal_url(goal)
assert_response :success
assert_includes response.body, goal.target_amount_money.format(precision: 0)
end
# One vocabulary, not three. "level" and "floor" said the same thing as
# "target balance" in different words, on the same page.
test "the goals copy settles on one word for a reserve's balance" do
%i[en fr].each do |locale|
copy = YAML.load_file(Rails.root.join("config/locales/views/goals/#{locale}.yml")).to_s
assert_no_match(/\bfloor\b|\bniveau\b/i, copy, "#{locale} still mixes vocabularies")
end
end
# The gap this closes: at the moment the user has reached the target and
# spent some of it, the page offered only "Close this goal" — which releases
# the earmark, and whose own hint says to do it once the money is actually
# spent. Saying so was two clicks away in the overflow menu.
test "a reached goal offers recording a spend outside the overflow menu" do
goal = reached_goal_holding_money
get goal_url(goal)
assert_response :success
# In the panel, not only in the menu: scoped to the celebration panel's own
# action row by id. `section` was not enough — the panel renders through
# DS::Card, which emits a <section>, so any card on the page satisfied it.
panel_links = css_select("#goal-celebration-actions a[href='#{consume_goal_path(goal)}']")
assert_operator panel_links.size, :>=, 1,
"the spend action was still only reachable through the overflow menu"
end
test "closing is still offered alongside it" do
goal = reached_goal_holding_money
get goal_url(goal)
assert_select "form[action=?]", complete_goal_path(goal)
end
# Two doors lead to the same dialog, the panel and the overflow menu, and they
# disagreed: the menu gated on `current_balance`, which counts every linked
# account including ones private to another member. A reader backed only by
# such an account was shown the entry, opened a dialog with nothing to pick,
# and was refused on submit. Asserted page-wide on purpose — neither door may
# offer it.
test "money the reader cannot reach opens no door to the spend dialog" do
account = Account.create!(
family: @user.family, owner: users(:family_member), accountable: Depository.new,
name: "Member Only Pot", currency: "USD", balance: 5_000
)
goal = @user.family.goals.create!(name: "Hidden", target_amount: 5_000, currency: "USD") do |g|
g.goal_accounts.build(account: account, allocated_amount: 5_000)
end
get goal_url(goal)
assert_response :success
assert goal.current_balance.to_d.positive?, "the goal is backed, just not for this reader"
assert_empty css_select("a[href='#{consume_goal_path(goal)}']"),
"a spend was still offered against money the reader cannot see"
end
private
def spent_goal_for_display
account = Account.create!(
family: @user.family, accountable: Depository.new,
name: "Spent Pot", currency: "USD", balance: 5_000
)
goal = @user.family.goals.create!(name: "Trip", target_amount: 5_000, currency: "USD") do |g|
g.goal_accounts.build(account: account, allocated_amount: 5_000)
end
goal.consume!(2_000)
goal
end
def reached_goal_holding_money
account = Account.create!(
family: @user.family, accountable: Depository.new,
name: "Reached Pot", currency: "USD", balance: 5_000
)
@user.family.goals.create!(name: "Trip", target_amount: 5_000, currency: "USD") do |g|
g.goal_accounts.build(account: account, allocated_amount: 5_000)
end
end
# SQL the pooled-allocation read issues, and nothing else: goal_accounts
# joined to goals.
def count_pool_queries
count = 0
sub = ActiveSupport::Notifications.subscribe("sql.active_record") do |*, payload|
sql = payload[:sql].to_s
count += 1 if sql.include?("FROM \"goal_accounts\"") && sql.include?("INNER JOIN \"goals\"")
end
yield
count
ensure
ActiveSupport::Notifications.unsubscribe(sub)
end
# The row must carry both readings, since one of them is invisible to the
# other: a whole-account claim elsewhere sums to zero, and without the flag
# the form would tell the user the account is theirs alone and then refuse
# the blank allocation on submit.
test "each account row carries the whole-account claim as well as the sum" do
account = unclaimed_account("Claimed Pot")
@user.family.goals.create!(name: "Neighbour", target_amount: 5_000, currency: "USD") do |g|
g.goal_accounts.build(account: account)
end
get new_goal_url
assert_response :success
assert_match(/data-earmarked-by-others="0(\.0)?"[^>]*data-whole-account-claimed="true"/m, response.body)
end
# The hint for a blank amount is chosen client-side from two strings the
# form hands over. A missing one does not raise — the value reads as
# undefined and the line renders empty — so the wiring is what needs
# pinning, not the ternary that picks between them.
test "the form carries both blank-amount hints" do
unclaimed_account("Hint Pot")
get new_goal_url
assert_response :success
# Escaped: the copy carries an apostrophe, and the attribute value in the
# response is HTML-escaped.
assert_includes response.body, ERB::Util.html_escape(I18n.t("goals.form.earmark.whole_balance_alone"))
assert_includes response.body, ERB::Util.html_escape(I18n.t("goals.form.earmark.whole_balance"))
end
# The two must stay distinguishable: if they ever say the same thing, the
# branch is doing nothing and a first-time user is back to being told about
# earmarks that do not exist.
test "the two blank-amount hints say different things" do
assert_not_equal I18n.t("goals.form.earmark.whole_balance"),
I18n.t("goals.form.earmark.whole_balance_alone")
assert_no_match(/earmark/i, I18n.t("goals.form.earmark.whole_balance_alone"),
"the hint shown with no other claims should not mention earmarks")
end
private
# A private account of another member, linked to the goal under test.
def private_linked_account
account = Account.create!(
family: @user.family,
owner: users(:family_member),
accountable: Depository.new,
name: "Member Private Checking",
currency: @goal.currency,
balance: 1_000
)
@goal.goal_accounts.create!(account: account, allocated_amount: 500)
account
end
def goal_with_outflow
account = Account.create!(
family: @user.family, accountable: Depository.new,
name: "Trip Pot #{SecureRandom.hex(4)}", currency: @user.family.currency, balance: 5_000
)
goal = @user.family.goals.create!(
name: "Trip", target_amount: 5_000, currency: @user.family.currency
) { |g| g.goal_accounts.build(account: account, allocated_amount: 5_000) }
entry = account.entries.create!(
name: "Flights", date: Date.current, amount: 1_200,
currency: account.currency, entryable: Transaction.new
)
[ goal, entry ]
end
# An active one_off goal sitting exactly at its target, on an account no
# other goal claims.
def fully_funded_goal
account = Account.create!(
family: @user.family, accountable: Depository.new,
name: "Funded Pot", currency: "USD", balance: 2_000
)
@user.family.goals.create!(name: "Funded", target_amount: 2_000, currency: "USD") do |g|
g.goal_accounts.build(account: account)
end
end
# A fundable account no goal fixture claims. The fixtures link
# @depository and @connected as whole-balance earmarks, and GoalAccount
# refuses a second whole-balance link on an account already claimed in
# full — so any test that wants the default "dedicate the whole balance"
# link needs an account of its own.
def unclaimed_account(name)
Account.create!(
family: @user.family, accountable: Depository.new,
name: name, currency: "USD", balance: 1_000
)
end
# A goal in the state account deletion leaves behind: still present, zero
# linked accounts, failing its own validations.
def orphaned_goal
family = @user.family
throwaway = Account.create!(
family: family, accountable: Depository.new, name: "Throwaway", currency: "USD", balance: 100
)
goal = family.goals.new(name: "Orphan", target_amount: 500, currency: "USD")
goal.goal_accounts.build(account: throwaway)
goal.save!
throwaway.destroy!
goal.reload
assert_empty goal.goal_accounts, "fixture setup failed to orphan the goal"
goal
end
# Each goal gets its own funding account, mirroring @depository's balance.
# These goals used to share @depository as a whole-balance link, which
# GoalAccount now refuses — and which was the double count in the first
# place: every goal read the same 5,000 as if it were its own. One account
# each keeps every goal's current_balance identical to what it was, without
# the overlap.
def build_goal(family, name, target_amount: 1_000_000, target_date: nil)
funding = Account.create!(
family: family, accountable: Depository.new,
name: "#{name} Funding", currency: "USD", balance: @depository.balance
)
g = family.goals.new(name: name, target_amount: target_amount, target_date: target_date, currency: "USD")
g.goal_accounts.build(account: funding)
g.save!
g
end
public
test "create ignores forbidden params (family_id, state)" do
family = users(:family_admin).family
other_family = Family.create!(name: "Other", currency: "USD", locale: "en", country: "US", timezone: "UTC")
assert_difference -> { family.goals.count }, 1 do
post goals_url, params: {
goal: {
name: "Hijack target",
target_amount: 100,
currency: "USD",
state: "archived",
family_id: other_family.id,
account_ids: [ unclaimed_account("Hijack Pot").id ]
}
}
end
goal = family.goals.order(:created_at).last
# Strong params must strip both `state` (AASM-managed) and `family_id`
# (cross-family pivot) — otherwise a crafted POST would create rows
# outside the current family or skip the active-state assumption.
assert_equal "active", goal.state
assert_equal family.id, goal.family_id
end
test "another family's goal returns 404" do
other_family = Family.create!(name: "Other", currency: "USD", locale: "en", country: "US", timezone: "UTC")
other_account = Account.create!(family: other_family, accountable: Depository.new, name: "Foreign", currency: "USD", balance: 100)
other_goal = other_family.goals.new(name: "Foreign goal", target_amount: 100, currency: "USD")
other_goal.goal_accounts.build(account: other_account)
other_goal.save!
get goal_url(other_goal)
assert_redirected_to goals_path
assert_equal I18n.t("goals.errors.not_found"), flash[:alert]
end
end