From 3bccc4d1b9f949315990461d2e7bda7d3769798f Mon Sep 17 00:00:00 2001 From: Kenichiro NOGI Date: Sat, 12 Sep 2026 14:08:53 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=92=AE=E5=BD=B1=E3=83=86=E3=82=B9?= =?UTF-8?q?=E3=83=88=E5=AE=8C=E4=BA=86=E3=83=BB=E8=BF=BD=E5=8A=A0=E3=83=90?= =?UTF-8?q?=E3=82=B04=E4=BB=B6(=E9=81=8E=E5=8E=BB=E6=97=A5=E4=BB=98?= =?UTF-8?q?=E3=83=90=E3=83=AA=E3=83=87=E3=83=BC=E3=82=B7=E3=83=A7=E3=83=B3?= =?UTF-8?q?=E6=AC=A0=E5=A6=82/=E6=96=87=E5=AD=97=E5=8C=96=E3=81=91/?= =?UTF-8?q?=E3=83=86=E3=82=B9=E3=83=88=E3=83=87=E3=83=BC=E3=82=BF=E4=B8=8D?= =?UTF-8?q?=E6=95=B4=E5=90=88/CONTACT=5FMESSAGE=E5=B7=BB=E3=81=8D=E6=88=BB?= =?UTF-8?q?=E3=82=8A)=E3=81=AE=E7=99=BA=E8=A6=8B=E3=83=BB=E4=BF=AE?= =?UTF-8?q?=E6=AD=A3=E3=82=92=E8=A8=98=E9=8C=B2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit マニュアル用スクリーンショット撮影を全ケース実施完了(計50枚)。並行して発見した 過去日付が確定できてしまう不具合の修正、文字化け修正、担当者連絡文言の巻き戻り 修正をHC-WAへ反映し、いずれも実機再検証済み。 --- .../docs/n8n/design-fixed-menu.md | 65 +++++++++++++++++++ 1 file changed, 65 insertions(+) diff --git a/Pleasanter/健康診断管理/docs/n8n/design-fixed-menu.md b/Pleasanter/健康診断管理/docs/n8n/design-fixed-menu.md index b5d67a57..f1916cae 100644 --- a/Pleasanter/健康診断管理/docs/n8n/design-fixed-menu.md +++ b/Pleasanter/健康診断管理/docs/n8n/design-fixed-menu.md @@ -1398,3 +1398,68 @@ Status260→300→承諾→日程確定→メニュー3択表示）まで実施 HC-WA/HC-WPは検証後の原則通りdeactivateへ戻した。取得済みスクリーンショットは `Pleasanter/健康診断管理/ScreenShot/`に保存済み（①②通知本文＋button_template、承諾→日程確定、 固定メニュー3択、Status=310照会表示、計6枚）。 + +### 撮影テスト再開（2026-09-12）: 追加バグ2件発見・修正 + +上記の待機状態リセット修正確認を兼ねて撮影テストを再開。ケース1〜4（メニュー出し分け・受診日時 +について・受診結果について・健康診断結果の提出）を実施し、以下2件を追加で発見・修正した。 + +**1. テストデータ不整合（実装バグではない）**: 513409のClass003（検査機関）が511924に実在しない +ResultId `511926` を指しており、`buildHospitalContactMessage`が該当なしで空の連絡先メッセージ +（病院名・電話番号が空欄）を返していた。511924の実データを確認し、正しいResultId `514112` +（日の出が丘病院　健診センター）へ手動update。以後の検証は正しい連絡先表示を確認済み。 +Status=300へ戻す操作を繰り返す中でClass003が自分手配（513480）のまま残存するケースが再発し、 +その都度514112へ再修正しながら撮影を続行した（テスト運用上の注意点として記録）。 + +**2. 過去日付が日程確定できてしまう不具合（ユーザー指摘・2026-09-12）**: `parseDateInput`の +共通ヘルパー`finalizeDateParts`は実在日付かどうかのみ検証しており、過去日付でもそのまま +受理していた（例: 「2026年7月20日」が「2026-09-12」時点で承諾可能な候補として提示された）。 +`finalizeDateParts`に「今日（時刻0時基準）より前なら`Error("過去の日付は指定できません")`」の +チェックを追加。`tryParseEraDate`・`tryParseMonthDay`・`parseDateInput`の全経路が +`finalizeDateParts`を通るため、この1箇所の修正で全入力経路に反映される。HC-WAへPUT反映済み +（2026-09-12 04:44 UTC）。実機で「7/20」（過去日付）→「過去の日付は指定できません」を確認済み。 + +**3. 文字化け修正（2026-09-11の緊急バグ修正時に混入）**: 日付3回連続失敗時の中断メッセージ +（`awaitInput=schedule_confirm`側）が「固定メニュー���ら「受診日時について」を選び直して +ください」と文字化けしていた（`await sendText.call(this, "...固定メニュー���ら..."）"`）。 +同じ文言を持つ`retest_choice`側（399行目、正しい表記）と比較して発見。「固定メニューから」に +修正し、ファイル全体を文字化け文字（U+FFFD）でスキャンして他に無いことを確認済み。HC-WAへ +PUT反映済み（2026-09-12 04:59 UTC）。実機でケース2-7（過去日付・存在しない日付・認識不能文字列 +の3回連続失敗）を再現し、正しい文言での中断メッセージを確認済み。 + +いずれも撮影テストと並行してn8n実行履歴（execution runData）を都度確認しながら根本原因を +特定・修正する形で対応した。 + +**4. `CONTACT_MESSAGE`が旧文言へ巻き戻っていた（撮影テスト完了後、ケース7のスクリーンショット +確認中に発見）**: ケース7（担当者に連絡）の実機スクリーンショットで、案内文言が +「ご用の方は総務総合窓口へお問合せください🙇\nhttps://line.worksmobile.com/message/send? +userNoList=800300000001350」という2026-09-11修正前の旧仕様のまま送信されていることが判明 +（`《総務・契約関連窓口》`行と、URLの`&version=25&type=counselor`パラメータが欠落）。 +2026-09-11時点で一度PUT反映済みのはずだったが、本セッション冒頭の緊急バグ修正（2.5節追加）で +n8nから再取得したワークフローJSONの時点で既に旧文言に戻っていた（反映が実際には反映されて +いなかったか、その後の操作で上書きされたか、原因は未特定）。正しい文言 +`ご用の方は総務総合窓口へお問合せください🙇\n《総務・契約関連窓口》\n +https://line.worksmobile.com/message/send?userNoList=800300000001350&version=25&type=counselor` +へ再修正し、HC-WAへPUT反映済み（2026-09-12 05:05 UTC）。**教訓**: 定数値の修正はPUT成功 +レスポンスだけでなく、後続の別修正時に取得したワークフローJSON上で値が保持されているか +都度確認すること。次に「担当者に連絡」を撮影・検証する際は、この文言で実機確認すること +（今回はケース7実機スクリーンショット確認時点で旧文言のまま撮影済みのため、撮り直しが必要）。 + +HC-WA再activate→固定メニューから「担当者に連絡」を直接タップして撮り直し、正しい文言 +（《総務・契約関連窓口》行＋`&version=25&type=counselor`込み）を実機確認済み。続けてURL +リンクをクリックし、ブラウザ版LINEWORKSで「総務・契約関連窓口」トークルームへ正しく遷移する +ことも確認済み（マニュアル7章の導線説明に使える画像）。 + +### 撮影テスト完了（2026-09-12） + +`2026-09-12-screenshot-test-plan.md`の全ケース（1-1〜1-4、2-1〜2-8、3-1〜3-7、4-1〜4-3、 +5-1〜5-6、6-1〜6-3、7-2＋URL遷移確認）を実機で撮影完了。`Pleasanter/健康診断管理/ScreenShot/` +に計50枚保存済み（トーク一覧・固定メニュー単体・ファイル送信ダイアログ等の周辺画像を含む）。 +撮影と並行してn8n実行履歴を都度確認しながら根本原因を特定する形で、上記4件のバグ・不整合 +（待機状態リセット漏れ、テストデータ不整合、過去日付バリデーション欠如、文字化け、 +CONTACT_MESSAGE巻き戻り）を発見・修正し、いずれも実機再検証済み。HC-WA/HC-WPは検証完了後 +両方deactivateへ戻した。 + +**残作業**: テスト添付ファイル（513409の`診断結果.pdf`・`診断結果.txt`、ケース4検証分）は +Pleasanter画面から手動削除が必要（API削除は反映されないことを2026-09-11に確認済み）。 +マニュアル（`健康診断Bot機能_仕様(管理担当者向け).md`）への画像挿入は次回対応。