데이터베이스

Supabase(PostgreSQL) 기반 데이터 아키텍처, 이중 저장소 패턴, 주요 테이블 설명, 백업/복원 절차를 안내합니다.

개요

v0.43.0에서 SQLite → Supabase 마이그레이션 완료. 인증서 바이너리만 로컬 SQLite에 유지합니다.

이중 저장소 아키텍처

시스템은 메모리와 Supabase 두 곳에 데이터를 유지합니다. 사용자가 편집하는 동안에는 메모리에서 작업하고, 명시적으로 DB에 동기화하는 구조입니다.

엑셀 업로드 → [파싱] → 메모리(Zustand Store) + Supabase(kpis_gap_rows/kpis_eul_rows)
                           │
                    사용자 편집 (메모리만 변경)
                           │
                    flushCurrentDate()
                           │
                    Supabase에 최종 상태 저장 (RPC)

동작 방식

편집 중 페이지를 새로고침하면 마지막 동기화 시점의 데이터로 돌아갑니다. 중요한 수정 후에는 반드시 동기화(flush)를 수행하세요.

주요 테이블 구조

공급 데이터

kpis_gap_rows (갑지 행)

갑지 엑셀에서 업로드된 공급내역 행 데이터입니다. 21열의 갑지 데이터와 제출 상태를 함께 저장합니다.

전체 컬럼은 사업자번호, 영업형태, 계약방법, 공급형태, 거래처 정보, 로트번호, 유효기간 등 21개 이상입니다.

kpis_eul_rows (을지 행)

갑지에 연결되는 의약품 일련번호/RFID 데이터입니다.

표준코드 마스터

kpis_standard_codes

KPIS 13자리 의약품 식별코드 마스터 테이블입니다. 바코드 데이터, 엑셀 업로드, API 조회 3가지 소스에서 적재됩니다.

kpis_code_mappings (코드매핑 학습)

제품명과 표준코드의 매핑 이력을 저장하여 자동 매칭에 활용합니다.

규칙 및 학습

kpis_batch_rules (일괄 수정 규칙)

사용자가 정의한 조건-액션 규칙입니다. 우선순위 순서대로 적용됩니다.

kpis_auto_correction_rules (자동 보정)

과거 수정 패턴을 학습하여 동일 오류 발생 시 자동 보정을 제안합니다.

kpis_edit_history (수정 이력)

모든 데이터 변경 이력을 감사 추적용으로 저장합니다.

인증 및 설정

kpis_users (사용자)

최초 가입 사용자가 자동으로 admin 역할을 부여받습니다.

kpis_api_config (API 설정, 싱글톤)

cert_config (인증서 설정 — 로컬 SQLite)

로컬 SQLite(data/local.db)에 저장됩니다. 바이너리 데이터 보안 정책상 Supabase가 아닌 로컬에 유지합니다.

기타 테이블

RPC 함수

Supabase RPC를 통해 복합 데이터 조작을 수행합니다.

데이터 조작

대시보드

마이그레이션

supabase/migrations/ 디렉토리에 순서대로 SQL 파일을 관리합니다.

데이터 백업 및 복원

Supabase (메인 DB)

Supabase 셀프호스팅 환경에서 PostgreSQL 표준 백업을 사용합니다.

# Supabase PostgreSQL 백업 (pg_dump)
pg_dump -h sb.dvsharp.com -U postgres -d postgres \
  --schema=public -F c -f backup_$(date +%Y%m%d).dump
 
# 복원
pg_restore -h sb.dvsharp.com -U postgres -d postgres \
  --clean --if-exists backup_20260315.dump

로컬 SQLite (cert_config)

인증서 데이터는 로컬 SQLite 단일 파일입니다.

# 백업
cp data/local.db data/local_backup_$(date +%Y%m%d).db
 
# 복원
pm2 stop kpis-dsr-api
cp /backup/local_backup.db data/local.db
pm2 restart kpis-dsr-api

복원 시 반드시 서버를 중지한 후 진행합니다.

정기 백업 권장

다음 단계

• API 레퍼런스 — 내부/외부 API 엔드포인트
• 문제 해결 — DB 관련 장애 대응