-- ===================================================================== -- performance_db 초기화 스크립트 (PostgreSQL) — 실적(쇼핑몰 통합 매출) 모듈 -- ===================================================================== -- 멱등(idempotent): 여러 번 실행해도 안전. 기존 데이터를 삭제하지 않는다. -- -- ⚠️ 실행 전 사용자 승인 + 백업 확인 필수. DROP/TRUNCATE 없음. -- -- 실행 방법 (운영 PostgreSQL 컨테이너명: postgres-db): -- -- 1) DB / 역할 / 스키마 생성 (superuser 로 1회) -- read -s -p "performance_app password: " APP_PWD; echo -- docker exec -i postgres-db psql -U postgres \ -- -v app_password="$APP_PWD" \ -- < scripts/sql/performance_db_init.sql -- -- 2) main-app .env 에 추가 -- PERFORMANCE_DB_URL=postgresql://performance_app:@postgres-db:5432/performance_db -- APP_ENCRYPTION_KEY=$(openssl rand -hex 32) # 쇼핑몰 인증정보 암호화 마스터 키 -- APP_ENCRYPTION_KEY_VERSION=1 -- -- 3) main-app 재기동 -- cd /opt/www/main && docker compose up -d --build -- -- 주의: -- - 기존 DB 가 있으면 DROP 하지 않는다(CREATE DATABASE 는 미존재 시에만). -- - 비밀번호는 절대 Git 에 커밋하지 않는다. psql -v 로만 전달. -- - 쇼핑몰 API 인증정보는 이 DB 에 **암호문**으로만 들어간다(perf_credentials). -- 암호화 마스터 키(APP_ENCRYPTION_KEY)는 DB 에 저장하지 않는다. -- ===================================================================== \set ON_ERROR_STOP on SELECT 'CREATE DATABASE performance_db ENCODING ''UTF8'' TEMPLATE template0' WHERE NOT EXISTS (SELECT 1 FROM pg_database WHERE datname = 'performance_db') \gexec SELECT 'CREATE ROLE performance_app LOGIN PASSWORD ' || quote_literal(:'app_password') WHERE NOT EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'performance_app') \gexec SELECT 'ALTER ROLE performance_app WITH LOGIN PASSWORD ' || quote_literal(:'app_password') \gexec GRANT CONNECT ON DATABASE performance_db TO performance_app; \connect performance_db CREATE OR REPLACE FUNCTION perf_set_updated_at() RETURNS trigger AS $$ BEGIN NEW.updated_at := now(); RETURN NEW; END; $$ LANGUAGE plpgsql; -- ════════════════════════════════════════════════════════════ -- 1) 쇼핑몰 기본 설정 — 사용 여부 / 매출 집계 여부 / 표시 순서 -- 어댑터(코드)가 쇼핑몰의 "종류"를 정의하고, 이 표는 운영 설정만 담는다. -- ════════════════════════════════════════════════════════════ CREATE TABLE IF NOT EXISTS perf_marketplaces ( code TEXT PRIMARY KEY, name TEXT NOT NULL, enabled BOOLEAN NOT NULL DEFAULT TRUE, include_in_sales BOOLEAN NOT NULL DEFAULT TRUE, sort_order INTEGER NOT NULL DEFAULT 0, manual_input BOOLEAN NOT NULL DEFAULT FALSE, -- 수동 입력 사용(002) — perf_manual_sales 값이 그날 API 값을 대신 created_at TIMESTAMPTZ NOT NULL DEFAULT now(), updated_at TIMESTAMPTZ NOT NULL DEFAULT now() ); ALTER TABLE perf_marketplaces ADD COLUMN IF NOT EXISTS manual_input BOOLEAN NOT NULL DEFAULT FALSE; DROP TRIGGER IF EXISTS trg_perf_marketplaces_updated ON perf_marketplaces; CREATE TRIGGER trg_perf_marketplaces_updated BEFORE UPDATE ON perf_marketplaces FOR EACH ROW EXECUTE FUNCTION perf_set_updated_at(); INSERT INTO perf_marketplaces (code, name, sort_order) VALUES ('cafe24', '카페24', 10), ('naver', '네이버 스마트스토어', 20), ('coupang', '쿠팡', 30), ('toss', '토스쇼핑', 40), ('gsshop', 'GS샵', 50), ('elevenst', '11번가', 60), ('ohouse', '오늘의집', 70), ('gmarket', 'G마켓', 80), ('kakao', '카카오', 90), ('lotteon', '롯데ON', 100) ON CONFLICT (code) DO NOTHING; -- ════════════════════════════════════════════════════════════ -- 2) 수수료율 이력 — 적용 시작일(effective_from)부터 다음 변경 전까지 그 요율. -- 과거 실적은 그 날짜에 유효했던 요율로 계산한다(요율을 바꿔도 과거가 안 바뀜). -- rule_type 은 향후 상품별/카테고리별/정액 수수료 확장용(현재 'marketplace' 만). -- ════════════════════════════════════════════════════════════ CREATE TABLE IF NOT EXISTS perf_commission_rates ( id BIGSERIAL PRIMARY KEY, marketplace_code TEXT NOT NULL REFERENCES perf_marketplaces(code), rule_type TEXT NOT NULL DEFAULT 'marketplace' CHECK (rule_type IN ('marketplace')), rate_percent NUMERIC(7,3) NOT NULL CHECK (rate_percent >= 0 AND rate_percent <= 100), effective_from DATE NOT NULL, memo TEXT NOT NULL DEFAULT '', created_by TEXT NOT NULL DEFAULT '', created_at TIMESTAMPTZ NOT NULL DEFAULT now(), UNIQUE (marketplace_code, rule_type, effective_from) ); CREATE INDEX IF NOT EXISTS idx_perf_rates_code_from ON perf_commission_rates (marketplace_code, effective_from DESC); -- ════════════════════════════════════════════════════════════ -- 3) 쇼핑몰 API 인증정보 — 항목 하나 = 행 하나, 값은 AES-256-GCM 암호문. -- encrypted_value 형식: "v{키버전}:{base64url(nonce + 암호문 + tag)}" -- key_version 은 마스터 키 교체(rotation) 때 재암호화 대상을 찾는 데 쓴다. -- access/refresh token 도 여기에 같은 방식으로 저장한다. -- ════════════════════════════════════════════════════════════ CREATE TABLE IF NOT EXISTS perf_credentials ( marketplace_code TEXT NOT NULL REFERENCES perf_marketplaces(code), credential_key TEXT NOT NULL, encrypted_value TEXT NOT NULL, key_version INTEGER NOT NULL, updated_by TEXT NOT NULL DEFAULT '', created_at TIMESTAMPTZ NOT NULL DEFAULT now(), updated_at TIMESTAMPTZ NOT NULL DEFAULT now(), PRIMARY KEY (marketplace_code, credential_key) ); DROP TRIGGER IF EXISTS trg_perf_credentials_updated ON perf_credentials; CREATE TRIGGER trg_perf_credentials_updated BEFORE UPDATE ON perf_credentials FOR EACH ROW EXECUTE FUNCTION perf_set_updated_at(); -- ════════════════════════════════════════════════════════════ -- 4) 연결 상태 — 연결 테스트/동기화 결과. last_error 는 비밀값을 가린 문구만. -- ════════════════════════════════════════════════════════════ CREATE TABLE IF NOT EXISTS perf_connection_status ( marketplace_code TEXT PRIMARY KEY REFERENCES perf_marketplaces(code), status TEXT NOT NULL DEFAULT 'unknown' CHECK (status IN ('ok', 'not_configured', 'auth_failed', 'token_expired', 'api_error', 'not_implemented', 'unknown')), last_test_at TIMESTAMPTZ, last_test_ok BOOLEAN, last_sync_at TIMESTAMPTZ, last_success_sync_at TIMESTAMPTZ, last_error TEXT NOT NULL DEFAULT '', last_error_at TIMESTAMPTZ, updated_at TIMESTAMPTZ NOT NULL DEFAULT now() ); DROP TRIGGER IF EXISTS trg_perf_status_updated ON perf_connection_status; CREATE TRIGGER trg_perf_status_updated BEFORE UPDATE ON perf_connection_status FOR EACH ROW EXECUTE FUNCTION perf_set_updated_at(); -- ════════════════════════════════════════════════════════════ -- 5) 매출 사건 — 결제(+), 취소(-), 반품(-). 금액은 원 단위 정수(BIGINT). -- sales_date = 집계 기준일. 결제는 결제일, 취소·반품은 발생일 -- (지난 실적이 나중에 바뀌지 않게). order_date/payment_date 는 원래 날짜를 -- 따로 보관해 기준을 바꿀 수 있게 한다. -- 중복 방지: UNIQUE(쇼핑몰, 사건 종류, 외부 사건 ID) — 같은 사건은 덮어쓴다. -- raw_data 는 비밀값을 가린 원본. is_sample = 테스트(모의) 데이터. -- ════════════════════════════════════════════════════════════ CREATE TABLE IF NOT EXISTS perf_sales_events ( id BIGSERIAL PRIMARY KEY, marketplace_code TEXT NOT NULL REFERENCES perf_marketplaces(code), event_type TEXT NOT NULL CHECK (event_type IN ('SALE', 'CANCEL', 'RETURN', 'ADJUST')), external_event_id TEXT NOT NULL, external_order_id TEXT NOT NULL, external_line_id TEXT NOT NULL DEFAULT '', order_date DATE, payment_date DATE, event_date DATE NOT NULL, sales_date DATE NOT NULL, product_name TEXT NOT NULL DEFAULT '', option_name TEXT NOT NULL DEFAULT '', quantity INTEGER NOT NULL DEFAULT 0, amount BIGINT NOT NULL, discount_amount BIGINT NOT NULL DEFAULT 0, order_status TEXT NOT NULL DEFAULT '', raw_data JSONB, is_sample BOOLEAN NOT NULL DEFAULT FALSE, synced_at TIMESTAMPTZ NOT NULL DEFAULT now(), created_at TIMESTAMPTZ NOT NULL DEFAULT now(), updated_at TIMESTAMPTZ NOT NULL DEFAULT now(), UNIQUE (marketplace_code, event_type, external_event_id) ); CREATE INDEX IF NOT EXISTS idx_perf_events_date_code ON perf_sales_events (sales_date, marketplace_code); CREATE INDEX IF NOT EXISTS idx_perf_events_order ON perf_sales_events (marketplace_code, external_order_id); CREATE INDEX IF NOT EXISTS idx_perf_events_sample ON perf_sales_events (is_sample) WHERE is_sample; DROP TRIGGER IF EXISTS trg_perf_events_updated ON perf_sales_events; CREATE TRIGGER trg_perf_events_updated BEFORE UPDATE ON perf_sales_events FOR EACH ROW EXECUTE FUNCTION perf_set_updated_at(); -- ════════════════════════════════════════════════════════════ -- 6) 동기화 실행 기록 — 같은 쇼핑몰은 동시에 하나만(running 부분 유니크 인덱스). -- 웹/스케줄러 어디서 돌려도 중복 실행이 막힌다. -- ════════════════════════════════════════════════════════════ CREATE TABLE IF NOT EXISTS perf_sync_runs ( id BIGSERIAL PRIMARY KEY, marketplace_code TEXT NOT NULL REFERENCES perf_marketplaces(code), trigger TEXT NOT NULL DEFAULT 'manual' CHECK (trigger IN ('manual', 'schedule')), range_from DATE, range_to DATE, status TEXT NOT NULL DEFAULT 'running' CHECK (status IN ('running', 'success', 'failed')), fetched_count INTEGER NOT NULL DEFAULT 0, upserted_count INTEGER NOT NULL DEFAULT 0, error TEXT NOT NULL DEFAULT '', started_by TEXT NOT NULL DEFAULT '', started_at TIMESTAMPTZ NOT NULL DEFAULT now(), finished_at TIMESTAMPTZ ); CREATE UNIQUE INDEX IF NOT EXISTS uq_perf_sync_running ON perf_sync_runs (marketplace_code) WHERE status = 'running'; CREATE INDEX IF NOT EXISTS idx_perf_sync_runs_code ON perf_sync_runs (marketplace_code, started_at DESC); -- ════════════════════════════════════════════════════════════ -- 7) 수동 입력 매출(002) — 쇼핑몰 × 날짜 하나에 총매출 하나. 그 쇼핑몰 수동 입력이 켜져 있을 때만 집계에 쓴다. -- ════════════════════════════════════════════════════════════ CREATE TABLE IF NOT EXISTS perf_manual_sales ( marketplace_code TEXT NOT NULL REFERENCES perf_marketplaces(code), sales_date DATE NOT NULL, amount BIGINT NOT NULL, updated_by TEXT NOT NULL DEFAULT '', created_at TIMESTAMPTZ NOT NULL DEFAULT now(), updated_at TIMESTAMPTZ NOT NULL DEFAULT now(), PRIMARY KEY (marketplace_code, sales_date) ); CREATE INDEX IF NOT EXISTS idx_perf_manual_sales_date ON perf_manual_sales (sales_date); DROP TRIGGER IF EXISTS trg_perf_manual_sales_updated ON perf_manual_sales; CREATE TRIGGER trg_perf_manual_sales_updated BEFORE UPDATE ON perf_manual_sales FOR EACH ROW EXECUTE FUNCTION perf_set_updated_at(); -- ════════════════════════════════════════════════════════════ -- 권한 — 앱 계정은 DML 만 -- ════════════════════════════════════════════════════════════ GRANT USAGE ON SCHEMA public TO performance_app; GRANT SELECT, INSERT, UPDATE, DELETE ON perf_marketplaces, perf_commission_rates, perf_credentials, perf_connection_status, perf_sales_events, perf_sync_runs, perf_manual_sales TO performance_app; GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO performance_app; ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO performance_app; ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT USAGE, SELECT ON SEQUENCES TO performance_app;