양돈 AI 통합 플랫폼 — 사용자 설명서

① 입력창 (맨 위) — 새 자료 넣기

1. 빈칸에 값을 입력합니다. (회색 안내문이 들어갈 내용을 알려줍니다)
2. 맨 아래 저장을 누르면 등록됩니다.

② 입력 자료 목록 (가운데) — 확인 · 수정 · 삭제

• 자동 표시 — 저장한 자료가 목록에 바로 나타납니다.
• 여닫기 — ▼ 목록 펼치기 / ▲ 목록 접기 버튼으로 목록을 열고 닫습니다.
• 검색 — 검색창에 개체번호·키워드를 넣고 조회.
• 수정 쉬워짐 — 고칠 줄의 수정을 누르면 위 입력창에 그 자료가 그대로 채워집니다. 값을 고치고 수정 저장. 잘못 눌렀으면 취소를 눌러 신규 입력으로 돌아갑니다.
• 삭제 농장장 — 삭제를 누르면 확인 후 지워집니다.
• 엑셀로 내보내기 — 엑셀 다운로드로 CSV 파일을 받습니다.

⚙ 고급 기능 (맨 아래, 접혀 있음) — 평소엔 안 열어도 됨

• 제목 ⚙ 고급 기능을 누르면 펼쳐집니다. 기본은 닫혀 있어 화면이 깔끔합니다.
• 여기에는 원시화일(엑셀·CSV) 일괄 업로드, AI 예측 같은 부가 기능이 들어 있습니다.
• 한 건씩 손으로 넣을 때는 열 필요가 없습니다. 많은 자료를 한꺼번에 올릴 때만 사용하세요.

로그인 방법

1. 웹 브라우저에서 프로그램 주소에 접속합니다.
2. 사업장(농장) 이름을 입력합니다. (예: demo-farm)
3. 아이디와 비밀번호를 입력합니다.
4. 회원 구분에서 본인의 역할(농장직원 / 농장장 / 시스템관리자)을 선택합니다.
5. 로그인을 누르거나 엔터키를 누릅니다.

주요 메뉴

• HOME (농장현황) — 오늘 할 일, 돈사 환경, 발정·분만 임박 알림을 한눈에
• 혈통/번식 관리 — 개체 등록, 종돈 도입, 혈통 조회, 번식돈 선발, 교배계획, 번식·분만 관리
• 사양/환경 관리 — 사료 등록, 성장 기록, 돈사 환경 모니터링·AI 제어, 법정 기록부
• HACCP/질병 관리 — HACCP 점검·인증, 질병·백신 기록
• 경영관리 — 도체 성적, 출하 정산, 경영비, 손익·수익 분석
• 업무캘린더 — 월간/주간/일간 업무 계획
• 설정/도움말 — 내 정보, 알림 설정, 사용법
• 검증 시스템관리자 — 회원 승인, 감사 로그

매일 확인할 사항

1. 로그인하면 자동으로 농장현황이 열립니다.
2. ⚡ 일상 빠른 입력에서 약품·사료·출입·소독 등 자주 쓰는 기록을 바로 입력할 수 있습니다.
3. 오늘의 일정에서 할 일(교배·분만 예정 등)을 확인합니다.
4. 사육현황·돈사 환경·장치 장애 알림을 점검하고, 이상이 있으면 해당 메뉴로 이동해 조치합니다.

개체 등록

1. 혈통/번식 관리 → 개체 등록.
2. 개체번호(끝 5자리는 숫자), 성별, 품종, 출생일을 입력합니다. 국가·농장번호는 자동으로 붙습니다.
3. 부(아비)·모(어미) 개체번호를 넣으면 혈통이 자동 연결됩니다.
4. 저장으로 등록을 완료합니다.

종돈 도입 — 외부에서 들여온 종자돼지 NEW

1. 혈통/번식 관리 → 종돈 도입. (농장 밖에서 들여오는 암·수 종돈 모두 여기서 관리)
2. 종돈 개체번호, 종돈명/품종, 성별(수컷/암컷), 공급처, 도입일, 일령을 입력하고 저장.
3. 저장하면 자동으로 농장 개체로 등록됩니다. 도입한 암컷 종돈은 곧바로 ‘번식돈 선발’ 대상이 됩니다.
4. 종돈 목록의 ‘등록개체’ 칸에서 어느 개체로 등록됐는지 확인할 수 있습니다.

번식돈 선발 농장장

1. 번식돈선발에서 선발 계산을 실행하면, 육종가(EBV) 기준으로 우수 개체가 정렬됩니다.
2. 예측등급(도체 EBV 백분위 1⁺/1/2/등외)으로 우수성을 미리 봅니다.
3. 개체번호를 누르면 번식 후보돈으로 담깁니다.
4. ‘보유번식돈 목록’에서 농장 내 개체와 외부 도입종돈을 함께 조회할 수 있습니다.

교배계획 수립 · 번식·분만 관리 농장장

1. 교배계획수립에서 🤖 후보돈으로 최적 교배 추천을 실행하면, 선발한 암·수만으로 근친을 피한 최적 교배가 계산됩니다. (전체 암퇘지에 일괄 배정하려면 🤖 AI 자동 추천)
2. 발정 기록이 있는 개체가 1순위로 배정 검토됩니다.
3. 번식관리에서 발정·교배·임신진단·이유를, 분만관리에서 분만을 기록합니다. 분만 시 자돈을 자동 생성할 수 있습니다.
4. 🔥 발정 탐지(번식관리)·🐖 분만 탐지(분만관리) 패널이 조치가 필요한 모돈을 자동으로 알려 줍니다. 행을 누르면 입력창에 모돈번호가 채워집니다.

사료 등록 · 성장 기록

1. 사양/환경 관리 → 사양관리 → 사료등록에서 사료코드·사료명·성장단계(포유/이유/육성/비육)와 영양성분을 입력·저장합니다.
2. 같은 사양관리의 성장기록에서 개체번호·측정일·생체중을 입력하면 일당증체량(ADG)이 자동 계산됩니다. (일령은 자동)
3. 잘못 입력한 측정값은 목록에서 수정 → 값을 고치고 수정 저장.

돈사 환경 모니터링

1. 환경 기록에서 온도·습도·가스 농도를 확인합니다. 게이트웨이 연결 시 자동 수집, 미연결 시 수동 입력합니다.
2. AI 환경제어에서 성장단계별 적정 온습도(포유 30~34℃, 이유 26~30℃, 육성 20~24℃, 비육 16~22℃)를 설정하면 기준 이탈 시 자동 제어됩니다.

법정 기록부 · 증빙 관리 농장장

1. 환경관리 → 📋 법정 기록부에서 분뇨·악취·시설기준 등을 작성합니다.
2. 증빙 파일(PDF·이미지·HWP·엑셀·워드, 최대 15MB)을 다중 첨부할 수 있습니다. (이미지는 자동 압축)
3. 본인 농가 자료만 조회·다운로드되며, 필요 시 기관으로 메일 송부할 수 있습니다.

HACCP 점검 · 인증 농장직원

1. HACCP/질병 관리 → 농장 HACCP 점검표에서 항목별 적합/부적합을 체크하고, 부적합은 시정조치를 기록합니다.
2. 약품·백신 사용 기록 시 휴약기간(출하가능일)이 자동 계산되어 잔류물질 위반을 막아 줍니다.
3. 저장 후 농장장에게 승인을 요청합니다. (HACCP 인증 신청·관리는 같은 탭에 있습니다)

질병 이벤트 기록

1. HACCP/질병 관리 → 질병/처치에서 개체번호·질병명·증상·치료내용·약품을 입력합니다.
2. HACCP/질병 관리 → 💉 백신접종에서 성장단계별 접종 프로그램과 📅 캘린더로 예정·지연 접종을 한눈에 확인합니다.
3. 잘못 입력한 기록은 목록에서 수정으로 손쉽게 고칠 수 있습니다.

도체 성적 입력

1. 경영관리 → 도체 입력에서 도체중(kg)·등지방(mm)·등심깊이(mm)를 입력합니다.
2. AI가 예상 육질등급·도체등급을 추천합니다. 실제 판정 결과를 골라 저장합니다.

경영비 · 손익/수익 분석

1. 경영비 입력에서 사료비·인건비·약품비 등 비용을 기록합니다.
2. 정산·비용 데이터가 쌓이면 경영분석에서 손익요약, AI 수익 예측, KPI 추세를 제공합니다.
3. 월별 비용·수익·이익 추세를 보며 경영을 개선합니다.

일정 등록과 관리

1. 업무캘린더에서 월간/주간/일간 보기를 전환합니다.
2. 날짜를 선택하고 업무 내용을 입력합니다. 오늘 일정은 농장현황(HOME)에도 표시됩니다.
3. 완료된 업무는 체크하여 진행 상태를 관리합니다.

AI 기능 목록

• AI 육종가 평가(BLUP) — 성장·도체·번식 형질의 유전가치를 평가
• AI 성장 예측 — Gompertz 곡선으로 출하 적기 예측
• AI 도체등급 예측 — 생체 데이터로 출하 시 등급 예측
• AI 도태 추천 — 유전가치·번식·건강·산차 종합 도태 순위
• AI 사료 효율/배합 — 사료별 ADG·FCR 비교, 최소비용 배합 설계
• AI 환경 제어(PID) — 정밀 온습도 자동 제어
• AI 수익 예측 · KPI 추세 · 종합 경영 자문 — 데이터를 종합한 경영 조언

내 정보 · 알림 설정

1. 설정/도움말 → 설정에서 이름·이메일·연락처를 확인·수정합니다.
2. 비밀번호 변경, 간편번호(PIN) 설정, 🔔 알림 설정(발정·분만·출하 등 알림 받기)을 관리합니다.
3. 데이터 관리(백업·내보내기) 같은 관리용 기능은 농장장 이상에게만 접이식으로 보입니다.

언어 변경

1. 화면 우측 상단의 언어 선택에서 원하는 언어를 고르면 즉시 전환됩니다.
2. 지원 언어: 한국어, English, 中文, Tiếng Việt, ไทย, ភាសាខ្មែរ, မြန်မာ, नेपाली

입력한 자료를 어떻게 고치나요?

• 목록에서 고칠 줄의 수정을 누르면 위 입력창에 자료가 채워집니다. 값을 고치고 수정 저장을 누르면 됩니다.
• 잘못 눌렀으면 취소로 신규 입력 상태로 돌아갑니다. 삭제는 농장장 이상 권한이 필요합니다.

도입한 종돈이 번식돈 선발에 안 보여요

• 종돈을 저장하면 자동으로 개체로 등록됩니다. 종돈 목록의 ‘등록개체’ 칸에 개체번호가 있으면 정상입니다.
• ‘보유번식돈 목록’에서 외부 도입종돈 필터로 확인할 수 있습니다.

로그인 / 저장이 안 됩니다

• 로그인: 회원 승인 완료 여부, 역할 선택, 비밀번호를 확인하세요.
• 저장: 인터넷 연결과 필수 항목(* 표시)을 확인하세요. 세션이 만료되면 다시 로그인합니다.

저장 버튼이 안 보여요 (환경 등)

• 일부 화면은 게이트웨이(자동 수집) 모드가 기본입니다. 손으로 입력하려면 입력방식을 ‘수동’으로 바꾸면 저장 버튼이 나타납니다.
• 수정 모드에서는 항상 수정 저장 버튼이 보입니다.

권한 부족 메시지가 나옵니다

• 삭제·승인·교배계획 등 일부 기능은 농장장 이상 권한이 필요합니다. 시스템관리자에게 권한 변경을 요청하세요.

일일

1. 농장현황에서 오늘 일정·환경·발정/분만 알림을 확인합니다.
2. 사료 급여·환경 데이터를 기록하고 HACCP 일일 점검을 체크합니다.
3. 분만·이유·질병 등 발생 이벤트를 당일 입력합니다.

주간 / 월간

1. 주간: 개체 체중 샘플(최소 20두) 측정, 번식돈 선발·교배계획 점검.
2. 월간: 도체 성적·경영비 정리, 손익/수익 분석 확인, 다음 달 캘린더 정비.

대처 순서

1. 웹 브라우저를 새로고침합니다.
2. 다시 로그인합니다.
3. 인터넷 연결을 확인합니다.
4. 계속되면 시스템관리자에게 연락합니다.

장치 장애 알림

• 센서 미수신: 5분 이상 데이터 없음 / 비정상값: 10분 내 3회 이상 / 제어 실패: 명령 후 3분 내 무응답.
• 장애가 해소되면 자동으로 상태가 업데이트됩니다.