🐄 한우농장 AI 통합 플랫폼

v0.3.0 · Phase 0 · env=production
API(Swagger) · 개발자 · health

🧭 메인탭 메뉴 (각 탭에서 하는 일·볼 데이터 · 클릭 → 이동)

🏠 홈 ▾
  • 농가 현황과 오늘의 우선조치를 한눈에 확인합니다.
  • 핵심지표(KPI)·경보·다가오는 일정을 요약합니다.
📅 오늘의 일정 ▾
  • 업무 캘린더에 일정을 등록하고 상세를 관리합니다.
  • 분만·백신·발정·법정기록 예정을 날짜별로 확인합니다.
🧬 혈통·EBV ▾
  • 개체 등록·목록·4세대 혈통도를 관리합니다.
  • EBV(추정육종가) 농장분포와 전국 백분위를 확인합니다.
🐄 번식·분만 ▾
  • 발정·수정·분만 이벤트와 암소 번식주기를 관리합니다.
  • 보증씨수소(KPN) 추천·송아지·초유·분만 예측을 지원합니다.
🌾 사양 (TMR-LP) ▾
  • 사양단계별 원료단가 편집과 LP 최적배합을 산출합니다.
  • ADG(일당증체량) 실측을 NIAS 표준과 비교합니다.
💉 HACCP·질병 ▾
  • 백신·치료를 등록하고 예정을 관리합니다.
  • 휴약기간→출하가능일 계산과 질병 조기경보를 제공합니다.
🏚️ 축사환경관리 ▾
  • 우사 구역과 환경 IoT 경보를 관리합니다.
  • 시설 컴플라이언스 12개 의무점검을 확인합니다.
⚖️ 출하관리 ▾
  • 출하·등급을 예측하고 경락가(KAPE)·소매가(KAMIS)를 조회합니다.
  • 영상 비접촉 측정(체중·근내지방도·체형)을 지원합니다.
🤖 AI 컨설팅 ▾
  • 한국어 AI 상담과 우선순위 인사이트를 제공합니다.
  • 농가간 익명 벤치마킹·지식베이스 검색을 지원합니다.
🌱 통합 AI·탄소 ▾
  • 탄소발자국과 deepGBLUP EBV 상태를 확인합니다.
  • 영상모델·AI 엔진 상태를 점검합니다.
⚙️ 설정/도움말 ▾
  • 비밀번호 변경과 개인정보(이메일·연락처)를 수정합니다.
  • 이용 설명서로 사용법·계정 관리를 확인합니다.

🏠 우리농장 현황 — 오늘 할 일 한눈에

🔔 오늘의 우선조치 (중요도 순 · 클릭 → 해당 관리로 이동)

농가 ID 입력 후 조회하면 표시됩니다.

📅 다가오는 일정 (분만·백신·발정·법정기록 · 클릭 → 일정 탭)

농가 ID 입력 후 조회하면 표시됩니다.

📤 데이터 업로드 (축평원 등급판정결과 파일 · 자기 농가 ID로 받은 파일 그대로)

출하관리에서 상세 →
ekapepia 로그인 → 등급판정확인 조회 → 엑셀/CSV 저장 후 업로드. 한글 헤더·복합등급(예 2B)·중복 자동 처리. 필수: 개체식별번호·도축일자.

📅 오늘의 일정 — 업무 캘린더

업무 캘린더

📝 수기 업무 외에 ★ 분만·백신·발정·임신감정·법정기록 자동일정이 함께 표시됩니다(읽기전용). 날짜를 클릭하면 상세 조회·수정할 수 있습니다.

농가 ID 입력 후 조회

업무 등록

일자 상세 업무

캘린더에서 날짜를 클릭하면 해당 일자의 전체 내용을 확인할 수 있습니다.

날짜 미선택

다가오는 일정 (D-day 순 · 클릭 → 해당 관리)

전체
🐄 분만
💉 백신
💉 백신프로그램
🐂 발정
🔬 임신감정
📋 법정기록
농가 ID 입력 후 조회

🧬 개체·혈통관리 — 우수 혈통 → 생산성 최상위

보유 개체 목록

신규 개체 등록

💡 MTRACE 12자리 입력 후 "자동조회" 클릭 → 국가 소 이력추적시스템에서 출생일·성별·혈통 자동 채움 (Phase 8 mock, 실 API URL은 .env로 주입).

혈통도 (4세대)

개체 목록에서 행을 클릭하면 혈통도가 표시됩니다.

EBV 농장 분포 + 전국 백분위

🏅 육질·육량 유전 선발지수 (개체별 전국 100분위 합성 · 우수 혈통 확보·유지 의사결정)

농가 조회 후 표시됩니다.

유전평가 · 보존/도태 우선순위 (EBV·자손 실측 도체·번식성적·근친 통합 · 보존점수 순 · 참고자료)

농가 조회 후 표시됩니다.

후대검정 — 부모별 자손 도체 실측 (실측 자손성적 역집계 → 부모 유전평가 · 표본수 n 병기)

자손의 실제 도체등급(출하성적)을 부모(암소·KPN)별로 모아 유전적 능력을 평가합니다. 표본수(자손 n)가 작으면 신뢰도가 낮으니 EBV·ssGBLUP과 함께 판단하세요.

농가 조회 후 표시됩니다.

📐 선형심사 (체형 19형질 → 외모 100점) (KAIA 방식 · 1~9점 · 우량 암80/수82점 · 우수 혈통 확보·유지)

🐄 번식·분만 관리 (발정→수정→임신→분만→포유→송아지 lifecycle 통합)

번식 이벤트 등록

🎯 우리농장 개량목표 (설정하면 아래 모든 교배추천에 자동 적용)

교배 배정 추천 (보유 암소 × 보증씨수소)

📋 확정 교배계획 (추천 → 계획 확정 → 교배 실행·다운로드 · 우수 혈통 확보 산출물)

위 "교배 배정 추천" 또는 "보증씨수소 추천"에서 계획 담기를 누르면 확정 교배계획이 여기에 쌓입니다.

보증씨수소 추천 (암소별) (근친 F<0.0625 허용 + 후대 EBV 최대 · 클릭 → 계획 담기)

보증씨수소 카탈로그 업로드 (NIAS 반기 육종가 → 추천에 반영)

│
NIAS 「한우교배계획길라잡이」 엑셀(xlsx)을 변환 없이 그대로 올리면 한글 헤더(KPN번호·도체중·근내지방도·등심단면적·등지방두께·정확도)를 자동 인식합니다.
· 갱신: 반기(2월·8월, 국가단위 유전능력평가 반영) · 소스: NIAS 누리집 연구활동→농가활용프로그램 (또는 농사로 포털)
· CSV 직접 작성 시 헤더: kpn_id, name, price_per_dose, marbling_score, carcass_weight, eye_muscle_area, backfat_thickness, accuracy

번식 lifecycle 진행 (암소별)

번식 성적 (수태율·분만율·수정회당수태)

발정 후보 (캘린더 예측 + 센서융합, P0)

도태 · 유지 판단 (번식성적 rule + 자손 도체 경제가치)

🍼 분만·포유·송아지 관리 (번식 lifecycle 후반 — 분만→초유→육성)

송아지 기록 등록

7일 내 분만 예정

초유 미수행 (골든타임 6h 경과)

12개월 폐사 트렌드

센서 기반 분만 정밀예측 (24h/6h, Tier1 규칙기반)

🌾 사양관리 — 자가배합 사료 (사료비 절감)

🥣 간편 자가배합 (원터치) (농가용 · 단계·체중만 입력 → 표준 배합비 자동 산출 · 실급여량 kg · 배합비 다운로드)

💡 버튼 한 번이면 이 단계에 맞는 최소비용 표준 배합비가 자동으로 나옵니다. 보유하지 않은 원료는 체크 해제 후 "보유 원료만 다시 만들기"를 누르면 그 원료를 빼고 다시 계산합니다.
단계·체중을 고르고 "표준 배합비 만들기"를 누르세요.
🔬 전문가용 — 원료단가·비율 직접 편집 + LP 최적화 (선택)

1) 사양 단계 선택

💡 체중 입력 시 건물섭취량(DMI)을 자동 산정, 목표증체 입력 시 CP·TDN을 보정합니다. LP는 NIAS 사양표준 요구량 + 조사료:농후사료 비율·NDF 상한을 충족하는 최소비용 배합을 산출합니다.

2) 원료 단가 (편집 가능 — 원/kg)

상단의 "원료 목록 불러오기" 클릭

3) LP 최적 배합 결과

"최적 배합 계산" 결과가 여기에 표시됩니다.

저장된 배합 (급여표) (계산 → 저장 → 급여표 인쇄)

저장된 배합 없음

4) 규모별(두수) 비용 비교 (선택 단계 · 30/100/500두)

5) ADG(일당증체량) 실측 vs NIAS 4차 표준 편차 (농가 전체)

"ADG 편차 조회" 클릭 시 개체별 실측 ADG vs 표준 편차가 표시됩니다.

📈 Gompertz 성장예측 (체중 시계열 → 목표체중 도달 예상일)

💉 HACCP · 질병관리

📋 일일 위생점검일지 (매일 기록 — 축산물HACCP 자가점검)



백신·치료 등록

30일 백신·치료 예정

💉 백신 프로그램 (성장단계·번식주기 표준 스케줄 → 개체별 자동 예정)

법정 의무 · 2026자율전환 · 자율(권장) · ⚠ 생독 백신은 임신우 접종 금기(사독만).

📋 표준 백신 스케줄 — 성장단계별

로딩…

📋 표준 백신 스케줄 — 번식주기별 (번식우 대상)

로딩…

🐄 우리 농가 개체별 예정

농가 ID 입력 후 조회

개체별 휴약기간 → 출하 가능일 · 질병·투약 이력

질병 조기경보 (24~72h, multi-modal 이상탐지)

📝 HACCP 12절차 마법사 (준비 5절차 + 원칙1~7)

⚠️ 위해요소 분석표 (원칙1 · 심각도×발생빈도 = 유의성)

🎯 CCP 결정·정의 (원칙2~7 · 한계기준·모니터링·개선·검증)

HACCP 자가점검표 (분기별)



🏅 HACCP 한우 인증기준 자가점검 (선행요건 + CCP)

🏅 HACCP 인증 신청·유지관리 (KAHACCP, 유효 3년)

🔎 개선조치 후보 (4출처 통합) (CCP이탈·일일일지·자체평가·방역경보 → 미해결 부적합 자동수렴)

🛠️ 개선조치(CAPA) 대장 (이탈·부적합 발생 시 시정·재발방지)

🏚️ 시설·환경관리 — IoT + 열스트레스(THI) 감시

24h 환경 시계열 (IoT 데이터 미연결 시 빈 차트)

우사 구역 등록 / 목록

활성 환경 경보

시설환경 컴플라이언스 (12개 의무)

🖧 게이트웨이·장치 관리 (IP 스캔·자동매핑·장애·제어)

🏛️ 축사·환경 법정 기록부 (가축분뇨법·악취방지법·축산법·건축법 등 — 신고·기록·보고 이행 + 증빙 첨부)

법령별 관리항목을 펼쳐 수행 기록을 입력하고 증빙 파일(PDF·이미지·엑셀 등)을 첨부하세요. 기록은 보존기간 동안 관리되며 목록 조회·CSV 다운로드·프린트가 가능합니다.

⚖️ 출하관리 — 영상 비접촉 + 등급·가격 예측

개체 출하 예측

🥩 도체등급판정성적 (KAPE 등급판정 · 예측 vs 실측 피드백)

① 직접 입력

② 성적 업로드 (KAPE 파일 / 온라인)

│
CSV 헤더: individual_id, slaughter_date, grade_meat, grade_yield, carcass_weight_kg, bms, backfat_mm, ribeye_area_cm2, auction_price_per_kg

③ 축평원(ekapepia) 등급판정결과 파일 업로드 (자기 농가 ID로 받은 파일 그대로)

ekapepia 로그인 → 등급판정확인 조회 → 엑셀/CSV 저장 후 업로드. 한글 헤더·복합등급(예 2B)·중복 자동 처리. 필수 컬럼: 개체식별번호·도축일자 (개체+도축일 중복은 자동 스킵).

📈 예측 정확도 분석 (출하 예측 등급 vs 도체 실측)

📊 도체 12개월 시계열 (두수·도체중·경락가·고급육률)

🔄 KAPE 폐루프 — 씨수소별 선발 피드백 (실측 도체등급 → 고급육률 → 재사용/도태)

실시간 경락가 (KAPE) · 소매가 (KAMIS)

출하 시나리오 시뮬레이션

영상 비접촉 측정 (RealSense / RGB)

출하 게이트 카메라·모바일에서 체중/체형(BCS)/근내지방을 자동 측정합니다 · Phase 9 예정.

🤖 경영분석 · AI 컨설팅 — AI 학습형 자문 (RAG 진화학습)

🧠 AI 종합자문 (전 도메인 집계 → 긴급·개선·우수 실행권고)

농가 조회 후 표시됩니다.

💰 경영비 입력 (항목별·기간별, 농진청 생산비조사 항목)

📥 CSV 일괄 업로드 (여러 달·항목 한 번에)
헤더: 기간,항목,금액,메모 · 기간=YYYY 또는 YYYY-MM · 항목=코드(feed…) 또는 한글(사료비…) · 예: 2026-07,사료비,1500000,7월

📊 경영 분석 (두당 생산비·소득·수익률)

기간 입력 후 분석

📈 비용 분석 대시보드 (연도 월별 추이 + 유형별 비중)


연도 입력 후 분석

🧾 출하 정산서 (경락대금 − 공제[도축·등급판정·운송·상장수수료] = 순수취액)


※ 공제 표준값(도축 45,000 · 등급판정 6,000 · 운송 30,000원/두 · 상장 2%)은 참고값(도축장·공판장별 상이) — 실값은 설정 후 반영 예정.
기간 입력 후 정산 조회 (도체 실측 데이터 필요)

🧬 씨수소(혈통)별 수익성 (어느 혈통이 돈이 되나 · 유전개량 폐루프 피드백 → 우수 혈통 확대·저수익 혈통 도태)


출하·정산 실측 후 표시됩니다 (개체에 부 KPN 연결 필요).

💬 AI 농가 컨설턴트 (지식베이스 근거 질의응답)

빠른 질문: 분만간격이 길어졌어 · 사료비 절감 · 혈통 개량 · 럼피스킨 정책

🚦 우선순위 인사이트 (이번 주 주의 사항)

🌐 농가간 익명 비교 (연합학습 기반 벤치마킹 — 농가 식별정보 없이 집계)

📚 지식베이스 검색 (사양표준·정책·전염병)

🌱 통합 최첨단 AI — 진화학습 + 탄소중립

Concept Drift 모니터 (원칙 12 — 분기별 PSI/KL)

탄소발자국 (연간)

deepGBLUP 한국형 EBV 상태

영상 모델 (체중·BMS·BCS·BRD)

LLM·임베딩 상태 (RAG 컨설팅 엔진)

⚙️ 설정 / 도움말

🔑 비밀번호 변경

👤 개인정보 수정

로그인 아이디: - · 권한: -

🔔 알림 설정 (아침 브리핑 시각 · 채널 · 최소 심각도)

분만·백신·발정·거세/첫종부/출하 적기 등 오늘 할 일을 매일 정한 시각에 한 번 보내드립니다. 농장 일과에 맞는 시각으로 바꾸세요.

🗂 데이터 관리센터 (우리농장 데이터 CSV/ZIP 내보내기 · 백업)

내보낼 모듈을 선택하고 ZIP 다운로드를 누르면 선택 데이터가 CSV로 묶여 저장됩니다(우리농장 범위).
법정기록 일괄제출 — 기록부 CSV + 증빙파일 + (선택)분기보고서 PDF를 ZIP으로 묶습니다.

📖 이용 설명서

■ 시작하기

  • 상단 농가 ID 입력 → 조회 — 우리농장 데이터가 전 탭에 채워집니다.
  • 실서비스에서는 로그인 토큰이 필요합니다(개발 모드는 자동 통과).

■ 탭 구성 (상단 메뉴바 = 홈의 「메인탭 바로가기」와 동일 순서)

  • 홈 — 핵심지표(KPI) · 오늘의 우선조치 · 다가오는 일정 · 탭 바로가기
  • 오늘의 일정 — 업무 캘린더(분만·백신·발정·법정기록 자동일정 병합)
  • 혈통·EBV — 개체 등록·목록 · 4세대 혈통도 · EBV 전국 백분위
  • 번식·분만 — 발정·수정·분만 · 보증씨수소(KPN) 추천 · 송아지·초유·분만 예측
  • 사양(TMR-LP) — 원료단가 · LP 최적배합 · ADG 실측 vs 표준
  • HACCP·질병 — 백신·치료 · 휴약기간→출하가능일 · 질병 조기경보
  • 축사환경관리 — 우사 구역 · 환경 IoT 경보 · 컴플라이언스 12항
  • 출하관리 — 출하·등급 예측 · 경락가·소매가 · 영상 비접촉 측정
  • AI 컨설팅 — 한국어 RAG 상담 · 벤치마킹 · 지식베이스 검색
  • 통합 AI·탄소 — 탄소발자국 · deepGBLUP · 영상모델 · RAG 엔진 상태
  • 설정/도움말 — 계정 관리 · 데이터 백업 · 이용 설명서

■ 자주 쓰는 흐름

  • 탭 이름 옆 ▾ 클릭 → 세부화면(서브탭) 바로 이동.
  • 목록 화면의 📥 엑셀(CSV) 다운로드로 데이터 반출.
  • 홈 오늘의 우선조치 클릭 → 해당 관리 탭으로 딥링크.
  • 이 탭의 데이터 관리센터 — 모듈 선택 ZIP·💾 전체 백업으로 우리농장 데이터 일괄 보관.
  • 📋 법정기록 일괄제출(ZIP) — 기록부 CSV+증빙, 연도·분기 선택 시 분기보고서 PDF 포함.
  • 📄 분기보고서 PDF — 연도·분기 지정 후 단독 다운로드.

■ 문의

  • 계정 발급·권한 변경은 관리자(superadmin)에게 요청하세요.
  • 버전: 화면 우상단 표기(예: v0.3.0). 오류 시 버전과 함께 문의.