# -*- coding: utf-8 -*-
"""第7回 PDF「確認事項（第7回）」の自己点検。
原稿 (docs/handoff/TeamWorks確認事項_第7回_20260910.md) の文言が
すべて PDF に含まれているか、フォントが日本語フォントで埋め込まれているかを見る。
PDF のパスは第1引数で渡せる。省略時はこのスクリプトと同じディレクトリ。
check_teamworks_qa6_pdf.py（第6回用）と同じ構成。
★2026-09-10 の改訂に追随済み★
1. 旧第4部（ダンプ元サーバが MariaDB）は削除された。旧5→4、旧6→5。
MariaDB 関連は第1部 1-4（謝意と当方の対応状況）だけを検査する。
2. 第3部の依頼は A-2 / A-3b / B-2 / B-3b の4件のみ。
B-1（外部キー／索引）と A-1（主キー）の取り下げは 1-5 で検査する。
3. 質問は3件。サマリ表・おわりにの優先順表も3件に追随している。
★must に「ページを跨ぐ語」を入れないこと★
抽出テキストにフッター（D-Watch / DFA Robotics とページ番号）が挟まり、
空白を詰めても一致しません。第3回で bigint auto_increment が実際に引っかかりました。
★4 の検査があっても、表の列幅崩れの目視確認は省かないこと★
4 は「識別子が行の途中で割れていないか」を抽出テキストで見るだけで、
枠のはみ出し・改ページ位置・重なりは見られません（pdf/README.md）。
"""
import os
import re
import sys
from pypdf import PdfReader
PDF = (sys.argv[1] if len(sys.argv) > 1 else
os.path.join(os.path.dirname(os.path.abspath(__file__)),
"DWatch_確認事項_第7回_20260910.pdf"))
if not os.path.exists(PDF):
raise SystemExit("PDF が見つからない: %s\n"
"先に make_teamworks_qa7_pdf.py を実行するか、"
"PDF のパスを第1引数で渡すこと。" % PDF)
raw = open(PDF, "rb").read()
reader = PdfReader(PDF)
pages = [p.extract_text() for p in reader.pages]
text = "\n".join(pages)
flat = re.sub(r"\s+", "", text)
print("== 1. ページ数とサイズ ==")
print("ページ数:", len(reader.pages), " サイズ:", len(raw), "bytes",
"(%.1f KB)" % (len(raw) / 1024))
print("抽出文字数:", len(text))
print("\n== 2. フォント埋め込み ==")
print("/FontFile2 出現回数:", raw.count(b"/FontFile2"))
biz = sorted(set(re.findall(rb"/([A-Z]{6}\+[A-Za-z0-9\-]*BIZ[A-Za-z0-9\-]*)", raw)))
print("BIZUDGothic を含むフォント名:", biz)
if not biz:
print(" ★NG★ BIZ UDGothic が埋め込まれていない")
# 中国語向けフォントが混ざっていないこと（CLAUDE.md §0-3）
CN = [b"SimSun", b"SimHei", b"MicrosoftYaHei", b"MSYaHei",
b"NotoSansSC", b"NotoSerifSC", b"SourceHanSansSC", b"SourceHanSerifSC"]
hit = [n.decode() for n in CN if n in raw]
print("中国語向けフォント:", hit if hit else "混入なし")
if hit:
print(" ★NG★ 中国語向けフォントが混ざっている")
print("\n== 3. 原稿の全項目が含まれるか ==")
must = [
# 表題・前文
"確認事項（第7回）", "TeamWorks（DB開発側）",
"作成日:2026-09-10", "DFARobotics",
"最新のDDL（clean_watch_20260909.sql）をお送りいただき",
"ありがとうございました",
"2026-09-09受領。第6回でお願いしていた項目です",
"率のカラムを小数第一位まで持つ形（double(4,1)）に変更いただき",
"当方からお願いしていた内容が、そのまま反映されておりました",
"これで当方の判定処理が正しく行えるようになります（詳細は第1部）",
"本書は次の5部構成です",
"今回は、お伺いすることを3件に絞りました",
"接続先/DDLの未反映4件/precheckの値域",
"お伺いする件数が少ないほど、早くお返事をいただけると考えたためです",
"第1部と第5部は当方からの共有ですので、回答は不要です",
# 前文の表（5部構成）
"1.照合結果のご共有", "いただいたDDLを当日中に照合しました",
"MariaDBの件と、依頼2件の取り下げもこちらです", "回答不要",
"2.接続先", "（ホスト名・ポート）",
"第6回からの継続。あとはこれだけです", "最優先",
"3.DDLの未反映項目", "（4件）",
"採番・桁数・DEFAULT・索引の食い違いです", "お手すきの折に",
"4.precheckに入る", "値の範囲",
"反映時期と既存データの扱い", "中",
"5.面積の型変更について", "共有のみ。質問はありません",
# 1. 照合結果
"1.照合結果のご共有（回答不要です）",
"第6回で", "受領しましたら、その日のうちに照合してご報告します",
"とお約束していた件です",
"2026-09-09に受領し、当日中に照合を完了しました",
# 1-1
"1-1.照合方法",
"ローカルのMySQLに読み込み、09-07版・09-02版と",
"information_schemaで機械的に差分を取りました",
"目視ではなく、列名・型の両方を双方向で突き合わせています",
# 1-2
"1-2.率のカラムが小数第一位になっていました（13列）",
"変更前", "変更後",
"tinyintunsigned（整数）", "double(4,1)", "（小数第一位）",
"対象は", "13列", "です",
"テーブル", "列",
"customer_summaries/", "facility_summaries",
"operation_ratio/launch_ratio/", "clean_ratio/error_ratio（各4列）",
"clean_status_histories/", "clean_statuses/", "clean_task_reports/",
"robots/", "section_robot_statuses", "clean_ratio（各1列）",
"これで当方の判定が正しく行えるようになりました",
"当方は清掃完了率から4段階（◎○△×）の判定を行っており",
"その境界値は90.0/90.1/70.0/70.1/10.0/9.9と、すべて小数第一位までです",
"整数で格納されていると",
"例えば89.6%が90に丸められて格納され",
"本来「○」であるべきものが「◎」になってしまう",
"という問題がありました",
"今回の変更で、この問題は解消しました",
# 1-3
"1-3.テーブル・列の増減はありませんでした",
"CREATETABLEは39で、09-07版・09-02版と同数です",
"テーブル名の集合も完全に一致しました",
"列の増減もありません",
"今回の変更は型（と一部のDEFAULT）だけでした",
"なお、面積のカラムもdecimalからdoubleに変わっておりましたので",
"この点だけ第5部で申し添えます",
"当方に実害はありません",
# 1-4 MariaDB（質問ではなく謝意と対応状況）
"1-4.本番がMariaDBであることをお教えいただき",
"本書をお送りする前に、本番サーバがMariaDBであることを",
"お教えいただきました。ありがとうございます",
"09-09版のダンプヘッダが5.5.5-10.11.13-MariaDB-logに",
"なっており、09-07版までのMySQL8.0.41と異なっておりましたので",
"お伺いしようとしていた件です",
"先にご回答いただけましたので、本書からは質問を取り下げました",
"当方の対応状況を申し添えます",
"アプリの実装に生のSQLは1件もありません",
"すべてPrismaのクエリビルダ経由ですので",
"現時点で対応が必要な箇所はありません",
"DBクライアントのドライバも、すでにMariaDB用のもの",
"（@prisma/adapter-mariadb）を使っております",
"どうしてもMariaDB特有のDMLを使いたい場合は",
"その箇所をお知らせください」とのご指示、承知しました",
"その必要が生じた際にご連絡します",
"なお、", "当方のローカルの検証環境はMySQLです", "ので",
"今後もし生のSQLを書く場合は、",
"MySQLとMariaDBの双方で通る書き方に注意いたします",
# 1-5 B-1 / A-1 の取り下げ
"1-5.これまでお願いしていた2件（外部キー／索引・主キー）を、",
"今回の依頼から外します",
"第5回・第6回でお願いしておりました",
"B-1（clean_timetable_idの外部キー／索引）",
"A-1（robot_error_reportsの主キー）",
"当方の実装が固まり、いずれも当方側で支障が無いことが",
"はっきりしました",
"今回の依頼から外させてください",
"B-1（clean_timetable_idの外部キー・索引）",
"当方は、これらのテーブルを全件取得し、",
"アプリ側で突き合わせる実装にしました",
"clean_timetables/clean_status_histories/",
"robot_error_reportsを、それぞれ",
"WHERE句なしの全件取得", "で読み出しています",
"読み出したあと、clean_timetable_idをキーにした対応表を",
"メモリ上に作り、そこで結合しています",
"つまり、clean_timetable_idで「検索」をしておりません",
"索引はWHERE句で絞り込むときに効くものですので、",
"この実装では使われません",
"この実装はすでに完成しており、外部キーが無いまま",
"清掃ログの画面が動いております",
"どの索引が必要かは、実際のクエリの形と、",
"実データの量・分布で決まります",
"当方はまだ実データを1行も見ておらず、",
"絞り込みのクエリも書いておりません",
"この状態で特定の索引を名指しでお願いするのは、",
"当方の根拠が薄いと考え直しました",
"したがって、現時点で支障はありません",
"将来クエリの形が変わって索引が必要になりましたら、",
"その時点で具体的なクエリを添えて、",
"あらためてご相談します",
"過去の確認書では外部キーの追加をお願いしておりましたが",
"当方の実装方針が定まった結果、当方の見立てが変わりました",
"お手数をおかけしました",
"A-1（robot_error_reportsの主キー）",
"error_idを識別子として使う方針は第4回のご回答でいただいており",
"当方はその前提で実装しております",
"主キーが無くても当方の実装は動いております",
"error_idにUNIQUEがありますので、一意性は担保されています",
"当方の実装で支障が無い以上、",
"DDLの変更をお願いする根拠がありませんので",
"こちらも依頼から外します",
# 2. 接続先
"をお教えいただけますでしょうか—最優先",
"第6回でもお願いした件で、恐れ入りますが繰り返しになります",
"参照用アカウントは2026-09-08にいただいておりますので",
"あとは接続先だけです",
"接続先のホスト名（またはIPアドレス）と、ポート番号",
"をお教えいただければ接続できます",
"あわせて確認させてください",
"接続元IPの制限はありますか",
"ある場合、", "当方の接続元をお伝えします", "のでお知らせください",
"SSL/TLS接続は必須でしょうか",
"証明書の受け渡し方法", "もお教えください",
"接続先はステージング環境でしょうか、本番環境でしょうか",
"当方の扱い（参照のみ/負荷のかけ方）を合わせたいためです",
"なぜ急いでお願いしているか",
"9月中にPPIH様向けにデモを実施する可能性があります",
"実データでお見せできるかどうかが、この接続情報で決まります",
# 2. 準備状況
"当方の準備状況",
"接続情報さえいただければ、すぐに使える状態になっております",
"済んでいること",
"いただいたDDLからローカルにDBを作成し、実DDLと列レベルで完全一致させました",
"差分0件を機械的に確認済み",
"prismadbpullでスキーマを取り込み済みです",
"今回の23列の型変更も反映済み",
"施設マスタ・スケジュール・D-Secログ・D-Secアラート・"
"清掃詳細ログの5画面が、",
"そのローカルDB経由で動くところまで実装済みです",
"接続先をいただければ、接続文字列を差し替えるだけです",
"また第6回でお伝えしたとおり、接続でき次第",
"error_typeの値の分布・robots.statusの実出現値",
"週次サマリのweekの値域など",
"当方で数えられるものは当方で確認します",
"その分だけ貴社への照会が減ります",
# 3. 未反映項目（4件）
"3.DDLの未反映項目（4件）を、",
"お手すきの折にご対応いただけますでしょうか",
"お忙しいところ恐縮です。3回目のお願いになります",
"第5回・第6回でお願いしていた項目のうち",
"4項目が09-09版でも未反映でした",
"今回のDDLは率と面積の型変更が主眼だったかと存じますので",
"これらは単に今回のスコープに入っていなかっただけかと思っております",
"状況だけ共有させてください",
"お願いしていた内容", "09-09版の実測",
"A-2", "履歴テーブルのidを", "AUTO_INCREMENTで採番",
"clean_status_histories.id/", "clean_timetable_histories.idとも",
"bigint(20)unsignedNOTNULL。", "AUTO_INCREMENT無し",
"A-3b", "facility_contacts.emailを", "varchar(100)に",
"varchar(255)DEFAULTNULLのまま",
"（contact_typeはtinyint(3)unsigned", "で反映済みです）",
"B-2", "robot_task_versions.clean_schedule_id", "にインデックス",
"KEYは", "robot_task_versions_robot_id_foreign", "（robot_id）のみ",
"clean_schedule_idのインデックスは0件",
"B-3b", "security_status_histories.reported_at", "にDEFAULT",
"timestampNOTNULL、", "DEFAULTなしのまま",
# 3-1
"3-1.この4件は、当方の設計上のお願いではなく、具体的なズレです",
"1-5で取り下げた2件（外部キー／索引・主キー）は",
"「DBの設計をどうするか」という判断を伴うお願い", "でした",
"当方の実装方針が固まり、必要がなくなりましたので",
"取り下げました",
"一方、この4件は性質が違います",
"いずれも、採番・桁数・DEFAULT・索引の有無という、",
"具体的で機械的な食い違いです",
"食い違いの中身", "補足",
"採番の仕組み", "idにAUTO_INCREMENTが無く、",
"誰が採番するのかが決まっていない状態", "です",
"桁数", "「emailはvarchar(100)とします」と",
"ご回答いただいた桁数が、", "varchar(255)のままです",
"索引の有無", "定義書でfkと記載されている列",
"ですが、", "実DDLには外部キーも索引もありません",
"DEFAULTの有無", "timestampNOTNULLに", "DEFAULT句がありません",
"いずれも「どちらが正なのか」が当方には判断できない箇所です",
"意図的なものでしたら、",
"その旨だけお知らせいただければ結構です",
# 3-2
"3-2.お手すきの折で結構です",
"いずれも当方の開発を止めておりません",
"お手すきの折に、まとめてご対応いただければ十分です",
"急かす意図はありません", "状況が分かれば大丈夫です",
"次回まとまった段階でDDLをいただければ、"
"同じように当日中に照合してご報告します",
# 4. precheck
"clean_timetables.precheckに入る値の範囲をお教えいただけますでしょうか",
"4-1.現状の理解",
"clean_timetables.precheckは現行",
"tinyintunsigned/既定値0", "です（09-09版でも変化なし）",
"DFA側で「0=本清掃/60=60分前/30=30分前」のように",
"分前の数値をそのまま入れる方向でご検討いただいている",
"と伺っております",
"設定値によっては", "20なら20分前", "のように",
"任意の分数が入りうるとも伺っております",
"4-2.お伺いしたいこと",
"この理解で合っていますでしょうか",
"いつ頃反映される見込みでしょうか",
"既存のデータはどうなりますでしょうか",
"1/2のまま残るのか、60/30に更新されるのか",
"新旧の値が混在する期間はありますでしょうか",
"0以外に予約値はありますでしょうか",
"特に4番をお伺いしたいです",
"混在すると、当方は1を「1分前」と読み違えてしまうためです",
"値だけを見て新旧を判別する方法がありませんので",
"期間が分かれば当方で切り替え時期を合わせられます",
"4-3.なぜお伺いするか",
"アラート画面で「60分前の異常」「30分前の異常」を出し分けるのに",
"この値を使います",
"値の意味を取り違えると、現場への連絡タイミングの判断を誤ります",
"「30分前のチェックで異常が出た」のか「60分前で出た」のかによって",
"現場に間に合うかどうかが変わるためです",
"DDLからは値の意味が読めませんでした",
"カラムコメントが空のため",
"型はtinyintunsigned（0〜255）ですので",
"60も30も20も、型の変更なしで入ります",
"つまり", "値の意味の変更はDDLには現れません", "ので、お伺いする次第です",
# 5. 面積（共有のみ）
"5.面積のカラムの型変更について（共有のみ。回答は不要です）",
"これは要望でも質問でもなく、事実の共有だけです",
"5-1.実測",
"09-09版で、面積のカラムも型が変わっておりました（", "10列", "）。",
"decimal(12,6)unsigned",
"double(12,6)", "（customer_summaries/", "facility_summariesはdouble(14,6)）",
"task_area/clean_area",
"5-2.当方に実害はありません",
"この変更で当方が困ることはありません",
"理由は2つです", "理由",
"viewerに面積を表示する箇所は1つもありません",
"画面に出るのは%だけです",
"面積は完了率の計算材料としてのみ使う想定でしたが、"
"率を小数でいただけるようになったため、"
"当方で計算し直す必要も無くなりました",
"したがって、お戻しいただく必要はありません",
"5-3.意図の確認は今回は見送ります",
"当初は「率の小数化に伴う変更でしょうか」と",
"お伺いしようと考えておりましたが",
"上記のとおり当方に実害がありませんので、",
"今回は質問といたしません",
"お伺いする件数を絞り、",
"早くお返事をいただきたいためです",
"もし何か意図がおありでしたら、",
"次回ついでの折にお聞かせいただければ十分です",
# おわりに
"おわりに",
"優先度をつけるとすれば次の順です",
"順", "項目",
"アカウントはいただいておりますので、これだけで接続できます",
"9月中のデモを実データで行えるかがここで決まります",
"precheckの値の範囲と", "反映時期",
"新旧混在の期間があるかどうかを特に知りたいです",
"DDLの未反映4件", "（A-2/A-3b/B-2/B-3b）",
"お手すきの折で結構です。", "当方の開発は止まっていません",
"1（接続先）が最優先です",
"これだけ先にいただければ、当方で確認できることが一気に増え、"
"その分だけ貴社への照会が減ります",
"なお、これまでお願いしておりました外部キー／索引（B-1）と",
"主キー（A-1）は、",
"当方の実装方針が固まり必要がなくなりましたので、",
"今回の依頼から外しました", "（1-5に経緯を記しました）",
"率のカラムの小数化、そして本番がMariaDBであることのご教示、",
"あらためてありがとうございました",
"引き続きよろしくお願いします",
]
miss = [m for m in must if re.sub(r"\s+", "", m) not in flat]
print("検査項目:", len(must), " 欠落:", len(miss))
for m in miss:
print(" ★欠落★", m)
print("\n== 4. 識別子の語中改行 ==")
# wordWrap="CJK" は ASCII の語中でも折り返す。折り返されると抽出テキストに
# 改行が入るため、空白を詰めない生の抽出テキストで原形のまま探す。
IDENT = [
"clean_watch_20260909.sql",
"double(4,1)", "double(12,6)", "double(14,6)",
"decimal(12,6) unsigned", "tinyint unsigned", "tinyint(3) unsigned",
"information_schema", "CREATE TABLE",
"customer_summaries", "facility_summaries",
"operation_ratio", "launch_ratio", "clean_ratio", "error_ratio",
"clean_status_histories", "clean_statuses", "clean_task_reports",
"section_robot_statuses",
"task_area", "clean_area",
"prisma db pull", "error_type", "robots.status",
"robot_error_reports", "error_id",
"clean_status_histories.id", "clean_timetable_histories.id",
"bigint(20) unsigned NOT NULL", "AUTO_INCREMENT",
"facility_contacts.email", "varchar(100)", "varchar(255) DEFAULT NULL",
"contact_type",
"robot_task_versions.clean_schedule_id",
"robot_task_versions_robot_id_foreign",
"clean_schedule_id",
"security_status_histories.reported_at", "timestamp NOT NULL",
"clean_timetable_id", "clean_timetables",
"@prisma/adapter-mariadb",
# PRIMARY KEY / CONSTRAINT は A-1・B-1 を落としたので本文から消えている
"SSL/TLS",
"MySQL 8.0.41", "5.5.5-10.11.13-MariaDB-log",
"clean_timetables.precheck",
]
broken = [i for i in IDENT if i not in text]
print("検査した識別子:", len(IDENT), " 語中改行:", len(broken))
for b in broken:
print(" ★語中で割れている★", b)
print("\n== 5. 認証情報が載っていないこと ==")
# 参照用アカウントのユーザー名・パスワードは PDF に書かない（原稿にも無い）
SECRET = ["password", "PASSWORD", "IDENTIFIED BY", "passwd", "pwd="]
leak = [s for s in SECRET if s in text]
print("認証情報らしき語:", leak if leak else "なし")
print("\n== 6. 判定 ==")
ok = (not miss) and bool(biz) and (not hit) and (not broken) and (not leak)
print("結果:", "OK" if ok else "NG")
sys.exit(0 if ok else 1)
