refactor: organize backend by business responsibility

2026-09-13 13:52:57 +03:00
parent 7fde3ece6e
commit 8ba005346d
145 changed files with 3027 additions and 2346 deletions
@@ -0,0 +1,224 @@
+jest.mock('../operations/application/brokerage-operations.service', () => ({
+  BrokerageOperationsService: class BrokerageOperationsService {},
+}));
+
+import { BrokerageOperationDto } from '../operations/presentation/brokerage-operation.dto';
+import { IncomeAnalyticsService } from './income-analytics.service';
+
+describe('IncomeAnalyticsService', () => {
+  const operations = { collectRanges: jest.fn() };
+  const service = new IncomeAnalyticsService(operations as never);
+
+  beforeEach(() => jest.clearAllMocks());
+
+  function seed(items: BrokerageOperationDto[]) {
+    operations.collectRanges.mockImplementation(
+      (
+        _user: string,
+        _account: string,
+        build: (opened?: Date) => unknown[],
+      ) => {
+        build(undefined);
+        return { pages: [[{ items }], [{ items: [] }], [{ items: [] }]] };
+      },
+    );
+  }
+
+  it.each([
+    {
+      identity: {
+        instrumentUid: 'UID',
+        figi: 'FIGI',
+        ticker: 'T',
+        instrumentType: 'bond',
+      },
+      key: 'uid:UID:RUB',
+    },
+    {
+      identity: { figi: 'FIGI', ticker: 'T', instrumentType: 'bond' },
+      key: 'figi:FIGI:RUB',
+    },
+    {
+      identity: { ticker: 'T', instrumentType: 'bond' },
+      key: 'ticker:T:bond:RUB',
+    },
+    { identity: { ticker: 'T' }, key: 'ticker:T::RUB' },
+    {
+      identity: { ticker: null, instrumentType: 'bond' },
+      key: 'ticker::bond:RUB',
+    },
+    { identity: { ticker: null }, key: 'operation:receipt:RUB' },
+  ])(
+    'uses one membership for entry and aggregate: $key',
+    async ({ identity, key }) => {
+      const payment = {
+        ...entry('receipt', 'OPERATION_TYPE_COUPON', '10.25', 'RUB'),
+        ...identity,
+      };
+      seed([payment]);
+
+      const result = await service.analytics(
+        'user',
+        'account',
+        '2026-01-01',
+        '2026-01-31',
+      );
+
+      expect(result.entries).toEqual([{ ...payment, instrumentKey: key }]);
+      expect(result.instruments).toEqual([
+        expect.objectContaining({
+          key,
+          receiptCount: 1,
+          total: { currency: 'RUB', value: '10.25' },
+        }),
+      ]);
+    },
+  );
+
+  it('preserves entry order, repeated IDs, currency groups and signed exact totals', async () => {
+    const selected = [
+      {
+        ...entry('same-id', 'OPERATION_TYPE_COUPON', '10.25', 'RUB'),
+        instrumentUid: 'UID',
+      },
+      {
+        ...entry('same-id', 'OPERATION_TYPE_DIVIDEND', '-0.25', 'RUB'),
+        instrumentUid: 'UID',
+      },
+      {
+        ...entry('usd', 'OPERATION_TYPE_COUPON', '20', 'USD'),
+        instrumentUid: 'UID',
+      },
+    ];
+    seed(selected);
+
+    const result = await service.analytics(
+      'user',
+      'account',
+      '2026-01-01',
+      '2026-01-31',
+    );
+
+    expect(result.entries).toEqual(
+      selected.map((item) => ({
+        ...item,
+        instrumentKey: `uid:UID:${item.payment?.currency}`,
+      })),
+    );
+    expect(
+      result.instruments.map(
+        ({ key, receiptCount, coupon, dividend, total }) => ({
+          key,
+          receiptCount,
+          coupon,
+          dividend,
+          total,
+        }),
+      ),
+    ).toEqual([
+      {
+        key: 'uid:UID:USD',
+        receiptCount: 1,
+        coupon: { currency: 'USD', value: '20' },
+        dividend: { currency: 'USD', value: '0' },
+        total: { currency: 'USD', value: '20' },
+      },
+      {
+        key: 'uid:UID:RUB',
+        receiptCount: 2,
+        coupon: { currency: 'RUB', value: '10.25' },
+        dividend: { currency: 'RUB', value: '-0.25' },
+        total: { currency: 'RUB', value: '10' },
+      },
+    ]);
+    expect(
+      result.entries
+        .filter((item) => item.instrumentKey === 'uid:UID:RUB')
+        .map((item) => item.payment?.value),
+    ).toEqual(['10.25', '-0.25']);
+  });
+
+  it('aggregates only exact coupon and dividend payments by source currency', async () => {
+    operations.collectRanges.mockImplementation(
+      (
+        _user: string,
+        _account: string,
+        build: (opened?: Date) => unknown[],
+      ) => {
+        build(undefined);
+        return {
+          pages: [
+            [
+              {
+                items: [
+                  entry('coupon', 'OPERATION_TYPE_COUPON', '10.25', 'RUB'),
+                  entry('dividend', 'OPERATION_TYPE_DIVIDEND', '-2.5', 'RUB'),
+                  entry(
+                    'transfer',
+                    'OPERATION_TYPE_DIVIDEND_TRANSFER',
+                    '99',
+                    'RUB',
+                  ),
+                  entry('usd', 'OPERATION_TYPE_COUPON', '1', 'USD'),
+                ],
+              },
+            ],
+            [{ items: [] }],
+            [{ items: [] }],
+          ],
+        };
+      },
+    );
+
+    const result = await service.analytics(
+      'user',
+      'account',
+      '2026-01-01',
+      '2026-01-31',
+    );
+
+    expect(result.totalsByCurrency).toEqual([
+      expect.objectContaining({
+        currency: 'RUB',
+        coupon: { currency: 'RUB', value: '10.25' },
+        dividend: { currency: 'RUB', value: '-2.5' },
+        total: { currency: 'RUB', value: '7.75' },
+      }),
+      expect.objectContaining({
+        currency: 'USD',
+        total: { currency: 'USD', value: '1' },
+      }),
+    ]);
+    expect(result.entries.map((entry) => entry.id)).toEqual([
+      'coupon',
+      'dividend',
+      'usd',
+    ]);
+    expect(result.buckets).toHaveLength(31);
+  });
+});
+
+function entry(
+  id: string,
+  type: string,
+  value: string,
+  currency: string,
+): BrokerageOperationDto {
+  return {
+    id,
+    occurredAt: '2026-01-15T12:00:00.000Z',
+    type,
+    category: 'income',
+    description: id,
+    figi: null,
+    instrumentUid: null,
+    ticker: id,
+    instrumentType: null,
+    logoName: null,
+    payment: { currency, value },
+    quantity: null,
+    price: null,
+    accruedInterest: null,
+    commission: null,
+  };
+}