水道事業の担当が浄水場・配水池・給水栓で手書きする毎日の水質の点検記録を読み取り、残留塩素・濁度・色度を台帳に転記して、基準や管理の目標を外れた値を拾う

処理の起点を決める

点検記録票の画像が保存フォルダに保存されたことを起点にします。 点検員は、その地点で書き終えたらすぐに撮ります。

1日1回、課に戻ってからまとめて撮る形にはしません。 地点で撮れば、連絡が漏れた異常値も、点検員が次の地点へ向かう間に担当へ届きます。 (c)の「土日の分は月曜に気づく」をなくすのが狙いです。

ファイル名には撮影の日時と地点の番号を入れます。処理が終わった画像は処理済みのフォルダへ移し、移すのは成功したときだけにします。 庁内のネットワークの区分によっては、画像を外部の API へ送れる端末が限られるので、フォルダを見張る処理を、外部へ接続してよい区分の端末に置きます。

入力データを集める

質を決めるのは、判定の値の一覧です。 法令の値は条文から写し、管理の目標は事業者が決めた値を写します。「ありうる値の範囲」は、桁の読み違いを拾うための値で、法令とは関係ありません。 遊離残留塩素が10mg/L を超えるような値は、測り方の誤りか読み違いとして扱います。

地点の種類を持つのは、法令の値が給水栓の値だからです。 浄水場の出口や配水池の値に、給水栓の0.1mg/L をそのまま当てると、判定の意味が変わります。地点ごとに、どの値で照らすかを一覧に書いておきます。

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

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

公式の説明では、text が認識されたテキストの唯一の元で、ほかの欄は startIndex と endIndex でその位置を指すとされています。セルの文字はこの位置から原文を引いて取り出し、小数点や「<」の記号を落とさずに持ちます。

臭気と味は、文字ではなくチェックボックスで読みます。 公式の説明では、チェックボックスはキーと値のペアとして返り、印の付いたものは filled_checkbox、付いていないものは unfilled_checkbox になるとされています。「異常なし」と「異常あり」の両方に印が無い、または両方に印があるときは、記入漏れか書き損じとして扱います。

値の空いた欄には気を配ります。 公式の説明では、値の空いたキーと値のペアは確実には読めないとされています。上の欄の「点検者」が空いていると、欄ごと返ってこないことがあり、返ってこなかったことを「空」と同じに扱って印を付けます。

AIへ渡す前に整形する

1. 画像の向きと傾き … タブレットで斜めに撮った画像を、紙の四隅で補正します
2. 解像度 … 公式の説明では、スキャンは最低200dpi、300dpi以上で一般に最良の結果とされています。小数点を拾うには、なるべく大きく撮ります
3. ファイルの形式と大きさ … JPEG か PNG で保存し、オンラインの処理の要求の上限の40MBと、画像の40メガピクセルの上限に収めます
4. 地点の確認 … ファイル名の地点の番号と、上の欄の地点の名前を照らします
5. 重複の検知 … 同じ地点・同じ日で二度撮ったものは、新しいほうだけを使います。再採水した日は、時刻の違う2枚として両方を残します
6. 記号の扱いの準備 … 「<」「＜」「未満」「以下」「ND」などの書き方を一覧にしておきます。ここでは置き換えず、変換の段で使います

2番目を軽く見ないでください。 小数点は紙の上でいちばん小さな印です。解像度が足りずに消えた小数点は、「0.35」を「035」に変え、それが35として扱われる経路になります。

5番目で再採水を残すのは、異常のときの記録だからです。 残留塩素が低く、時間を置いて測り直した日は、最初の値も測り直した値も、どちらも記録として要ります。

AIに処理させる

生成AIにさせるのは3つだけです。 表の行を水質の項目に対応づけること、値をセルの文字のまま写すこと、備考を分類することです。

数値への変換と判定は、プログラムの側で行います。

2行目がいちばん起きやすい失敗です。 「<0.1」を数値にしてと言われれば、生成AIは0.1か0を返します。0.1として扱えば濁度は基準内に見え、0として扱えば「定量できなかった」という事実が消えます。 どちらも台帳の上では正しそうに見えます。

指示内容を固定する

あなたは町の上下水道課で、毎日の水質の点検記録票の読み取り結果を
表の形にそろえる係です。
OCRが返した表と上の欄だけを見てください。推測で埋めないでください。

【項目】
free_chlorine（遊離残留塩素 mg/L）、turbidity（濁度 度）、color（色度 度）、
water_temp（水温）、ph（pH）、hypochlorite_stock（次亜塩素酸ナトリウムの貯留量）

【厳守事項】
- 各行がどの項目に当たるかを row_map に書いてください。
  決められない行は unknown にしてください。
- 値は、セルの文字をそのまま value_raw に写してください。
  小数点、「<」「＜」「未満」「以下」「ND」などの記号や語も、書かれたとおりに写してください。
- 「.35」のように小数点の前の0が無くても、0を補わないでください。
- 「未満」や「<」の付いた値を、数値に置き換えないでください。
- 読めない文字は空にし、unreadable_cells に入れてください。
  前日の値やありそうな値で埋めないでください。
- 空いているセルは空のまま写してください。空いている理由を書かないでください。
- 基準を満たしているか、水質が良いか悪いかを書かないでください。
- 備考は原文を note_text に写し、resample（再採水）、construction（配管の工事）、
  rain（降雨）、equipment（設備の不具合）、other のどれかに分けてください。

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

「0を補わない」を明記しているのは、生成AIが親切に表記を整えるからです。 「.35」は「0.35」に、「<0.1」は「0.1未満」に、何も言わなければ書き直します。直した結果が正しくても、元の書き方が残らなければ、後で紙と見比べたときにどこを直したのかが分かりません。 表記の整え方は、プログラムの決まりとして1か所にまとめます。

出力形式を固定する

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

{
  "image_id": "",
  "header": {
    "site_name": "",
    "date": "",
    "sampling_time": "",
    "weather": "",
    "inspector": ""
  },
  "row_map": [
    { "row_index": 0, "field": "free_chlorine | turbidity | color | water_temp | ph | hypochlorite_stock | unknown" }
  ],
  "values": [
    { "field": "", "value_raw": "" }
  ],
  "note": { "note_text": "", "note_type": "resample | construction | rain | equipment | other | none" },
  "unreadable_cells": [ { "row_index": 0 } ]
}

値を value_raw という文字列で受けるのは、変換の決まりを1か所に置くためです。 Python の側で、value_raw を次の4つに分けます。

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

後段の照合は、変換した値に対して決まりで行います。

4行目と5行目だけを、すぐの通知にします。 管理の目標を外れた値まで通知にすると、通知が多すぎて、法令の値を下回った通知が埋もれます。

システムへ連携する

台帳の確定のシートへは、人が確定した値だけを書き込みます。 自動で書くのは下書きのシートまでです。法令で保存が求められる記録の元を、読み取りの結果のまま確定させないためです。

通知の文面には、値を文字のまま入れます。 「0.05」を「0.1未満」と言い換えたりせず、点検記録票に書かれた文字と、画像へのリンクを並べます。 受け取った担当が、まず画像で読み違いでないかを確かめられるようにします。

人が確認する

人が見るのは、印の付いた欄と、通知の届いた値です。

1. 通知の届いた値を先に見る … 画像で読み違いでないかを確かめ、点検員から連絡があったかを確かめます。連絡が無かったなら、点検員に状況を聞き、課の手順で対応します
2. 桁の疑いを確かめる … 小数点の有無を画像で見て直します
3. 記入漏れを確かめる … 点検員に、測ったかを聞きます。測っていなかったなら、その日は測れなかったことを記録します
4. 管理の目標を外れた値を見る … 備考と前後の日の値を見て、係長に上げるかを決めます
5. 台帳の下書きを確定する … 印の無い記録票は一覧で流し見て確定します

1番目で「連絡があったか」を確かめるのが、この構成を入れる意味の半分です。 読み取りで拾った異常値のうち、点検員からの連絡が無かったものは、手順のどこかに穴があるということです。

4番目で前後の日の値を見るのは、1日だけの外れと続く外れを分けるためです。 降雨や配管の工事の備考がある日の濁度の上がりと、理由の書かれていない上がりでは、係長に上げる急ぎ方が違います。

目標は、360件をならして1件2分です。 印の無い記録票は数十秒、通知の届いた値や記入漏れは点検員に確かめるので数分かかります。

例外に対処する

2行目と3行目は、この題材に固有の例外です。 どちらも値の大きさや向きを逆にする誤りで、推測で直すと、法令の値の判定そのものが反対になります。

5行目の「記録票が来ない」は、読み取りの誤りより重く扱います。 1日1回以上の検査が求められている項目で、1地点の1日分が欠ければ、その日の記録そのものが欠けます。 毎日決まった時刻に、地点の一覧と届いた記録票を突き合わせ、未着の地点を担当に知らせます。撮り忘れなのか、点検できなかったのかは、点検員に聞いて記録に残します。

記録を残す

• 点検記録票の画像と、撮影の日時・地点の番号
• OCR が返した Document の全文（text、formFields、tables、チェックボックス、信頼度）
• 生成AIの出力（行の対応づけ、写した文字、備考の分類）
• 文字から数値への変換の記録 … 「.35」を0.35にした、「<0.1」を未満とした、など
• 照合の結果と、そのとき使った判定の値の一覧の版
• 通知を送った日時と宛先、点検員からの連絡の有無
• 人が直した記録と、確定した日時と人

4つ目の変換の記録は、紙と台帳を見比べるときの手がかりです。 法律が求める記録の保存は5年間で、その間に台帳の値と紙の書き方が違って見えても、どう変換したかが分かります。

判定の値の一覧の版を残すのは、管理の目標が見直されるためです。 目標を変えたあとに過去の印を見直すとき、当時の目標が分からないと判断できません。