Spaces:
Sleeping
Sleeping
File size: 3,206 Bytes
f5957a1 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 | import {
Controller,
Get,
Post,
Delete,
Param,
UseGuards,
ParseIntPipe,
Request,
} from '@nestjs/common';
import {
ApiTags,
ApiBearerAuth,
ApiOperation,
ApiResponse,
ApiParam,
} from '@nestjs/swagger';
import { JwtAuthGuard } from '../../auth/guards/jwt-auth.guard';
import { RolesGuard } from '../../auth/guards/roles.guard';
import { Roles } from '../../../common/decorators/roles.decorator';
import { RoleName } from '../../auth/entities/role.entity';
import { BackupService } from '../services/backup.service';
@ApiTags('💾 Backups')
@ApiBearerAuth('JWT-auth')
@Controller('api/backups')
@UseGuards(JwtAuthGuard, RolesGuard)
export class BackupController {
constructor(private readonly backupService: BackupService) {}
@Get()
@Roles(RoleName.ADMIN, RoleName.IT_ADMIN)
@ApiOperation({
summary: 'List all backup records',
description:
'Retrieves all database backup records ordered by most recent. ' +
'Access roles: ADMIN, IT_ADMIN. Uses table: `backup_records`.',
})
@ApiResponse({ status: 200, description: 'Backup records returned' })
@ApiResponse({ status: 401, description: 'Unauthorized' })
@ApiResponse({ status: 403, description: 'Forbidden – insufficient role' })
async listBackups() {
return this.backupService.listBackups();
}
@Post()
@Roles(RoleName.IT_ADMIN)
@ApiOperation({
summary: 'Create a new database backup',
description:
'Triggers a mysqldump of the database and saves the output to backups/ directory. ' +
'Access roles: IT_ADMIN. Uses table: `backup_records`. Executes system command: `mysqldump`.',
})
@ApiResponse({ status: 201, description: 'Backup created (or failed with message)' })
@ApiResponse({ status: 401, description: 'Unauthorized' })
@ApiResponse({ status: 403, description: 'Forbidden – insufficient role' })
async createBackup(@Request() req) {
return this.backupService.createBackup(req.user.sub);
}
@Get(':id')
@Roles(RoleName.ADMIN, RoleName.IT_ADMIN)
@ApiOperation({
summary: 'Get backup details by ID',
description:
'Retrieves full details of a specific backup record including creator info. ' +
'Access roles: ADMIN, IT_ADMIN. Uses table: `backup_records`.',
})
@ApiParam({ name: 'id', type: Number, description: 'Backup record ID' })
@ApiResponse({ status: 200, description: 'Backup details returned' })
@ApiResponse({ status: 404, description: 'Backup not found' })
async getBackupDetails(@Param('id', ParseIntPipe) id: number) {
return this.backupService.getBackupDetails(id);
}
@Delete(':id')
@Roles(RoleName.IT_ADMIN)
@ApiOperation({
summary: 'Delete a backup record and file',
description:
'Removes the backup record from the database and deletes the physical file from disk. ' +
'Access roles: IT_ADMIN. Uses table: `backup_records`.',
})
@ApiParam({ name: 'id', type: Number, description: 'Backup record ID' })
@ApiResponse({ status: 200, description: 'Backup deleted' })
@ApiResponse({ status: 404, description: 'Backup not found' })
async deleteBackup(@Param('id', ParseIntPipe) id: number) {
return this.backupService.deleteBackup(id);
}
}
|