feat!: persist T-Bank data and synchronize reads

Store account membership, portfolio, operations, forecasts and market sources in SQLite.
Coalesce scoped refreshes, fence connection revisions, preserve complete financial
snapshots and stabilize operation period state.

BREAKING CHANGE: investment reads return data/meta resource envelopes and locally
persisted snapshots; consumers must use the matching OpenAPI contract and explicit
synchronization endpoints.

src/modules/investments/operations/presentation/brokerage-operation.dto.ts

@@ -1,3 +1,7 @@
+import {
+  InvestmentReadQueryDto,
+  InvestmentResourceMetaDto,
+} from '../../investment-resource.dto';
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
 import { Transform, Type } from 'class-transformer';
 import {
@@ -30,7 +34,7 @@ export const operationCategories = [
 ] as const;
 export type OperationCategory = (typeof operationCategories)[number];
 
-export class BrokerageOperationsQueryDto {
+export class BrokerageOperationsQueryDto extends InvestmentReadQueryDto {
   @ApiPropertyOptional({
     format: 'uuid',
     description:
@@ -144,3 +148,10 @@ export class BrokerageOperationsPageDto {
   @ApiProperty({ format: 'date-time' })
   declare observedAt: string;
 }
+
+export class BrokerageOperationsResourceDto {
+  @ApiProperty({ type: BrokerageOperationsPageDto, nullable: true })
+  declare data: BrokerageOperationsPageDto | null;
+  @ApiProperty({ type: InvestmentResourceMetaDto })
+  declare meta: InvestmentResourceMetaDto;
+}

src/modules/investments/operations/presentation/brokerage-operations.controller.spec.ts

@@ -6,13 +6,13 @@ import { BrokerageOperationsController } from './brokerage-operations.controller
 
 describe('BrokerageOperationsController', () => {
   it('passes the authenticated user, account, and validated query to the service', async () => {
-    const operations = { get: jest.fn() };
+    const operations = { read: jest.fn() };
     const controller = new BrokerageOperationsController(operations as never);
     const query = { limit: 10 };
     const request = { user: { sub: 'user' } };
 
     await controller.get(request as never, 'account', query);
 
-    expect(operations.get).toHaveBeenCalledWith('user', 'account', query);
+    expect(operations.read).toHaveBeenCalledWith('user', 'account', query);
   });
 });

src/modules/investments/operations/presentation/brokerage-operations.controller.ts

@@ -4,7 +4,7 @@ import type { Request } from 'express';
 import { ApiProblemResponses } from '../../../../common/decorators/api-safe-error-response.decorator';
 import { AccessPayload, JwtAuthGuard } from '../../../auth/auth.api';
 import {
-  BrokerageOperationsPageDto,
+  BrokerageOperationsResourceDto,
   BrokerageOperationsQueryDto,
 } from './brokerage-operation.dto';
 import { BrokerageOperationsService } from '../application/brokerage-operations.service';
@@ -18,21 +18,21 @@ export class BrokerageOperationsController {
   constructor(private readonly operations: BrokerageOperationsService) {}
 
   @Get('all/operations')
-  @ApiOkResponse({ type: BrokerageOperationsPageDto })
+  @ApiOkResponse({ type: BrokerageOperationsResourceDto })
   all(
     @Req() request: Request & { user: AccessPayload },
     @Query() query: BrokerageOperationsQueryDto,
   ) {
-    return this.operations.getAll(request.user.sub, query);
+    return this.operations.read(request.user.sub, 'all', query);
   }
 
   @Get(':accountId/operations')
-  @ApiOkResponse({ type: BrokerageOperationsPageDto })
+  @ApiOkResponse({ type: BrokerageOperationsResourceDto })
   get(
     @Req() request: Request & { user: AccessPayload },
     @Param('accountId') accountId: string,
     @Query() query: BrokerageOperationsQueryDto,
   ) {
-    return this.operations.get(request.user.sub, accountId, query);
+    return this.operations.read(request.user.sub, accountId, query);
   }
 }