養鶏場が鶏舎ごとの手書きの集卵・へい死・給餌の記録を読み取り、日ごと・鶏舎ごとの集計表を作る

処理の起点を決める

18時30分の定時に、共有フォルダの新着を見に行くことを起点にします。 動かすのは、事務所の PC のタスクの予約の機能です。

時刻は、翌日の日報の印刷に間に合うように決めます。 夕方の見回りと集卵が終わり、日報がそろう時刻の後で、事務の担当が帰る前に「読み取りの確認」を直せる時刻にします。直した後に、翌日の日報の印刷用のファイルを作り直すボタン（もう一度動かすための小さな手順）を用意しておきます。

8枚がそろわないうちは、翌日の日報を作りません。 1棟でも欠けると、その鶏舎の21日の平均が1日分ずれます。欠けた鶏舎は「日報が届いていない」として一覧の先頭に出し、 事務の担当が鶏舎に取りに行きます。

入力データを集める

質を決めるのは、群の台帳の「除く日」の列です。 空舎の日や設備の故障の日を付け忘れると、その日のへい死が21日の平均に入り、翌日以降の目安の羽数がずれます。 付けるのは農場長で、付けた理由を備考に書きます。

集卵の数は、トレーの数と端数で書いてもらいます。 1トレーの個数を決めておき、プログラムがトレーの数×個数＋端数で個数に直します。 個数を直接書くより、桁の多い数字を手で書く回数が減ります。

データの取得方法を決める

Python のプログラムから、公式のライブラリ google-cloud-documentai で Form Parser を呼びます。 プロセッサの名前と文書を渡して process_document を呼ぶと、ページごとのキーと値（formFields）が返ります。

キーと値を列に直す処理は、次のような流れです。

doc = client.process_document(
    request=documentai_v1.ProcessRequest(name=PROCESSOR_NAME, raw_document=raw)).document

def text_of(layout):
    return "".join(doc.text[s.start_index:s.end_index]
                   for s in layout.text_anchor.text_segments).strip()

row, low = {}, []
for page in doc.pages:
    for f in page.form_fields:
        col = LABEL_MAP.get(text_of(f.field_name))      # 見出しの対応表で列を決める
        if col is None:
            continue
        if f.value_type in ("filled_checkbox", "unfilled_checkbox"):
            row[col] = (f.value_type == "filled_checkbox")
        else:
            row[col] = text_of(f.field_value)
        if f.field_value.confidence < THRESHOLD:
            low.append(col)

missing = [c for c in REQUIRED_COLUMNS if c not in row]  # 取れなかった列＝書き忘れの疑い

最後の行の missing が、記録の欠けを拾う場所です。 取れなかった列を0で埋めず、そのまま「読み取りの確認」に渡します。

ラベルの文字は、見出しの対応表で列に直します。 「へい死（羽）」が「へい死（羽」や「へいし」と読まれても、対応表に読み違えやすい表記を足しておけば同じ列に入ります。キーと値の様式では、表のように列の位置で決められないため、対応表が読み取りの要になります。

取れなかったラベルは、そのまま「読み取りの確認」に出します。 公式の説明では、Form Parser は値の空いたキーと値のペアを確実には取り出せないとされています。へい死の欄が空欄だと、ラベルごと結果から消えることがあります。 次の前処理の「0も書く」が、ここに効きます。

AIへ渡す前に整形する

1. 「0も書く」決まり … へい死・淘汰・破卵・汚卵が0のときも「0」と書きます。空欄は書き忘れとして扱います
2. 様式の改訂 … 欄を太い枠で区切り、ラベルを枠の左に置きます。ラベルと値の並びが毎回同じになるようにします
3. チェック欄は「あり」「なし」の2つ … どちらか一方に印を付けます。ラジオボタンのような丸い選択の欄は、Form Parser のチェック欄の読み取りが対応しないため、四角いチェック欄にします
4. 目安の羽数の欄 … 日報の上に、前の日の夕方に印刷する「すぐ知らせる羽数の目安」の欄を作ります。印刷の文字は読み取りの対象から外し、 集計にはプログラムが計算した値を使います
5. スキャンの設定 … 公式の説明では、スキャンは200 dpi 以上、300 dpi 以上で最もよい結果になります。複合機を300 dpi にそろえます
6. ファイルの形式 … 以前の JPEG の圧縮方式の TIFF は使えないため、保存形式を PDF にします
7. 日報の汚れ … 鶏舎の前室で書く場所を決め、日報を板に挟んでおきます。衛生管理区域から持ち出す物の扱いは、農場の決まりに従います

1番目の「0も書く」が、この構成でいちばん効きます。 空欄が書き忘れと決まれば、記録の欠けを読み取りの段階で拾えます。 へい死が0の日を記録に残すことは、21日の平均を正しく出すことにもつながります。

AIに処理させる

Form Parser にさせるのは、キーと値とチェック欄を読み取り、信頼度を付けることだけです。 計算と比較は、Python の決まった規則で行います。

21日の平均は、群の台帳の「除く日」を除いて、通算21日で数えます。 防疫指針の数え方に合わせ、空舎の日と特段の事情のあった日を飛ばして、さかのぼって21日分を集めます。5羽以上のまとまった死亡は、防疫指針の留意事項に出てくる目安で、農場長が家畜保健衛生所と取り決めた目安があれば、そちらを使います。

数え方の例を挙げます。 鶏舎3で、10月の5日から7日まで給餌の機器の故障があり、農場長が台帳に「除く日（設備の故障）」を付けていたとします。10月28日の平均を出すとき、さかのぼる21日間に故障の3日が入るため、その3日を飛ばして、さらに3日さかのぼった通算21日で計算します。故障の日のへい死の増え方が平均を押し上げ、翌日の目安の羽数が高くなりすぎることを防ぎます。

させないことも決めておきます。

3行目がいちばん起きやすい失敗です。 空欄を0として計算すると、集計表はきれいにそろいますが、その日の本当のへい死が分からなくなります。 空欄の日は、鶏舎の担当に確かめてから値を入れます。

指示内容を固定する

この構成には生成AIへのプロンプトがありません。AIへの指示にあたるのは、見出しの対応表と、Python の計算の規則です。

【見出しの対応表（読み違えやすい表記も並べる）】
house_no ....... 鶏舎 / 鶏舎番号 / 鶏舎No
date ........... 日付 / 月日
egg_tray ....... 集卵(トレー) / 集卵トレー
egg_rest ....... 端数 / 集卵端数
broken ......... 破卵 / 破卵数
dirty .......... 汚卵 / 汚卵数
dead ........... へい死 / へい死(羽 / へいし / 死亡
culled ......... 淘汰 / 淘汰(羽
feed_kg ........ 給餌 / 給餌量 / 給餌(kg
temp_max ....... 最高 / 最高温度
temp_min ....... 最低 / 最低温度
water_alarm .... 給水異常（チェック）
abnormal ....... 異状（チェック）と 異状の内容

【計算の規則（Python）】
1. 取れなかった列、数字として読めない値、信頼度の低い値は「読み取りの確認」。0 で埋めない
2. 集卵の個数 ＝ egg_tray × 1トレーの個数 ＋ egg_rest
3. 飼養羽数 ＝ 群の台帳の前日の羽数 − dead − culled（読み取りの確認が残る鶏舎は計算を保留）
4. 産卵率 ＝ 集卵の個数 ÷ 前日の飼養羽数 × 100
5. へい死率 ＝ dead ÷ 前日の飼養羽数 × 100
6. 21日の平均 ＝ 群の台帳の「除く日」を除き、さかのぼって通算21日のへい死率の平均
7. 当日のへい死率が21日の平均の2倍以上、または dead が5以上なら「へい死の増え方」
8. 翌日の目安の羽数 ＝ 21日の平均 × 2 × 当日の飼養羽数 を切り上げ、5 と比べて小さいほう
9. 特定症状に当たるか、通報するかは書かない

8番の目安の羽数を「小さいほう」にするのは、知らせ漏れを避けるためです。 21日の平均の2倍と、まとまった死亡の5羽のどちらか早く届くほうを、鶏舎の担当の目安にします。

3番で「計算を保留」にするのは、 読み違いのまま飼養羽数を引き継ぐと、翌日以降の産卵率もへい死率もずれていくからです。

出力形式を固定する

集計表は、日ごと・鶏舎ごとに1行です。

翌日の日報には、目安の羽数をこう印刷します。

鶏舎 3   日付 10/29   日齢 412日   前日の飼養羽数 14,820羽
【すぐ知らせる羽数の目安】 へい死 4羽以上（21日平均 1.9羽／日 → 2倍 3.8羽 → 切り上げ 4羽）
  ※ 目安より少なくても、まとまって死んでいる・元気がない・とさかの色が悪いなど
    いつもと違うときは、すぐ農場長に電話する

目安の羽数の横に、計算の元を書いています。 鶏舎の担当が目安の意味を知っていると、目安に届かなくても、いつもと違うと感じたときに知らせやすくなります。 目安は、知らせる判断を絞るためではなく、迷ったときの背中を押すためのものです。

この例では、21日平均の2倍から出した4羽が5羽より小さいので、 規則の8番に沿って目安は4羽です。印刷の文面には、プログラムが計算した値をそのまま入れ、手で書き直しません。

システムへ連携する

群の台帳に書き足すのは、読み取りの確認が残っていない鶏舎の飼養羽数だけです。 除く日や備考の列には書き込みません。台帳の書き換えは、農場長の手に残します。

人が確認する

1. 「日報が届いていない」を見る … 事務の担当が鶏舎に取りに行きます
2. 「読み取りの確認」を見る … 事務の担当が日報と見比べて直します。空欄は、鶏舎の担当に確かめてから値を入れます
3. 「へい死の増え方」を見る … 農場長が、その日に鶏舎の担当から連絡があったか、鶏舎の様子を見たかを確かめます。連絡が無かったなら、すぐに鶏舎を見に行きます
4. 「異状の記載」を見る … 内容を読み、必要なら獣医師に相談します
5. 群の台帳の「除く日」を付ける … 空舎の日や設備の故障の日を、理由とともに付けます

3番目を省かないでください。 夕方の一覧は、その場の連絡が漏れていなかったかを確かめる二重の網です。連絡があった鶏舎は記録を残すだけで済み、無かった鶏舎は、この一覧が最初の気づきになります。

目標は、240枚をならして1枚2分です。 「読み取りの確認」になる日報が2割前後という想定で、それより多い鶏舎は、日報の汚れか書き方を見直します。

例外に対処する

最後の行は、目安の羽数を空にしないためです。 読み取りが止まっても、前の日の目安を「前日の値」と書いて印刷すれば、鶏舎の担当がその場で見比べる手順は途切れません。

記録を残す

• 日報のスキャンと紙の原本
• Document AI が返した結果の JSON と、プロセッサの版
• 集計表と、事務の担当が直した値の記録（どの列を、何から何に直したか）
• 群の台帳の「除く日」と、その理由
• 印刷した翌日の日報の目安の羽数と、その計算の元
• 「へい死の増え方」に出た日と、その日の連絡の有無・農場長の対応

飼養衛生管理基準では、飼養する家きんの羽数、日齢、異状の有無と症状などの記録を作り、少なくとも1年間保存することが求められています。集計表と日報の原本は、この記録の一部になります。 保存の期間は1年を下限に、農場の決まりで決めます。