1. 프로젝트 업데이트 배경 ℹ️
이전에 개발했던 YouTube 분석 도구는 개인적 사용 목적으로 만들어졌으며, 내 API 키를 직접 입력해서 사용하는 방식이었습니다. 다른 사람이 쓰려면 제 API 키를 공유해주거나, 코드에 하드코딩해야 하죠.
하지만 그러면 너무 비효율적이고 사용자가 많아질 경우 일 사용한도가 금방 초과되죠.
그래서 이 툴을 쓰고싶다는 요청이 많아서, 다른 사용자도 개별 API를 발급받아 자유롭게 쓸 수있는 구조 로 전환을 결정하게 되었습니다.
전환의 주요 동기 ✅
다수의 사용자가 자신의 API 키로 독립적으로 사용 가능한 구조 필요
API 키의 안전한 저장 및 관리 방식 구현
일일 API 할당량 관리의 개인화
2. AI 협업을 통한 설계 및 구현 과정 🤖
2-1. 서비스 아키텍처 설계 및 구현 🏗️
실제 서비스 전환을 위해 클로드와 먼저 웹앱 구조를 변경했습니다.
코드를 주지 말라고 했는데도 마음대로 코드를 주네요..
수정 제안내용을 받고 이 구조로 수정하면 배포시 예상 이슈는 없는지 점검했습니다.
이렇게 몇번 티키타카를 하고 난 후, 챗GPT O1과 웹앱 배포시 예상 이슈와 대응방안에 대해 정리해 봤습니다.
먼저 첫번째 답변
이 답변에 대해 저도 피드백을 줍니다.
그렇게 최종적으로 아래 구조로 반영키로 했습니다.
데이터 저장 구조 단순화
개별 스프레드시트 대신 마스터 스프레드시트만 사용
불필요한 복잡성 제거 및 관리 효율성 증대
API 사용량 추적을 위한 통합 로깅 구현
API 키 관리 최적화
브라우저
localStorage를 활용한 API 키 저장한 번 입력 후 재사용 가능한 구조
보안을 위한 API 키 마스킹 처리 구현
리소스 최적화
6시간 단위 캐싱으로 API 호출 최소화
캐시 유효 기간은 데이터 신선도와 API 호출량 밸런스 고려
2-2. 사용자 지원 및 운영 준비 🙋♂️
서비스 공개를 위한 사용자 지원 체계를 구축했습니다
사용자 가이드 제작
상세 PDF 매뉴얼 작성
향후 영상 가이드 제작 계획
API 키 발급 프로세스 상세 설명
Q&A 및 홍보채널
웹앱에 Q&a 대응 및 홍보를 위한 개인 채널 삽입
운영 관점의 도전과제
다수 사용자 동시 접속 시나리오
API 할당량 초과 상황 대응
사용자 피드백 수집 및 반영 방안
2-5. 보안 강화 🔒
API 키 마스킹 처리
localStorage를 통한 클라이언트 측 안전한 저장
3. 개발 과정에서의 주요 도전과제 ⚠️
3-1. API 키 관련 이슈
문제점:
사용자들의 API 키 발급 과정 어려움
API 키 보안 관련 우려
리퍼러 설정 미숙으로 인한 오류
해결방안:
상세한 API 키 발급 가이드 작성
Google Cloud Console에서 리퍼러 설정 방법 상세 안내
API 키 보안 관련 사용자 불안 해소를 위한 설명 추가
3-2. 다중 계정 접근 문제
이슈 상황:
동일 PC에서 여러 구글 계정 로그인 시 접근 차단
예상치 못한 권한 오류 발생
대응 방안:
단일 계정 사용 권장 안내
다중 계정 사용 시 주의사항 가이드 제공
오류 발생 시 문제해결 가이드 제공
4. 향후 개선 계획 🌟
4.1 단기 개선사항
API 키 발급 가이드 영상 제작
자주 묻는 질문(FAQ) 섹션 추가
오류 발생 시 자동 문제해결 가이드 제공
4.2 장기 개선계획
사용자 피드백 기반 기능 개선
5. 결론 🎉
개인용 도구를 공개 서비스로 전환하는 과정은 예상보다 많은 고려사항이 있더라구요.
"나만의 서비스"와 "공용 서비스"는 근본적으로 다르다
개인용은 기능 구현이 전부
공용은 사용자 경험, 보안, 안정성 모두 중요
운영 관점의 고려사항이 훨씬 더 많음
시작은 작게, 성장은 점진적으로
현재는 소규모 사용자 기준으로 설계
실제 사용량과 피드백 기반으로 개선
"일단 만들고, 닥치면 그때 수정" 접근
사용자 지원의 중요성
개발자에겐 쉬운 것이 사용자에겐 어려울 수 있음
상세한 가이드와 지원 자료 필수
지속적인 사용자 피드백 수집 필요
이러한 경험을 통해, 서비스 개발에서 가장 중요한 것은 기술적 완성도가 아닌 실제 사용자들의 경험과 니즈임을 깨달았습니다. 감사합니다! 🙏
P.S. : 사실 이제 막 배포하는 단계라 어떤 문제가 발생할지 잘 모르겠지만, 닥치면서 하나하나 수정해보겠습니다. 혹시 해당 프로그램 써보고 싶으신 분들은 아래 구글폼즈로 신청주시면, URL과 가이드 송부 드릴게요!
https://docs.google.com/forms/d/e/1FAIpQLScTGkrQSImKoLsMrdmpCjH80Ww-4DlMBHT8EZhhbc7m6slQhA/viewform