@things-factory/accounting 10.1.134 → 10.1.136

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

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveTransactions = saveTransactions;
+const typeorm_1 = require("typeorm");
+const shell_1 = require("@things-factory/shell");
+const bank_account_1 = require("../bank-account/bank-account");
+const cash_flow_type_1 = require("../cash-flow-type");
+const payment_1 = require("../payment/payment");
+const payment_service_1 = require("../payment/payment-service");
+const payment_targets_1 = require("../payment/payment-targets");
+const transaction_1 = require("./transaction");
+const transaction_period_1 = require("./transaction-period");
+/** What changes the money of a transaction - its payments are checked again when one of these changes. */
+const MONEY = ['amount', 'type', 'currency'];
+/**
+ * The row a patch writes over the current one: a confirmed transaction has a day and takes its year and month from it;
+ * a forecast has a year and a month, and the day its timing names.
+ */
+function rowOf(input, current) {
+    const { id, cuFlag, ...fields } = input;
+    const row = { ...fields };
+    const merged = { ...current, ...row };
+    const category = merged.category ?? transaction_1.TransactionCategory.CONFIRMED;
+    row.category = category;
+    if (!current && !row.type)
+        throw new shell_1.Refusal('transaction-type-required', {}, 'type: money in or money out');
+    if (row.type !== undefined && !Object.values(cash_flow_type_1.CashFlowType).includes(row.type))
+        throw new shell_1.Refusal('transaction-type-required', {}, 'type: money in or money out');
+    if (!current && (row.amount === undefined || row.amount === null))
+        row.amount = 0;
+    if (category === transaction_1.TransactionCategory.CONFIRMED) {
+        const period = (0, transaction_period_1.yearMonthOf)(merged.transactionDate);
+        if (!period)
+            throw new shell_1.Refusal('transaction-date-required', { value: merged.transactionDate ?? '' }, 'transactionDate: YYYY-MM-DD');
+        Object.assign(row, period, { status: null });
+    }
+    else {
+        const [year, month] = [Number(merged.year), Number(merged.month)];
+        if (!year)
+            throw new shell_1.Refusal('forecast-year-required', {}, 'year: the year it is planned in');
+        if (!(month >= 1 && month <= 12))
+            throw new shell_1.Refusal('month-out-of-range', { month: merged.month ?? '' }, 'month: must be 1 to 12');
+        if (!String(merged.description ?? '').trim())
+            throw new shell_1.Refusal('forecast-description-required', {}, 'description: what is planned');
+        Object.assign(row, { year, month, transactionDate: (0, transaction_period_1.forecastDay)(year, month, merged.timing) });
+        if (!merged.status)
+            row.status = transaction_1.ForecastStatus.PLANNED;
+    }
+    if (merged.probability !== undefined &&
+        merged.probability !== null &&
+        !(merged.probability >= 0 && merged.probability <= 100)) {
+        throw new shell_1.Refusal('probability-out-of-range', {}, 'probability: must be 0 to 100');
+    }
+    return row;
+}
+/** The payments on these transactions, and the transfers into them, by target kind. */
+async function paymentsOn(tx, domain, ids) {
+    if (!ids.length)
+        return [];
+    const repo = tx.getRepository(payment_1.Payment);
+    return [
+        ...(await repo.find({
+            where: { domain: { id: domain.id }, transaction: { id: (0, typeorm_1.In)(ids) } },
+            relations: ['transaction']
+        })),
+        ...(await repo.find({
+            where: { domain: { id: domain.id }, targetType: 'Transaction', targetId: (0, typeorm_1.In)(ids) },
+            relations: ['transaction']
+        }))
+    ];
+}
+/**
+ * Apply rows to a domain's transactions: `+` (or no id) adds, `M` changes, `-` deletes (softly - a financial row
+ * that was deleted stays readable). A transaction that pays something, or is paid, is unlinked before it is
+ * deleted; when its money changes, its payments are checked again - the general rule and each target kind's own.
+ */
+async function saveTransactions(tx, domain, user, inputs) {
+    const repo = tx.getRepository(transaction_1.Transaction);
+    const deletes = [...new Set(inputs.filter(one => one.cuFlag === '-' && one.id).map(one => one.id))];
+    if (deletes.length) {
+        const found = await repo.find({ where: { domain: { id: domain.id }, id: (0, typeorm_1.In)(deletes) } });
+        if (found.length !== deletes.length)
+            throw new shell_1.Refusal('transaction-not-found', {}, 'a transaction was not found - reload and try again');
+        if ((await paymentsOn(tx, domain, deletes)).length)
+            throw new shell_1.Refusal('transaction-has-payments', {}, 'unlink what the transaction paid before deleting it');
+        await repo.softRemove(found);
+    }
+    const saved = [];
+    const moneyChanged = [];
+    for (const input of inputs.filter(one => one.cuFlag !== '-')) {
+        const isNew = !input.id || input.cuFlag === '+';
+        const current = isNew ? undefined : await repo.findOne({ where: { domain: { id: domain.id }, id: input.id } });
+        if (!isNew && !current)
+            throw new shell_1.Refusal('transaction-not-found', {}, 'a transaction was not found - reload and try again');
+        const row = rowOf(input, current);
+        if (row.bankAccount?.id && !('currency' in input)) {
+            const account = await tx
+                .getRepository(bank_account_1.BankAccount)
+                .findOne({ where: { domain: { id: domain.id }, id: row.bankAccount.id } });
+            if (!account)
+                throw new shell_1.Refusal('bank-account-not-found', {}, 'the bank account was not found - reload and try again');
+            if (account.currency)
+                row.currency = account.currency;
+        }
+        if (row.bankFingerprint) {
+            const twin = await repo.findOne({ where: { domain: { id: domain.id }, bankFingerprint: row.bankFingerprint } });
+            if (twin && twin.id !== current?.id)
+                throw new shell_1.Refusal('bank-line-twice', { day: twin.transactionDate ?? '' }, 'this bank line is already in the books');
+        }
+        const written = await repo.save({ ...(current ?? { domain, creator: user }), ...row, updater: user });
+        if (current && MONEY.some(field => field in row && row[field] !== current[field]))
+            moneyChanged.push(current.id);
+        saved.push(written);
+    }
+    if (moneyChanged.length) {
+        const payments = await paymentsOn(tx, domain, moneyChanged);
+        await (0, payment_service_1.checkPaymentsWithin)(tx, domain, payments.map(one => one.transaction.id));
+        const kinds = new Map();
+        for (const payment of payments)
+            kinds.set(payment.targetType, [...(kinds.get(payment.targetType) ?? []), payment]);
+        for (const [targetType, ofKind] of kinds) {
+            await (0, payment_targets_1.paymentTargetOf)(targetType)?.validate?.(tx, domain, {
+                targetIds: [...new Set(ofKind.map(one => one.targetId))],
+                transactionIds: [...new Set(ofKind.map(one => one.transaction.id))]
+            });
+        }
+    }
+    return saved;
+}
+//# sourceMappingURL=transaction-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-service.js","sourceRoot":"","sources":["../../../server/service/transaction/transaction-service.ts"],"names":[],"mappings":"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","sourcesContent":["import { EntityManager, In } from 'typeorm'\n\nimport { Refusal } from '@things-factory/shell'\n\nimport { BankAccount } from '../bank-account/bank-account'\nimport { CashFlowType } from '../cash-flow-type'\nimport { Payment } from '../payment/payment'\nimport { checkPaymentsWithin } from '../payment/payment-service'\nimport { paymentTargetOf } from '../payment/payment-targets'\nimport { ForecastStatus, Transaction, TransactionCategory } from './transaction'\nimport { forecastDay, yearMonthOf } from './transaction-period'\n\n/** A transaction as a module writes it: what a person may write, and the facts a bank statement gives. */\nexport type TransactionInput = Partial<\n  Omit<Transaction, 'bankAccount' | 'account' | 'counterparty' | 'recurringItem' | 'bankStatement'>\n> & {\n  id?: string\n  cuFlag?: string\n  bankAccount?: { id: string } | null\n  account?: { id: string } | null\n  counterparty?: { id: string } | null\n  recurringItem?: { id: string } | null\n  bankStatement?: { id: string } | null\n}\n\n/** What changes the money of a transaction - its payments are checked again when one of these changes. */\nconst MONEY = ['amount', 'type', 'currency'] as const\n\n/**\n * The row a patch writes over the current one: a confirmed transaction has a day and takes its year and month from it;\n * a forecast has a year and a month, and the day its timing names.\n */\nfunction rowOf(input: TransactionInput, current: Transaction | undefined): Record<string, any> {\n  const { id, cuFlag, ...fields } = input\n  const row: Record<string, any> = { ...fields }\n  const merged = { ...current, ...row }\n  const category = merged.category ?? TransactionCategory.CONFIRMED\n  row.category = category\n\n  if (!current && !row.type) throw new Refusal('transaction-type-required', {}, 'type: money in or money out')\n  if (row.type !== undefined && !Object.values(CashFlowType).includes(row.type))\n    throw new Refusal('transaction-type-required', {}, 'type: money in or money out')\n  if (!current && (row.amount === undefined || row.amount === null)) row.amount = 0\n\n  if (category === TransactionCategory.CONFIRMED) {\n    const period = yearMonthOf(merged.transactionDate)\n    if (!period)\n      throw new Refusal(\n        'transaction-date-required',\n        { value: merged.transactionDate ?? '' },\n        'transactionDate: YYYY-MM-DD'\n      )\n    Object.assign(row, period, { status: null })\n  } else {\n    const [year, month] = [Number(merged.year), Number(merged.month)]\n    if (!year) throw new Refusal('forecast-year-required', {}, 'year: the year it is planned in')\n    if (!(month >= 1 && month <= 12))\n      throw new Refusal('month-out-of-range', { month: merged.month ?? '' }, 'month: must be 1 to 12')\n    if (!String(merged.description ?? '').trim())\n      throw new Refusal('forecast-description-required', {}, 'description: what is planned')\n    Object.assign(row, { year, month, transactionDate: forecastDay(year, month, merged.timing) })\n    if (!merged.status) row.status = ForecastStatus.PLANNED\n  }\n\n  if (\n    merged.probability !== undefined &&\n    merged.probability !== null &&\n    !(merged.probability >= 0 && merged.probability <= 100)\n  ) {\n    throw new Refusal('probability-out-of-range', {}, 'probability: must be 0 to 100')\n  }\n\n  return row\n}\n\n/** The payments on these transactions, and the transfers into them, by target kind. */\nasync function paymentsOn(tx: EntityManager, domain: { id: string }, ids: string[]): Promise<Payment[]> {\n  if (!ids.length) return []\n  const repo = tx.getRepository(Payment)\n  return [\n    ...(await repo.find({\n      where: { domain: { id: domain.id }, transaction: { id: In(ids) } },\n      relations: ['transaction']\n    })),\n    ...(await repo.find({\n      where: { domain: { id: domain.id }, targetType: 'Transaction', targetId: In(ids) },\n      relations: ['transaction']\n    }))\n  ]\n}\n\n/**\n * Apply rows to a domain's transactions: `+` (or no id) adds, `M` changes, `-` deletes (softly - a financial row\n * that was deleted stays readable). A transaction that pays something, or is paid, is unlinked before it is\n * deleted; when its money changes, its payments are checked again - the general rule and each target kind's own.\n */\nexport async function saveTransactions(\n  tx: EntityManager,\n  domain: { id: string },\n  user: any,\n  inputs: TransactionInput[]\n): Promise<Transaction[]> {\n  const repo = tx.getRepository(Transaction)\n\n  const deletes = [...new Set(inputs.filter(one => one.cuFlag === '-' && one.id).map(one => one.id!))]\n  if (deletes.length) {\n    const found = await repo.find({ where: { domain: { id: domain.id }, id: In(deletes) } })\n    if (found.length !== deletes.length)\n      throw new Refusal('transaction-not-found', {}, 'a transaction was not found - reload and try again')\n    if ((await paymentsOn(tx, domain, deletes)).length)\n      throw new Refusal('transaction-has-payments', {}, 'unlink what the transaction paid before deleting it')\n    await repo.softRemove(found)\n  }\n\n  const saved: Transaction[] = []\n  const moneyChanged: string[] = []\n  for (const input of inputs.filter(one => one.cuFlag !== '-')) {\n    const isNew = !input.id || input.cuFlag === '+'\n    const current = isNew ? undefined : await repo.findOne({ where: { domain: { id: domain.id }, id: input.id } })\n    if (!isNew && !current)\n      throw new Refusal('transaction-not-found', {}, 'a transaction was not found - reload and try again')\n\n    const row = rowOf(input, current)\n    if (row.bankAccount?.id && !('currency' in input)) {\n      const account = await tx\n        .getRepository(BankAccount)\n        .findOne({ where: { domain: { id: domain.id }, id: row.bankAccount.id } })\n      if (!account)\n        throw new Refusal('bank-account-not-found', {}, 'the bank account was not found - reload and try again')\n      if (account.currency) row.currency = account.currency\n    }\n\n    if (row.bankFingerprint) {\n      const twin = await repo.findOne({ where: { domain: { id: domain.id }, bankFingerprint: row.bankFingerprint } })\n      if (twin && twin.id !== current?.id)\n        throw new Refusal(\n          'bank-line-twice',\n          { day: twin.transactionDate ?? '' },\n          'this bank line is already in the books'\n        )\n    }\n\n    const written = await repo.save({ ...(current ?? { domain, creator: user }), ...row, updater: user } as Transaction)\n    if (current && MONEY.some(field => field in row && row[field] !== (current as any)[field]))\n      moneyChanged.push(current.id)\n    saved.push(written)\n  }\n\n  if (moneyChanged.length) {\n    const payments = await paymentsOn(tx, domain, moneyChanged)\n    await checkPaymentsWithin(\n      tx,\n      domain,\n      payments.map(one => one.transaction.id)\n    )\n    const kinds = new Map<string, Payment[]>()\n    for (const payment of payments) kinds.set(payment.targetType, [...(kinds.get(payment.targetType) ?? []), payment])\n    for (const [targetType, ofKind] of kinds) {\n      await paymentTargetOf(targetType)?.validate?.(tx, domain, {\n        targetIds: [...new Set(ofKind.map(one => one.targetId))],\n        transactionIds: [...new Set(ofKind.map(one => one.transaction.id))]\n      })\n    }\n  }\n\n  return saved\n}\n"]}

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

@@ -1,16 +1,48 @@
-import { Transaction, TransactionType } from './transaction';
+import { ObjectRef } from '@things-factory/shell';
+import { CashFlowType } from '../cash-flow-type';
+import { ForecastStatus, Transaction, TransactionCategory } from './transaction';
 export declare class NewTransaction {
-    name: string;
+    category?: TransactionCategory;
+    type: CashFlowType;
+    bankAccount?: ObjectRef;
+    transactionDate?: string;
+    year?: number;
+    month?: number;
+    amount?: number;
+    currency?: string;
+    balance?: number;
+    account?: ObjectRef;
     description?: string;
-    type?: TransactionType;
-    active?: boolean;
+    ledgerCategory?: string;
+    counterpartyName?: string;
+    counterparty?: ObjectRef;
+    timing?: string;
+    status?: ForecastStatus;
+    probability?: number;
+    notes?: string;
+    recurringItem?: ObjectRef;
 }
 export declare class TransactionPatch {
     id?: string;
-    name?: string;
+    category?: TransactionCategory;
+    type?: CashFlowType;
+    bankAccount?: ObjectRef;
+    transactionDate?: string;
+    year?: number;
+    month?: number;
+    amount?: number;
+    currency?: string;
+    balance?: number;
+    account?: ObjectRef;
     description?: string;
-    type?: TransactionType;
-    active?: boolean;
+    ledgerCategory?: string;
+    counterpartyName?: string;
+    counterparty?: ObjectRef;
+    timing?: string;
+    status?: ForecastStatus;
+    probability?: number;
+    notes?: string;
+    recurringItem?: ObjectRef;
     cuFlag?: string;
 }
 export declare class TransactionList {

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

@@ -3,71 +3,193 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TransactionList = exports.TransactionPatch = exports.NewTransaction = void 0;
 const tslib_1 = require("tslib");
 const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const cash_flow_type_1 = require("../cash-flow-type");
 const transaction_1 = require("./transaction");
 let NewTransaction = class NewTransaction {
 };
 exports.NewTransaction = NewTransaction;
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(),
+    (0, type_graphql_1.Field)(type => transaction_1.TransactionCategory, { nullable: true, description: 'Confirmed when not given' }),
     tslib_1.__metadata("design:type", String)
-], NewTransaction.prototype, "name", void 0);
+], NewTransaction.prototype, "category", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)(type => cash_flow_type_1.CashFlowType, { description: 'Money in or money out' }),
+    tslib_1.__metadata("design:type", String)
+], NewTransaction.prototype, "type", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'The account the money moved in or out of' }),
+    tslib_1.__metadata("design:type", shell_1.ObjectRef)
+], NewTransaction.prototype, "bankAccount", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'YYYY-MM-DD - required for a confirmed transaction' }),
+    tslib_1.__metadata("design:type", String)
+], NewTransaction.prototype, "transactionDate", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'The year a forecast is planned in' }),
+    tslib_1.__metadata("design:type", Number)
+], NewTransaction.prototype, "year", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'The month a forecast is planned in' }),
+    tslib_1.__metadata("design:type", Number)
+], NewTransaction.prototype, "month", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { nullable: true, description: 'Amount - zero when not given' }),
+    tslib_1.__metadata("design:type", Number)
+], NewTransaction.prototype, "amount", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: "ISO 4217 code - the bank account's when not given" }),
+    tslib_1.__metadata("design:type", String)
+], NewTransaction.prototype, "currency", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { nullable: true, description: 'Account balance after it' }),
+    tslib_1.__metadata("design:type", Number)
+], NewTransaction.prototype, "balance", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'The account subject it is booked to' }),
+    tslib_1.__metadata("design:type", shell_1.ObjectRef)
+], NewTransaction.prototype, "account", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'What a person wrote about it' }),
     tslib_1.__metadata("design:type", String)
 ], NewTransaction.prototype, "description", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => transaction_1.TransactionType, { nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The classifying word of the ledger it was kept in' }),
+    tslib_1.__metadata("design:type", String)
+], NewTransaction.prototype, "ledgerCategory", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The counterparty name as a person wrote it' }),
+    tslib_1.__metadata("design:type", String)
+], NewTransaction.prototype, "counterpartyName", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'The registered counterparty' }),
+    tslib_1.__metadata("design:type", shell_1.ObjectRef)
+], NewTransaction.prototype, "counterparty", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'When in the month a forecast falls' }),
+    tslib_1.__metadata("design:type", String)
+], NewTransaction.prototype, "timing", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => transaction_1.ForecastStatus, { nullable: true, description: 'State of a forecast' }),
+    tslib_1.__metadata("design:type", String)
+], NewTransaction.prototype, "status", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'The probability of a forecast being realized (0 to 100)' }),
     tslib_1.__metadata("design:type", Number)
-], NewTransaction.prototype, "type", void 0);
+], NewTransaction.prototype, "probability", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Notes' }),
+    tslib_1.__metadata("design:type", String)
+], NewTransaction.prototype, "notes", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
-    tslib_1.__metadata("design:type", Boolean)
-], NewTransaction.prototype, "active", void 0);
+    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'The recurring item a forecast was made from' }),
+    tslib_1.__metadata("design:type", shell_1.ObjectRef)
+], NewTransaction.prototype, "recurringItem", void 0);
 exports.NewTransaction = NewTransaction = tslib_1.__decorate([
-    (0, type_graphql_1.InputType)()
+    (0, type_graphql_1.InputType)({ description: 'A transaction someone writes - a bank line by hand, or a forecast' })
 ], NewTransaction);
 let TransactionPatch = class TransactionPatch {
 };
 exports.TransactionPatch = TransactionPatch;
 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 transaction to change or delete' }),
     tslib_1.__metadata("design:type", String)
 ], TransactionPatch.prototype, "id", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)(type => transaction_1.TransactionCategory, { nullable: true, description: 'Confirmed or forecast' }),
     tslib_1.__metadata("design:type", String)
-], TransactionPatch.prototype, "name", void 0);
+], TransactionPatch.prototype, "category", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
+    (0, type_graphql_1.Field)(type => cash_flow_type_1.CashFlowType, { nullable: true, description: 'Money in or money out' }),
+    tslib_1.__metadata("design:type", String)
+], TransactionPatch.prototype, "type", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'The account the money moved in or out of' }),
+    tslib_1.__metadata("design:type", shell_1.ObjectRef)
+], TransactionPatch.prototype, "bankAccount", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'YYYY-MM-DD' }),
+    tslib_1.__metadata("design:type", String)
+], TransactionPatch.prototype, "transactionDate", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'The year a forecast is planned in' }),
+    tslib_1.__metadata("design:type", Number)
+], TransactionPatch.prototype, "year", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'The month a forecast is planned in' }),
+    tslib_1.__metadata("design:type", Number)
+], TransactionPatch.prototype, "month", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { nullable: true, description: 'Amount' }),
+    tslib_1.__metadata("design:type", Number)
+], TransactionPatch.prototype, "amount", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'ISO 4217 code' }),
+    tslib_1.__metadata("design:type", String)
+], TransactionPatch.prototype, "currency", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { nullable: true, description: 'Account balance after it' }),
+    tslib_1.__metadata("design:type", Number)
+], TransactionPatch.prototype, "balance", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'The account subject it is booked to' }),
+    tslib_1.__metadata("design:type", shell_1.ObjectRef)
+], TransactionPatch.prototype, "account", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'What a person wrote about it' }),
     tslib_1.__metadata("design:type", String)
 ], TransactionPatch.prototype, "description", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => transaction_1.TransactionType, { nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The classifying word of the ledger it was kept in' }),
+    tslib_1.__metadata("design:type", String)
+], TransactionPatch.prototype, "ledgerCategory", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The counterparty name as a person wrote it' }),
+    tslib_1.__metadata("design:type", String)
+], TransactionPatch.prototype, "counterpartyName", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'The registered counterparty' }),
+    tslib_1.__metadata("design:type", shell_1.ObjectRef)
+], TransactionPatch.prototype, "counterparty", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'When in the month a forecast falls' }),
+    tslib_1.__metadata("design:type", String)
+], TransactionPatch.prototype, "timing", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => transaction_1.ForecastStatus, { nullable: true, description: 'State of a forecast' }),
+    tslib_1.__metadata("design:type", String)
+], TransactionPatch.prototype, "status", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { nullable: true, description: 'The probability of a forecast being realized (0 to 100)' }),
     tslib_1.__metadata("design:type", Number)
-], TransactionPatch.prototype, "type", void 0);
+], TransactionPatch.prototype, "probability", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Notes' }),
+    tslib_1.__metadata("design:type", String)
+], TransactionPatch.prototype, "notes", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true }),
-    tslib_1.__metadata("design:type", Boolean)
-], TransactionPatch.prototype, "active", void 0);
+    (0, type_graphql_1.Field)(type => shell_1.ObjectRef, { nullable: true, description: 'The recurring item a forecast was made from' }),
+    tslib_1.__metadata("design:type", shell_1.ObjectRef)
+], TransactionPatch.prototype, "recurringItem", 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)
 ], TransactionPatch.prototype, "cuFlag", void 0);
 exports.TransactionPatch = TransactionPatch = tslib_1.__decorate([
-    (0, type_graphql_1.InputType)()
+    (0, type_graphql_1.InputType)({ description: 'A change to a transaction, or a grid row: cuFlag + adds, M changes, - deletes' })
 ], TransactionPatch);
 let TransactionList = class TransactionList {
 };
 exports.TransactionList = TransactionList;
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)(type => [transaction_1.Transaction]),
+    (0, type_graphql_1.Field)(type => [transaction_1.Transaction], { description: 'The transactions on this page' }),
     tslib_1.__metadata("design:type", Array)
 ], TransactionList.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)
 ], TransactionList.prototype, "total", void 0);
 exports.TransactionList = TransactionList = tslib_1.__decorate([
-    (0, type_graphql_1.ObjectType)()
+    (0, type_graphql_1.ObjectType)({ description: 'A page of transactions' })
 ], TransactionList);
 //# sourceMappingURL=transaction-type.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"transaction-type.js","sourceRoot":"","sources":["../../../server/service/transaction/transaction-type.ts"],"names":[],"mappings":";;;;AAAA,+CAAsF;AAEtF,+CAA4D;AAGrD,IAAM,cAAc,GAApB,MAAM,cAAc;CAY1B,CAAA;AAZY,wCAAc;AAEzB;IADC,IAAA,oBAAK,GAAE;;4CACI;AAGZ;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;mDACN;AAGpB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,6BAAe,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;4CAC7B;AAGtB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8CACV;yBAXL,cAAc;IAD1B,IAAA,wBAAS,GAAE;GACC,cAAc,CAY1B;AAGM,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAkB5B,CAAA;AAlBY,4CAAgB;AAE3B;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;4CAC3B;AAGX;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8CACb;AAGb;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;qDACN;AAGpB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,6BAAe,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;8CAC7B;AAGtB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;gDACV;AAGhB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;gDACX;2BAjBJ,gBAAgB;IAD5B,IAAA,wBAAS,GAAE;GACC,gBAAgB,CAkB5B;AAGM,IAAM,eAAe,GAArB,MAAM,eAAe;CAM3B,CAAA;AANY,0CAAe;AAE1B;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,CAAC,yBAAW,CAAC,CAAC;;8CACT;AAGpB;IADC,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,CAAC;;8CACN;0BALF,eAAe;IAD3B,IAAA,yBAAU,GAAE;GACA,eAAe,CAM3B","sourcesContent":["import { ObjectType, Field, InputType, Int, ID, registerEnumType } from 'type-graphql'\n\nimport { Transaction, TransactionType } from './transaction'\n\n@InputType()\nexport class NewTransaction {\n  @Field()\n  name: string\n\n  @Field({ nullable: true })\n  description?: string\n\n  @Field(type => TransactionType, { nullable: true })\n  type?: TransactionType\n\n  @Field({ nullable: true })\n  active?: boolean\n}\n\n@InputType()\nexport class TransactionPatch {\n  @Field(type => ID, { nullable: true })\n  id?: string\n\n  @Field({ nullable: true })\n  name?: string\n\n  @Field({ nullable: true })\n  description?: string\n\n  @Field(type => TransactionType, { nullable: true })\n  type?: TransactionType\n\n  @Field({ nullable: true })\n  active?: boolean\n\n  @Field({ nullable: true })\n  cuFlag?: string\n}\n\n@ObjectType()\nexport class TransactionList {\n  @Field(type => [Transaction])\n  items: Transaction[]\n\n  @Field(type => Int)\n  total: number\n}\n"]}
+{"version":3,"file":"transaction-type.js","sourceRoot":"","sources":["../../../server/service/transaction/transaction-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 { CashFlowType } from '../cash-flow-type'\nimport { ForecastStatus, Transaction, TransactionCategory } from './transaction'\n\n@InputType({ description: 'A transaction someone writes - a bank line by hand, or a forecast' })\nexport class NewTransaction {\n  @Field(type => TransactionCategory, { nullable: true, description: 'Confirmed when not given' })\n  category?: TransactionCategory\n\n  @Field(type => CashFlowType, { description: 'Money in or money out' })\n  type: CashFlowType\n\n  @Field(type => ObjectRef, { nullable: true, description: 'The account the money moved in or out of' })\n  bankAccount?: ObjectRef\n\n  @Field({ nullable: true, description: 'YYYY-MM-DD - required for a confirmed transaction' })\n  transactionDate?: string\n\n  @Field(type => Int, { nullable: true, description: 'The year a forecast is planned in' })\n  year?: number\n\n  @Field(type => Int, { nullable: true, description: 'The month a forecast is planned in' })\n  month?: number\n\n  @Field(type => Float, { nullable: true, description: 'Amount - zero when not given' })\n  amount?: number\n\n  @Field({ nullable: true, description: \"ISO 4217 code - the bank account's when not given\" })\n  currency?: string\n\n  @Field(type => Float, { nullable: true, description: 'Account balance after it' })\n  balance?: number\n\n  @Field(type => ObjectRef, { nullable: true, description: 'The account subject it is booked to' })\n  account?: ObjectRef\n\n  @Field({ nullable: true, description: 'What a person wrote about it' })\n  description?: string\n\n  @Field({ nullable: true, description: 'The classifying word of the ledger it was kept in' })\n  ledgerCategory?: string\n\n  @Field({ nullable: true, description: 'The counterparty name as a person wrote it' })\n  counterpartyName?: string\n\n  @Field(type => ObjectRef, { nullable: true, description: 'The registered counterparty' })\n  counterparty?: ObjectRef\n\n  @Field({ nullable: true, description: 'When in the month a forecast falls' })\n  timing?: string\n\n  @Field(type => ForecastStatus, { nullable: true, description: 'State of a forecast' })\n  status?: ForecastStatus\n\n  @Field(type => Int, { nullable: true, description: 'The probability of a forecast being realized (0 to 100)' })\n  probability?: number\n\n  @Field({ nullable: true, description: 'Notes' })\n  notes?: string\n\n  @Field(type => ObjectRef, { nullable: true, description: 'The recurring item a forecast was made from' })\n  recurringItem?: ObjectRef\n}\n\n@InputType({ description: 'A change to a transaction, or a grid row: cuFlag + adds, M changes, - deletes' })\nexport class TransactionPatch {\n  @Field(type => ID, { nullable: true, description: 'The transaction to change or delete' })\n  id?: string\n\n  @Field(type => TransactionCategory, { nullable: true, description: 'Confirmed or forecast' })\n  category?: TransactionCategory\n\n  @Field(type => CashFlowType, { nullable: true, description: 'Money in or money out' })\n  type?: CashFlowType\n\n  @Field(type => ObjectRef, { nullable: true, description: 'The account the money moved in or out of' })\n  bankAccount?: ObjectRef\n\n  @Field({ nullable: true, description: 'YYYY-MM-DD' })\n  transactionDate?: string\n\n  @Field(type => Int, { nullable: true, description: 'The year a forecast is planned in' })\n  year?: number\n\n  @Field(type => Int, { nullable: true, description: 'The month a forecast is planned in' })\n  month?: number\n\n  @Field(type => Float, { nullable: true, description: 'Amount' })\n  amount?: number\n\n  @Field({ nullable: true, description: 'ISO 4217 code' })\n  currency?: string\n\n  @Field(type => Float, { nullable: true, description: 'Account balance after it' })\n  balance?: number\n\n  @Field(type => ObjectRef, { nullable: true, description: 'The account subject it is booked to' })\n  account?: ObjectRef\n\n  @Field({ nullable: true, description: 'What a person wrote about it' })\n  description?: string\n\n  @Field({ nullable: true, description: 'The classifying word of the ledger it was kept in' })\n  ledgerCategory?: string\n\n  @Field({ nullable: true, description: 'The counterparty name as a person wrote it' })\n  counterpartyName?: string\n\n  @Field(type => ObjectRef, { nullable: true, description: 'The registered counterparty' })\n  counterparty?: ObjectRef\n\n  @Field({ nullable: true, description: 'When in the month a forecast falls' })\n  timing?: string\n\n  @Field(type => ForecastStatus, { nullable: true, description: 'State of a forecast' })\n  status?: ForecastStatus\n\n  @Field(type => Int, { nullable: true, description: 'The probability of a forecast being realized (0 to 100)' })\n  probability?: number\n\n  @Field({ nullable: true, description: 'Notes' })\n  notes?: string\n\n  @Field(type => ObjectRef, { nullable: true, description: 'The recurring item a forecast was made from' })\n  recurringItem?: ObjectRef\n\n  @Field({ nullable: true, description: '+ adds, M changes, - deletes' })\n  cuFlag?: string\n}\n\n@ObjectType({ description: 'A page of transactions' })\nexport class TransactionList {\n  @Field(type => [Transaction], { description: 'The transactions on this page' })\n  items: Transaction[]\n\n  @Field(type => Int, { description: 'How many there are in all' })\n  total: number\n}\n"]}

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

@@ -1,50 +1,77 @@
 import { Domain } from '@things-factory/shell';
 import { User } from '@things-factory/auth-base';
+import { Counterparty } from '@things-factory/biz-base';
 import { Account } from '../account/account';
+import { BankAccount } from '../bank-account/bank-account';
+import { BankStatement } from '../bank-statement/bank-statement';
+import { CashFlowType } from '../cash-flow-type';
 import { Payment } from '../payment/payment';
 import { AccountingDocument } from '../accounting-document/accounting-document';
-export declare enum TransactionType {
-    SalesIncome = 0,// 매출
-    PurchaseExpense = 1,// 매입
-    Asset = 2,// 자산
-    Liability = 3,// 부채
-    Equity = 4,// 자본
-    OtherIncome = 5,// 기타 수익
-    OtherExpense = 6
-}
+import { RecurringCashItem } from '../recurring-cash-item/recurring-cash-item';
 export declare enum TransactionCategory {
-    Confirmed = "Confirmed",// 확정된 건
-    Forecast = "Forecast"
+    CONFIRMED = "CONFIRMED",
+    FORECAST = "FORECAST"
+}
+export declare enum TransactionSource {
+    BANK_STATEMENT = "BANK_STATEMENT",
+    LEGACY = "LEGACY",
+    MANUAL = "MANUAL"
 }
-export declare enum TransactionStatus {
-    Pending = "Pending",// 처리 대기 중
-    Paid = "Paid",// 전액 결제됨
-    PartiallyPaid = "PartiallyPaid",// 일부만 결제됨
-    Cancelled = "Cancelled",// 취소됨
-    Delayed = "Delayed",// 지연됨
-    ForecastFailed = "ForecastFailed"
+export declare enum ForecastStatus {
+    PLANNED = "PLANNED",
+    DONE = "DONE",
+    CANCELLED = "CANCELLED"
 }
+/**
+ * Money that moves in or out of the business: a line on a bank account (confirmed), or a plan someone made of money
+ * still to come or go (forecast).
+ *
+ * What a transaction paid - a contract round, a tax invoice, a VAT period - is its payments (§`Payment`). The facts
+ * of a bank line are kept as the bank gave them, beside what a person wrote about it.
+ */
 export declare class Transaction {
     readonly id: string;
     version?: number;
     domain?: Domain;
     domainId?: string;
-    name?: string;
-    description?: string;
-    currency?: string;
-    amount?: number;
-    active?: boolean;
-    type?: TransactionType;
     category: TransactionCategory;
-    status: TransactionStatus;
-    probability?: number;
-    forecastNotes?: string;
+    type: CashFlowType;
+    bankAccount?: BankAccount;
+    bankAccountId?: string;
+    transactionDate?: string;
+    transactionAt?: string;
+    year: number;
+    month: number;
+    amount: number;
+    currency: string;
+    balance?: number;
     account?: Account;
     accountId?: string;
-    year?: number;
-    quarter?: number;
-    month?: number;
-    transactionDate: string;
+    description?: string;
+    ledgerCategory?: string;
+    counterpartyName?: string;
+    counterparty?: Counterparty;
+    counterpartyId?: string;
+    source: TransactionSource;
+    bankStatement?: BankStatement;
+    bankStatementId?: string;
+    sourceFile?: string;
+    sourceRow?: number;
+    bankSequence?: number;
+    bankFingerprint?: string;
+    bankReconciliationBefore?: Record<string, any>;
+    bankDescription?: string;
+    bankKind?: string;
+    bankCounterpartyName?: string;
+    bankCounterpartyAccount?: string;
+    bankCounterpartyBank?: string;
+    bankMemo?: string;
+    timing?: string;
+    status?: ForecastStatus;
+    probability?: number;
+    notes?: string;
+    recurringItem?: RecurringCashItem;
+    recurringItemId?: string;
     payments?: Payment[];
     documents?: AccountingDocument[];
     createdAt?: Date;