@things-factory/accounting 10.1.134 → 10.1.135

package/dist-server/service/payment/payment-service.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkPaymentsWithin = checkPaymentsWithin;
+exports.savePayments = savePayments;
+const typeorm_1 = require("typeorm");
+const shell_1 = require("@things-factory/shell");
+const transaction_1 = require("../transaction/transaction");
+const payment_1 = require("./payment");
+const payment_targets_1 = require("./payment-targets");
+/** Amounts are decimals; a sum within half a cent of the transaction is the transaction. */
+const CENT = 0.005;
+/**
+ * Within one purpose a transaction pays no more than itself. Run after its payments or its amount change.
+ */
+async function checkPaymentsWithin(tx, domain, transactionIds) {
+    const ids = [...new Set(transactionIds)];
+    if (!ids.length)
+        return;
+    const transactions = await tx
+        .getRepository(transaction_1.Transaction)
+        .find({ where: { domain: { id: domain.id }, id: (0, typeorm_1.In)(ids) }, select: ['id', 'amount'] });
+    const payments = await tx
+        .getRepository(payment_1.Payment)
+        .find({ where: { domain: { id: domain.id }, transaction: { id: (0, typeorm_1.In)(ids) } }, relations: ['transaction'] });
+    const paid = new Map();
+    for (const payment of payments) {
+        const key = `${payment.transaction.id}|${payment.purpose}`;
+        paid.set(key, (paid.get(key) ?? 0) + Number(payment.amount));
+    }
+    for (const transaction of transactions) {
+        for (const [key, sum] of paid) {
+            const [id, purpose] = key.split('|');
+            if (id !== transaction.id)
+                continue;
+            const amount = Math.abs(Number(transaction.amount));
+            if (sum > amount + CENT) {
+                throw new shell_1.Refusal('payment-over-transaction', { purpose, paid: sum, amount }, `${purpose}: ${sum} put on a transaction of ${amount}`);
+            }
+        }
+    }
+}
+/** A patch as the row it writes: the target kind known, the amount more than zero, the purpose the kind's. */
+function rowOf(patch, isNew) {
+    const row = {};
+    const transactionId = patch.transaction?.id;
+    if (isNew && !transactionId)
+        throw new shell_1.Refusal('payment-transaction-required', {}, 'a payment needs the transaction it is a part of');
+    if (transactionId)
+        row.transactionId = transactionId;
+    if (patch.targetType !== undefined || isNew) {
+        const target = (0, payment_targets_1.paymentTargetOf)(String(patch.targetType ?? ''));
+        if (!target)
+            throw new shell_1.Refusal('payment-target-unknown', { targetType: patch.targetType }, `'${patch.targetType}' is not a kind of target any module registered`);
+        row.targetType = patch.targetType;
+        row.purpose = target.purpose;
+    }
+    if (patch.targetId !== undefined || isNew) {
+        if (!patch.targetId)
+            throw new shell_1.Refusal('payment-target-required', {}, 'a payment needs what it paid');
+        row.targetId = patch.targetId;
+    }
+    if (patch.amount !== undefined || isNew) {
+        const amount = Number(patch.amount);
+        if (!(amount > 0))
+            throw new shell_1.Refusal('payment-amount-not-positive', {}, 'amount: must be more than zero');
+        row.amount = amount;
+    }
+    if (patch.method !== undefined)
+        row.method = patch.method ?? payment_1.PaymentMethod.PERSON;
+    if (patch.basis !== undefined)
+        row.basis = patch.basis || null;
+    if (patch.notes !== undefined)
+        row.notes = patch.notes || null;
+    return row;
+}
+/**
+ * Apply rows to a domain's payments: `+` (or no id) adds, `M` changes, `-` deletes (softly). Then the general rule
+ * (§`checkPaymentsWithin`) and each touched kind's own rules run, in the same database transaction.
+ */
+async function savePayments(tx, domain, user, patches) {
+    const repo = tx.getRepository(payment_1.Payment);
+    const transactions = tx.getRepository(transaction_1.Transaction);
+    const touched = new Map();
+    const touch = (payment) => {
+        const kind = touched.get(payment.targetType) ?? { targetIds: new Set(), transactionIds: new Set() };
+        kind.targetIds.add(payment.targetId);
+        if (payment.transactionId)
+            kind.transactionIds.add(payment.transactionId);
+        touched.set(payment.targetType, kind);
+    };
+    const deletes = patches.filter(one => one.cuFlag === '-' && one.id).map(one => one.id);
+    if (deletes.length) {
+        const owned = await repo.find({ where: { domain: { id: domain.id }, id: (0, typeorm_1.In)(deletes) }, relations: ['transaction'] });
+        if (owned.length !== new Set(deletes).size)
+            throw new shell_1.Refusal('payment-not-found', {}, 'a payment was not found - reload and try again');
+        for (const one of owned)
+            touch({ ...one, transactionId: one.transaction.id });
+        await repo.softDelete({ id: (0, typeorm_1.In)(deletes) });
+    }
+    const saved = [];
+    for (const patch of patches.filter(one => one.cuFlag !== '-')) {
+        const isNew = !patch.id || patch.cuFlag === '+';
+        const { transactionId, ...row } = rowOf(patch, isNew);
+        const current = isNew
+            ? undefined
+            : await repo.findOne({ where: { domain: { id: domain.id }, id: patch.id }, relations: ['transaction'] });
+        if (!isNew && !current)
+            throw new shell_1.Refusal('payment-not-found', {}, 'a payment was not found - reload and try again');
+        const transactionOf = transactionId ?? current.transaction.id;
+        const transaction = await transactions.findOne({ where: { domain: { id: domain.id }, id: transactionOf } });
+        if (!transaction)
+            throw new shell_1.Refusal('payment-transaction-not-found', {}, 'the transaction was not found - reload and try again');
+        const targetType = row.targetType ?? current.targetType;
+        const targetId = row.targetId ?? current.targetId;
+        const twin = await repo.findOne({
+            where: { domain: { id: domain.id }, transaction: { id: transaction.id }, targetType, targetId }
+        });
+        if (twin && twin.id !== current?.id)
+            throw new shell_1.Refusal('payment-twice', { targetType, targetId }, 'the transaction already pays this - change that payment instead');
+        if (current)
+            touch({ ...current, transactionId: current.transaction.id });
+        const written = await repo.save({
+            ...(current ?? { domain, creator: user }),
+            ...row,
+            transaction,
+            updater: user
+        });
+        touch({ targetType: written.targetType, targetId: written.targetId, transactionId: transaction.id });
+        saved.push(written);
+    }
+    await checkPaymentsWithin(tx, domain, [...touched.values()].flatMap(kind => [...kind.transactionIds]));
+    for (const [targetType, kind] of touched) {
+        await (0, payment_targets_1.paymentTargetOf)(targetType)?.validate?.(tx, domain, {
+            targetIds: [...kind.targetIds],
+            transactionIds: [...kind.transactionIds]
+        });
+    }
+    return saved;
+}
+//# sourceMappingURL=payment-service.js.map

package/dist-server/service/payment/payment-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-service.js","sourceRoot":"","sources":["../../../server/service/payment/payment-service.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntityManager, In } from 'typeorm'\n\nimport { Refusal } from '@things-factory/shell'\n\nimport { Transaction } from '../transaction/transaction'\nimport { Payment, PaymentMethod } from './payment'\nimport { paymentTargetOf } from './payment-targets'\nimport { PaymentPatch } from './payment-type'\n\n/** Amounts are decimals; a sum within half a cent of the transaction is the transaction. */\nconst CENT = 0.005\n\n/**\n * Within one purpose a transaction pays no more than itself. Run after its payments or its amount change.\n */\nexport async function checkPaymentsWithin(\n  tx: EntityManager,\n  domain: { id: string },\n  transactionIds: string[]\n): Promise<void> {\n  const ids = [...new Set(transactionIds)]\n  if (!ids.length) return\n\n  const transactions = await tx\n    .getRepository(Transaction)\n    .find({ where: { domain: { id: domain.id }, id: In(ids) }, select: ['id', 'amount'] })\n  const payments = await tx\n    .getRepository(Payment)\n    .find({ where: { domain: { id: domain.id }, transaction: { id: In(ids) } }, relations: ['transaction'] })\n  const paid = new Map<string, number>()\n  for (const payment of payments) {\n    const key = `${payment.transaction.id}|${payment.purpose}`\n    paid.set(key, (paid.get(key) ?? 0) + Number(payment.amount))\n  }\n  for (const transaction of transactions) {\n    for (const [key, sum] of paid) {\n      const [id, purpose] = key.split('|')\n      if (id !== transaction.id) continue\n      const amount = Math.abs(Number(transaction.amount))\n      if (sum > amount + CENT) {\n        throw new Refusal(\n          'payment-over-transaction',\n          { purpose, paid: sum, amount },\n          `${purpose}: ${sum} put on a transaction of ${amount}`\n        )\n      }\n    }\n  }\n}\n\n/** A patch as the row it writes: the target kind known, the amount more than zero, the purpose the kind's. */\nfunction rowOf(patch: PaymentPatch, isNew: boolean): Partial<Payment> & { transactionId?: string } {\n  const row: Record<string, any> = {}\n  const transactionId = patch.transaction?.id\n  if (isNew && !transactionId)\n    throw new Refusal('payment-transaction-required', {}, 'a payment needs the transaction it is a part of')\n  if (transactionId) row.transactionId = transactionId\n\n  if (patch.targetType !== undefined || isNew) {\n    const target = paymentTargetOf(String(patch.targetType ?? ''))\n    if (!target)\n      throw new Refusal(\n        'payment-target-unknown',\n        { targetType: patch.targetType },\n        `'${patch.targetType}' is not a kind of target any module registered`\n      )\n    row.targetType = patch.targetType\n    row.purpose = target.purpose\n  }\n  if (patch.targetId !== undefined || isNew) {\n    if (!patch.targetId) throw new Refusal('payment-target-required', {}, 'a payment needs what it paid')\n    row.targetId = patch.targetId\n  }\n  if (patch.amount !== undefined || isNew) {\n    const amount = Number(patch.amount)\n    if (!(amount > 0)) throw new Refusal('payment-amount-not-positive', {}, 'amount: must be more than zero')\n    row.amount = amount\n  }\n  if (patch.method !== undefined) row.method = patch.method ?? PaymentMethod.PERSON\n  if (patch.basis !== undefined) row.basis = patch.basis || null\n  if (patch.notes !== undefined) row.notes = patch.notes || null\n  return row\n}\n\n/**\n * Apply rows to a domain's payments: `+` (or no id) adds, `M` changes, `-` deletes (softly). Then the general rule\n * (§`checkPaymentsWithin`) and each touched kind's own rules run, in the same database transaction.\n */\nexport async function savePayments(\n  tx: EntityManager,\n  domain: { id: string },\n  user: any,\n  patches: PaymentPatch[]\n): Promise<Payment[]> {\n  const repo = tx.getRepository(Payment)\n  const transactions = tx.getRepository(Transaction)\n  const touched = new Map<string, { targetIds: Set<string>; transactionIds: Set<string> }>()\n  const touch = (payment: { targetType: string; targetId: string; transactionId?: string }) => {\n    const kind = touched.get(payment.targetType) ?? { targetIds: new Set<string>(), transactionIds: new Set<string>() }\n    kind.targetIds.add(payment.targetId)\n    if (payment.transactionId) kind.transactionIds.add(payment.transactionId)\n    touched.set(payment.targetType, kind)\n  }\n\n  const deletes = patches.filter(one => one.cuFlag === '-' && one.id).map(one => one.id!)\n  if (deletes.length) {\n    const owned = await repo.find({ where: { domain: { id: domain.id }, id: In(deletes) }, relations: ['transaction'] })\n    if (owned.length !== new Set(deletes).size)\n      throw new Refusal('payment-not-found', {}, 'a payment was not found - reload and try again')\n    for (const one of owned) touch({ ...one, transactionId: one.transaction.id })\n    await repo.softDelete({ id: In(deletes) })\n  }\n\n  const saved: Payment[] = []\n  for (const patch of patches.filter(one => one.cuFlag !== '-')) {\n    const isNew = !patch.id || patch.cuFlag === '+'\n    const { transactionId, ...row } = rowOf(patch, isNew)\n    const current = isNew\n      ? undefined\n      : await repo.findOne({ where: { domain: { id: domain.id }, id: patch.id }, relations: ['transaction'] })\n    if (!isNew && !current) throw new Refusal('payment-not-found', {}, 'a payment was not found - reload and try again')\n\n    const transactionOf = transactionId ?? current!.transaction.id\n    const transaction = await transactions.findOne({ where: { domain: { id: domain.id }, id: transactionOf } })\n    if (!transaction)\n      throw new Refusal('payment-transaction-not-found', {}, 'the transaction was not found - reload and try again')\n\n    const targetType = row.targetType ?? current!.targetType\n    const targetId = row.targetId ?? current!.targetId\n    const twin = await repo.findOne({\n      where: { domain: { id: domain.id }, transaction: { id: transaction.id }, targetType, targetId }\n    })\n    if (twin && twin.id !== current?.id)\n      throw new Refusal(\n        'payment-twice',\n        { targetType, targetId },\n        'the transaction already pays this - change that payment instead'\n      )\n\n    if (current) touch({ ...current, transactionId: current.transaction.id })\n    const written = await repo.save({\n      ...(current ?? { domain, creator: user }),\n      ...row,\n      transaction,\n      updater: user\n    } as Payment)\n    touch({ targetType: written.targetType, targetId: written.targetId, transactionId: transaction.id })\n    saved.push(written)\n  }\n\n  await checkPaymentsWithin(\n    tx,\n    domain,\n    [...touched.values()].flatMap(kind => [...kind.transactionIds])\n  )\n  for (const [targetType, kind] of touched) {\n    await paymentTargetOf(targetType)?.validate?.(tx, domain, {\n      targetIds: [...kind.targetIds],\n      transactionIds: [...kind.transactionIds]\n    })\n  }\n\n  return saved\n}\n"]}

package/dist-server/service/payment/payment-targets.d.ts

@@ -0,0 +1,31 @@
+import { EntityManager } from 'typeorm';
+import { PaymentPurpose } from './payment';
+/**
+ * The kinds of thing a transaction can pay, registered by the module that owns them.
+ *
+ * accounting keeps the general rules - the target kind is known, a transaction pays no more than itself within one
+ * purpose. What a target may take (a contract round's capacity, one VAT period per withdrawal) is the owner's rule,
+ * run in the same database transaction after the payments are written.
+ */
+export interface PaymentTarget {
+    /** What a payment on this kind tells of its transaction. */
+    purpose: PaymentPurpose;
+    /** What people call each target - 「H2026021 3차」 - for the screens that list what a transaction paid. */
+    label?: (tx: EntityManager, domain: {
+        id: string;
+    }, targetIds: string[]) => Promise<Map<string, string>>;
+    /**
+     * The owner's rules on the payments of its targets, given the targets and transactions a save touched. Throw a
+     * `Refusal` to refuse the save.
+     */
+    validate?: (tx: EntityManager, domain: {
+        id: string;
+    }, touched: {
+        targetIds: string[];
+        transactionIds: string[];
+    }) => Promise<void>;
+}
+/** Register a kind of target. A kind is registered once; registering it again is a mistake in the app. */
+export declare function registerPaymentTarget(targetType: string, target: PaymentTarget): void;
+export declare function paymentTargetOf(targetType: string): PaymentTarget | undefined;
+export declare function registeredPaymentTargets(): string[];

package/dist-server/service/payment/payment-targets.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPaymentTarget = registerPaymentTarget;
+exports.paymentTargetOf = paymentTargetOf;
+exports.registeredPaymentTargets = registeredPaymentTargets;
+const targets = new Map();
+/** Register a kind of target. A kind is registered once; registering it again is a mistake in the app. */
+function registerPaymentTarget(targetType, target) {
+    if (targets.has(targetType))
+        throw new Error(`payment target '${targetType}' is registered twice`);
+    targets.set(targetType, target);
+}
+function paymentTargetOf(targetType) {
+    return targets.get(targetType);
+}
+function registeredPaymentTargets() {
+    return [...targets.keys()];
+}
+//# sourceMappingURL=payment-targets.js.map

package/dist-server/service/payment/payment-targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-targets.js","sourceRoot":"","sources":["../../../server/service/payment/payment-targets.ts"],"names":[],"mappings":";;AA8BA,sDAGC;AAED,0CAEC;AAED,4DAEC;AAdD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAA;AAEhD,0GAA0G;AAC1G,SAAgB,qBAAqB,CAAC,UAAkB,EAAE,MAAqB;IAC7E,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,UAAU,uBAAuB,CAAC,CAAA;IAClG,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;AACjC,CAAC;AAED,SAAgB,eAAe,CAAC,UAAkB;IAChD,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;AAChC,CAAC;AAED,SAAgB,wBAAwB;IACtC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;AAC5B,CAAC","sourcesContent":["import { EntityManager } from 'typeorm'\n\nimport { PaymentPurpose } from './payment'\n\n/**\n * The kinds of thing a transaction can pay, registered by the module that owns them.\n *\n * accounting keeps the general rules - the target kind is known, a transaction pays no more than itself within one\n * purpose. What a target may take (a contract round's capacity, one VAT period per withdrawal) is the owner's rule,\n * run in the same database transaction after the payments are written.\n */\nexport interface PaymentTarget {\n  /** What a payment on this kind tells of its transaction. */\n  purpose: PaymentPurpose\n  /** What people call each target - 「H2026021 3차」 - for the screens that list what a transaction paid. */\n  label?: (tx: EntityManager, domain: { id: string }, targetIds: string[]) => Promise<Map<string, string>>\n  /**\n   * The owner's rules on the payments of its targets, given the targets and transactions a save touched. Throw a\n   * `Refusal` to refuse the save.\n   */\n  validate?: (\n    tx: EntityManager,\n    domain: { id: string },\n    touched: { targetIds: string[]; transactionIds: string[] }\n  ) => Promise<void>\n}\n\nconst targets = new Map<string, PaymentTarget>()\n\n/** Register a kind of target. A kind is registered once; registering it again is a mistake in the app. */\nexport function registerPaymentTarget(targetType: string, target: PaymentTarget): void {\n  if (targets.has(targetType)) throw new Error(`payment target '${targetType}' is registered twice`)\n  targets.set(targetType, target)\n}\n\nexport function paymentTargetOf(targetType: string): PaymentTarget | undefined {\n  return targets.get(targetType)\n}\n\nexport function registeredPaymentTargets(): string[] {\n  return [...targets.keys()]\n}\n"]}

package/dist-server/service/payment/payment-type.d.ts

@@ -1,27 +1,23 @@
 import { ObjectRef } from '@things-factory/shell';
-import { Payment, PaymentDirection, PaymentType } from './payment';
+import { Payment, PaymentMethod } from './payment';
 export declare class NewPayment {
     transaction: ObjectRef;
-    currency?: string;
+    targetType: string;
+    targetId: string;
     amount: number;
-    paidAt: Date;
-    direction: PaymentDirection;
-    paymentType: PaymentType;
-    sourceBankAccount?: ObjectRef;
-    destinationBankAccount?: ObjectRef;
-    note?: string;
+    method?: PaymentMethod;
+    basis?: string;
+    notes?: string;
 }
 export declare class PaymentPatch {
     id?: string;
-    transaction: ObjectRef;
-    currency?: string;
-    amount: number;
-    paidAt: Date;
-    direction: PaymentDirection;
-    paymentType: PaymentType;
-    sourceBankAccount?: ObjectRef;
-    destinationBankAccount?: ObjectRef;
-    note?: string;
+    transaction?: ObjectRef;
+    targetType?: string;
+    targetId?: string;
+    amount?: number;
+    method?: PaymentMethod;
+    basis?: string;
+    notes?: string;
     cuFlag?: string;
 }
 export declare class PaymentList {

package/dist-server/service/payment/payment-type.js

@@ -9,106 +9,90 @@ let NewPayment = class NewPayment {
 };
 exports.NewPayment = NewPayment;
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => shell_1.ObjectRef),
+    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { description: 'The transaction a part of which this is' }),
     tslib_1.__metadata("design:type", shell_1.ObjectRef)
 ], NewPayment.prototype, "transaction", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ description: 'The kind of what was paid, as registered' }),
     tslib_1.__metadata("design:type", String)
-], NewPayment.prototype, "currency", void 0);
+], NewPayment.prototype, "targetType", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: false }),
+    (0, type_graphql_1.Field)({ description: 'The id of what was paid' }),
+    tslib_1.__metadata("design:type", String)
+], NewPayment.prototype, "targetId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { description: 'The part of the transaction put on the target' }),
     tslib_1.__metadata("design:type", Number)
 ], NewPayment.prototype, "amount", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: false }),
-    tslib_1.__metadata("design:type", Date)
-], NewPayment.prototype, "paidAt", void 0);
-tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => payment_1.PaymentDirection),
+    (0, type_graphql_1.Field)(type => payment_1.PaymentMethod, { nullable: true, description: 'Who made the link - a person when not given' }),
     tslib_1.__metadata("design:type", String)
-], NewPayment.prototype, "direction", void 0);
+], NewPayment.prototype, "method", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => payment_1.PaymentType, { description: 'Type of the payment' }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Why a rule made the link' }),
     tslib_1.__metadata("design:type", String)
-], NewPayment.prototype, "paymentType", void 0);
-tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'Source bank account for the payment' }),
-    tslib_1.__metadata("design:type", shell_1.ObjectRef)
-], NewPayment.prototype, "sourceBankAccount", void 0);
-tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'Destination bank account for the payment' }),
-    tslib_1.__metadata("design:type", shell_1.ObjectRef)
-], NewPayment.prototype, "destinationBankAccount", void 0);
+], NewPayment.prototype, "basis", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Notes' }),
     tslib_1.__metadata("design:type", String)
-], NewPayment.prototype, "note", void 0);
+], NewPayment.prototype, "notes", void 0);
 exports.NewPayment = NewPayment = tslib_1.__decorate([
-    (0, type_graphql_1.InputType)()
+    (0, type_graphql_1.InputType)({ description: 'A new part of a transaction put on what it paid' })
 ], NewPayment);
 let PaymentPatch = class PaymentPatch {
 };
 exports.PaymentPatch = PaymentPatch;
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { nullable: true }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { nullable: true, description: 'The payment to change or delete' }),
     tslib_1.__metadata("design:type", String)
 ], PaymentPatch.prototype, "id", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => shell_1.ObjectRef),
+    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'The transaction a part of which this is' }),
     tslib_1.__metadata("design:type", shell_1.ObjectRef)
 ], PaymentPatch.prototype, "transaction", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The kind of what was paid, as registered' }),
     tslib_1.__metadata("design:type", String)
-], PaymentPatch.prototype, "currency", void 0);
+], PaymentPatch.prototype, "targetType", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: false }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The id of what was paid' }),
+    tslib_1.__metadata("design:type", String)
+], PaymentPatch.prototype, "targetId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { nullable: true, description: 'The part of the transaction put on the target' }),
     tslib_1.__metadata("design:type", Number)
 ], PaymentPatch.prototype, "amount", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: false }),
-    tslib_1.__metadata("design:type", Date)
-], PaymentPatch.prototype, "paidAt", void 0);
-tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => payment_1.PaymentDirection),
+    (0, type_graphql_1.Field)(type => payment_1.PaymentMethod, { nullable: true, description: 'Who made the link' }),
     tslib_1.__metadata("design:type", String)
-], PaymentPatch.prototype, "direction", void 0);
+], PaymentPatch.prototype, "method", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => payment_1.PaymentType, { description: 'Type of the payment' }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Why a rule made the link' }),
     tslib_1.__metadata("design:type", String)
-], PaymentPatch.prototype, "paymentType", void 0);
-tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'Source bank account for the payment' }),
-    tslib_1.__metadata("design:type", shell_1.ObjectRef)
-], PaymentPatch.prototype, "sourceBankAccount", void 0);
-tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'Destination bank account for the payment' }),
-    tslib_1.__metadata("design:type", shell_1.ObjectRef)
-], PaymentPatch.prototype, "destinationBankAccount", void 0);
+], PaymentPatch.prototype, "basis", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Notes' }),
     tslib_1.__metadata("design:type", String)
-], PaymentPatch.prototype, "note", void 0);
+], PaymentPatch.prototype, "notes", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: '+ adds, M changes, - deletes' }),
     tslib_1.__metadata("design:type", String)
 ], PaymentPatch.prototype, "cuFlag", void 0);
 exports.PaymentPatch = PaymentPatch = tslib_1.__decorate([
-    (0, type_graphql_1.InputType)()
+    (0, type_graphql_1.InputType)({ description: 'A change to a payment, or a grid row: cuFlag + adds, M changes, - deletes' })
 ], PaymentPatch);
 let PaymentList = class PaymentList {
 };
 exports.PaymentList = PaymentList;
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => [payment_1.Payment]),
+    (0, type_graphql_1.Field)(type => [payment_1.Payment], { description: 'The payments on this page' }),
     tslib_1.__metadata("design:type", Array)
 ], PaymentList.prototype, "items", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => type_graphql_1.Int),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'How many there are in all' }),
     tslib_1.__metadata("design:type", Number)
 ], PaymentList.prototype, "total", void 0);
 exports.PaymentList = PaymentList = tslib_1.__decorate([
-    (0, type_graphql_1.ObjectType)()
+    (0, type_graphql_1.ObjectType)({ description: 'A page of payments' })
 ], PaymentList);
 //# sourceMappingURL=payment-type.js.map

package/dist-server/service/payment/payment-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-type.js","sourceRoot":"","sources":["../../../server/service/payment/payment-type.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FileUpload } from 'graphql-upload/GraphQLUpload.js'\nimport GraphQLUpload from 'graphql-upload/GraphQLUpload.js'\nimport { ObjectType, Field, InputType, Int, ID, registerEnumType } from 'type-graphql'\n\nimport { ObjectRef, ScalarObject } from '@things-factory/shell'\n\nimport { Payment, PaymentDirection, PaymentType } from './payment'\n\n@InputType()\nexport class NewPayment {\n  @Field(type => ObjectRef)\n  transaction: ObjectRef\n\n  @Field({ nullable: true })\n  currency?: string\n\n  @Field({ nullable: false })\n  amount: number\n\n  @Field({ nullable: false })\n  paidAt: Date\n\n  @Field(type => PaymentDirection)\n  direction: PaymentDirection\n\n  @Field(type => PaymentType, { description: 'Type of the payment' })\n  paymentType: PaymentType // 결제 유형\n\n  @Field(type => ObjectRef, { nullable: true, description: 'Source bank account for the payment' })\n  sourceBankAccount?: ObjectRef\n\n  @Field(type => ObjectRef, { nullable: true, description: 'Destination bank account for the payment' })\n  destinationBankAccount?: ObjectRef\n\n  @Field({ nullable: true })\n  note?: string\n}\n\n@InputType()\nexport class PaymentPatch {\n  @Field(type => ID, { nullable: true })\n  id?: string\n\n  @Field(type => ObjectRef)\n  transaction: ObjectRef\n\n  @Field({ nullable: true })\n  currency?: string\n\n  @Field({ nullable: false })\n  amount: number\n\n  @Field({ nullable: false })\n  paidAt: Date\n\n  @Field(type => PaymentDirection)\n  direction: PaymentDirection\n\n  @Field(type => PaymentType, { description: 'Type of the payment' })\n  paymentType: PaymentType // 결제 유형\n\n  @Field(type => ObjectRef, { nullable: true, description: 'Source bank account for the payment' })\n  sourceBankAccount?: ObjectRef\n\n  @Field(type => ObjectRef, { nullable: true, description: 'Destination bank account for the payment' })\n  destinationBankAccount?: ObjectRef\n\n  @Field({ nullable: true })\n  note?: string\n\n  @Field({ nullable: true })\n  cuFlag?: string\n}\n\n@ObjectType()\nexport class PaymentList {\n  @Field(type => [Payment])\n  items: Payment[]\n\n  @Field(type => Int)\n  total: number\n}\n"]}
+{"version":3,"file":"payment-type.js","sourceRoot":"","sources":["../../../server/service/payment/payment-type.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObjectType, Field, Float, InputType, Int, ID } from 'type-graphql'\n\nimport { ObjectRef } from '@things-factory/shell'\n\nimport { Payment, PaymentMethod } from './payment'\n\n@InputType({ description: 'A new part of a transaction put on what it paid' })\nexport class NewPayment {\n  @Field(type => ObjectRef, { description: 'The transaction a part of which this is' })\n  transaction: ObjectRef\n\n  @Field({ description: 'The kind of what was paid, as registered' })\n  targetType: string\n\n  @Field({ description: 'The id of what was paid' })\n  targetId: string\n\n  @Field(type => Float, { description: 'The part of the transaction put on the target' })\n  amount: number\n\n  @Field(type => PaymentMethod, { nullable: true, description: 'Who made the link - a person when not given' })\n  method?: PaymentMethod\n\n  @Field({ nullable: true, description: 'Why a rule made the link' })\n  basis?: string\n\n  @Field({ nullable: true, description: 'Notes' })\n  notes?: string\n}\n\n@InputType({ description: 'A change to a payment, or a grid row: cuFlag + adds, M changes, - deletes' })\nexport class PaymentPatch {\n  @Field(type => ID, { nullable: true, description: 'The payment to change or delete' })\n  id?: string\n\n  @Field(type => ObjectRef, { nullable: true, description: 'The transaction a part of which this is' })\n  transaction?: ObjectRef\n\n  @Field({ nullable: true, description: 'The kind of what was paid, as registered' })\n  targetType?: string\n\n  @Field({ nullable: true, description: 'The id of what was paid' })\n  targetId?: string\n\n  @Field(type => Float, { nullable: true, description: 'The part of the transaction put on the target' })\n  amount?: number\n\n  @Field(type => PaymentMethod, { nullable: true, description: 'Who made the link' })\n  method?: PaymentMethod\n\n  @Field({ nullable: true, description: 'Why a rule made the link' })\n  basis?: string\n\n  @Field({ nullable: true, description: 'Notes' })\n  notes?: string\n\n  @Field({ nullable: true, description: '+ adds, M changes, - deletes' })\n  cuFlag?: string\n}\n\n@ObjectType({ description: 'A page of payments' })\nexport class PaymentList {\n  @Field(type => [Payment], { description: 'The payments on this page' })\n  items: Payment[]\n\n  @Field(type => Int, { description: 'How many there are in all' })\n  total: number\n}\n"]}

package/dist-server/service/payment/payment.d.ts

@@ -1,37 +1,38 @@
 import { Domain } from '@things-factory/shell';
 import { User } from '@things-factory/auth-base';
 import { Transaction } from '../transaction/transaction';
-import { BankAccount } from '../bank-account/bank-account';
-export declare enum PaymentDirection {
-    Incoming = "Incoming",// 수금
-    Outgoing = "Outgoing"
+export declare enum PaymentPurpose {
+    SETTLEMENT = "SETTLEMENT",
+    EVIDENCE = "EVIDENCE",
+    TRANSFER = "TRANSFER"
 }
-export declare enum PaymentType {
-    Transfer = "Transfer",// 계좌 이체
-    Cash = "Cash",// 현금
-    CreditCard = "CreditCard",// 신용카드
-    DebitCard = "DebitCard"
+export declare enum PaymentMethod {
+    RULE = "RULE",
+    PERSON = "PERSON"
 }
+/**
+ * What a transaction paid: a part of it, put on one target - a contract round, a tax invoice, a VAT period, the other
+ * line of a transfer between our own accounts. One transaction may pay several targets, and one target be paid by
+ * several transactions.
+ *
+ * The kinds of target are registered by the apps that own them (§`registerPaymentTarget`), each with its purpose.
+ * Within one purpose the payments of a transaction add up to no more than the transaction; across purposes the same
+ * money is told twice - a deposit settles a round and is evidenced by that round's tax invoice.
+ */
 export declare class Payment {
     readonly id: string;
     version?: number;
     domain?: Domain;
     domainId?: string;
     transaction: Transaction;
-    transactionId: string;
-    currency?: string;
+    transactionId?: string;
+    targetType: string;
+    targetId: string;
     amount: number;
-    paymentType: PaymentType;
-    sourceBankAccount?: BankAccount;
-    sourceBankAccountId?: string;
-    destinationBankAccount?: BankAccount;
-    destinationBankAccountId?: string;
-    year?: number;
-    quarter?: number;
-    month?: number;
-    paidAt: Date;
-    direction: PaymentDirection;
-    note?: string;
+    purpose: PaymentPurpose;
+    method: PaymentMethod;
+    basis?: string;
+    notes?: string;
     createdAt?: Date;
     updatedAt?: Date;
     deletedAt?: Date;