resolve manual DTOs

apps/api/src/domain/analytics/AnalyticsController.ts

@@ -1,16 +1,22 @@
-import { Controller, Post, Body, Res, HttpStatus } from '@nestjs/common';
+import { Controller, Get, Post, Body, Res, HttpStatus } from '@nestjs/common';
+import { ApiTags, ApiOperation, ApiBody, ApiResponse } from '@nestjs/swagger';
 import type { Response } from 'express';
 import type { RecordPageViewInputDTO } from './dtos/RecordPageViewInputDTO';
 import type { RecordPageViewOutputDTO } from './dtos/RecordPageViewOutputDTO';
 import type { RecordEngagementInputDTO } from './dtos/RecordEngagementInputDTO';
 import type { RecordEngagementOutputDTO } from './dtos/RecordEngagementOutputDTO';
+import type { GetDashboardDataOutputDTO } from './dtos/GetDashboardDataOutputDTO';
+import type { GetAnalyticsMetricsOutputDTO } from './dtos/GetAnalyticsMetricsOutputDTO';
 import { AnalyticsService } from './AnalyticsService';
 
 type RecordPageViewInput = RecordPageViewInputDTO;
 type RecordPageViewOutput = RecordPageViewOutputDTO;
 type RecordEngagementInput = RecordEngagementInputDTO;
 type RecordEngagementOutput = RecordEngagementOutputDTO;
+type GetDashboardDataOutput = GetDashboardDataOutputDTO;
+type GetAnalyticsMetricsOutput = GetAnalyticsMetricsOutputDTO;
 
+@ApiTags('analytics')
 @Controller('analytics')
 export class AnalyticsController {
   constructor(
@@ -18,6 +24,9 @@ export class AnalyticsController {
   ) {}
 
   @Post('page-view')
+  @ApiOperation({ summary: 'Record a page view' })
+  @ApiBody({ type: RecordPageViewInputDTO })
+  @ApiResponse({ status: 201, description: 'Page view recorded', type: RecordPageViewOutputDTO })
   async recordPageView(
     @Body() input: RecordPageViewInput,
     @Res() res: Response,
@@ -27,6 +36,9 @@ export class AnalyticsController {
   }
 
   @Post('engagement')
+  @ApiOperation({ summary: 'Record an engagement event' })
+  @ApiBody({ type: RecordEngagementInputDTO })
+  @ApiResponse({ status: 201, description: 'Engagement recorded', type: RecordEngagementOutputDTO })
   async recordEngagement(
     @Body() input: RecordEngagementInput,
     @Res() res: Response,
@@ -34,4 +46,18 @@ export class AnalyticsController {
     const output: RecordEngagementOutput = await this.analyticsService.recordEngagement(input);
     res.status(HttpStatus.CREATED).json(output);
   }
+
+  @Get('dashboard')
+  @ApiOperation({ summary: 'Get analytics dashboard data' })
+  @ApiResponse({ status: 200, description: 'Dashboard data', type: GetDashboardDataOutputDTO })
+  async getDashboardData(): Promise<GetDashboardDataOutput> {
+    return await this.analyticsService.getDashboardData();
+  }
+
+  @Get('metrics')
+  @ApiOperation({ summary: 'Get analytics metrics' })
+  @ApiResponse({ status: 200, description: 'Analytics metrics', type: GetAnalyticsMetricsOutputDTO })
+  async getAnalyticsMetrics(): Promise<GetAnalyticsMetricsOutput> {
+    return await this.analyticsService.getAnalyticsMetrics();
+  }
 }

apps/api/src/domain/analytics/AnalyticsService.ts

@@ -3,6 +3,8 @@ import type { RecordPageViewInputDTO } from './dtos/RecordPageViewInputDTO';
 import type { RecordPageViewOutputDTO } from './dtos/RecordPageViewOutputDTO';
 import type { RecordEngagementInputDTO } from './dtos/RecordEngagementInputDTO';
 import type { RecordEngagementOutputDTO } from './dtos/RecordEngagementOutputDTO';
+import type { GetDashboardDataOutputDTO } from './dtos/GetDashboardDataOutputDTO';
+import type { GetAnalyticsMetricsOutputDTO } from './dtos/GetAnalyticsMetricsOutputDTO';
 import type { Logger } from '@core/shared/application';
 import { RecordPageViewUseCase } from './use-cases/RecordPageViewUseCase';
 import { RecordEngagementUseCase } from './use-cases/RecordEngagementUseCase';
@@ -11,6 +13,8 @@ type RecordPageViewInput = RecordPageViewInputDTO;
 type RecordPageViewOutput = RecordPageViewOutputDTO;
 type RecordEngagementInput = RecordEngagementInputDTO;
 type RecordEngagementOutput = RecordEngagementOutputDTO;
+type GetDashboardDataOutput = GetDashboardDataOutputDTO;
+type GetAnalyticsMetricsOutput = GetAnalyticsMetricsOutputDTO;
 
 const Logger_TOKEN = 'Logger_TOKEN';
 const RECORD_PAGE_VIEW_USE_CASE_TOKEN = 'RecordPageViewUseCase_TOKEN';
@@ -31,4 +35,24 @@ export class AnalyticsService {
   async recordEngagement(input: RecordEngagementInput): Promise<RecordEngagementOutput> {
     return await this.recordEngagementUseCase.execute(input);
   }
+
+  async getDashboardData(): Promise<GetDashboardDataOutput> {
+    // TODO: Implement actual dashboard data retrieval
+    return {
+      totalUsers: 0,
+      activeUsers: 0,
+      totalRaces: 0,
+      totalLeagues: 0,
+    };
+  }
+
+  async getAnalyticsMetrics(): Promise<GetAnalyticsMetricsOutput> {
+    // TODO: Implement actual analytics metrics retrieval
+    return {
+      pageViews: 0,
+      uniqueVisitors: 0,
+      averageSessionDuration: 0,
+      bounceRate: 0,
+    };
+  }
 }

apps/api/src/domain/analytics/dtos/GetAnalyticsMetricsOutputDTO.ts

@@ -0,0 +1,20 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsNumber } from 'class-validator';
+
+export class GetAnalyticsMetricsOutputDTO {
+  @ApiProperty()
+  @IsNumber()
+  pageViews!: number;
+
+  @ApiProperty()
+  @IsNumber()
+  uniqueVisitors!: number;
+
+  @ApiProperty()
+  @IsNumber()
+  averageSessionDuration!: number;
+
+  @ApiProperty()
+  @IsNumber()
+  bounceRate!: number;
+}

apps/api/src/domain/analytics/dtos/GetDashboardDataOutputDTO.ts

@@ -0,0 +1,20 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsNumber } from 'class-validator';
+
+export class GetDashboardDataOutputDTO {
+  @ApiProperty()
+  @IsNumber()
+  totalUsers!: number;
+
+  @ApiProperty()
+  @IsNumber()
+  activeUsers!: number;
+
+  @ApiProperty()
+  @IsNumber()
+  totalRaces!: number;
+
+  @ApiProperty()
+  @IsNumber()
+  totalLeagues!: number;
+}