* feat(reconciliation): skattekonto bridge engine, sync-time twin proposals, account-keyed facade The engine half of the reconciliation page (design: Avstämningsmotorn). - lib/reconciliation/skattekonto-reconciliation.ts: getSkattekontoReconciliationStatus anchors at the saldo snapshot and returns the bridge (saldo hos Skatteverket, händelser som saknas, 1630-rader utan händelse, ignorerade, ingående skillnad, bokfört), the item buckets the page shows (proposed, unmatched external, unmatched ledger, matched, ignored, upcoming), opening_difference, unexplained_difference (0,00 by construction when data is consistent), dead-link handling (a link to a reversed/draft entry counts as unlinked and is flagged), awaiting_external for ledger lines within 5 days of the snapshot, staleness, and a window that scopes item lists without hiding older rows. Core reads skattekonto_transactions and the extension's snapshot row directly; no @/extensions import. - lib/reconciliation/gl-balance.ts: one ledger-balance helper with the trial-balance predicate status IN (posted, reversed). The drift check summed posted only, which misstated 1630 for any company with a storno on the account; skattekonto-drift.ts now delegates to the helper. - Proposals at sync: migration 20260823120000 adds suggested_journal_entry_id / suggested_at (ON DELETE SET NULL, partial index on open rows); the sync calls refreshSkattekontoProposals after the upsert. findMatchSuggestionsBulk now assigns one-to-one across rows (AGI period first, then nearest date) and falls back to an entry whose 1630 lines net to the amount (split lines); a proposal is never a link. - lib/reconciliation/service.ts + schemas.ts: the account-keyed facade (bank:<cash_account_id> | skattekonto | manual:NNNN) with listReconciliationAccounts (enabled cash accounts folded per IBAN, skattekonto when configured) and getAccountStatus dispatching to the bank engine or the new one; shared Zod shapes for the v1 registry, MCP schemas and the UI (PR 2). Tests: identity on a mixed fixture, storno pair, stale snapshot, awaiting window, window scoping, failed ledger read, live-linked entries never proposed; matcher one-to-one and split-line cases; proposal refresh writes/clears; service dedupe and dispatch. No UI in this PR. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(reconciliation): roundOre instead of inline öre rounding (guard ratchet) The antipattern ratchet counts Math.round(x*100)/100; the new engine used it in five places. Switch to roundOre from @/lib/money and ratchet the baseline down by the three occurrences this removes net of the matcher rewrite. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * feat(reconciliation): three doors over one engine: dashboard routes, v1 API and MCP tools for account-keyed reconciliation PR 2 of the Avstämning build (design: Avstämning via API och MCP). Every door calls lib/reconciliation/{service,items,actions}.ts; none re-implements a link. - lib/reconciliation/items.ts: listAccountItems per account_key, the page's buckets (proposed, unmatched_external, unmatched_ledger, matched, ignored, upcoming), limit/offset; skattekonto from the engine, bank from the scoped transactions + unlinked GL lines (netted per entry). - lib/reconciliation/actions.ts: matchPairs (pairs or use_proposals, dry run, partial success with codes), unmatchLink, setItemIgnored; emits reconciliation.matched / reconciliation.unmatched. - lib/skatteverket/skattekonto-link.ts: canonical core link semantics for a skattekonto row (single line or entry net on 1630, live-link guard, race-safe update, unlink, ignore); the extension keeps its own matchSkattekontoToEntry until its tests are ported. - Dashboard routes /api/reconciliation/accounts[...]: list, status, items, links (POST), links/{linkId} (DELETE), items/{itemId}/ignore (POST); apply directly (a human clicked). - v1 routes /api/v1/companies/{id}/reconciliation/accounts[...]: same six, withApiV1, new scopes reconciliation:read / reconciliation:write (write is a staging scope for SoD), Idempotency-Key + dry_run on writes, registered for OpenAPI, load-routes, skills/accounted-api regenerated. Legacy bank routes and their transactions:* scopes unchanged. - MCP: gnubok_get_reconciliation_status takes account_key (legacy bank path untouched), new gnubok_list_reconciliation_items (default catalog), gnubok_reconcile_match (stages reconciliation_match, preflight = status) and gnubok_reconcile_unmatch (stages reconciliation_unmatch), both search-only to stay under the tools/list payload ceiling; gnubok_link_transaction_to_journal_entry moved to search. Executors in commit.ts; risk tiers medium/low; migration pair 20260823130000/130001 adds the two op types to the CHECK constraint (value list = live prod as of 2026-08-23 + the two); close_period loadout updated. Tests: service/actions/items/link unit tests, v1 route tests (401/403/400/404/ happy, idempotency, dry run), dashboard route tests, MCP tool tests + the guard suite (payload ceiling, descriptions, staging meta, qualified ids). Guards and apiskill:check green; no type errors in changed files. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(reconciliation): refresh the v1 spec snapshot and keep the ignore update readable by the phantom-column guard The six new v1 reconciliation endpoints and the two new scopes were not recorded in the spec snapshot, and setSkattekontoRowIgnored updated through one conditional payload, which the phantom-column scanner cannot read (ceiling 380 -> 381). Two literal payloads instead; snapshot updated. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * feat(reconciliation): the Avstämning page, one body for every account with an outside truth /reconciliation in Arbeta (after Transaktioner), on the approved layout: an account rail on the left (bank accounts and the skattekonto, logo or monogram, last fetch, status dot, URL-owned selection), and for the selected account four tiles (outside, ledger, difference, unexplained), the bridge that explains the difference, an actions row (link the proposed pairs, book the unbooked skattekonto events, run the bank matcher) and a full-width table banded by bucket with proposal rows linkable one by one. Every read and write goes through the PR 2 dashboard routes, so the page shows exactly what the v1 API and the MCP tools see. Also: nav item, command palette entry, sv/en strings. Period picker, manual match mode and sign-off are deliberately not here (PR 4/5). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * feat(reconciliation): sign-off, period picker, Hem row and the three doors for it "Markera som avstämd t.o.m. <datum>" as an append-only attestation: account_reconciliations (who signed which account through which date, with the numbers as they stood; reopen stamps instead of deletes; RLS members write as themselves, viewers read). Policy in one place (lib/reconciliation/signoff.ts): refused with an unexplained difference unless forced with a note, refused past today or past the skattekonto snapshot, refused at or before an active sign-off; reopen is the undo. Every status read now carries the latest active sign-off and the rail shows "avstämt t.o.m.". Three doors: dashboard routes (GET/POST .../signoff, POST .../reopen), v1 (same, scope reconciliation:signoff, Idempotency-Key, dry-run, registry + regenerated API skill), MCP gnubok_reconcile_signoff (search catalog, stages reconciliation_signoff after a policy dry run; executor + risk tier + op-type CHECK migration pair). Events reconciliation.signed_off / reconciliation.reopened, and the four reconciliation events join the public webhook set (additive; API version unchanged, changelog section added). Page: räkenskapsår + range picker in the header (own preset memory, opens on this month) scoping the bridge, the items and the default sign-off date; sign-off dialog with the forced-with-note path; reopen on hover. Hem: worklist category reconciliation_due ("Konton att stämma av"), zero until the company has signed anything off. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(reconciliation): classify reconciliation:signoff as a tenant write for the MCP role guard gnubok_reconcile_signoff carries the deliberately separate reconciliation:signoff scope; the central viewer guard keys on the :write/:approve/:manage suffixes, so a viewer could reach the tool (RLS would still refuse the row, but the guard is the intended layer). Add :signoff to the classifier; the strictness test that caught it now passes. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * fix(providers): serve local rate-limiter waiters in arrival order Two callers that both found the in-memory bucket empty each set their own timeout; the timeouts expired at the same instant from different timer lists and which woke first was platform-dependent. hydrateInvoices relies on "started first, requested first" to serve open invoices before paid ones, so lib/providers/__tests__/hydrate-invoices.test.ts flipped on CI (twice on #1817) while holding locally. A promise queue makes the local waiters FIFO without changing the rate; the Upstash path is untouched. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> (cherry picked from commit 14a7599bf2c6fa7f97de6ffab3dc4cf4d0e1827d) --------- Co-authored-by: Jakob Wennberg <311770904+jakobwennberg-oss@users.noreply.github.com> Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
150 lines
6.3 KiB
TypeScript
150 lines
6.3 KiB
TypeScript
import { randomUUID } from 'node:crypto'
|
|
import { describe, it, expect } from 'vitest'
|
|
import { getPool, withUserContext } from './setup'
|
|
import { seedCompany, insertAuthUser, insertCompanyMember } from './fixtures'
|
|
|
|
// pg-real coverage for 20260823140000_account_reconciliations: RLS (member
|
|
// SELECT, owner/admin/member writes with signed_by = auth.uid(), viewers
|
|
// read-only, no DELETE policy), the account_key CHECK, the one-active-per-date
|
|
// partial unique index (a reopened row frees the slot), and the reopen pair
|
|
// CHECK.
|
|
|
|
async function insertSignoff(
|
|
companyId: string,
|
|
signedBy: string,
|
|
overrides: { accountKey?: string; throughDate?: string } = {},
|
|
): Promise<string> {
|
|
const id = randomUUID()
|
|
await getPool().query(
|
|
`INSERT INTO public.account_reconciliations
|
|
(id, company_id, account_key, through_date, external_balance, ledger_balance, unexplained_difference, signed_by)
|
|
VALUES ($1, $2, $3, $4, 100.00, 100.00, 0, $5)`,
|
|
[id, companyId, overrides.accountKey ?? 'skattekonto', overrides.throughDate ?? '2026-07-31', signedBy],
|
|
)
|
|
return id
|
|
}
|
|
|
|
describe('account_reconciliations RLS', () => {
|
|
it('lets company members read, strangers see nothing', async () => {
|
|
const { userId, companyId } = await seedCompany()
|
|
const rowId = await insertSignoff(companyId, userId)
|
|
const stranger = await insertAuthUser()
|
|
|
|
const ownerView = await withUserContext(userId, (client) =>
|
|
client.query<{ id: string }>(`SELECT id FROM public.account_reconciliations WHERE id = $1`, [rowId]),
|
|
)
|
|
expect(ownerView.rows).toHaveLength(1)
|
|
|
|
const strangerView = await withUserContext(stranger, (client) =>
|
|
client.query<{ id: string }>(`SELECT id FROM public.account_reconciliations WHERE id = $1`, [rowId]),
|
|
)
|
|
expect(strangerView.rows).toHaveLength(0)
|
|
})
|
|
|
|
it('lets viewers read but not sign', async () => {
|
|
const { userId, companyId } = await seedCompany()
|
|
const rowId = await insertSignoff(companyId, userId)
|
|
const viewer = await insertAuthUser()
|
|
await insertCompanyMember({ companyId, userId: viewer, role: 'viewer' })
|
|
|
|
const viewerRead = await withUserContext(viewer, (client) =>
|
|
client.query<{ id: string }>(`SELECT id FROM public.account_reconciliations WHERE id = $1`, [rowId]),
|
|
)
|
|
expect(viewerRead.rows).toHaveLength(1)
|
|
|
|
await expect(
|
|
withUserContext(viewer, (client) =>
|
|
client.query(
|
|
`INSERT INTO public.account_reconciliations (company_id, account_key, through_date, signed_by)
|
|
VALUES ($1, 'skattekonto', '2026-08-31', $2)`,
|
|
[companyId, viewer],
|
|
),
|
|
),
|
|
).rejects.toThrow(/row-level security/i)
|
|
})
|
|
|
|
it('lets members sign as themselves but not as someone else', async () => {
|
|
const { userId: owner, companyId } = await seedCompany()
|
|
const member = await insertAuthUser()
|
|
await insertCompanyMember({ companyId, userId: member, role: 'member' })
|
|
|
|
const inserted = await withUserContext(member, (client) =>
|
|
client.query<{ id: string }>(
|
|
`INSERT INTO public.account_reconciliations (company_id, account_key, through_date, signed_by)
|
|
VALUES ($1, 'skattekonto', '2026-08-31', $2) RETURNING id`,
|
|
[companyId, member],
|
|
),
|
|
)
|
|
expect(inserted.rows).toHaveLength(1)
|
|
|
|
await expect(
|
|
withUserContext(member, (client) =>
|
|
client.query(
|
|
`INSERT INTO public.account_reconciliations (company_id, account_key, through_date, signed_by)
|
|
VALUES ($1, 'skattekonto', '2026-09-30', $2)`,
|
|
[companyId, owner],
|
|
),
|
|
),
|
|
).rejects.toThrow(/row-level security/i)
|
|
})
|
|
|
|
it('lets members stamp a reopen but never delete', async () => {
|
|
const { userId, companyId } = await seedCompany()
|
|
const rowId = await insertSignoff(companyId, userId)
|
|
|
|
const reopened = await withUserContext(userId, (client) =>
|
|
client.query<{ id: string; reopened_at: string | null }>(
|
|
`UPDATE public.account_reconciliations
|
|
SET reopened_at = NOW(), reopened_by = $2, reopen_reason = 'sen rad'
|
|
WHERE id = $1 AND reopened_at IS NULL
|
|
RETURNING id, reopened_at`,
|
|
[rowId, userId],
|
|
),
|
|
)
|
|
expect(reopened.rows).toHaveLength(1)
|
|
expect(reopened.rows[0].reopened_at).not.toBeNull()
|
|
|
|
// No DELETE policy: the statement succeeds but touches nothing.
|
|
const deleted = await withUserContext(userId, (client) =>
|
|
client.query(`DELETE FROM public.account_reconciliations WHERE id = $1`, [rowId]),
|
|
)
|
|
expect(deleted.rowCount).toBe(0)
|
|
})
|
|
})
|
|
|
|
describe('account_reconciliations constraints', () => {
|
|
it('rejects an account_key that is not bank:<uuid>, skattekonto or manual:NNNN', async () => {
|
|
const { userId, companyId } = await seedCompany()
|
|
await expect(insertSignoff(companyId, userId, { accountKey: '1930' })).rejects.toThrow(/account_key/i)
|
|
await expect(insertSignoff(companyId, userId, { accountKey: 'bank:not-a-uuid' })).rejects.toThrow(/account_key/i)
|
|
await expect(insertSignoff(companyId, userId, { accountKey: `bank:${randomUUID()}` })).resolves.toBeTruthy()
|
|
await expect(insertSignoff(companyId, userId, { accountKey: 'manual:1910' })).resolves.toBeTruthy()
|
|
})
|
|
|
|
it('allows one active sign-off per account and date; a reopened one frees the slot', async () => {
|
|
const { userId, companyId } = await seedCompany()
|
|
const first = await insertSignoff(companyId, userId, { throughDate: '2026-07-31' })
|
|
await expect(insertSignoff(companyId, userId, { throughDate: '2026-07-31' })).rejects.toThrow(
|
|
/ux_account_reconciliations_active|duplicate key/i,
|
|
)
|
|
// A different account on the same date is fine.
|
|
await expect(
|
|
insertSignoff(companyId, userId, { accountKey: `bank:${randomUUID()}`, throughDate: '2026-07-31' }),
|
|
).resolves.toBeTruthy()
|
|
|
|
await getPool().query(
|
|
`UPDATE public.account_reconciliations SET reopened_at = NOW(), reopened_by = $2 WHERE id = $1`,
|
|
[first, userId],
|
|
)
|
|
await expect(insertSignoff(companyId, userId, { throughDate: '2026-07-31' })).resolves.toBeTruthy()
|
|
})
|
|
|
|
it('requires reopened_at and reopened_by together', async () => {
|
|
const { userId, companyId } = await seedCompany()
|
|
const rowId = await insertSignoff(companyId, userId)
|
|
await expect(
|
|
getPool().query(`UPDATE public.account_reconciliations SET reopened_at = NOW() WHERE id = $1`, [rowId]),
|
|
).rejects.toThrow(/account_reconciliations_reopen_pair/i)
|
|
})
|
|
})
|