안티바이오 내비 독립 개발 관제판

운영 v1.4.1

환경·인수인계

개발, 시험, 운영을 나누고 되돌리는 길을 미리 닦아 둡니다

세 환경은 데이터·DB·비밀키·승인자가 모두 다릅니다. 운영은 자물쇠 표시가 붙은 곳이며, 발주자 승인으로만 바뀝니다.

인증·관리자로그인·로그아웃, 관리자·일반 권한 구분, 기본 계정 관리, 사용자별 기록 접근 제한
접근권한 설정·시험서버 API 권한, Supabase RLS, 파일 저장소 권한, 사용자별 실제 접근 시험
개발·테스트·배포 환경환경 분리, 자동 빌드·타입 검사·핵심 시험, Vercel Preview, 운영 배포 승인, 비밀 관리, 복구 검증
Claude Code 개발체계프로젝트 설정·문서, 변경 금지 영역, 변경 검토 절차, 승인 없는 수정·배포 차단 장치
인수인계·실습비전공자용 단계별 매뉴얼, 변경 → 자동시험 → Preview → 복구 직접 실습

두 안 모두 항생제 추천 엔진(engine/**)은 바꾸지 않습니다.

A안 전체에 아래 4가지를 더합니다. 새 관리 시스템을 만들지 않고 기존 기능과 DB 구조를 다시 씁니다.

증례 DB비식별·합성 증례 저장·재조회 안정화
증례 기록 관리사용자별 증례 기록 생성·조회와 최소 관리
임상 흐름 개선기존 UTI·폐렴 입력, OCR 확인, 결과 조회 흐름 다듬기
일관성 검증저장된 입력정보와 추천 결과가 같은지 자동 비교

두 안 모두 항생제 추천 엔진(engine/**)은 바꾸지 않습니다.

개발

각자 PC · 작업 공간

데이터: 합성 증례 30건
DB: Supabase 개발 프로젝트
배포 방식: PC에서 직접 실행 (npm run dev)
승인자: 없음 · 개인 작업 공간
비밀키 보관: .env.local · GitHub에 올라가지 않음
Claude Code: 작업 가능 · 보호 영역 제외

테스트(Preview)

PR마다 새 주소

데이터: 합성 증례 120건
DB: Supabase 테스트 프로젝트
배포 방식: PR을 올리면 Vercel Preview 자동 생성
승인자: 자동 검증 통과 시에만 생성
비밀키 보관: Vercel Preview 환경변수
Claude Code: 시험 결과 읽기만

운영

의료진이 쓰는 화면

데이터: 운영 데이터
DB: Supabase 운영 프로젝트
배포 방식: main 병합 → 발주자 승인 → 배포
승인자: 발주자
비밀키 보관: Vercel Production 환경변수 · 발주자 계정만 열람
Claude Code: 접근 없음

복구 절차 5단계

운영에 문제가 보이면 이 순서대로 합니다. 납품 전에 실제로 한 번 되돌려 보고 걸린 시간을 기록합니다.

1 알아차리기
화면 오류 신고나 자동 점검 실패 알림을 확인합니다.
5분 안
2 직전 정상 버전 찾기
Vercel 배포 목록에서 정상 표시가 붙은 마지막 버전을 고릅니다.
배포 목록
3 되돌리기
그 버전을 운영으로 다시 지정합니다. 코드는 지우지 않습니다.
버튼 한 번
4 다시 시험
운영 주소 기준으로 핵심 시험 42개를 다시 돌립니다.
약 2분
5 기록 남기기
무엇을 왜 되돌렸는지 GitHub 이슈에 남기고, 원인 수정은 개발 환경에서 다시 시작합니다.
GitHub 이슈

DB 구조가 바뀐 배포는 Supabase 백업 시점을 먼저 확인한 뒤 되돌립니다. 백업 확인과 내려받기는 매뉴얼 4장에 따로 적습니다.

인수인계 매뉴얼 목차

기술 비전공자가 순서대로 따라 할 수 있게 화면 캡처와 함께 단계별로 씁니다.

1 개발 Claude Code에 작은 변경 요청하기 · 요청 문장 예시 12개 · 허용 영역과 보호 영역 구분
2 시험 자동 시험 결과 읽는 법 · 실패 표시가 떴을 때 할 일
3 배포 Preview 주소에서 확인하기 · 승인하고 운영 배포하기
4 백업 Supabase 백업 시점 확인 · 백업 내려받기와 보관 위치
5 복구 이전 버전으로 되돌리기 · 복구 뒤 확인할 3가지

발주자 실습 점검표

납품 전 발주자가 직접 한 번씩 해 보고 체크합니다. 막힌 곳은 그 자리에서 매뉴얼을 고칩니다.

0/4 완료

1 변경 로그인 안내 문구 한 줄을 Claude Code로 바꿉니다.
2 자동시험 GitHub에서 빌드·타입 검사·핵심 시험 42개 통과를 확인합니다.
3 Preview Preview 주소에서 바뀐 문구를 직접 확인하고 승인합니다.
4 복구 운영 배포 뒤 이전 버전으로 되돌리고 원래 문구를 확인합니다.

시연용 화면입니다. 표시된 이름과 숫자는 모두 예시 데이터입니다.