[플레이데이터 SK네트웍스 Family AI캠프 16기] 21주차 회고

기간: 2025.11.10 ~ 2025.11.14

 

21주차는 데이터베이스 구조 조정, FastAPI 연동, 그리고 중간발표 준비까지
프로젝트 전반의 핵심 영역을 점검하고 안정화하는 데 집중된 기간이었다.
프론트엔드 요구사항 변화에 따라 ERD 수정이 반복되었으며,
백엔드 API 연결 과정에서도 다양한 오류가 발생하여 이를 해결하는 데 상당한 시간이 소요되었다.
또한 중간발표 및 멘토링을 통해 프로젝트 방향성을 다시 점검하고 보완점을 도출할 수 있었다.

---

1. ERD 4차 수정 (11월 10일)

프론트엔드 화면 구조 변경으로 인해 ERD를 4차 수정하였다.
화면 설계 변경 → API 구조 수정 → DB 구조 수정의 흐름이 반복되면서
데이터베이스가 고정된 형태가 아니라 계속 조정되는 구조임을 다시 확인했다.

• 다수의 테이블에서 필드명 및 구조 재정비
• 관계 정의의 재점검
• API 요구사항에 맞춘 정규화 수준 조정

해당 작업은 프로젝트의 핵심 데이터 구조를 견고하게 하기 위한 필수 조치였다.

---

2. FastAPI–PostgreSQL 연동 및 오류 해결 (11월 11~14일)

주중 대부분은 FastAPI와 PostgreSQL DB 연동 문제를 해결하는 데 집중되었다.
Docker로 구축된 PostgreSQL에 FastAPI를 연결하는 과정에서
여러 구조적·기술적 오류가 발생했으며, 이를 하나씩 확인하며 해결해 나갔다.

발생한 주요 오류는 다음과 같다.

• ORM 모델 매핑 오류(user_id 타입 불일치)
• Foreign Key 충돌
• Swagger 테스트 시 ValidationError 발생
• DBeaver에서 데이터가 조회되지 않는 문제

이러한 오류를 모두 해결한 이후,
Swagger에서 POST 요청을 통해 입력한 데이터가 DBeaver에 정상 반영되는 것을 확인하였다.
서비스의 기본 구조가 안정적으로 작동하기 시작한 중요한 지점이었다.

---

3. 파이널 프로젝트 중간발표 준비 (11월 12일)

중간발표에서는 프로젝트 Medinote의 목표, 전체 구조, 기술 스택,
STT·임베딩·리랭크 모델 실험 결과 등을 정리하여 발표하였다.

• PPT 구성 및 발표 시나리오 수정
• 팀원들과 발표 분담 및 질의응답 준비
• 백엔드·AI·프론트엔드의 전체적인 연결 흐름 설명

중간발표는 프로젝트의 진행 방향이 적절한지 점검하는 중요한 기회였다.

---

4. 멘토링 4회차 (11월 13일)

멘토링에서는 데이터 구조 및 비정형 데이터 처리에 대한 심도 있는 피드백을 받았다.

핵심 조언은 다음과 같다.

• ERD는 정형 데이터 구조 중심 → 비정형 데이터는 의미 기반 매핑 구조 필요
• OCR 파싱 과정에서 단위 구분 오류 해결 필요
• STT 성능 비교 시 화자분리 옵션 적용 여부 실험 권장
• 임베딩 모델 비교 시 비용·시간 요소 고려 필요
• 전체 시스템 아키텍처 명확한 시각화 필요

멘토링을 통해 단순한 기능 구현을 넘어
설명 가능한 구조를 설계하는 방향으로 시야를 확장할 수 있었다.

---

5. FastAPI–DB 통합 테스트 마무리 (11월 14일)

금요일에는 CRUD 요청 기반 FastAPI–DB 통합 테스트를 완료했다.

• POST 요청 → DB 반영 확인
• 전체 기본 CRUD 기능 점검
• 테스트 환경에서의 주요 예외 처리 검토

이후 단계에서는 프론트엔드와의 API 연동 테스트가 예정되어 있었다.

---

6. 다음 주 계획

22주차는 프론트·API·DB의 실제 통합 테스트 주간으로 계획되었다.

• 프론트 기능 테스트 (네비게이션·카메라 등)
• Docker·EC2 환경 구축
• DB–프론트 연동 테스트
• 벡터 DB(OpenSearch) 구축
• DB–API–프론트 CRUD 통합 테스트
• Git 통합 및 가드레일·랭그래프 테스트
• AWS 환경 점검

서비스 전체 흐름을 실제 운영 환경 기준으로 검증하기 위한 단계가 시작될 예정이다.

---

총평

21주차는 데이터 구조 조정과 시스템 연동의 기반을 다지는 시기였다.
ERD 수정, FastAPI–PostgreSQL 연동, 중간발표, 멘토링 등
프로젝트 전반을 깊이 점검하며 이후 개발 방향을 확립하는 데 중요한 역할을 했다.
비록 반복적인 수정과 오류 해결이 필요했지만,
그 과정에서 프로젝트 구조의 완성도를 높일 수 있었다.