연동·배포 마무리 제안 · 동작 데모 포함

ESG·사회적가치 진단 서비스
연동 및 배포 마무리 제안서

남은 일은 기능을 늘리는 것이 아니라, 오픈해도 되는 상태로 만드는 것이라고 봅니다

신영진 | 풀스택 개발 · 시스템 운영

연동 후 어떤 상태가 되어야 하는지 만들어 봤습니다

화면은 완성되어 있다고 하셔서, 데이터가 붙었을 때 사용자가 겪게 될 흐름을 기준으로 구성했습니다

진단 입력

선택값이 계정 단위로 저장되어 중간에 나갔다 들어와도 이어서 진행됩니다. 파일럿 업체가 끝까지 완료하려면 이 부분이 먼저입니다

결과 리포트

입력값 기준 자동 생성. 영역별 점수와 업종 평균을 함께 보여주고 PDF·인쇄를 고려해 구성했습니다

재진단 이력 — 저장 구조가 먼저입니다

기업별 변화를 보여줄 수 있다고 하신 부분인데, 이는 화면이 아니라 데이터를 어떻게 쌓느냐에서 결정됩니다

1덮어쓰면 불가능진단 결과를 계정에 덮어쓰는 방식이면 이 화면 자체를 만들 수 없습니다. 회차마다 별도 기록으로 쌓는 구조여야 합니다

2문항 버전 기록문항이 개정되어도 과거 진단과 비교되도록, 진단 시점의 문항 버전을 함께 저장해 둡니다

3지금 정하는 이유파일럿 데이터가 쌓인 뒤에 구조를 바꾸면 그동안의 진단 기록을 비교에 쓸 수 없게 됩니다

연동 범위 — 무엇을 확인할지

Supabase 연동은 테이블을 만드는 일보다, 잘못된 요청을 막는 규칙을 세우는 일에 가깝습니다

1인증회원가입·로그인·비밀번호 재설정. 이메일 인증을 쓸지 여부와 세션 유지 기간을 먼저 정해야 합니다. 세션이 끊겼을 때 입력 중이던 진단이 사라지지 않게 처리하는 것이 실제 체감에 큰 영향을 줍니다

2데이터 접근 제어Supabase의 행 단위 보안(RLS)으로 자기 계정의 진단만 조회·수정되도록 데이터베이스가 직접 강제합니다. 화면 코드로 거르는 방식은 한 군데만 빠져도 남의 진단이 노출됩니다

3진단 저장 구조진단 회차·문항 버전·응답·산출 점수를 나눠 저장합니다. 점수만 저장하면 나중에 "이 점수가 왜 나왔는지" 확인할 수 없습니다

4관리자 조회관리자 기능이 범위에 포함되는지에 따라 접근 규칙이 달라집니다. 포함된다면 관리자만 전체 조회가 되도록 별도 규칙을 둡니다

배포 안정화 — 실제로 문제가 되는 것들

"배포 시 오류 없이"라고 하셨는데, Netlify 배포에서 자주 걸리는 지점은 대체로 정해져 있습니다

환경변수	로컬에서는 되는데 배포하면 안 되는 경우의 대부분이 여기입니다. Supabase 키가 빌드 설정에 등록되지 않았거나 이름이 다른 경우로, 운영·테스트 환경을 나눠 관리하겠습니다
새로고침 시 404	화면 이동 후 새로고침하면 페이지를 찾을 수 없다고 나오는 문제입니다. 리다이렉트 설정으로 처리합니다. 사용자가 링크를 공유했을 때 열리지 않는 원인이기도 합니다
접근 허용 도메인	Supabase에 배포 주소를 등록하지 않으면 로그인 후 되돌아오는 과정에서 막힙니다. 도메인이 확정되면 함께 등록합니다
키 노출	브라우저에서 쓰는 키와 서버 전용 키를 구분해야 합니다. 서버 전용 키가 화면 코드에 들어가면 누구나 전체 데이터에 접근할 수 있게 됩니다. 배포 전 반드시 점검할 항목입니다
인쇄·PDF	화면에서 잘 보여도 인쇄하면 색이 빠지거나 그래프가 잘립니다. 리포트가 제출용이라면 A4 출력 상태를 실제로 확인해야 합니다

성공적인 마무리의 기준

11월 중순 파일럿을 앞두고 있으므로, 무엇이 되면 끝인지를 먼저 맞추고 싶습니다

1끝까지 완주하는 것파일럿 업체가 가입부터 진단 완료, 리포트 확인까지 도움 없이 끝내는 것. 중간에 막히는 지점이 없어야 합니다

2데이터가 남는 것진단 기록이 회차별로 쌓여, 파일럿이 끝난 뒤 업체별 결과를 비교·분석할 수 있는 상태가 되는 것

3남의 데이터가 안 보이는 것다른 계정의 진단이 어떤 경로로도 조회되지 않는 것. 기업 진단 데이터라 한 번의 노출도 문제가 됩니다

4고칠 수 있는 상태파일럿 중 수정 요청이 나왔을 때 바로 반영하고 재배포할 수 있는 것. 오픈이 끝이 아니라 그때부터 피드백이 들어옵니다

4번을 강조드립니다. 파일럿의 목적은 무사히 오픈하는 것이 아니라 피드백을 받는 것입니다. 그 피드백을 반영할 수 없으면 파일럿을 한 의미가 줄어듭니다. 그래서 배포 절차를 문서로 남기고, 원하시면 담당자께서 직접 재배포하실 수 있게 안내드리겠습니다.

확인이 필요한 부분

착수 시 코드와 함께 확인하고 싶은 사항입니다

?관리자 기능 포함 여부파일럿 업체 목록과 진단 현황을 보는 화면이 필요한지 — 접근 규칙 설계가 달라집니다

?Supabase 프로젝트 상태이미 만들어 두셨는지, 테이블이 일부 있는지 — 처음부터 설계할지 이어받을지가 정해집니다

?문항 개정 가능성파일럿 중 문항이 바뀔 수 있다면, 문항을 코드가 아닌 데이터로 관리하는 편이 낫습니다

?리포트 용도화면 확인용인지 제출용 문서인지 — 제출용이면 PDF 레이아웃에 시간을 더 씁니다

?도메인Netlify 기본 주소로 파일럿할지, 별도 도메인을 연결할지

일정에 대해 — 11월 중순 파일럿이면 시간은 있는 편입니다. 다만 연동 완료 후 최소 1~2주는 실제로 써보는 기간을 두시길 권합니다. 배포 직후에는 보이지 않던 문제가 며칠 쓰다 보면 나옵니다. 파일럿 시작일에 맞춰 개발을 끝내는 일정보다, 그 전에 끝내고 점검하는 일정이 안전합니다.

오픈해도 되는 상태로
만들어 드리겠습니다

남은 일은 기능을 늘리는 것이 아니라 끝까지 동작하게 하는 것이라고 봅니다.
데모는 직접 눌러보실 수 있습니다.