S01 — 기준정보(Master Data)
학습 목표
- 기준정보가 왜 ERP 품질의 80%를 결정하는지 설명한다.
- 코드 정규화·중복 방지·입력 검증을 구현한다.
- 거래 이력이 있는 데이터는 삭제하지 않고 비활성화(soft delete)한다.
1. 핵심 개념
- 코드(Key):
MASK-KF94,SUP-HANBIT같은 사람이 읽는 업무 키. DB의id(대리키)와 구분합니다. 코드는 대문자·공백제거로 정규화해mask-kf94와MASK-KF94가 같은 품목이 되게 합니다. - 과세구분: 같은 상품이라도 과세(10%)/면세가 다르면 세금계산서와 분개가 달라집니다. 기준정보에 있어야 거래마다 실수하지 않습니다.
- 거래처 구분: 공급사(SUPPLIER) / 고객(CUSTOMER) / 양방향(BOTH). 약국에 발주를 내는 실수를 시스템이 막아야 합니다.
- 사업자등록번호 체크섬: 10자리 중 마지막 자리는 검증번호입니다. 오타의 대부분을 입력 순간에 잡습니다.
- Soft delete: 이미 발주·출고에 쓰인 품목을 DELETE하면 과거 전표가 깨집니다.
active=0으로만 바꾸고, 재고가 남아 있으면 그것도 막습니다.
2. 체크섬 알고리즘
번호: d1 d2 d3 d4 d5 d6 d7 d8 d9 d10
가중치: 1 3 7 1 3 7 1 3 5
합계 = Σ(di × wi, i=1..9) + (d9 × 5) // 10
검증번호 = (10 − 합계 % 10) % 10 → d10 과 같아야 함예: 123-45-67891 은 유효, 123-45-67890 은 무효.
3. LAB (workspace/erp/master.py)
| 함수 | 요점 |
|---|---|
validate_biz_no | 하이픈 제거, 10자리 숫자, 체크섬 |
create_item | sku 정규화, 이름 필수, 단가 0 이상 정수, 과세구분, 중복 금지 |
create_partner | 코드 정규화, 구분 검증, 사업자번호(선택) 검증 후 숫자만 저장 |
deactivate_item | 없으면 오류, 재고 남으면 오류, 아니면 active=0 |
모든 오류는 ErpError로. 검증은 INSERT 전에 끝내세요. 저장은 with transaction(conn): 안에서. 금액은 왜 정수(원)일까요? 0.1 + 0.2 != 0.3 — ERP에서 float 금액은 금지입니다.
4. 채점
python academy.py check S015. 실무 연결
도매 쇼핑몰의 상품코드·약국 거래처 정보가 바로 이 기준정보입니다. 약국명·약사·연락처는 필수 운영 데이터이므로 보관하되 노출을 통제해야 합니다(→ S06 권한).
6. 심화 과제
- 품목에
barcode(GTIN-13) 컬럼과 체크디지트 검증을 추가하세요. - 거래처 정보 변경 이력 테이블(
partner_history)을 만들어 "언제 누가 무엇을 바꿨는지" 남겨 보세요.