From 8d645d08dca2ba91b6aa71dcc542804acfdc84ff Mon Sep 17 00:00:00 2001
From: yoosangwook <swyoo@interplug.co.kr>
Date: Tue, 25 Mar 2025 13:33:36 +0900
Subject: [PATCH] =?UTF-8?q?refactor:=20API=20Router=20=EC=BD=94=EB=93=9C?=
 =?UTF-8?q?=20=EC=9D=BC=EB=B6=80=20=EB=A6=AC=ED=8C=A9=ED=86=A0=EB=A7=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 패턴에 어긋나는 응답 포맷 수정
- 주석 작성
---
 src/app/api/image/cad/route.js    |  1 -
 src/app/api/image/canvas/route.js | 19 ++++++++++++++++---
 2 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/src/app/api/image/cad/route.js b/src/app/api/image/cad/route.js
index 510feff2..b7d64a50 100644
--- a/src/app/api/image/cad/route.js
+++ b/src/app/api/image/cad/route.js
@@ -36,7 +36,6 @@ export async function POST(req) {
     const file = formData.get('file')
 
     const result = await uploadImage(file)
-    result.message = '이미지 업로드 성공'
 
     return NextResponse.json(result)
   } catch (error) {
diff --git a/src/app/api/image/canvas/route.js b/src/app/api/image/canvas/route.js
index f2e6df86..6a15e9bf 100644
--- a/src/app/api/image/canvas/route.js
+++ b/src/app/api/image/canvas/route.js
@@ -75,7 +75,10 @@ export async function POST(req) {
 
     const OriginalKey = `Drawing/${uuidv4()}`
 
-    // Upload original image
+    /**
+     * 원본 이미지를 우선 저장한다.
+     * 이미지 이름이 겹지는 현상을 방지하기 위해 uuid 를 사용한다.
+     */
     await s3.send(
       new PutObjectCommand({
         Bucket,
@@ -85,12 +88,19 @@ export async function POST(req) {
       }),
     )
 
-    // Process the image
+    /**
+     * 저장된 원본 이미지를 기준으로 크롭여부를 결정하여 크롭 이미지를 저장한다.
+     */
     const bufferImage = await cropImage(OriginalKey, width, height, left, top)
 
+    /**
+     * 크롭 이미지 이름을 결정한다.
+     */
     const Key = `Drawing/${objectNo}_${planNo}_${type}`
 
-    // Upload processed image
+    /**
+     * 크롭이 완료된 이미지를 업로드한다.
+     */
     await s3.send(
       new PutObjectCommand({
         Bucket,
@@ -100,6 +110,9 @@ export async function POST(req) {
       }),
     )
 
+    /**
+     * 크롭이미지 저장이 완료되면 원본 이미지를 삭제한다.
+     */
     await s3.send(
       new DeleteObjectCommand({
         Bucket,