設計書に504412利用目的(メール整合性チェック・フリガナ補完)を具体化

Bot対話フローとは独立した補助機能として8章に新設。504412の
列構成(Class011=ユーザID, Class036=PLメールアドレス,
Class003/004=姓名カナ)を明記し、508971のメールアドレス整合性
チェックとClassD(フリガナ)補完の参照先として使う設計にした。
2章の記述は重複を避け8章への参照に整理。

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Kenichiro NOGI 2026-09-05 13:58:28 +09:00
parent 64e8b8d011
commit 5fa82fda43

View File

@ -24,7 +24,7 @@ n8n環境自体の詳細URL・API・既存ワークフロー・過去の罠
| 対象者解決 | プリザンター標準Usersのメールアドレスを、そのままLINEWORKS宛先IDuserIdとして使う。LINE WORKS側からの受信時も`source.userId`=メールアドレスという前提で扱う(専用マッピングマスタは不要) | | 対象者解決 | プリザンター標準Usersのメールアドレスを、そのままLINEWORKS宛先IDuserIdとして使う。LINE WORKS側からの受信時も`source.userId`=メールアドレスという前提で扱う(専用マッピングマスタは不要) |
| 対象レコード特定 | LINEWORKSから届いたメッセージの送信者メール→508971の中で、そのユーザーが紐づくレコードのうち**未完了Status 900/910以外の最新レコード**を対象とする。複数該当時の自動判定は行わず、実装上は「複数ヒット」を異常系として扱う | | 対象レコード特定 | LINEWORKSから届いたメッセージの送信者メール→508971の中で、そのユーザーが紐づくレコードのうち**未完了Status 900/910以外の最新レコード**を対象とする。複数該当時の自動判定は行わず、実装上は「複数ヒット」を異常系として扱う |
対象者解決は基本的にプリザンター標準Usersのメールアドレスだけで足りる想定だが、所属会社・部署・在籍状況等の**社員属性の裏付けが必要になった場合**は、社員・組織マスタ管理テーブルSiteId 504412、org-master-syncプロジェクトが同期している全社マスタ、`NodeSrv/apps/n8n/docs/n8n-guide.md`参照を参照する。508971自体のClassA所属会社等の入力値だけでは信頼性が不十分なケースが出た場合の裏付け手段として、新規マスタを増やさずこの既存マスタを流用する 対象者解決は基本的にプリザンター標準Usersのメールアドレスだけで足りる想定。データ品質の裏付けチェック・補完に社員・組織マスタ管理テーブルSiteId 504412を使う件は8章参照Bot対話フローとは独立した補助機能
## 3. 全体アーキテクチャ ## 3. 全体アーキテクチャ
@ -122,7 +122,23 @@ n8n-guide.md 7-1Clear出力の握り潰し・7-2複数行が後続へ
- 初回検証は1Process・1件のみで実施し、疎通確認後にフロー全体①〜③の通し検証に進める - 初回検証は1Process・1件のみで実施し、疎通確認後にフロー全体①〜③の通し検証に進める
- 508971は本番の健診データそのものなので、検証は既存レコードを壊さない捨てレコードを用意して行う - 508971は本番の健診データそのものなので、検証は既存レコードを壊さない捨てレコードを用意して行う
## 8. 未確定事項(実装時に個別確定) ## 8. 補助機能Bot対話フローとは独立: 社員マスタ(504412)によるデータ品質チェック・補完
3〜7章のBot対話フローとは関係のない、508971のデータ品質を担保するための補助機能。n8nのHC-SUB/HC-WP/HC-WAワークフローには組み込まず、別途の仕組みバッチ・Pleasanter Process/ServerScript等、実装方式は別途検討として扱う。
社員・組織マスタ管理テーブルSiteId 504412、2章参照の列構成`NodeSrv/apps/org-master-sync/configs/site-504412_社員・組織マスタ管理テーブル/`で取得済み):
| 504412の列 | 内容 |
|---|---|
| `Class011` | ユーザIDPleasanterUserId |
| `ClassB` | メールアドレス |
| `Class036` | PLメールアドレス |
| `Class003` / `Class004` | 姓(カナ)/名(カナ) |
- **メールアドレス整合性チェック**: 508971の`ClassC`Users参照から解決した対象者のPleasanterUserIdを軸に504412の`Class011`と突き合わせ、その社員の`Class036`PLメールアドレスと、`api/users/get`で解決した実際のメールアドレスが一致するかを検証する
- **フリガナ補完**: 508971の`ClassD`フリガナ、必須項目が空欄の場合、504412の`Class003`(姓(カナ))+`Class004`(名(カナ))から補完する
## 9. 未確定事項(実装時に個別確定)
- 具体的なProcess定義①日程通知〜③検査結果受取りの各Process内容、Status値の追加・修正は508971のStatus設計がまだ未完成のため、実装着手時に個別に設計する - 具体的なProcess定義①日程通知〜③検査結果受取りの各Process内容、Status値の追加・修正は508971のStatus設計がまだ未完成のため、実装着手時に個別に設計する
- LINEWORKS Bot Private Key CredentialとBotId484184側の対応関係の実機確認 - LINEWORKS Bot Private Key CredentialとBotId484184側の対応関係の実機確認