MD-25 · 어드민·엑셀 용어 통일

🆕 신규 화면 개발

무엇 — 어드민 전 화면과 다운로드 엑셀에서 같은 대상을 부르는 말을 표준 용어 1개로 통일하고, 그 근거가 되는 용어 대응표(글로서리)를 단일 소스로 관리한다.📍 위치: 시스템 설정 › 용어 사전 관리

핵심 결정

표준 용어(핵심 4)

공급처=공급사 / 상품코드=히어로코드 / 주문 고객=식당 / 대체발주→대체주문

변경 범위

어드민 노출 전체 글자 + 다운로드 엑셀 제목줄 전체를 전수 감사 후 1:1로 교체

대외 노출

대외 화면·문서도 공급사로 통일('파트너' 폐기). 약어 MFC·DC·SoldTo는 유지

구분(통일 아님)

상품코드 3종 히어로코드 / 공급사상품코드 / 그룹코드는 각각 다른 코드 — 병합 금지

거버넌스

용어 사전(글로서리)을 단일 소스로 개발·유지, 신규 화면 용어 규칙 매뉴얼화

화면 — 먼저 보기

이 티켓이 실제로 어떤 화면이 되는지 먼저 봅니다

실제 공급사 관리 화면 하나에 제목은 '공급사', 표는 '유통사 ID·공급사 명', 검색칸은 '파트너명', 버튼은 '거래처 코드 등록'이 공존한다. DB의 seller 테이블에도 seller_name과 partner_name이 함께 존재 — 이 화면은 그 혼선을 표준어 1개로 수렴시키는 단일 소스다.

현행 화면 · 실제 캡처

현행 「공급사」 목록 — 용어 혼용(공급사/파트너/거래처) 예시

변경안 · 제안 화면

◆ OrderHero 어드민🔍 통합검색관리자 ▾

📊 대시보드

📦 상품관리

🧾 주문관리

🏬 재고관리

🎯 프로모션

💳 정산

⚙️ 설정

시스템 설정 › 용어 사전 관리신규 화면

개념	표준 용어 🆕	섞여 쓰던 표현 🆕	노출 위치 🆕	대외	상태 🆕
물건 대주는 곳	공급사	유통사 · 파트너 · 거래처	공급사 관리(제목·표·검색·버튼)	통일	미교체
상품 식별 코드	히어로코드	히어로 코드 · 히어로 프로덕트 코드	공급사 상품 관리 표헤더	-	교체완료
주문 고객	식당	고객 · 업장 · SoldTo	주문관리 목록·엑셀 제목줄	-	미교체
대체발주 명칭	대체주문	대체발주	주문 상태/버튼	-	예외

총 128건 · 20/page‹123›

▲ 용어 대응표 — 바뀌는 컬럼은 🆕 로 표시(예시 데이터)

전수 감사 스캔 — 어드민 전 화면의 라벨·표 헤더·버튼·검색칸 텍스트와 다운로드 엑셀 제목줄을 수집해 term_occurrence에 적재한다. 엑셀 실제 제목줄은 운영에서 수집(0순위).

개념별 표준어 확정 — 수집된 표현을 개념(concept_key)으로 묶고, term_glossary에 표준어 1개와 폐기 별칭을 확정한다. 코드 3종처럼 '구분' 개념은 is_locked=true로 잠근다.

대응표 검토 — 표준어별 노출 위치 목록을 화면에서 확인. '공급사'처럼 한 화면에 유통사 ID·파트너명·거래처가 섞인 케이스를 한눈에 본다.

링크 영향 판정 — location_type=route 항목은 라벨만 바꾸고 라우트는 보존하거나 redirect 대상으로 표시해 기존 외부 링크가 깨지지 않게 한다.

표준어 일괄 교체 적용 — 확정 표준어로 화면 문구와 엑셀 제목줄을 1:1 교체하고 status=done 처리. 대체발주→대체주문 개칭도 이 단계에서 반영.

거버넌스 고정 — term_glossary를 코드/문서 단일 소스로 배포하고 신규 화면 용어 규칙을 매뉴얼화한다. 이후 나머지 24건 티켓은 이 표준어로 '어느 화면 어느 칸'을 지목.

정책 / 정의

용어를 못 박고, 규칙을 명확히

용어 정의

용어	정의
공급사	물건을 대주는 매입처. 기존 '유통사/파트너/거래처'를 모두 대체하는 표준어(대외 노출 포함). 스키마 근거: seller 테이블.
히어로코드	상품 식별 표준키. 기존 '히어로 코드/히어로 프로덕트 코드' 표기 3종을 '히어로코드' 한 단어로 통일. 컬럼: hero_product_code.
식당	주문하는 고객(사장님) 업장. 기존 '고객/업장/SoldTo' 혼용을 '식당'으로 통일.
그룹상품명(=노출명)	상품명 계층의 최상위 노출 명칭. '그룹 상품명/유통사 상품명/노출명' 혼용을 구조 확인 후 '그룹상품명' 단일 표기로 정리.
대체주문	품절 등으로 다른 상품으로 바꿔 나가는 주문. 기존 '대체발주'를 '대체주문'으로 개칭(발주 상태값 자체는 유지).
net 공급가	매입 순공급가. 표기는 소문자 net으로 통일하며 공급사 대면 화면에는 net을 미노출. 면세/과세 로직은 별도 재무티켓(PLD-821 계열).
DC 작업 코드(허브코드)	물류 작업용 코드. '이지어드민 코드' 명칭은 ERP 교체 시 정크가 되므로 사용 금지, 'DC 작업 코드'로 표기.

정책 (규칙)

#	규칙	비고
1	1개념=1표준어	같은 개념은 어디서든 한 단어. 공급사/히어로코드/식당/그룹상품명/대체주문을 표준으로 고정.
2	화면 글자 + 엑셀 제목줄 1:1 매칭	어드민 노출 전체와 다운로드 엑셀 컬럼 제목줄을 전수 감사하여 같은 표준어로 동시 교체. 엑셀 실제 제목줄은 운영 수집분을 대응표에 입력(운영 확인 0순위).
3	공급사 대면 화면 net 미노출	net 공급가/net 단가는 내부 표기 소문자 통일하되, 공급사가 보는 화면에는 노출하지 않음.
4	마진·수수료·여/부 플래그 유지	마진율(공급사/상품)·수수료·매입, 그리고 노출여부/사용여부/검수필요여부/과세여부 등 여부 플래그 표기는 현행 유지(통일 대상 아님).
5	상품코드 3종은 구분	히어로코드 / 공급사상품코드 / 그룹코드는 별개 코드. hero_code_mapping의 type으로 구분되며 병합·단일화하지 않음.
6	대체발주 → 대체주문	명칭만 변경. 발주 상태값(미마감·미발주·발주대기·발주마감·발주완료)과 로직은 유지.
7	링크(URL) 깨짐 방지	외부에서 링크로 접속하는 화면 주소(예: /partnerList)는 그대로 두거나 표준 경로로 자동 연결(redirect). 라벨만 바꾸고 라우트는 보존. [가정] 감사 결과에 따라 redirect 필요 목록 확정.
8	물류거점 명칭·재무 로직은 별도 티켓	센터/MFC/허브/DC(TC·DC 명칭)는 유지 — 명칭 변경은 별도 티켓. 단가 면세/과세는 재무티켓(PLD-821 계열)에서 처리.
9	거버넌스: 글로서리 단일 소스 + 신규 규칙	term_glossary를 코드/문서 단일 소스로 두고, 신규 화면·기능은 이 사전 기준으로 용어 사용(매뉴얼화).

ERD

데이터 구조 · 관계 · DDL

term_glossary 신규

idPK bigserial

concept_keyvarchar(50)

standard_termvarchar(50)

aliasesjsonb

external_visibleboolean

scopevarchar(20)

is_lockedboolean

updated_attimestamp

개념별 표준 용어 사전(단일 소스). 개념 1건당 표준어 1개 + 폐기 별칭 목록.

term_occurrence 신규

idPK bigserial

glossary_idFK bigint

screen_keyvarchar(100)

location_typevarchar(20)

raw_textvarchar(255)

source_refvarchar(255)

statusvarchar(20)

전수 감사 결과: 실제 화면/엑셀에 박힌 표현의 위치 대응표. 교체 진행 상태 추적.

seller READ

idPK varchar(100)

seller_namevarchar(20)

partner_namevarchar(20)

공급사 마스터. seller_name·partner_name이 공존해 혼선의 근원 — 표준어 노출은 seller_name로 수렴.

hero_code_mapping READ

hero_product_codevarchar(100)

typevarchar(30)

specific_codevarchar(100)

히어로코드↔개별코드 매핑. type으로 코드 종류 구분 → 코드 3종 '구분' 정책의 근거.

term_occurrence.glossary_id → term_glossary.id (표준어 1건이 여러 노출 위치를 가짐)

term_occurrence.screen_key = 어드민 라우트/엑셀 파일 식별자(예: partnerList) — 링크 보존 판단용

hero_code_mapping.type 으로 히어로코드 vs 공급사상품코드 vs 그룹코드 구분(병합 금지)

-- 용어 사전(글로서리): 개념별 표준 용어 단일 소스\nCREATE TABLE term_glossary (\n    id               BIGSERIAL PRIMARY KEY,                 -- PK\n    concept_key      VARCHAR(50)  NOT NULL UNIQUE,          -- 개념 키(supplier, hero_code, restaurant ...)\n    standard_term    VARCHAR(50)  NOT NULL,                 -- 표준 용어(예: 공급사)\n    aliases          JSONB        NOT NULL DEFAULT '[]',    -- 폐기/혼용 별칭 배열(예: [\"유통사\",\"파트너\",\"거래처\"])\n    external_visible BOOLEAN      NOT NULL DEFAULT TRUE,    -- 대외 노출에도 표준어 적용(공급사=true)\n    scope            VARCHAR(20)  NOT NULL DEFAULT 'all',   -- 적용 범위: admin/excel/app/all\n    is_locked        BOOLEAN      NOT NULL DEFAULT FALSE,   -- '구분' 개념 잠금(코드 3종 등 통일 금지)\n    updated_at       TIMESTAMP    NOT NULL DEFAULT (CURRENT_TIMESTAMP AT TIME ZONE 'Asia/Seoul')\n);\nCOMMENT ON TABLE term_glossary IS '용어 사전(단일 소스): 개념 1건당 표준어 1개';\n\n-- 전수 감사 결과: 화면/엑셀에 박힌 표현의 위치 대응표\nCREATE TABLE term_occurrence (\n    id            BIGSERIAL PRIMARY KEY,                    -- PK\n    glossary_id   BIGINT       NOT NULL REFERENCES term_glossary(id), -- 표준어 FK\n    screen_key    VARCHAR(100) NOT NULL,                    -- 화면/라우트 식별(예: partnerList)\n    location_type VARCHAR(20)  NOT NULL,                    -- label/table_header/button/search/excel_header/route\n    raw_text      VARCHAR(255) NOT NULL,                    -- 실제 박혀있던 텍스트(예: '유통사 ID')\n    source_ref    VARCHAR(255),                             -- 근거(파일:라인 또는 엑셀 파일명)\n    status        VARCHAR(20)  NOT NULL DEFAULT 'todo'      -- todo(미교체)/done(교체완료)/except(예외)\n);\nCOMMENT ON TABLE term_occurrence IS '용어 노출 위치 전수 감사 및 교체 진행 상태';\nCREATE INDEX idx_term_occurrence_glossary ON term_occurrence(glossary_id);\nCREATE INDEX idx_term_occurrence_status   ON term_occurrence(status);\n\n-- [참고] 기존 seller.partner_name 은 데이터 보존, 노출만 seller_name 으로 수렴(스키마 변경 없음)\n-- [참고] 링크 보존: /partnerList 등 기존 라우트는 유지하거나 표준 경로로 redirect(앱/코드 레벨 처리)

화면 상세 — 세부 표·규칙

목록 외 품목표·모달·규칙 등 세부 화면

개념별 표준 용어 확정표(규칙)

개념	지금 섞여 쓰는 말	표준	비고
상품명 계층	그룹 상품명 · 유통사 상품명 · 노출명	그룹상품명(=노출명)	구조 확인 후 단일 표기
가격 용어	Net공급가 · net단가 · 공급가 · 단가	net(소문자) 통일	공급사 화면 net 미노출 · 면세/과세는 재무티켓
상품코드 3종	히어로/공급사/그룹	구분 유지	통일 아님(is_locked) · hero_code_mapping.type 구분
약어	MFC · DC · SoldTo	유지	살림
여/부 플래그	노출여부 · 사용여부 · 과세여부	유지	접미사·On/Off 스타일 현행

티켓 A/B 섹션의 확정 내용을 규칙표로 고정. '유지/구분' 항목은 교체 대상에서 제외됨을 명시.

엑셀 다운로드 제목줄 대응표

엑셀/화면	현행 제목줄	표준 제목줄	상태
공급사 목록.xlsx	유통사 ID	공급사 ID	미교체
공급사 목록.xlsx	파트너명	공급사명	미교체
주문 내역.xlsx	업장명(SoldTo)	식당명	교체완료

운영 수집 0순위 항목. 화면 라벨과 엑셀 제목줄을 반드시 1:1로 맞춤. 실제 제목줄은 운영 다운로드본을 수집해 채운다([가정] 일부 파일명 예시).