TeamWorks 様 確認事項（第11回）

作成: 2026-10-02 / 作成者: DFA Robotics

第10回へのご回答、ありがとうございました。いただいた内容をもとに実装を進めております。 本書は、その中で生じた確認事項とお願いをまとめたものです。以前の確認事項を開かなくても、本書だけでご回答いただけます。 各設問には選択肢（A / B / C …）を付けておりますので、記号だけでご回答いただければ結構です（補足が必要なものは設問の中に書いております）。 これまでの設問のうち、本書に載っていないものはご回答不要です。

特にお急ぎいただきたいのは 1章（完了率） と 3章（制御盤・セキュリティのエラー） です。

1. 清掃の完了率・清掃結果

P-1. 訂正後の clean_task_reports.clean_ratio は、どの値になりますでしょうか

clean_ratio 列は「計算式が誤っているので、訂正後に回答する」と伺いました。 サマリの完了率は、清掃1回ごとに「clean_area ÷ task_area × 100（100を超えたら100、小数第2位以下切り捨て）」を求め、その平均を取ると伺っております。当方の当期（進行中の週・月）の集計も、いまはこの式で計算しております。

あわせて、訂正の時期の目安と、すでに入っている行も直すかをお教えください。

P-2. 完了率の式について（ご相談）

clean_area は同じ場所を複数回清掃した面積の総和と伺いました。そのため面積の比は100を超えることがあり、上限の100で切られます。 受領したCSV（189行）では 129行（68.3%）が100% になり、対象面積のうち実際に清掃できた割合より高く出ているおそれがございます。 当方は当面、サマリと数字をそろえるために貴社の式に合わせておりますが、将来の方針を伺えますでしょうか。

B の場合は、サマリと当期の式がずれないよう、当方も同じ時期に切り替えます。

P-3. 「正常終了」なのに清掃面積が0の行は、どう読めばよいでしょうか

CSV の status = 4（清掃正常終了）161行のうち 22行が clean_area = 0 / clean_ratio = 0 / clean_time = 0 でした。うち20行は ended_at が 01:00:00 ちょうど です。ステージングの1行（task_area = 1377.39502）も同じ形です。

当方はいま A として扱い、完了率0%（判定 ×）を表示しております。

P-4. clean_task_reports.status = 6 は何を表しますでしょうか

0〜5 の意味は伺いましたが、CSV に status = 6 が22行 ございました。 うち20行は日中に開始から数秒〜数分で終わり、clean_area = 0 です（残り2行は clean_ratio = 100）。

0〜6 以外に入りうる値があれば、あわせてお教えください。当方はいま、6 を数字のまま表示しております。

P-5. task_area = 0 の行は、サマリでどう扱われますでしょうか

CSV・ステージングには該当する行がございませんが、1回ごとの式で割り算ができなくなるため伺います。

当方はいま A として扱っております。

2. サマリの数え方

P-6. サマリの3つの率の分子・分母をお教えください

launch_count は「清掃タスクを開始できた回数（正常終了の回数ではない）」と伺いました。task_count は本清掃の予定の回数と理解しております。

ご回答は「A / B / A」のように、上から順に3つの記号で結構です。

P-7. clean_timetable_histories も読む必要がございますでしょうか

サマリの集計対象は「clean_timetables もしくは clean_timetable_histories の precheck が0のデータ」と伺いました。当方はいま clean_timetables だけを読んでおります。

B の場合は、clean_task_reports.clean_timetable_id がどちらの表の id を指すかもお教えください。

3. 制御盤・セキュリティのエラー

P-8. 制御盤・セキュリティのエラーの入れ方について

robot_error_reports をエラー全般の表にし、robot_id と serial_number を NULL 可にする（両方 NULL＝セキュリティエラー、robot_id だけ NULL＝D-S制御盤エラー）と伺いました。 ご回答の記号は「A（制御盤が属するエリアのロボットの robot_id を入れる）」でしたが、本文は DDL を変更する内容でしたので、確認させてください。

P-9. 制御盤・セキュリティのエラーは、サマリの error_count に入りますでしょうか

「clean_timetable_id が NULL のエラー行は error_count に含まない」「制御盤のエラーは error_count に含む」と伺いました。 制御盤・セキュリティのエラー行の clean_timetable_id が NULL ですと、この2つが両立いたしません。

P-10. control_error_histories と robot_error_reports のどちらを正とすればよいでしょうか

control_error_histories は今後も書くと伺いました。同じ制御盤のエラーが robot_error_reports にも入りますと、画面に二重に出たり、対応状況（status / comment / responded_at / resolved_at）の更新先が2つになったりいたします。

あわせて、同じ1件のエラーが両方の表に1行ずつ入るのかをお教えください。

4. 時刻・ステージング・アカウント

P-11. 本番DBのタイムゾーンも、ステージングと同じ設定になりますでしょうか

ステージングは、既定のタイムゾーンを Asia/Tokyo（@@system_time_zone = JST）に直し、時刻の列に JST の値を書いていると伺いました。

P-12. タイムゾーン変更後の「データの再登録」の範囲をお教えください

ずれていたのは control_reports.reported_at と robot_error_reports.created_at（いずれも UTC で書かれていた）と理解しております。 当方はアプリ側で時刻を補正しておりませんので、UTC のまま残る行があるかを確認させてください。

P-13. 4カラムの更新に使うアカウントについて

robot_error_reports / control_error_histories の4カラム（status / comment / responded_at / resolved_at）を画面から更新する機能を作っております。4カラム以外には書き込みません。 当方が接続に使っているアカウントで SHOW GRANTS を実行したところ、2テーブルの UPDATE 権限も表示されました。更新では WHERE error_id = ? で行を指定しますので、その列の SELECT 権限も必要になります。

P-14. お願い: ステージングの入れ替えの事前のご連絡

ステージングはデータの入れ替えがありうると伺いました。当方はステージングで上記4カラムの更新を検証いたします。 データの入れ替え、接続先・アカウントの変更の際は、前日までにお知らせいただけますと助かります。 その間は検証を控えます。 あわせて、10/5 中に投入いただく予定の0行のテーブル（clean_schedules / clean_timetables など）も、投入が終わりましたら一言いただけますと幸いです。

ご回答: 承知 / 難しい

5. 軽い確認

P-15. customers は、屋号と法人のどちらの単位になりますでしょうか

画面には「グループ → 顧客 → 店舗」の絞り込みがございます。customers はいま法人名（株式会社ドン・キホーテ）で入っており、当方はこの単位のまま表示しております。

A の場合は、屋号を持たない店舗が customers にどう入るか（customer_name に何を入れるか）もお教えください。

P-16. 区域別の内訳は、どこから読めますでしょうか

「1回の清掃の中の区域別（売り場・通路・レジ前など）の内訳」について「できる。sections 単位」とご回答いただきました。 当方は「清掃エリア（sections の1行）＝ロボット1台」とし、すでに清掃エリアごとの完了率を出しております。

P-17. 制御盤の報告間隔の「0」は何を表しますでしょうか

報告間隔は「0〜3599（秒）で、制御盤ごとに変える」と伺いました。テーブル定義書の link_schedules.intervals は「1〜3599」です。通信が途絶えたかどうかの判断に関わるため伺います。

以上です。ご確認のほど、よろしくお願いいたします。