중소기업 생산 및 품질실적 조회 대시보드 만들기
2026.07.29
소개
23기 자동화 오프모임에서 Claude Code로 웹앱을 GitHub → Vercel → Supabase까지 연결하는 것을 배웠습니다. 이것을 어디에 적용해볼까 고민하다가 파워BI로 관리하던 생산/품질 실적 대시보드를 웹에서 구현하는 쪽으로 진행하여 사내 대시보드를 만들게 됐습니다.
목표는 이랬습니다.
사내 도메인(
naju.kbmtt.com)으로 접속하면 로그인 후 여러 대시보드를 선택할 수 있는 구조첫 대시보드는 "코팅현황" — 나주공장 코팅 공정의 생산량, 합격/불합격/폐기, 차수별·품번별 합격률 등을 파워BI 화면과 동일하게 보여주는 것
데이터는 현장에서 쓰는 엑셀 파일을 그대로 소스로 사용
아무나 못 보게 로그인 + 관리자 승인 체계 적용
진행 방법
사용한 도구: Next.js(App Router) + Supabase(인증/DB/RLS) + Vercel(배포) + GitHub(버전관리), 전부 Claude Code 대화만으로 진행했습니다.
전체 흐름
npx create-next-app으로 프로젝트 생성 → GitHub 저장소 연결 → Vercel 배포까지 기본 골격을 잡고Supabase Auth로 로그인/회원가입 구현, "관리자가 승인해야 로그인 가능" 워크플로우 추가 (가입하면 관리자에게 이메일 알림이 가도록 Resend 연동)
파워BI 화면 캡처 한 장과 원본 엑셀 파일만으로 KPI 계산 로직(합격/불합격/폐기/검사대기/코팅대기)을 역산해서 만들어줬습니다
실제 숫자가 파워BI와 안 맞는 부분들을 하나씩 맞춰나가는 과정이 꽤 흥미로웠습니다 (아래 "시행착오" 참고)
관리자 화면에 "엑셀 업로드" 버튼을 만들어서, 현장 엑셀이 갱신될 때마다 저와의 대화 없이 관리자가 직접 파일만 올리면 데이터가 자동 교체되도록 구현
앞으로 대시보드가 여러 개 늘어날 걸 대비해서, 게이트웨이 프로젝트(
naju-gateway)를 하나 더 만들어naju.kbmtt.com도메인 하나로 여러 서브 대시보드를 경로별로 라우팅하는 구조도 잡아뒀습니다
실제 사용한 프롬프트 예시
대시보드 방향을 확 바꾼 시점의 프롬프트:
웹페이지의 이름을 URL_Making 이 아니라 KBM Naju Dashboard 로 변경해줘.
나주공장의 생산 및 품질실적을 조회할 수 있는 대시보드를 만들기 위한 목적으로 URL 만들기 실습을 하려고 했던건데... URL을 등록하는 대시보드가 되어서 조금 당황스럽네. 대시보드의 디자인은 파워BI로 화면을 구성했고, source data는 엑셀파일이야.KPI 계산식이 안 맞아서 정확한 수식을 직접 알려준 프롬프트:
코팅대기 수량에서 차이가 있음.
1차코팅대기는 필요없음 삭제해주고. 나머지 차수별 계산식은 아래와 같으니 다시 적용해줘.
2차코팅대기 = [1차불합격량]-[2차합격량]-[2차불합격량]-[2차폐기량]-[2차검사대기]
3차코팅대기 = [2차불합격량]-[3차합격량]-[3차불합격량]-[3차폐기량]-[3차검사대기]엑셀 자동 업데이트 방법을 논의한 프롬프트:
원본 엑셀데이터가 업데이트 될 때는 어떻게 작업을 하면 될까?→ 이 질문에 Claude가 "매번 저를 거치는 방식" vs "관리자 페이지에 업로드 버튼을 만드는 방식" 두 가지를 제안해줬고, 후자로 결정해서 바로 구현했습니다.
결과와 배운 점
결과: 로그인 → 대시보드 선택 화면 → 코팅현황(실데이터 연동, 파워BI와 동일한 KPI) → 관리자 전용 화면(회원 승인/삭제, 엑셀 업로드)까지 실제로 동작하는 사내 대시보드를 완성했습니다.
배운 점
화면 캡처 한 장 + 엑셀 원본만으로도 AI가 계산 로직을 상당히 정확하게 역산해낸다는 게 신기했습니다. 다만 완벽하진 않아서, 애매한 지표(예: "코팅대기" 정의)는 제가 정확한 수식을 직접 짚어줘야 100% 일치했습니다.
Supabase의 RLS(Row Level Security) 정책을 잘 쓰면, 민감한 관리자 키(service role key) 없이도 "관리자만 승인/수정 가능" 같은 권한 제어를 꽤 안전하게 구현할 수 있습니다. (회원 계정 삭제처럼 정말 관리자 권한이 필요한 기능만 최소한으로 service role key를 씀)
Vercel 환경변수는 "Production" 환경 체크, 저장 확인, 재배포까지 다 챙겨야 실제로 반영됩니다 — 이 부분에서 가장 많이 헤맸습니다.
시행착오
파워BI 숫자와 웹 대시보드 숫자가 계속 1~2건씩 안 맞아서 한참 원인을 찾았는데, 알고보니 제가 "중복 데이터"라고 판단해서 지운 행들이 사실 진짜 유효한 별도 기록이었습니다. 지우지 않으니 바로 정확히 일치했습니다.
날짜가 하루씩 밀리는 버그가 있었는데, 원인은 서버 시간대(한국 시간, UTC+9)와 엑셀 라이브러리의 날짜 변환 방식 충돌이었습니다. 엑셀의 날짜 일련번호를 직접 UTC 기준으로 변환하도록 고쳐서 해결했습니다.
관리자 계정으로 로그인해도 "관리자" 메뉴가 안 보이는 문제가 있었는데, Vercel에 등록했다고 생각한 환경변수가 실제로는 저장이 안 돼서 아예 없는 상태였습니다. 화면을 직접 캡처해서 하나씩 대조해보고서야 발견했습니다.
비밀번호 재설정 기능을 만들었는데, 재설정 이메일 링크를 눌러도 "새 비밀번호 입력 화면"이 없어서 무한 루프에 빠지는 문제가 있었습니다. 별도 화면을 새로 만드는 대신, "비밀번호 잊으면 관리자가 계정 삭제 후 재가입 안내" 방식으로 단순화했습니다.
도움이 필요한 부분
지금은 관리자가 엑셀 파일을 수동으로 업로드해야 하는데, 회사 사내 서버에 있는 파일을 주기적으로 자동으로 가져오는 방법(OneDrive/SharePoint API 연동 등)은 아직 시도하지 못했습니다.
앞으로의 계획
회사 도메인(
naju.kbmtt.com) DNS 연결 마무리사내 서버 파일 자동 동기화 방법 조사 및 적용
코팅현황 외 다른 공정(생산실적 등) 대시보드 추가
도움 받은 글 (옵션)
(없음 — Claude Code와의 대화만으로 진행)


