반응형
✔ 프로젝트 협업 트러블슈팅 문서
(1) Issue Summary
프로젝트 종료 단계에서 AWS RDS 접근권한이 일방적으로 차단되었고,
내가 직접 크롤링·정제·AI 요약·태그추출까지 수행하여 구축한
13,000개 카페 데이터 전체가 회수되지 않는 문제가 발생함.
팀장 및 일부 팀원은 연락두절 상태였으며,
중재 이후 선택된 두 개 테이블(cafes, tags)만 임의로 전달받았고,
핵심 테이블(매핑 및 AI 처리 데이터)은 팀 내부에서 임의 삭제된 상태라고 전달받음.
(2) Root Cause
- AWS 계정 구조 설계 오류
프로젝트 핵심 데이터가 특정 팀원 개인(AWS Owner 계정)에만 종속된 구조였음.
→ 데이터 통제권이 한 사람에게 집중됨. - 권한 관리 미흡
실질적 데이터 생산자는 나였지만, RDS 백업/관리 권한이 없어 직접 보관할 수 없었음. - 팀 내 커뮤니케이션 붕괴
종료 시점에 팀장 및 다른 팀원이 설명 없이 연락 두절되는 바람에 백업 요청 자체가 이루어지지 않음. - 프로젝트 종료 프로세스 부재
산출물 정리, 권한 공유, 데이터 백업 등의 절차가 팀 차원에서 정의되어 있지 않아 임의 삭제·선택적 제공 등 비정상적 처리 발생.
(3) Consequences
- 핵심 데이터 손실
- AI 요약 데이터
- AI 태그 매핑 데이터
- 리뷰 정제본
- 13,000개 카페의 확장 정보
일부는 전달받지 못함.
- 프로젝트 운영 불가
전체 데이터를 기반으로 동작하는 API 및 기능의 재현이 불가능한 상태로 종료됨. - 과금 및 리소스 낭비
해당 데이터 구축을 위해 내가- AWS 무료 크레딧 전부 사용
- 개인 비용 과금 발생
- PC를 일주일 이상 켜두며 크롤링을 수행했음에도 팀과 공유되지 않음.
(4) Troubleshooting / Attempted Solutions
- 강사님과 상위 선임에게 정식 요청하여 중재 시도
- 팀장과 재연락 → 제한된 테이블만 전달받음
- Full DB Dump 요청 → 부정확한 답변 및 테이블 삭제 사실 확인
- GitHub Organization을 Private 전환해 소스코드 유출 방지
- 남은 데이터를 기반으로 개인 프로젝트로 재구축 가능성 검토 중
(5) Lessons Learned
- 프로젝트 초기에 데이터·AWS 계정 구조를 분리해야 한다
- 공용 AWS 계정 사용 / 비용 분담 체계 필요
- 개인 계정 1명이 전체 통제하는 구조는 위험성 큼
- 권한은 역할이 아닌 ‘기여도 기준’으로 분배해야 한다
- 데이터를 생산한 사람 = 데이터 백업 권한은 반드시 필요
- 프로젝트 종료 단계의 프로토콜이 필수
- 전체 산출물 백업
- 접근권한 이관
- 버전 태깅
- 명확한 hand-off 문서 작성
- 문제 발생 시 즉시 중재 요청하는 것이 중요
- 개인적으로 해결하려고 하면 시간이 지나면서 상황 고착화됨
- 팀 프로젝트는 기술보다 ‘사람과 구조’가 더 중요하다
- 실제 손해는 코드가 아니라, 권한·신뢰·커뮤니케이션에서 발생함
(6) Action Items (개선 조치)
- 크롤링/AI 파이프라인 자동화 코드 백업 및 개선
- 개인 AWS 계정에서 데이터 파이프라인 재구축 준비
- 향후 모든 프로젝트에서
- 공용 계정 사용
- Role-based Access Control(RBAC)
- DB 자동 백업 정책 설정
- Notion에 Collaboration Risk Log 생성
- 포트폴리오 작성 시 이 이슈를
“협업 리스크 대응 경험”으로 정리하여 활용
✔ 이것을 기록하는 이유
이건 단순한 사건기록이 아니라고 생각함. 현업에서도 흔히 발생할 수도 있는 리스크를 실제로 경험했다는 증거이며,
문제를 감정적으로 대응하지 않고 체계적으로 해결한 점에서, 면접에서 팀 갈등 극복 질문에 대응하기 위해서이기도 하다.
다음 팀프로젝트에서는 절대 같은 형태의 리스크가 발생하지 않도록 할 것이다
'2025 > [풀스택]SeSAC 웹개발자 7기' 카테고리의 다른 글
| [cafeOn 팀프로젝트] 개인 AWS EC2 + RDS 구축 후 MySQL workbench로 over SSH 연결 트러블슈팅 (1) | 2025.12.09 |
|---|---|
| ✅ Redis란? (0) | 2025.10.26 |
| ✅ DB 인덱싱(Database Indexing) 이란? (0) | 2025.10.26 |
| ✅ (메일링서비스) Gmail SMTP 발송 한도? (0) | 2025.10.09 |
| ✅ DTO란? (0) | 2025.10.09 |