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,31 @@
+import { Controller, Get, Param, Req, UseGuards } from '@nestjs/common';
+import { ApiBearerAuth, ApiOkResponse, ApiTags } from '@nestjs/swagger';
+import type { Request } from 'express';
+import { ApiProblemResponses } from '../../../../common/decorators/api-safe-error-response.decorator';
+import { AccessPayload, JwtAuthGuard } from '../../../auth/auth.api';
+import { PortfolioDto } from './portfolio.dto';
+import { PortfolioService } from '../application/portfolio.service';
+
+@ApiTags('brokerage-accounts')
+@ApiProblemResponses()
+@ApiBearerAuth()
+@UseGuards(JwtAuthGuard)
+@Controller('brokerage-accounts')
+export class PortfolioController {
+  constructor(private readonly portfolio: PortfolioService) {}
+
+  @Get('all/portfolio')
+  @ApiOkResponse({ type: PortfolioDto })
+  all(@Req() request: Request & { user: AccessPayload }) {
+    return this.portfolio.getAll(request.user.sub);
+  }
+
+  @Get(':accountId/portfolio')
+  @ApiOkResponse({ type: PortfolioDto })
+  get(
+    @Req() request: Request & { user: AccessPayload },
+    @Param('accountId') accountId: string,
+  ) {
+    return this.portfolio.get(request.user.sub, accountId);
+  }
+}
@@ -0,0 +1,125 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+import { MoneyDto } from '../../../../common/money.dto';
+import { AccountReferenceDto } from '../../account-reference.dto';
+
+export class PortfolioPositionDto {
+  @ApiPropertyOptional({ type: String, nullable: true })
+  instrumentUid?: string | null;
+
+  @ApiPropertyOptional({ type: AccountReferenceDto })
+  account?: AccountReferenceDto;
+
+  @ApiProperty({ type: String, nullable: true })
+  declare figi: string | null;
+
+  @ApiProperty()
+  declare displayName: string;
+
+  @ApiProperty({
+    enum: [
+      'STOCK',
+      'BOND',
+      'FUND',
+      'CURRENCY',
+      'FUTURE',
+      'OPTION',
+      'STRUCTURED_NOTE',
+      'DIGITAL_FINANCIAL_ASSET',
+      'OTHER',
+    ],
+  })
+  declare type: string;
+
+  @ApiProperty()
+  declare quantity: string;
+
+  @ApiProperty({ type: MoneyDto, nullable: true })
+  declare currentValue: MoneyDto | null;
+
+  @ApiProperty({ type: MoneyDto, nullable: true })
+  declare averagePurchasePrice: MoneyDto | null;
+
+  @ApiProperty({ type: MoneyDto, nullable: true })
+  declare absoluteReturn: MoneyDto | null;
+
+  @ApiProperty({ type: String, nullable: true })
+  declare isin: string | null;
+
+  @ApiProperty({ type: String, nullable: true })
+  declare ticker: string | null;
+
+  @ApiProperty({ type: String, nullable: true })
+  declare logoName: string | null;
+}
+
+export class PortfolioStructureCategoryDto {
+  @ApiProperty({ enum: ['STOCK', 'BOND', 'OTHER', 'CASH'] })
+  declare type: string;
+
+  @ApiProperty({ description: 'Exact known value as a decimal string.' })
+  declare value: string;
+
+  @ApiProperty({
+    type: String,
+    nullable: true,
+    description:
+      'Percentage including cash, rounded to six decimal places. Null for incomplete, negative or zero-total compositions.',
+  })
+  declare sharePercent: string | null;
+}
+
+export class PortfolioStructureCurrencyDto {
+  @ApiProperty()
+  declare currency: string;
+
+  @ApiProperty()
+  declare totalValue: string;
+
+  @ApiProperty({
+    description: 'Any negative constituent, even if netted positive.',
+  })
+  declare hasNegativeValues: boolean;
+
+  @ApiProperty({ type: [PortfolioStructureCategoryDto] })
+  declare categories: PortfolioStructureCategoryDto[];
+}
+
+export class PortfolioUnvaluedCategoryDto {
+  @ApiProperty({ enum: ['STOCK', 'BOND', 'OTHER'] })
+  declare type: string;
+
+  @ApiProperty({ minimum: 1 })
+  declare count: number;
+}
+
+export class PortfolioStructureDto {
+  @ApiProperty({ type: [PortfolioStructureCurrencyDto] })
+  declare currencies: PortfolioStructureCurrencyDto[];
+
+  @ApiProperty({
+    type: [PortfolioUnvaluedCategoryDto],
+    description:
+      'Positions without current value and known valuation currency. Shares are unavailable across all currencies when nonempty.',
+  })
+  declare unvaluedCategories: PortfolioUnvaluedCategoryDto[];
+}
+
+export class PortfolioDto {
+  @ApiProperty({ format: 'date-time' })
+  declare lastSuccessfulAt: string;
+
+  @ApiProperty()
+  declare isStale: boolean;
+
+  @ApiProperty({ type: MoneyDto, isArray: true })
+  declare totalsByCurrency: MoneyDto[];
+
+  @ApiProperty({ type: PortfolioPositionDto, isArray: true })
+  declare positions: PortfolioPositionDto[];
+
+  @ApiProperty({ type: MoneyDto, isArray: true })
+  declare cashBalances: MoneyDto[];
+
+  @ApiProperty({ type: PortfolioStructureDto })
+  declare structure: PortfolioStructureDto;
+}