사용가이드

3분 안에 흐름 잡기 — 자세한 글 버전은 docs/사용가이드.md

결과물은 참고용 1차 스크리닝 자료 — 최종 판단과 법적 책임은 영업자에게 있음.

작업 흐름

1원료 확인·등록 쓸 원료가 마스터에 있는지. 없으면 간단 등록(자동 ⚠미검증) 원료 마스터
2제품 등록 유형·내용량·배합비(합계 100%)·제조원. 영양은 모르면 비움 + 새 제품 등록
3리포트 확인 표시사항 초안 + 등급별 판정. FAIL부터 해결 리포트 생성 클릭
4시험성적서 입력 성적서가 나오면 test_results 값 추가 → 규격 자동 판정 data/products/*.json
5재실행·확정 목록에서 재실행. FAIL 0 + CHECK 소거 후 라벨 확정 목록 → 재실행

등급 읽는 법

FAIL 규정 위반 확실→ 라벨 확정 전 반드시 수정
WARN 위반 가능성 높음→ 확인 후 수정 또는 소명
CHECK 시스템 판단 불가 — 사람 몫→ 항목별 확인 (미검증 규정 포함)
PASS 통과→ 참고만

모든 판정에 근거 조항 + 고시 버전이 붙습니다. 리포트 맨 아래 적용 규정 버전을 확인하세요.

리포트 구조

리포트 — 제품명
① 등급 요약 카드 (FAIL n / WARN n / CHECK n / PASS n)
② 표시사항 초안 — 주표시면 (제품명·내용량·열량)
③ 표시사항 초안 — 정보표시면 (원재료명·알레르기·주의사항·효소함량…)
④ 스크리닝 결과 표 (등급·규칙·내용·근거)
⑤ 미검증 플래그 (사람 확인 목록)
⑥ 적용 규정 버전

자동으로 되는 것 / 사람이 할 것

  • ✅ 원재료명 함량순 배열·복합원재료 괄호 표기 (5% 룰)
  • ✅ 알레르기 추출·표시란, 혼입 문구, 당알코올 주의문구
  • ✅ 영양 반올림·%기준치, 공전 규격 판정
  • ✅ 원산지 후보 산출 (98%/3순위, 당류·첨가물 제외)
  • 👤 식품유형 결정 (품목제조보고 기준 — 시스템은 판정 안 함)
  • 👤 CHECK 항목 소거 (원산지 품목 여부, 분리배출 도안, 글자 크기)
  • 👤 영양 분석값·시험성적서 확보

영양성분 입력

분석값·계산값 있다? 예 → 그 값을 입력 — 라벨에 그대로 사용
없다? → 비워두면 시스템이 임의 추정값 제시 (원료 데이터 × 배합비) — 라벨 사용 불가, 출시 전 공인기관 분석으로 확정

시험성적서 입력

성적서가 나오면 data/products/제품명.json에 추가하고 목록에서 재실행:

"test_results": {
  "수분": 8.2,            ← 수치 항목: 숫자 그대로
  "조단백질": 11.5,
  "대장균": "적합",        ← 미생물: 적합/부적합
  "타르색소": "불검출",    ← 색소: 불검출/검출
  "알파아밀라아제": 1620   ← 효소: 라벨 표시량과 자동 교차 비교
}

미입력 항목은 리포트에 "시험 필요" 체크리스트로 나옵니다 — 그대로 시험 의뢰 목록으로 쓰세요. 유형별 기준치·출처는 유형별 기준규격 페이지.

자주 나는 오류

메시지해결
배합비 합계가 100±0.5% 벗어남배합비 % 합계 확인
미지원 유형지원 6유형 외 — 의도된 중단 (어설픈 결과 금지)
원료 마스터에 없는 ID원료 마스터에서 먼저 등록
웹 포트 충돌python3 -m label_pilot web --port 8766