편의점 erd
테이블 (11)
categories
- id — bigint — 기본 키 — NOT NULL
- name — varchar(30) — NOT NULL — 예: 음료, 간편식, 과자 (SCR-PROD-001 ⑥ 드롭다운)
inventories
- id — bigint — 기본 키 — NOT NULL
- store_id — bigint — 외래 키 → stores.id — NOT NULL
- product_id — bigint — 외래 키 → products.id — NOT NULL
- current_quantity — integer — NOT NULL — 현재고. 0 미만이 되는 조정은 거부 -> 400 (REQ-FUNC-006)
- last_received_date — date — SCR-INV-001 ③ 최근 입고일
- updated_at — timestamp — NOT NULL
inventory_logs
- id — bigint — 기본 키 — NOT NULL
- inventory_id — bigint — 외래 키 → inventories.id — NOT NULL
- adjustment_type — ENUM('RECEIVE', 'DISPOSE', 'STOCKTAKE') — NOT NULL — 입고 / 폐기 / 실사 조정 (SCR-INV-001 ④)
- quantity — integer — NOT NULL — 부호 포함 변동 수량. 예: 입고 +12, 폐기 -2
- changed_by — bigint — 외래 키 → users.id — NOT NULL — 변경한 사용자 (REQ-NFN-006)
- changed_at — timestamp — NOT NULL — 변경 시각 (REQ-NFN-006)
market_signals
- id — bigint — 기본 키 — NOT NULL
- product_id — bigint — 외래 키 → products.id — NOT NULL
- source_type — ENUM('TREND_ANALYSIS', 'SYNTHETIC_CONSUMER') — NOT NULL — 신호를 공급한 외부 시스템 (SCR-PROD-003 ④ 원천)
- signal_type — ENUM('MENTION_VOLUME', 'PURCHASE_INTENT', 'PRICE_ACCEPTANCE', 'SIMILAR_LAUNCH_BUZZ') — NOT NULL — 신호 종류 (SCR-PROD-003 ③)
- value_num — decimal(10, 2) — NOT NULL — 수치값. 예: 언급량 +38.00, 구매 의향 41.00
- value_text — varchar(50) — NOT NULL — 화면 표시용 문자열. 예: 전월 대비 +38%
- collected_at — timestamp — NOT NULL — 수집 시각. 30일이 지난 신호는 추천에 반영하지 않는다
orders
- id — bigint — 기본 키 — NOT NULL
- recommendation_id — bigint — 외래 키 → recommendations.id — NOT NULL — 어떤 추천에 대한 결정인지 연결. 추천 1건당 최종 결정 1건 (1:1)
- store_id — bigint — 외래 키 → stores.id — NOT NULL
- product_id — bigint — 외래 키 → products.id — NOT NULL
- decision — ENUM('PENDING', 'CONFIRMED', 'REJECTED') — NOT NULL — CONFIRMED 확정 / REJECTED 미도입 (REQ-FUNC-010)
- quantity — integer — decision=CONFIRMED일 때 필수. 입수량의 배수
- reject_reason — varchar(200) — decision=REJECTED일 때 필수 (SCR-PROD-002 ④ 미도입 사유)
- decided_by — bigint — 외래 키 → users.id — NOT NULL — 결정한 점주 (REQ-NFN-006)
- decided_at — timestamp — NOT NULL — 결정 시각 (SCR-AI-002 ⑫)
products
- id — bigint — 기본 키 — NOT NULL
- product_code — varchar(30) — NOT NULL — 중복 등록 차단. 중복 시 409 (REQ-FUNC-002)
- name — varchar(100) — NOT NULL — SCR-PROD-001 ⑤ 상품명
- category_id — bigint — 외래 키 → categories.id — NOT NULL
- price — integer — NOT NULL — 판매가(원). 1 이상 (REQ-FUNC-002)
- cost_price — integer — NOT NULL — 매입원가(원). 과잉 재고 손실 계산에 사용 (REQ-FUNC-008)
- release_date — date — NOT NULL — 출시일. 경과 시 수정 불가 (REQ-FUNC-003)
- order_deadline — date — NOT NULL — 초도 발주 마감일. 경과 후 확정 시 400 (REQ-FUNC-010)
- order_unit — integer — NOT NULL — 입수량. 발주 수량은 이 값의 배수여야 함 (REQ-FUNC-009)
- storage_type — ENUM('ROOM', 'CHILL', 'FROZEN') — NOT NULL — 보관 온도대. 폐기 위험 판단 기준
- returnable — boolean — NOT NULL — 반품 가능 여부. 서비스 수준 산출에 사용 (REQ-FUNC-008)
- promotion — varchar(100) — 행사 정보. 예: 2+1 (09-15 ~ 09-30)
- status — ENUM('REGISTERED', 'RELEASED') — NOT NULL
- created_at — timestamp — NOT NULL
- updated_at — timestamp — NOT NULL
recommendation_reasons
- id — bigint — 기본 키 — NOT NULL
- recommendation_id — bigint — 외래 키 → recommendations.id — NOT NULL
- market_signal_id — bigint — 외래 키 → market_signals.id — factor_type=SIGNAL인 경우 추천 산출에 실제 사용된 시장 신호. 값·수집 시각 추적용 (REQ-NFN-007)
- factor_type — varchar(30) — NOT NULL — 근거 구분. SCORE(점수 항목) / SIMILAR(유사 상품) / SIGNAL(시장 신호) / QUANTITY(수량 산출)
- label — varchar(100) — NOT NULL — 근거 항목명. 예: 음료 카테고리 판매 규모
- value_text — varchar(100) — NOT NULL — 이 점포의 값. 예: 주 평균 312개
- benchmark — varchar(100) — 비교 기준. 예: 카테고리 평균 2.8회
- contribution — decimal(5, 1) — 적합도 점수 기여도. 감점은 음수 (SCR-AI-002 ⑤)
- max_score — decimal(5, 1) — 해당 항목의 배점. 막대 길이 계산에 사용
- detail — varchar(300) — 항목별 설명 문장 (SCR-AI-002 ⑤)
- sort_order — smallint — NOT NULL — 화면 표시 순서
recommendations
- id — bigint — 기본 키 — NOT NULL
- store_id — bigint — 외래 키 → stores.id — NOT NULL
- product_id — bigint — 외래 키 → products.id — NOT NULL
- fit_grade — ENUM('HIGH', 'MEDIUM', 'LOW') — NOT NULL — SCR-AI-001 ④ 적합도 등급
- fit_score — smallint — NOT NULL — 적합도 점수 0~100. 근거 항목 기여도의 합 (SCR-AI-002 ②)
- confidence — ENUM('HIGH', 'MEDIUM', 'LOW') — NOT NULL — 근거의 두께. 낮으면 보수적 수량 제시 (SCR-AI-001 ④)
- predicted_min — integer — NOT NULL — 7일 예상 판매 하한 (80% 구간 하단, SCR-AI-002 ③)
- predicted_median — integer — NOT NULL — 7일 예상 판매 중앙값
- predicted_max — integer — NOT NULL — 7일 예상 판매 상한 (80% 구간 상단)
- service_level — decimal(4, 3) — NOT NULL — 품절 손실 / (품절 손실 + 과잉 손실). 반품 가능·폐기 위험에 따라 달라짐
- signal_factor — decimal(4, 2) — NOT NULL — 시장 신호 보정 계수. 미수집 시 1.00 (REQ-FUNC-008)
- recommended_quantity — integer — NOT NULL — AI 산출 권장 초도 발주량. 읽기 전용 (SCR-AI-002 ⑦)
- order_quantity — integer — NOT NULL — 점주가 수정한 발주 수량. 초기값은 recommended_quantity (REQ-FUNC-009)
- decision — ENUM('PENDING', 'CONFIRMED', 'REJECTED') — NOT NULL — 미결정 / 확정 / 미도입 (SCR-AI-001 ④ 상태)
- calculated_at — timestamp — NOT NULL — 추천 산출 시각 (SCR-AI-001 ① 기준일, REQ-NFN-007)
sales_daily
- id — bigint — 기본 키 — NOT NULL
- store_id — bigint — 외래 키 → stores.id — NOT NULL
- product_id — bigint — 외래 키 → products.id — NOT NULL
- sold_date — date — NOT NULL
- quantity — integer — NOT NULL — 해당 일자 판매 수량
stores
- id — bigint — 기본 키 — NOT NULL
- name — varchar(50) — NOT NULL — 점포명. 예: 판교테크노점 (SCR-INV-001 ①)
- created_at — timestamp — NOT NULL
users
- id — bigint — 기본 키 — NOT NULL
- email — varchar(50) — NOT NULL — 로그인 ID (REQ-FUNC-001)
- password_hash — varchar(60) — NOT NULL — 단방향 해시. 원문 저장 금지 (REQ-NFN-002)
- name — varchar(30) — NOT NULL — 변경 이력에 기록되는 사용자명 (REQ-NFN-006)
- role — ENUM('HQ', 'OWNER', 'STAFF') — NOT NULL — 역할 기반 접근 제어 기준 (REQ-NFN-003)
- store_id — bigint — 외래 키 → stores.id — 점주·근무자는 소속 점포. 본사는 NULL (REQ-NFN-003)
- created_at — timestamp — NOT NULL