feat(domain): balance between people

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
YugonitoandClaude Opus 5.5 committed 2026-10-27 17:58:21 +01:00
1 parent 5ce5363f50
commit 89bf2a821c
4 files changed
+108

No files matched your search

+40
View File
@@ -0,0 +1,40 @@
import { shareAmounts } from "./money";
import type { Cents, Op, Settlement, UserId } from "./types";
/**
* Équilibre entre personnes (spec §7.1), sur toutes les opérations réelles.
* Positif : on doit de l'argent à cette personne.
*/
export function computeBalances(ops: Op[], settlements: Settlement[], userIds: UserId[]): Record<UserId, Cents> {
const balance: Record<UserId, Cents> = Object.fromEntries(userIds.map((id) => [id, 0]));
for (const o of ops) {
if (o.status !== "ACTUAL") continue;
const shares = shareAmounts(o.amount, o.split, o.accountUserId);
for (const userId of userIds) {
const share = shares[userId] ?? 0;
const held = userId === o.accountUserId ? o.amount : 0;
// Dépense : avoir payé pour les autres rend créancier.
// Entrée : avoir reçu ce qui revient aux autres rend débiteur.
balance[userId] += o.kind === "EXPENSE" ? held - share : share - held;
}
}
for (const s of settlements) {
balance[s.fromUserId] = (balance[s.fromUserId] ?? 0) + s.amount;
balance[s.toUserId] = (balance[s.toUserId] ?? 0) - s.amount;
}
return balance;
}
/** Pour deux personnes : qui doit combien à qui, ou null à l'équilibre. */
export function describeBalance(
b: Record<UserId, Cents>,
): { debtor: UserId; creditor: UserId; amount: Cents } | null {
const entries = Object.entries(b);
const creditor = entries.find(([, v]) => v > 0);
const debtor = entries.find(([, v]) => v < 0);
if (!creditor || !debtor) return null;
return { debtor: debtor[0], creditor: creditor[0], amount: creditor[1] };
}