Merge pull request #151 from boostcampwm-2024/feature/be/#49-#50-add-…

…channel

[BE][Feat] #50 : 경로방 별 사용자 추가 post api

backend/src/controllers/channelController.js

@@ -1,4 +1,4 @@
-import { createChannelService } from '../services/channelService.js';
+import { addGuestService, createChannelService } from '../services/channelService.js';
 
 export const createChannelController = async (req, res) => {
   try {
@@ -19,3 +19,30 @@ export const createChannelController = async (req, res) => {
     });
   }
 };
+
+export const addGuestController = async (req, res) => {
+  try {
+    const { channelId } = req.params;
+    const { guests } = req.body;
+
+    const updatedChannel = await addGuestService(channelId, guests);
+
+    if (!updatedChannel) {
+      return res.status(404).json({
+        success: false,
+        message: 'Channel not found',
+      });
+    }
+
+    return res.status(200).json({
+      success: true,
+      message: 'Guests added successfully',
+    });
+  } catch (err) {
+    console.error(err);
+    return res.status(500).json({
+      success: false,
+      message: 'Server error',
+    });
+  }
+};

backend/src/repositories/channelRepository.js

@@ -13,3 +13,19 @@ export const createChannelInDB = async (name, host_id) => {
 
   return result.rows[0];
 };
+
+export const getChannelById = async channelId => {
+  const query = `
+    SELECT * 
+    FROM "main"."channel" 
+    WHERE id = $1;
+  `;
+  const values = [channelId];
+  const result = await pool.query(query, values);
+
+  if (result.rows.length === 0) {
+    return null;
+  }
+
+  return result.rows[0];
+};

backend/src/repositories/guestRepository.js

@@ -1,7 +1,7 @@
 import { v4 as uuidv4 } from 'uuid';
 import { pool } from '../db/db.js';
 
-export const addGuestInDB = async (
+export const addGuestToChannel = async (
   channel_id,
   name,
   start_location,

backend/src/routes/channelRouter.js

@@ -1,6 +1,6 @@
 import express from 'express';
 import { body } from 'express-validator';
-import { createChannelController } from '../controllers/channelController.js';
+import { addGuestController, createChannelController } from '../controllers/channelController.js';
 import { validationMiddleware } from '../middleware/validationMiddleware.js';
 
 export const channelRouter = express.Router();
@@ -40,3 +40,96 @@ channelRouter.post(
   validationMiddleware,
   createChannelController,
 );
+
+/**
+ * @swagger
+ * /channels/{channelId}/guests:
+ *   post:
+ *     summary: 'Add guests to an existing channel'
+ *     description: 'Add new guests to an existing channel by providing guest information.'
+ *     operationId: 'addGuest'
+ *     parameters:
+ *       - in: path
+ *         name: channelId
+ *         required: true
+ *         description: 'ID of the channel to which guests are being added'
+ *         schema:
+ *           type: string
+ *           example: '123e4567-e89b-12d3-a456-426614174000'
+ *     requestBody:
+ *       description: 'Guest data to be added to the channel'
+ *       content:
+ *         application/json:
+ *           schema:
+ *             type: object
+ *             properties:
+ *               guests:
+ *                 type: array
+ *                 items:
+ *                   type: object
+ *                   properties:
+ *                     name:
+ *                       type: string
+ *                       description: 'Guest\'s name'
+ *                     start_location:
+ *                       type: object
+ *                       properties:
+ *                         lat:
+ *                           type: number
+ *                           description: 'Latitude of the start location'
+ *                         lng:
+ *                           type: number
+ *                           description: 'Longitude of the start location'
+ *                     end_location:
+ *                       type: object
+ *                       properties:
+ *                         lat:
+ *                           type: number
+ *                           description: 'Latitude of the end location'
+ *                         lng:
+ *                           type: number
+ *                           description: 'Longitude of the end location'
+ *                     path:
+ *                       type: array
+ *                       items:
+ *                         type: object
+ *                         properties:
+ *                           lat:
+ *                             type: number
+ *                             description: 'Latitude of a waypoint'
+ *                           lng:
+ *                             type: number
+ *                             description: 'Longitude of a waypoint'
+ *                     marker_style:
+ *                       type: object
+ *                       properties:
+ *                         color:
+ *                           type: string
+ *                           description: 'Color for the guest marker'
+ *     responses:
+ *       200:
+ *         description: 'Guests added successfully'
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 success:
+ *                   type: boolean
+ *                   example: true
+ *                 message:
+ *                   type: string
+ *                   example: 'Guests added successfully'
+ *       400:
+ *         description: 'Invalid input data'
+ *       404:
+ *         description: 'Channel not found'
+ *       500:
+ *         description: 'Server error'
+ */
+channelRouter.post(
+  '/:channelId/guests',
+  [body('guests').isArray().withMessage('Guests must be an array')],
+  validationMiddleware,
+  addGuestController,
+);

backend/src/services/channelService.js

@@ -1,14 +1,12 @@
-import { createChannelInDB } from '../repositories/channelRepository.js';
-import { addGuestInDB } from '../repositories/guestRepository.js';
+import { createChannelInDB, getChannelById } from '../repositories/channelRepository.js';
+import { addGuestToChannel } from '../repositories/guestRepository.js';
 
 export const createChannelService = async (name, host_id, guests) => {
-  // 채널 생성
   const channel = await createChannelInDB(name, host_id);
 
-  // 게스트 추가
   const guestPromises = guests.map(guest => {
     const { name, start_location, end_location, path, marker_style } = guest;
-    return addGuestInDB(
+    return addGuestToChannel(
       channel.id,
       name,
       start_location,
@@ -23,3 +21,25 @@ export const createChannelService = async (name, host_id, guests) => {
 
   return channel;
 };
+
+export const addGuestService = async (channelId, guests) => {
+  const channel = await getChannelById(channelId);
+  if (!channel) return null;
+
+  const guestPromises = guests.map(guest => {
+    const { name, start_location, end_location, path, marker_style } = guest;
+    return addGuestToChannel(
+      channelId,
+      name,
+      start_location,
+      end_location,
+      path,
+      marker_style,
+      channel.host_id,
+    );
+  });
+
+  await Promise.all(guestPromises);
+
+  return channel;
+};

backend/swaggerConfig.js

@@ -163,6 +163,92 @@ const swaggerDefinition = {
           },
         },
       },
+      // 게스트 추가 요청 스키마
+      AddGuestRequest: {
+        type: 'object',
+        properties: {
+          channel_id: {
+            type: 'string',
+            description: '채널 ID (UUID 형태)',
+          },
+          guest: {
+            type: 'object',
+            properties: {
+              name: {
+                type: 'string',
+                description: '게스트의 이름',
+              },
+              start_location: {
+                type: 'object',
+                properties: {
+                  lat: {
+                    type: 'number',
+                    description: '출발지 마커의 위도',
+                  },
+                  lng: {
+                    type: 'number',
+                    description: '출발지 마커의 경도',
+                  },
+                },
+              },
+              end_location: {
+                type: 'object',
+                properties: {
+                  lat: {
+                    type: 'number',
+                    description: '도착지 마커의 위도',
+                  },
+                  lng: {
+                    type: 'number',
+                    description: '도착지 마커의 경도',
+                  },
+                },
+              },
+              path: {
+                type: 'array',
+                items: {
+                  type: 'object',
+                  properties: {
+                    lat: {
+                      type: 'number',
+                      description: '경로 n번째 지점의 위도',
+                    },
+                    lng: {
+                      type: 'number',
+                      description: '경로 n번째 지점의 경도',
+                    },
+                  },
+                },
+                description: '게스트의 경로 (위도, 경도)를 담은 배열',
+              },
+              marker_style: {
+                type: 'object',
+                properties: {
+                  color: {
+                    type: 'string',
+                    description: '게스트를 구분하는 색상 스타일',
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+
+      // 게스트 추가 응답 스키마
+      AddGuestResponse: {
+        type: 'object',
+        properties: {
+          success: {
+            type: 'boolean',
+            description: '요청이 성공적으로 처리되었는지 여부',
+          },
+          message: {
+            type: 'string',
+            description: '응답 메시지',
+          },
+        },
+      },
     },
   },
   paths: {
@@ -241,6 +327,45 @@ const swaggerDefinition = {
         },
       },
     },
+    '/channel/guests': {
+      post: {
+        summary: '채널에 게스트 추가 API',
+        description: '주어진 채널에 새로운 게스트를 추가합니다.',
+        operationId: 'addGuest',
+        requestBody: {
+          description: '채널에 게스트를 추가하기 위한 데이터',
+          content: {
+            'application/json': {
+              schema: {
+                $ref: '#/components/schemas/AddGuestRequest',
+              },
+            },
+          },
+          required: true,
+        },
+        responses: {
+          200: {
+            description: '게스트 추가 성공',
+            content: {
+              'application/json': {
+                schema: {
+                  $ref: '#/components/schemas/AddGuestResponse',
+                },
+              },
+            },
+          },
+          400: {
+            description: '잘못된 요청, 채널 ID나 게스트 정보가 잘못됨',
+          },
+          404: {
+            description: '채널을 찾을 수 없음',
+          },
+          500: {
+            description: '서버 에러',
+          },
+        },
+      },
+    },
   },
 };