Claude Code와 Codex로 단체여행 의견 나눔&결정 웹앱 만들기
2026.10.13
Claude Code와 Codex로 단체 의견 수집 웹앱 만들기
한 단체의 구성원들이 여러 항목을 차례로 정하고, 운영진이 의견을 관리할 수 있는 웹앱을 만들고 있습니다. 기획부터 화면, 테스트까지 AI 코딩 도구와 함께 진행했고, 지금은 실제 데이터베이스 연결을 확인하는 단계입니다.
웹앱 개발 초기 단계: 스펙 설정
처음에는 만들고 싶은 서비스의 윤곽만 있었습니다. 그래서 먼저 누가 사용할지, 어떤 결정을 한곳에서 모을지 정리하고, 요구사항을 단계별로 나눴습니다.
사용자는 이름을 입력해 입장하고, 정해진 순서에 따라 각 항목에 투표합니다. 진행 중인 투표가 홈에서 먼저 보이도록 구성하고, 다른 사람의 응답 현황은 운영진만 볼 수 있게 했습니다. 참고 이미지의 색감과 카드 배치를 살펴 모바일과 데스크톱 화면도 설계했습니다.
작업 도구가 제안한 스택은 Next.js 14, TypeScript, Supabase입니다. 이 선택은 처음부터 확정된 기술 요구사항이 아니라 기본 제안으로 남겨 두었습니다.
완료 기준 설정 및 검증 과정
스펙 기반 작업 도구의 흐름에 따라 요구사항을 정리하고, 작업을 나누고, 완료 기준을 승인한 다음 구현과 검증을 진행했습니다.
프로젝트 기록에는 13개 작업과 11개 완료 기준이 있습니다. 타입 검사와 빌드, Node 테스트 80개, UI 테스트 65개, 모바일·데스크톱 주요 흐름이 통과했습니다. 스크린샷 8장도 확인해 시각 판정을 마쳤습니다.
다만 이 결과는 메모리 저장소를 사용한 검증입니다. 테스트가 통과했다고 실제 데이터베이스 연결까지 확인된 것은 아니었습니다.
데이터베이스 연결 문제 해결
Supabase에 테이블을 만들고 앱을 연결하자 이름 입력이 실패했습니다. 원인을 찾기 위해 먼저 테이블의 열 이름과 자료형을 읽기 전용으로 조회했습니다.
기존 테이블은 새 스키마와 달랐습니다. CREATE TABLE IF NOT EXISTS는 이미 있는 테이블을 그대로 두기 때문에, 처음 실행한 SQL만으로는 필요한 열이 추가되지 않았습니다. 기존 데이터를 지우지 않는 방식으로 누락된 열을 추가하는 마이그레이션을 준비했고, 실행 결과는 성공으로 확인했습니다. 모든 주요 테이블의 행 수준 보안도 켜져 있는 것을 조회 결과로 확인했습니다.
그 뒤에도 입장은 실패했습니다. 추가 조사에서 기존 categories 테이블에 앱이 쓰지 않는 필수 열 stage와 title이 남아 있다는 점을 발견했습니다. 앱의 시드 코드는 이 값을 보내지 않아 데이터베이스가 삽입을 거부하고 있었습니다.
이를 해결하기 위해 항목 종류에 따라 단계와 제목을 함께 저장하도록 코드를 수정했고, 저장소 테스트 17개와 타입 검사를 통과했습니다. 그러나 수정된 코드가 실제 Supabase에 저장되는지는 아직 검증하지 못했습니다. 새 데이터베이스를 위한 추가 마이그레이션도 남아 있으며, 서버를 재시작한 뒤 입장·투표·운영진 로그인을 확인해야 합니다.
프로젝트 진행 중 배운 점
자동 테스트와 실제 서비스 연결은 서로 다른 검증이었습니다. 메모리 저장소에서는 통과하던 코드가 기존 데이터베이스의 필수 열 때문에 실패할 수 있었습니다.
또 데이터베이스를 수정할 때는 테이블을 지우기보다 현재 구조를 먼저 조회하고, 필요한 변경만 추가하는 편이 안전했습니다. 화면에 성공 메시지가 보이는지와 앱에서 실제 데이터가 저장되는지도 따로 확인해야 했습니다.
AI 도구에는 현재 상태와 제한 조건을 구체적으로 전달하는 것이 도움이 됐습니다. 예를 들어 “기존 데이터를 지우지 말 것”, “비밀 값을 출력하지 말 것”, “먼저 읽기 전용으로 확인할 것”처럼 작업 범위를 분명히 했습니다. SQL 편집기의 경고창과 실행 결과를 혼동했을 때는 캡처를 보며 어느 단계인지 다시 확인했습니다.
현재까지 웹앱의 화면과 주요 흐름, 자동 테스트는 준비됐습니다. 실제 Supabase 연결은 아직 마무리되지 않았습니다. 다음으로 서버를 재시작하고 입장과 데이터 저장을 확인한 뒤, 투표와 운영진 로그인까지 실제 데이터베이스에서 점검할 계획입니다.



