feat(server): endpoints swagger docs

2026-02-17 13:20:31 +00:00 · 2025-06-30 16:30:55 +02:00
parent 83e698acf3
commit 9f6e9e85a5
23 changed files with 1248 additions and 23 deletions
--- a/packages/server/src/modules/Organization/dtos/GetCurrentOrganizationResponse.dto.ts
+++ b/packages/server/src/modules/Organization/dtos/GetCurrentOrganizationResponse.dto.ts
@@ -0,0 +1,151 @@
+import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
+
+export class OrganizationMetadataResponseDto {
+  @ApiProperty({
+    description: 'Internal numeric ID of the metadata',
+    example: 1,
+  })
+  id: number;
+
+  @ApiProperty({
+    description: 'Tenant ID associated with the organization',
+    example: 101,
+  })
+  tenantId: number;
+
+  @ApiProperty({
+    description: 'Name of the organization',
+    example: 'Acme Inc.',
+  })
+  name: string;
+
+  @ApiPropertyOptional({
+    description: 'Industry of the organization',
+    example: 'Technology',
+  })
+  industry: string;
+
+  @ApiProperty({ description: 'Location of the organization', example: 'US' })
+  location: string;
+
+  @ApiProperty({
+    description: 'Base currency in ISO 4217 format',
+    example: 'USD',
+  })
+  baseCurrency: string;
+
+  @ApiProperty({
+    description: 'Language/locale of the organization',
+    example: 'en-US',
+  })
+  language: string;
+
+  @ApiProperty({
+    description: 'Timezone of the organization',
+    example: 'America/New_York',
+  })
+  timezone: string;
+
+  @ApiProperty({
+    description: 'Date format used by the organization',
+    example: 'MM/DD/YYYY',
+  })
+  dateFormat: string;
+
+  @ApiProperty({
+    description: 'Fiscal year of the organization',
+    example: 'January',
+  })
+  fiscalYear: string;
+
+  @ApiPropertyOptional({
+    description: 'Tax identification number',
+    example: '12-3456789',
+    nullable: true,
+  })
+  taxNumber: string;
+
+  @ApiPropertyOptional({
+    description: 'Primary brand color in hex format',
+    example: '#4285F4',
+    nullable: true,
+  })
+  primaryColor: string;
+
+  @ApiPropertyOptional({
+    description: 'Logo file key reference',
+    example: 'organizations/acme-logo-123456.png',
+    nullable: true,
+  })
+  logoKey: string;
+
+  @ApiPropertyOptional({
+    description: 'Organization address details',
+    example: '123 Main St, New York, NY',
+    nullable: true,
+  })
+  address: string;
+}
+
+export class GetCurrentOrganizationResponseDto {
+  @ApiProperty({
+    description: 'Internal numeric ID of the organization',
+    example: 1,
+  })
+  id: number;
+
+  @ApiProperty({
+    description: 'Unique string identifier for the organization',
+    example: 'org_123456',
+  })
+  organizationId: string;
+
+  @ApiProperty({
+    description: 'Date when the organization was initialized',
+    example: '2024-01-01T00:00:00.000Z',
+  })
+  initializedAt: Date;
+
+  @ApiProperty({
+    description: 'Date when the organization was seeded',
+    example: '2024-01-01T01:00:00.000Z',
+  })
+  seededAt: Date;
+
+  @ApiProperty({
+    description: 'Date when the organization was built',
+    example: '2024-01-01T02:00:00.000Z',
+  })
+  builtAt: Date;
+
+  @ApiPropertyOptional({
+    description: 'Database batch identifier, if any',
+    example: 'batch_001',
+    nullable: true,
+  })
+  databaseBatch: null | string;
+
+  @ApiProperty({
+    description: 'Organization metadata',
+    type: () => [OrganizationMetadataResponseDto],
+  })
+  metadata: OrganizationMetadataResponseDto;
+
+  @ApiProperty({
+    description: 'Whether the organization is ready',
+    example: true,
+  })
+  isReady: boolean;
+
+  @ApiProperty({
+    description: 'Whether a build process is currently running',
+    example: false,
+  })
+  isBuildRunning: boolean;
+
+  @ApiProperty({
+    description: 'Whether an upgrade process is currently running',
+    example: false,
+  })
+  isUpgradeRunning: boolean;
+}