로컬이음 체험을 화면에서 실제 데이터까지 연결해 본 과정
2026.10.20

로컬이음 체험 플랫폼 소개
이전 사례글에서는 여행자가 체험을 찾고 신청하고, 호스트가 신청자를 관리하는 흐름을 설계했습니다. 이번에는 그 흐름이 실제 서비스에서 어떻게 이어지는지 확인하고, 호스트가 체험을 운영하는 데 필요한 화면과 데이터를 연결하는 데 집중했습니다.
로컬이음은 여행자와 지역 주민을 잇는 체험 플랫폼입니다. 여행자는 시장과 골목, 지역 문화를 경험할 체험을 찾고, 호스트는 자신의 프로그램과 운영 회차, 참가 신청을 관리합니다. 관광 정보를 보여주는 데 그치지 않고, 여행자가 지역 사람과 함께 활동하며 장소의 이야기를 경험하도록 돕는 것이 목표입니다.
이번 작업에서는 특히 “화면에 보이는가?”에서 멈추지 않고 다음을 확인하려 했습니다.
체험과 운영 회차가 Supabase 데이터와 연결되는가?
공개 데모와 실제 호스트 운영 권한을 구분할 수 있는가?
영어·일본어 번역과 실제 진행 가능한 언어가 혼동되지 않는가?
AI 분석이 실패했을 때 원인을 좁혀 확인할 수 있는가?
진행 방법
Codex와 Claude Code를 사용해 화면, 데이터, 권한, 배포 상태를 나눠 점검했습니다. React·Vite로 만든 화면과 Supabase Auth·PostgreSQL·RLS·Storage·Edge Function을 함께 살펴봤습니다. GitHub에서는 작업 브랜치와 main의 파일 내용을 비교했고, Vercel은 다른 사람이 화면을 확인할 수 있도록 임시 미리보기로 사용했습니다.
아래는 실제 작업 요청의 핵심 프롬프트입니다.
Open optionsauto
로컬이음 체험 플랫폼의 현재 구현 상태를 확인하고, 화면과 데이터가 실제로 연결되는지 점검해 줘.
먼저 Git 작업 상태와 현재 브랜치를 확인하고, 체험 목록·상세 화면, HOST 운영센터, Supabase 테이블과 RLS, AI Edge Function, 번역 데이터를 살펴봐. 실제 코드 구현, 원격 DB 적용, 함수 배포 상태를 구분해서 보고해.
여행자는 체험을 탐색하고 운영 회차에 신청할 수 있어야 하고, HOST는 자신의 프로그램·회차·신청자를 관리할 수 있어야 해. 공개 데모는 가상 정보만 보여주는 읽기 전용으로 제공하고 실제 개인정보와 수정 기능은 보호해.
한국어·영어·일본어 화면 언어와 호스트가 실제로 진행할 수 있는 언어는 구분해. 호스트 확인 전의 언어는 실제 진행 가능 언어로 표시하지 마.
AI 분석은 호스트에게 개선 제안을 제공하고, 결과는 검토와 수정 후 활용할 수 있게 해. 요청이 실패하면 API 설정, 인증, Edge Function 배포, 브라우저 Origin 허용 여부를 나눠 확인해.
기능이 화면에서 보이는 것과 실제로 저장·신청·운영되는 것을 구분해서 검증하고, 확인하지 못한 부분과 추가 확인이 필요한 내용을 함께 정리해.체험 신청과 호스트 운영 흐름 점검
체험 목록과 상세 페이지가 표시되는 것만으로 실제 신청이 완료되는 것은 아니었습니다. 신청 정보를 저장하고 호스트가 확인하려면 DB 구조와 인증, RLS 정책이 함께 맞아야 했습니다. 호스트 화면에서 발생한 JWT expired, permission denied 오류도 이 점을 확인하게 해 준 사례였습니다.
호스트 운영센터는 프로그램과 회차를 선택하고, 신청자 정보를 확인하는 흐름으로 정리했습니다. 공개 데모에서는 가상 정보를 보여주고 실제 신청자 개인정보와 변경 기능은 호스트 권한에 따라 제한하도록 구분했습니다.
다국어와 진행 언어 구분
한국어·영어·일본어로 화면을 볼 수 있는 기능과, 호스트가 실제로 해당 언어로 체험을 진행할 수 있는지는 별개로 다뤘습니다. 번역 문구가 존재한다는 이유만으로 체험 진행 언어까지 확정된 것처럼 보여서는 안 되기 때문입니다.
서울·부산·창원의 언어·친구 체험을 시연 사례로 구성하고, 각 체험에 일정과 장소, 소개 문구를 연결했습니다. 장소와 맞지 않는 이미지는 수정했습니다. 예를 들어 창동예술촌은 바닷가가 아니라 도심의 좁은 골목이라는 현장 특성을 반영했습니다.
AI 분석 요청 오류 해결
호스트의 체험 아이디어를 분석하고 개선안을 제안하는 AI 화면도 점검했습니다. API 키가 설정되어 있어도 브라우저에서 요청이 실패할 수 있었습니다. 함수가 배포되어 있는지, 인증이 통과하는지, 현재 웹 주소가 허용된 Origin인지 나눠 확인했습니다.
점검 당시 AI Edge Function은 배포되어 있었지만 Vercel 미리보기 주소의 요청은 CORS에서 차단됐습니다. 그래서 이 문제를 단순히 “API 키가 틀렸다”고 결론 내릴 수 없었습니다. 실제 AI 응답이 성공하는지 확인하는 것과 Edge Function이 배포되어 있는지는 각각 따로 검증해야 했습니다.

결과와 배운 점
체험 목록과 상세, 호스트 운영센터, 읽기 전용 공개 데모, 다국어 체험 자료, AI 분석 화면을 하나의 서비스 흐름으로 점검했습니다. 빌드와 린트, 로컬이음 및 AI 관련 자동 테스트를 실행했고, 당시 확인한 테스트는 통과했습니다.
다만 자동 테스트 통과가 실제 호스트의 회차 저장·취소, 실제 참가 신청, AI의 실사용까지 모두 검증했다는 뜻은 아닙니다. 화면과 코드 구현, Supabase 원격 반영, Edge Function 배포, 브라우저에서의 실제 요청은 각각 다른 단계라는 점을 배웠습니다.
가장 큰 시행착오는 화면 오류의 원인을 한곳에서 찾으려 했던 것입니다. 호스트 화면은 세션 만료나 RLS 권한 문제일 수 있고, AI 요청은 CORS나 함수 설정 문제일 수 있습니다. 사용자가 본 오류 메시지만 보고 판단하기보다 브라우저 요청, 원격 DB 정책, 함수 배포 상태를 함께 확인해야 했습니다.
다국어 체험을 만들면서도 “번역되어 있다”와 “그 언어로 진행할 수 있다”를 구분하는 것이 중요했습니다. 진행 언어는 호스트가 확인한 뒤 공개해야 체험 정보를 믿을 수 있습니다.
앞으로는 실제 호스트 계정으로 회차 생성·취소와 신청자 관리를 검증하고, 시연 데이터와 실제 DB 데이터가 목록·상세 화면에서 서로 다르게 보이지 않도록 보완할 계획입니다. AI 분석도 허용 Origin을 설정한 뒤 실제 응답과 오류 처리까지 확인하고 싶습니다. 이후에는 사용자에게 체험을 제공하고 피드백을 받아 운영 흐름을 개선하려 합니다.





라피스님, 안녕하세요! "화면에 보인다"와 "실제로 저장·신청·운영된다"를 단계별로 나눠 검증하려는 접근이 글 전체에 일관되게 드러나서 좋았어요.
AI 분석이 실패했을 때 API 키 문제로 단정하지 않고, 함수 배포 여부, 인증, Origin 허용을 따로 확인해 Vercel 미리보기 주소가 CORS에서 막힌 걸 짚어낸 대목이 특히 인상적이었어요. 다국어도 "번역되어 있다"와 "그 언어로 진행할 수 있다"를 구분해서, 호스트 확인 전에는 진행 가능 언어로 표시하지 않기로 한 기준이 서비스 신뢰에 꼭 필요한 디테일이라고 느꼈습니다. 자동 테스트 통과가 실제 신청·회차 저장 검증은 아니라고 스스로 선을 그은 점도 좋아요. 다음엔 실제 호스트 계정 검증 결과가 궁금해요.
꼬리 살랑살랑, 다음 글도 기다릴게요 🐈⬛