From 6bb60b79412381e0f6ce21fca6e4b275c3195c34 Mon Sep 17 00:00:00 2001
From: lemuel <lemuelhelonmarquezrosas@gmail.com>
Date: Tue, 31 May 2022 13:26:21 -0500
Subject: [PATCH] =?UTF-8?q?modulo=20documentaci=C3=B3n?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/modulo/modulo.controller.ts | 32 ++++++++++++++++++++++++--------
 src/modulo/modulo.service.ts    |  4 ----
 2 files changed, 24 insertions(+), 12 deletions(-)

diff --git a/src/modulo/modulo.controller.ts b/src/modulo/modulo.controller.ts
index 7a473b6..6a385c7 100644
--- a/src/modulo/modulo.controller.ts
+++ b/src/modulo/modulo.controller.ts
@@ -8,7 +8,7 @@ import {
   UseGuards,
 } from '@nestjs/common';
 import { AuthGuard } from '@nestjs/passport';
-import { ApiTags } from '@nestjs/swagger';
+import { ApiBody, ApiOperation, ApiQuery, ApiTags } from '@nestjs/swagger';
 import { ModuloService } from './modulo.service';
 import { IdInstitucionDto } from '../dto/id-institucion.dto';
 import { ModuloCreateDto } from './dto/modulo-create.dto';
@@ -16,23 +16,30 @@ import { ModuloUpdateDto } from './dto/modulo-update.dto';
 // import { Serealize } from '../interceptors/serialize.interceptor';
 
 @Controller('modulo')
-// @ApiTags('modulo')
+@ApiTags('modulo')
 export class ModuloController {
   constructor(private moduloService: ModuloService) {}
 
   @Post()
   // @UseGuards(AuthGuard('jwt'))
+  @ApiOperation({ description: 'Endpoint que crea un módulo.' })
+  @ApiBody({
+    description: 'Ambas variables son obligatorias.',
+    examples: { ejemplo: { value: { id_institucion: 200, modulo: '' } } },
+  })
   create(@Body() body: ModuloCreateDto) {
     return this.moduloService.create(body.id_institucion, body.modulo);
   }
 
-  @Get()
-  // @UseGuards(AuthGuard('jwt'))
-  get() {
-    return this.moduloService.findAll();
-  }
-
   @Get('modulos')
+  @ApiOperation({
+    description: 'Endpoint que retorna todos los módulos de una institución.',
+  })
+  @ApiQuery({
+    description: 'Id de la institución.',
+    name: 'id_institucion',
+    type: 'string',
+  })
   modulos(@Query() query: IdInstitucionDto) {
     return this.moduloService.findAllByIdInstitucion(
       parseInt(query.id_institucion),
@@ -41,6 +48,15 @@ export class ModuloController {
 
   @Put()
   // @UseGuards(AuthGuard('jwt'))
+  @ApiOperation({
+    description: 'Endpoint que actualiza la información de un módulo.',
+  })
+  @ApiBody({
+    description: 'Todas las variables a excepción de id_modulo son opcionales.',
+    examples: {
+      ejemplo: { value: { id_modulo: 1, activo: true, modulo: '' } },
+    },
+  })
   update(@Body() body: ModuloUpdateDto) {
     return this.moduloService.update(body);
   }
diff --git a/src/modulo/modulo.service.ts b/src/modulo/modulo.service.ts
index 603719f..4a4482a 100644
--- a/src/modulo/modulo.service.ts
+++ b/src/modulo/modulo.service.ts
@@ -47,10 +47,6 @@ export class ModuloService {
       });
   }
 
-  findAll() {
-    return this.repository.find();
-  }
-
   findAllByIdInstitucion(id_institucion: number) {
     return this.institucionService
       .findById(id_institucion)