From Abandoned Prototype to AI-Powered Google Form Platform

개요

AI 기반 Google Forms 생성 플랫폼은 자연어 프롬프트, 문서, 이미지를 활용하여 Google Forms를 자동으로 생성하고 관리하는 웹 애플리케이션으로, GitHub Copilot의 도움을 받아 버려졌던 프로토타입을 완성하고 개선했습니다.

주요 내용

  • AI 기반 Google Forms 생성기는 자연어 설명을 바탕으로 Google Forms를 생성하는 초기 실험에서 시작되었으나, 사용자 경험 부족, 복잡한 백엔드 구조, 기능 누락 등의 문제로 중단되었습니다.
  • GitHub Finish-Up-A-Thon Challenge를 통해 프로젝트를 재정비하여 Google OAuth 인증, Google Gemini를 활용한 AI 기반 폼 생성, PDF/DOCX 문서 및 이미지 기반 폼 생성, 편집 가능한 질문, 폼 분석 대시보드, 사용자 폼 관리, 사전 구축된 폼 템플릿, 보안 토큰 처리, Docker 기반 배포 지원 등의 기능을 추가했습니다.
  • 주요 기술 스택으로는 프론트엔드에 React 18, Vite, TailwindCSS, Redux Toolkit, Framer Motion, Recharts + D3.js를 사용했으며, 백엔드에는 Node.js, Express.js, Google Gemini API, Google Forms API, Supabase, PostgreSQL, Zod validation, JWT Authentication을 활용했습니다.
  • 프로젝트 재정비 과정에서 기존의 약한 UI/UX, 폼 관리 시스템 부재, 분석 미지원, 제한적인 백엔드 구조, 최소한의 검증, 템플릿 미비, 배포 미설정 등의 문제를 개선하는 데 중점을 두었습니다.
  • GitHub Copilot은 백엔드 서비스 리팩토링, API 보일러플레이트 생성, Express 라우트 및 미들웨어 개선, 재사용 가능한 유틸리티 함수 작성, 유효성 검사 스키마 생성, React 컴포넌트 구조 개선, 비동기 로직 디버깅, 프론트엔드 반복 작업 가속화 등에 크게 기여했습니다.
  • 기술적 도전 과제로는 Google OAuth 토큰의 안전한 처리, Google Forms API의 안정적인 통합, AI 생성 질문 형식의 일관성 유지, 업로드된 문서의 정확한 파싱, 기능 확장 시 클린 아키텍처 유지, AI 생성 및 Google API 간 비동기 워크플로우 처리 등이 있었습니다.
  • 프로젝트를 완성하는 과정에서 잦은 기능 추가보다는 안정성, 사용성, 시스템 구조 개선에 집중하는 것이 중요하다는 교훈을 얻었으며, 화려한 AI 기능보다 안정성과 사용성이 더 큰 개선점임을 확인했습니다.

시사점

본 프로젝트는 버려진 프로토타입을 안정적이고 프로덕션 준비가 된 애플리케이션으로 성공적으로 전환시킨 사례를 보여주며, 기능 추가보다는 완성도와 사용자 경험 개선이 프로젝트 성공에 더 중요하다는 점을 시사합니다.

원문 읽기 →
원문을 불러오는 중...

댓글

GitHub Discussions