로컬이음 프런트엔드 구현 가이드: 데이터베이스 활용
2026.10.13

로컬이음 서비스 구현 목표
지난 1주차에는 gatekit을 설치하고, 만들어 둔 화면 시안으로 시스템 설계 인터뷰를 시도했습니다. 하지만 인터뷰가 화면에 보이는 내용을 확인하는 데 집중되면서, 정작 제가 궁금했던 데이터베이스 구조와 시스템의 작동 원리를 이해하기는 어려웠습니다.
이번에는 방향을 바꿨습니다.
gatekit에 개발을 맡기기보다 클로드와 함께 직접 설계하고, 구현하면서 부족한 부분을 찾아가는 방식을 선택했습니다.
개발 대상으로 정한 서비스는 로컬이음(LOCAL EUM) 서비스 웹 구현입니다.
로컬이음은 여행자가 관광지를 구경하는 데 그치지 않고, 지역주민과 만나 그 지역의 음식, 문화, 일상을 함께 경험할 수 있도록 연결하는 서비스입니다.
예를 들어 부산을 여행하는 사람이 현지 주민과 해안가를 산책하거나, 전통시장을 둘러보고, 지역 문화를 이야기하는 프로그램에 참여할 수 있습니다.
이번 주에는 세 가지를 해결하고 싶었습니다.
여행자가 프로그램을 찾고 참가 신청하는 웹 화면 구현
호스트가 신청자를 확인하고 운영할 수 있는 구조 설계
신청 정보가 어디에 저장되고 어떻게 연결되는지 데이터베이스 구조 이해
특히 화면을 구현하는 것과 실제 서비스가 작동하는 것은 무엇이 다른지 직접 경험하고 싶었습니다.
활용한 도구와 기술
클로드(클로드코드): 서비스 기획, 화면 설계, 사용자 흐름 정리, 프런트엔드 구현 지원, 데이터베이스 구조 분석
React / Vite / JavaScript / CSS: 웹 화면 및 시연 기능 구현
Supabase: 데이터 저장·인증 구조를 간단하게 구현하기 위해 새롭게 선택한 서비스
Codex: 향후 데이터베이스 연결 및 실제 코드 구현·검증에 활용할 도구
이번 주에는 gatekit을 사용하지 않고 자체 설계 방식으로 진행했습니다.
구현 과정과 도전
서비스 작동 흐름 정리
시도한 방법
로컬이음에서 실제로 누가 무엇을 하는지부터 구분했습니다.
사용자는 여행자, 호스트, 관리자의 세 유형으로 나눴습니다.
여행자는 로컬 프로그램을 검색하고 참가 신청
호스트는 프로그램을 개설하고 신청자에게 연락하며 참가 승인
관리자는 프로그램과 호스트, 전체 신청 현황 관리
가장 중요하게 생각한 부분은 신청 이후의 과정이었습니다.
처음에는 참가 신청서를 만들면 된다고 생각했습니다.
그런데 신청자가 제출한 정보는 누가 받을까요? 담당 호스트는 어떻게 정해지고, 신청 현황은 어디에서 확인할까요?
이 질문을 해결하기 위해 다음과 같은 흐름을 설계했습니다.
프로그램 검색 → 상세 확인 → 참가 신청 → 접수번호 발급 → 담당 호스트 확인 → 연락 및 승인 → 관리자 현황 관리
이 과정을 정리하면서 화면에 표시되지 않는 데이터 처리와 운영 기능도 설계해야 한다는 것을 알게 됐습니다.
프런트엔드 시연 화면 구현
시도한 방법
클로드와 함께 화면별 기능과 사용자 이동 경로를 정리한 뒤 React 기반의 프런트엔드 시연 화면을 만들었습니다.
주요 구현 내용은 다음과 같습니다.
지역·언어·관심분야별 프로그램 검색
프로그램 상세 정보와 날짜·정원 표시
호스트 목록 및 호스트별 공개 홈페이지
참가 신청서 작성과 접수번호 표시
호스트 운영센터와 신청자 관리 화면
관리자 운영 현황 화면
시연을 위해 기본 프로그램 5종, 가상 호스트 9명, 체험 9건을 구성하고 이미지 42장도 준비했습니다.
새롭게 시도한 점
호스트마다 홈페이지를 각각 제작하는 대신, 공통 화면 하나에서 선택한 호스트의 정보가 자동으로 표시되도록 설계했습니다.
또한 참가 신청을 외부 구글폼으로 처리하지 않고 웹 내부에서 직접 접수하는 구조를 선택했습니다.
얻은 결과
화면을 눌러보면서 여행자, 호스트, 관리자의 이용 흐름을 시연할 수 있게 됐습니다.
다만 현재 신청 정보와 호스트 배정은 시연 데이터와 브라우저 상태를 이용한 것으로, 실제 데이터베이스에 저장되는 단계는 아닙니다.
[이미지 1: 로컬이음 메인 및 프로그램 검색 화면]

[이미지 2: 호스트별 공개 홈페이지와 프로그램 상세]

[이미지 3: 참가 신청서]
데이터베이스 설계의 도전
프런트엔드에서는 신청 버튼을 누르면 접수가 완료된 것처럼 보여줄 수 있었습니다. 그런데 실제 서비스라면 브라우저를 닫았다가 다시 접속해도 신청 정보가 남아 있어야 합니다. 또한 호스트가 자신에게 들어온 신청을 확인하고 처리할 수 있어야 합니다.
처음에는 Oracle Database를 기준으로 데이터베이스 구조를 설계했습니다. 그 과정에서 27개 테이블과 235개 컬럼으로 구성된 초기 설계자료까지 만들었습니다. 하지만 테이블이 늘어나면서 오히려 혼란스러워졌습니다.
어떤 화면에 어떤 데이터가 필요한지, 각 테이블이 어떻게 연결되는지, 백엔드가 어떤 일을 처리해야 하는지 충분히 이해하지 못했기 때문입니다.
문제는 테이블을 만드는 기술보다 데이터가 움직이는 과정을 제대로 이해하지 못한 데 있었습니다.
예를 들어 신청자가 프로그램에 참가 신청을 하면 다음 과정을 처리해야 합니다.
신청한 프로그램과 날짜를 확인한다.
신청 정보를 데이터베이스에 저장한다.
프로그램을 운영하는 호스트를 찾는다.
해당 호스트의 신청함에 표시한다.
호스트가 연락하거나 승인하면 처리 상태를 변경한다.
이 과정을 통해 먼저 업무 흐름을 만들고, 그다음 필요한 테이블을 정해야 한다는 것을 이해하게 됐습니다.
Supabase로의 전환
데이터베이스에 대한 이해가 부족한 상황에서 처음부터 복잡한 구조를 구현하는 것이 부담스러웠습니다. 그래서 데이터베이스를 Supabase로 변경하는 방향을 선택했습니다.
Supabase는 PostgreSQL 기반 데이터베이스와 사용자 인증, API 기능 등을 제공하는 서비스입니다.별도의 백엔드 서버를 처음부터 모두 만들지 않아도 데이터 저장과 조회를 구현할 수 있다는 점이 매력적이었습니다.
다만 모든 백엔드 로직을 없앨 수 있는 것은 아닙니다. 신청 정원 검사, 호스트 권한, 데이터 접근 제한처럼 중요한 처리는 별도로 검증해야 합니다.
현재 구상한 구조는 다음과 같습니다.
React 화면 → Supabase 데이터 저장·조회 → 호스트 및 관리자 화면에 결과 표시
호스트와 관리자의 로그인에는 Supabase Auth를 활용하고, 다른 호스트의 신청 정보가 보이지 않도록 RLS라는 데이터 접근 제한 기능을 적용할 계획입니다.
이번 주에는 데이터베이스 변경 방향과 설계 원칙을 정리했습니다. 실제 Supabase 테이블 생성과 프런트엔드 연동은 다음 작업으로 남아 있습니다.
시행착오와 교훈
1. 화면을 구현하면 서비스도 거의 완성된 것처럼 생각했습니다.
실제로는 화면의 버튼 하나에도 데이터 저장, 오류 처리, 사용자 권한, 상태 변경이 필요했습니다.
2. 데이터베이스를 크게 설계하면 더 완성도 있는 시스템이 된다고 생각했습니다.
27개 테이블을 설계했지만, 정작 어떤 데이터가 어디로 이동하는지 이해하지 못한 상태에서는 활용하기 어려웠습니다.
3. 만들고 싶은 기능을 계속 추가하려 했습니다.
커뮤니티, 다양한 로컬 모임, 결제, AI 추천까지 생각하다 보니 개발 범위가 커졌습니다. 현재는 최소 기능을 실제로 연결해 보는 것이 우선이라고 판단했습니다.
4. AI가 만들어 준 결과를 검증하는 기준이 부족했습니다.
화면이 정상적으로 보이는 것과 데이터베이스에 정보가 정확히 저장되는 것은 별개의 문제였습니다. 앞으로는 구현 요청과 함께 확인할 동작과 완료 조건도 제시하려고 합니다.
배운 점과 향후 계획
이번 주 가장 크게 배운 것은 프런트엔드, 백엔드, 데이터베이스가 각각 어떤 역할을 하는지 이해해야 서비스를 완성할 수 있다는 점입니다.
프런트엔드는 사용자가 보고 조작하는 화면입니다. 데이터베이스는 프로그램과 신청 정보를 저장합니다. 백엔드는 그사이에서 필요한 검사와 처리를 수행합니다. Supabase를 사용할 경우에는 일부 역할을 제공되는 API와 서버 측 기능으로 대신할 수 있습니다.
그리고 AI에게 개발을 맡기더라도 어떤 정보를 입력받고, 어떻게 처리하며, 어떤 결과를 보여줘야 하는지에 대한 판단은 필요했습니다.
gatekit은 이미지로 구현시 실패함에 따라 개발 도구에 시스템 설계를 전적으로 맡기기보다, 스스로 시스템의 흐름을 이해하면서 AI를 활용해야 한다는 것을 발견한 것이 더 큰 배움이었습니다.
향후 계획
Supabase를 실제로 연결하는 작업을 진행할 계획입니다. 우선 필요한 테이블만 만들고, 다음과 같은 하나의 동작을 끝까지 구현해 보려고 합니다.
프로그램 선택 → 참가 신청 → Supabase 저장 → 호스트 신청함 조회 → 처리 상태 변경
이 과정이 실제로 동작하는지 확인한 후 인증과 권한을 보완하고, 최종적으로 Vercel 배포까지 시도할 생각입니다.
또한 AI Agent를 활용한 로컬 프로그램 추천에도 관심이 있지만, 기본적인 데이터 처리 기능을 완성한 후 다음 단계에서 작은 범위로 실험하려고 합니다.
이번 주에는 공식 배포까지 완성하지 못했습니다.
하지만 1주차가 개발 도구를 설치하고 활용 방법을 찾는 과정이었다면, 2주차는 직접 만든 화면 뒤에 어떤 시스템이 필요할지 이해하기 시작한 시간이었습니다.
다음 주 목표는 화면을 더 많이 만드는 것이 아니라, 참가 신청 하나가 실제 데이터베이스에 저장되고 다시 조회되는 경험을 해보는 것입니다.




로컬이음 서비스 좋은것 같아요 :) 지역경제 발전에 큰힘이 되는 서비스 응원합니다👍