refactor(backend): 16단계 에러 처리 일관성 - schedules 라우트 try/catch 추가

모든 핸들러에 try/catch 블록 적용:
- GET /categories
- GET / (검색/월별/다가오는 일정)
- POST /sync-search
- GET /:id
- DELETE /:id

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

backend/src/routes/schedules/index.js

@@ -33,10 +33,15 @@ export default async function schedulesRoutes(fastify) {
       },
     },
   }, async (request, reply) => {
+    try {
       const [categories] = await db.query(
         'SELECT id, name, color, sort_order FROM schedule_categories ORDER BY sort_order ASC, id ASC'
       );
       return categories;
+    } catch (err) {
+      fastify.log.error(err);
+      return reply.code(500).send({ error: '카테고리 목록 조회 실패' });
+    }
   });
 
   /**
@@ -55,6 +60,7 @@ export default async function schedulesRoutes(fastify) {
       },
     },
   }, async (request, reply) => {
+    try {
       const { search, year, month, startDate, offset = 0, limit = 100 } = request.query;
 
       // 검색 모드
@@ -73,6 +79,10 @@ export default async function schedulesRoutes(fastify) {
       }
 
       return await getMonthlySchedules(db, parseInt(year), parseInt(month));
+    } catch (err) {
+      fastify.log.error(err);
+      return reply.code(500).send({ error: '일정 조회 실패' });
+    }
   });
 
   /**
@@ -97,8 +107,13 @@ export default async function schedulesRoutes(fastify) {
     },
     preHandler: [fastify.authenticate],
   }, async (request, reply) => {
+    try {
       const count = await syncAllSchedules(meilisearch, db);
       return { success: true, synced: count };
+    } catch (err) {
+      fastify.log.error(err);
+      return reply.code(500).send({ error: '동기화 실패' });
+    }
   });
 
   /**
@@ -116,6 +131,7 @@ export default async function schedulesRoutes(fastify) {
       },
     },
   }, async (request, reply) => {
+    try {
       const { id } = request.params;
 
       const [schedules] = await db.query(`
@@ -200,6 +216,10 @@ export default async function schedulesRoutes(fastify) {
       }
 
       return result;
+    } catch (err) {
+      fastify.log.error(err);
+      return reply.code(500).send({ error: '일정 상세 조회 실패' });
+    }
   });
 
   /**
@@ -225,6 +245,7 @@ export default async function schedulesRoutes(fastify) {
     },
     preHandler: [fastify.authenticate],
   }, async (request, reply) => {
+    try {
       const { id } = request.params;
 
       // 일정 존재 확인
@@ -246,11 +267,15 @@ export default async function schedulesRoutes(fastify) {
       try {
         const { deleteSchedule } = await import('../../services/meilisearch/index.js');
         await deleteSchedule(meilisearch, id);
-    } catch (err) {
-      fastify.log.error(`Meilisearch 삭제 오류: ${err.message}`);
+      } catch (meiliErr) {
+        fastify.log.error(`Meilisearch 삭제 오류: ${meiliErr.message}`);
       }
 
       return { success: true };
+    } catch (err) {
+      fastify.log.error(err);
+      return reply.code(500).send({ error: '일정 삭제 실패' });
+    }
   });
 }
 

docs/refactoring.md

@@ -163,6 +163,63 @@
 
 ---
 
+### 16단계: 에러 처리 일관성 ✅ 완료
+- [x] 모든 라우트에 try/catch 적용
+- [x] 에러 응답 패턴 통일
+
+**수정된 파일:**
+- `src/routes/schedules/index.js` - 모든 핸들러에 try/catch 추가
+
+---
+
+### 17단계: 중복 코드 제거 (멤버 조회) 🔄 진행 예정
+- [ ] 멤버 조회 로직을 서비스로 분리
+- [ ] 앨범 존재 확인 로직 통합
+
+**대상 파일:**
+- `src/services/member.js` - 신규 생성
+- `src/routes/members/index.js` - 서비스 호출로 변경
+
+---
+
+### 18단계: 이미지 처리 최적화 🔄 진행 예정
+- [ ] 이미지 메타데이터 중복 처리 제거
+- [ ] processImage에서 메타데이터 함께 반환
+
+**대상 파일:**
+- `src/services/image.js` - processImage 함수 개선
+
+---
+
+### 19단계: Redis 캐시 확대 🔄 진행 예정
+- [ ] 일정 상세 조회 캐싱
+- [ ] 멤버 목록 캐싱
+
+**대상 파일:**
+- `src/routes/schedules/index.js` - 캐시 적용
+- `src/routes/members/index.js` - 캐시 적용
+
+---
+
+### 20단계: 서비스 레이어 확대 🔄 진행 예정
+- [ ] schedules 라우트의 DB 쿼리를 서비스로 분리
+- [ ] 일관된 서비스 패턴 적용
+
+**대상 파일:**
+- `src/services/schedule.js` - 함수 추가
+- `src/routes/schedules/index.js` - 서비스 호출로 변경
+
+---
+
+### 21단계: 검색 페이징 최적화 🔄 진행 예정
+- [ ] Meilisearch 네이티브 페이징 사용
+- [ ] 클라이언트 slice 제거
+
+**대상 파일:**
+- `src/services/meilisearch/index.js` - offset/limit 파라미터 전달
+
+---
+
 ## 진행 상황
 
 | 단계 | 작업 | 상태 |
@@ -182,6 +239,12 @@
 | 13단계 | Swagger/OpenAPI 문서화 | ✅ 완료 |
 | 14단계 | 입력 검증 강화 (JSON Schema) | ✅ 완료 |
 | 15단계 | 스키마 파일 분리 | ✅ 완료 |
+| 16단계 | 에러 처리 일관성 | 🔄 진행 예정 |
+| 17단계 | 중복 코드 제거 (멤버 조회) | 🔄 진행 예정 |
+| 18단계 | 이미지 처리 최적화 | 🔄 진행 예정 |
+| 19단계 | Redis 캐시 확대 | 🔄 진행 예정 |
+| 20단계 | 서비스 레이어 확대 | 🔄 진행 예정 |
+| 21단계 | 검색 페이징 최적화 | 🔄 진행 예정 |
 
 ---