酒蔵がタンクごとに手書きするもろみの経過簿を読み取り、品温・ボーメ・日本酒度・アルコール分を日ごとの表にそろえて、記入漏れと急な変化を拾う

処理の起点を決める

経過簿の画像がフォルダに保存されたことを起点にします。 撮るのは朝と夕の2回で、蔵人が品温を書いたあとにタブレットで各タンクの経過簿を撮ります。

撮影は、タンクの番号の札が経過簿と一緒に写る位置で行います。タンクの番号は経過簿の上の欄にも書かれていますが、紙の取り違え（隣のタンクの板に挟んだ）に気づくため、札の番号と上の欄の番号を突き合わせます。

1日1回まとめて動かす形にはしません。撮った順に読み取っておけば、製造担当が確認を始めるときには、全タンクの表がそろっています。 (a)の夕方の集中をなくすのが狙いです。ファイル名には撮影の日時とタブレットの番号を入れ、処理が終わったものは処理済みのフォルダへ移します。移すのは成功したときだけにします。

入力データを集める

質を決めるのは、測定の予定と変化の幅です。 (b)の書き忘れは、予定が無いと「測らない日」と区別できません。急な変化も、幅を決めなければ毎日どこかに印が付きます。どちらも、杜氏が頭の中で持っている基準を最初に一覧にするところから始めます。

確定済みの行は、値だけでなく元の文字も持ちます。 「5.2」と確定した欄が、翌日の画像で「5.8」と読めたなら、それは書き直しの可能性があります。値だけを持っていると、元の文字との違いが読み違いなのか書き直しなのかを比べられません。

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

読み取りは、Python から Form Parser のプロセッサを呼ぶだけです。返ってくる Document から、表と上の欄と信頼度を取り出します。

公式の説明では、text が認識されたテキストの唯一の元で、ほかの欄は startIndex と endIndex でその位置を指すとされています。表のセルの文字は、この位置から原文を引いて取り出します。 表は headerRows と bodyRows に分かれ、Form Parser の表の抽出は行や列をまたぐセルの無い表だけを認識するため、rowSpan と colSpan は常に1とされています。

セルの文字と信頼度は、行と列の並びのまま持っておきます。

def cell_text(document, cell):
    # セルの layout.text_anchor が指す範囲を document.text から切り出す
    return "".join(
        document.text[int(s.start_index):int(s.end_index)]
        for s in cell.layout.text_anchor.text_segments
    ).strip()

rows = []
for page in document.pages:
    for table in page.tables:
        for r in table.body_rows:
            rows.append([(cell_text(document, c), c.layout.confidence) for c in r.cells])

行の並びは、紙の上から下の順で返ってくる前提にしません。 日付の欄の文字で並べ直し、日付が読めない行は、もろみの日数の欄で補います。どちらも読めない行は、確認の要る行に回します。

仕込みの計画表は、毎朝の書き出しを読みます。タンクの照合は、仕込みの記号と順号で行います。 タンクの番号だけで引くと、上槽して次のもろみを仕込んだタンクで、前のもろみの経過と混ざります。

AIへ渡す前に整形する

1. 画像の向きと傾き … タブレットで斜めに撮った画像を、紙の四隅で補正します
2. 解像度 … 公式の説明では、スキャンは最低200dpi、300dpi以上で一般に最良の結果とされています。撮影の解像度はこれに相当する大きさにします
3. ファイルの形式と大きさ … JPEG か PNG で保存します。オンラインの処理の要求は1ファイル40MBまでです
4. 札の番号の読み取り … 画像の端に写ったタンクの番号の札を読み、経過簿の上の欄の番号と突き合わせます
5. 重複の検知 … 同じタンク・同じ朝夕で二度撮ったものは、新しい方だけを使います
6. 記号の置き換えの準備 … 「▲」「−」「ー」「〃」を、後段で決まりどおりに扱えるよう、元の文字のまま残します

2番目を軽く見ないでください。 ボーメの小数点と日本酒度の符号は、小さな点と短い線です。解像度が足りずに消えた点は、書かれていないのか、読めなかったのかの区別がつきません。

6番目で置き換えをしないのは、意図してのことです。 「〃」を前日の値に置き換えるのはプログラムの決まりで行い、置き換えたことを記録に残します。 OCRの段階で置き換えると、後で紙と見比べたときに、どの値が「〃」だったのかが分からなくなります。

AIに処理させる

生成AIにさせるのは3つだけです。 表の列を経過の項目に対応づけること、行ごとの値をセルの文字のまま写すこと、備考の手書きのメモを操作の種類に分けて写すことです。

数字の扱いと判定は、プログラムの側で行います。

1行目がいちばん起きやすい失敗です。 夕の品温の欄が空いていると、朝の品温や前日の夕の値から埋めたくなります。埋めた瞬間、書き忘れという事実が消え、(b)を拾う仕組みそのものが働かなくなります。

指示内容を固定する

あなたは酒蔵の製造部で、もろみの経過簿の読み取り結果を表の形にそろえる担当です。
OCRが返した表と上の欄だけを見てください。推測で埋めないでください。

【経過の項目】
date（日付）、day（もろみの日数）、temp_am（品温・朝）、temp_pm（品温・夕）、
room_temp（室温）、baume（ボーメ）、smv（日本酒度）、alcohol（アルコール分）、
acidity（酸度）、amino（アミノ酸度）、note（備考）

【厳守事項】
- 各列がどの項目に当たるかを column_map に書いてください。
  決められない列は unknown にしてください。
- 行ごとに、セルの文字をそのまま写してください。
  数字を計算しないでください。小数点や桁を補わないでください。
- 「▲」「−」「＋」などの記号は、書かれたとおりに写してください。
  符号を推測して付けたり外したりしないでください。
- 「〃」は「〃」のまま写してください。前の行の値に置き換えないでください。
- 読めないセルは空にし、そのセルを unreadable_cells に入れてください。
  前の行の値、朝の値、ありそうな値で埋めないでください。
- 空いているセルは空のまま写してください。空いている理由を書かないでください。
- 備考は原文を note_text に写し、書かれた操作を
  heat（加温）、cool（冷却）、kai（櫂入れ）、water（追い水）、other のどれかに分けてください。
  分けられないものは other にしてください。
- もろみの状態の良し悪し、温度の操作の要否は書かないでください。

【OCRの表】{tables}
【上の欄】{form_fields}

「空いているセルの理由を書かない」を明記しているのは、生成AIが親切に理由を補うからです。 何も言わなければ「この日は測定日ではないため空欄」と書き添えます。測定日かどうかは測定の予定で決めることで、生成AIが表の外の知識で決めることではありません。

「〃」を文字のまま写させるのも同じ理由です。 置き換えを生成AIにさせると、前の行のどの値を引いたのかが記録に残りません。

出力形式を固定する

次の形のJSONで受け取ります。

{
  "image_id": "",
  "captured_at": "",
  "header": {
    "brew_code": "",
    "brew_seq": "",
    "tank_no": "",
    "tome_date": ""
  },
  "column_map": [
    { "column_index": 0, "field": "date | day | temp_am | temp_pm | room_temp | baume | smv | alcohol | acidity | amino | note | unknown" }
  ],
  "rows": [
    { "row_index": 0, "date": "", "day": "", "temp_am": "", "temp_pm": "",
      "room_temp": "", "baume": "", "smv": "", "alcohol": "",
      "acidity": "", "amino": "", "note_text": "", "note_type": "heat | cool | kai | water | other | none" }
  ],
  "unreadable_cells": [
    { "row_index": 0, "field": "" }
  ]
}

数字の欄を文字列で受けるのは、意図してのことです。 数値の型で受けると、「▲3」や「〃」や「5.」のような文字が、どこかで数値に丸められます。文字のまま受け、プログラムで数字として読めるかを確かめてから数値にします。

Claude の構造化出力は、output_config.format に JSON スキーマを渡して有効にし、オブジェクトには additionalProperties: false が必要とされています。 数値の minimum・maximum や文字列の minLength・maxLength は対応していないとされているので、値の範囲の確認はプログラムで行います。

後段の照合は、この出力に対して決まりで行います。

3行目で値を変えないのが要点です。 書き直しが正しい訂正なのか、別の日の値を誤って書いたのかは、紙を見ても分からないことがあります。確かめるまでは確定済みの値を残し、新しい文字は「書き直しの候補」として並べます。

システムへ連携する

経過の表へ書き込むのは、人が確かめた値だけです。 確認の要る欄の無い行は、製造担当が一覧で流し見て「確定」を押した時点で書き込みます。生成AIの出力を、そのまま表に流し込む経路は作りません。

酒税の帳簿とは、つなぎません。上槽の近いもろみについて、帳簿に要る値の一覧を帳簿の担当に渡すところまでにします。 帳簿の様式と記載のしかたは、所轄の税務署の指導に従っている蔵ごとの運用があるためです。

人が確認する

人が見るのは、印の付いた欄と行だけです。

1. 紙の取り違えを先に見る … 札の番号と上の欄が合わない画像は、ほかの照合の前に止めます
2. 記入漏れを確かめる … 予定の日に空いている欄を、その日の担当の蔵人に確かめます。測っていれば書き足してもらい、測っていなければ測れなかったことを記録します
3. 数字の欄を確かめる … 信頼度の低い欄、符号・小数点の読めない欄を、画像と並べて直します
4. 書き直しを確かめる … 確定済みの行の文字が変わったものは、書いた蔵人に理由を聞き、どちらの値を残すかを決めます
5. 急な変化を杜氏に回す … 印の付いたタンクを一覧にし、杜氏がタンクを見に行くかを決めます

2番目は、その日のうちに行います。 夕の撮影のあとすぐに一覧ができるので、書き忘れに気づくのが翌日になる(b)が、当日の夕方に変わります。 書いた本人がまだ蔵にいるうちに確かめられます。

5番目で杜氏が見るのは、表の上の数字だけではありません。 構成が出すのは「幅を超えた」という印までで、タンクの香りや泡の様子を見て判断するのは杜氏です。

目標は、720件をならして1件1分です。 印の無い行は一覧で流し見て数秒、記入漏れや書き直しの印の付いた行は蔵人に確かめるので数分かかります。

例外に対処する

上の3行が大半を占めます。 どれもAIの精度の問題というより、蔵の中の湿気と、タンクの脇で書く紙の性質の問題です。 濃い鉛筆に替える、経過簿をクリアファイルに入れるほうが、指示を直すより効きます。

記録を残す

• 経過簿の画像と、撮影の日時・朝夕の別・タブレットの番号
• OCR が返した Document の全文（text、formFields、tables、信頼度）
• 生成AIの出力（列の対応づけ、行の値、備考の分類）
• 照合の結果（取り違え・記入漏れ・数字の読み取り・前日との差・書き直し）
• 人が直した欄の記録 … どのタンクの、どの日の、どの欄を、何から何に直したか、誰が確かめたか
• 書き直しの記録 … 確定済みの値、新しい文字、どちらを残したか、理由
• 「〃」を置き換えた欄と、引いた元の値

書き直しの記録は、後で経過を振り返るときの手がかりになります。 上槽のあとに酒の出来を振り返るとき、どの値が当日に書かれ、どの値が後から直されたかが分かれば、経過の読み方が変わります。

記入漏れの記録が多い項目は、測定の予定を見直す材料になります。 同じ日数の同じ項目が毎回空くなら、予定が現場の作業の流れと合っていない可能性があります。