251218:1701 On going update to 1.7.0: Documnet Number rebuild

backend/src/modules/document-numbering/controllers/document-numbering-admin.controller.ts

@@ -0,0 +1,100 @@
+import {
+  Controller,
+  Post,
+  Get,
+  Delete,
+  Body,
+  Param,
+  Query,
+  UseGuards,
+  ParseIntPipe,
+} from '@nestjs/common';
+import { DocumentNumberingService } from '../services/document-numbering.service';
+import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
+import { JwtAuthGuard } from '../../../common/guards/jwt-auth.guard';
+import { RbacGuard } from '../../../common/guards/rbac.guard';
+import { RequirePermission } from '../../../common/decorators/require-permission.decorator';
+
+@ApiTags('Admin / Document Numbering')
+@ApiBearerAuth()
+@Controller('admin/document-numbering')
+@UseGuards(JwtAuthGuard, RbacGuard)
+export class DocumentNumberingAdminController {
+  constructor(private readonly service: DocumentNumberingService) {}
+
+  // ----------------------------------------------------------
+  // Template Management
+  // ----------------------------------------------------------
+
+  @Get('templates')
+  @ApiOperation({ summary: 'Get all document numbering templates' })
+  @RequirePermission('system.manage_settings')
+  async getTemplates(@Query('projectId') projectId?: number) {
+    if (projectId) {
+      return this.service.getTemplatesByProject(projectId);
+    }
+    return this.service.getTemplates();
+  }
+
+  @Post('templates')
+  @ApiOperation({ summary: 'Create or Update a numbering template' })
+  @RequirePermission('system.manage_settings')
+  async saveTemplate(@Body() dto: any) {
+    return this.service.saveTemplate(dto);
+  }
+
+  @Delete('templates/:id')
+  @ApiOperation({ summary: 'Delete a numbering template' })
+  @RequirePermission('system.manage_settings')
+  async deleteTemplate(@Param('id', ParseIntPipe) id: number) {
+    await this.service.deleteTemplate(id);
+    return { success: true };
+  }
+
+  // ----------------------------------------------------------
+  // Metrics & Logs
+  // ----------------------------------------------------------
+
+  @Get('metrics')
+  @ApiOperation({ summary: 'Get numbering usage metrics and logs' })
+  @RequirePermission('system.view_logs')
+  async getMetrics() {
+    const audit = await this.service.getAuditLogs(50);
+    const errors = await this.service.getErrorLogs(50);
+    return { audit, errors };
+  }
+
+  // ----------------------------------------------------------
+  // Admin Operations
+  // ----------------------------------------------------------
+
+  @Post('manual-override')
+  @ApiOperation({
+    summary: 'Manually override or set a document number counter',
+  })
+  @RequirePermission('system.manage_settings')
+  async manualOverride(@Body() dto: any) {
+    return this.service.manualOverride(dto);
+  }
+
+  @Post('void-and-replace')
+  @ApiOperation({ summary: 'Void a number and replace with a new generation' })
+  @RequirePermission('system.manage_settings')
+  async voidAndReplace(@Body() dto: any) {
+    return this.service.voidAndReplace(dto);
+  }
+
+  @Post('cancel')
+  @ApiOperation({ summary: 'Cancel/Skip a specific document number' })
+  @RequirePermission('system.manage_settings')
+  async cancelNumber(@Body() dto: any) {
+    return this.service.cancelNumber(dto);
+  }
+
+  @Post('bulk-import')
+  @ApiOperation({ summary: 'Bulk import/set document number counters' })
+  @RequirePermission('system.manage_settings')
+  async bulkImport(@Body() items: any[]) {
+    return this.service.bulkImport(items);
+  }
+}

backend/src/modules/document-numbering/controllers/document-numbering.controller.ts

@@ -0,0 +1,103 @@
+import {
+  Controller,
+  Get,
+  Post,
+  Patch,
+  Param,
+  Body,
+  UseGuards,
+  Query,
+  ParseIntPipe,
+} from '@nestjs/common';
+import {
+  ApiTags,
+  ApiOperation,
+  ApiResponse,
+  ApiBearerAuth,
+  ApiQuery,
+} from '@nestjs/swagger';
+import { JwtAuthGuard } from '../../../common/guards/jwt-auth.guard';
+import { RbacGuard } from '../../../common/guards/rbac.guard';
+import { RequirePermission } from '../../../common/decorators/require-permission.decorator';
+import { DocumentNumberingService } from '../services/document-numbering.service';
+import { PreviewNumberDto } from '../dto/preview-number.dto';
+
+@ApiTags('Document Numbering')
+@ApiBearerAuth()
+@Controller('document-numbering')
+@UseGuards(JwtAuthGuard, RbacGuard)
+export class DocumentNumberingController {
+  constructor(private readonly numberingService: DocumentNumberingService) {}
+
+  // ----------------------------------------------------------
+  // Logs
+  // ----------------------------------------------------------
+
+  @Get('logs/audit')
+  @ApiOperation({ summary: 'Get document generation audit logs' })
+  @ApiResponse({ status: 200, description: 'List of audit logs' })
+  @ApiQuery({ name: 'limit', required: false, type: Number })
+  @RequirePermission('system.view_logs')
+  getAuditLogs(@Query('limit') limit?: number) {
+    return this.numberingService.getAuditLogs(limit ? Number(limit) : 100);
+  }
+
+  @Get('logs/errors')
+  @ApiOperation({ summary: 'Get document generation error logs' })
+  @ApiResponse({ status: 200, description: 'List of error logs' })
+  @ApiQuery({ name: 'limit', required: false, type: Number })
+  @RequirePermission('system.view_logs')
+  getErrorLogs(@Query('limit') limit?: number) {
+    return this.numberingService.getErrorLogs(limit ? Number(limit) : 100);
+  }
+
+  // ----------------------------------------------------------
+  // Sequences / Counters
+  // ----------------------------------------------------------
+
+  @Get('sequences')
+  @ApiOperation({ summary: 'Get all number sequences/counters' })
+  @ApiResponse({ status: 200, description: 'List of counter sequences' })
+  @ApiQuery({ name: 'projectId', required: false, type: Number })
+  @RequirePermission('correspondence.read')
+  getSequences(@Query('projectId') projectId?: number) {
+    return this.numberingService.getSequences(
+      projectId ? Number(projectId) : undefined
+    );
+  }
+
+  @Patch('counters/:id')
+  @ApiOperation({ summary: 'Update counter sequence value (Admin only)' })
+  @RequirePermission('system.manage_settings')
+  async updateCounter(
+    @Param('id', ParseIntPipe) id: number,
+    @Body('sequence') sequence: number
+  ) {
+    return this.numberingService.setCounterValue(id, sequence);
+  }
+
+  // ----------------------------------------------------------
+  // Preview / Test
+  // ----------------------------------------------------------
+
+  @Post('preview')
+  @ApiOperation({ summary: 'Preview what a document number would look like' })
+  @ApiResponse({
+    status: 200,
+    description: 'Preview result without incrementing counter',
+  })
+  @RequirePermission('correspondence.read')
+  async previewNumber(@Body() dto: PreviewNumberDto) {
+    return this.numberingService.previewNumber({
+      projectId: dto.projectId,
+      originatorOrganizationId: dto.originatorOrganizationId,
+      typeId: dto.correspondenceTypeId,
+      subTypeId: dto.subTypeId,
+      rfaTypeId: dto.rfaTypeId,
+      disciplineId: dto.disciplineId,
+      recipientOrganizationId: dto.recipientOrganizationId,
+      year: dto.year,
+      customTokens: dto.customTokens,
+    });
+  }
+}