Linear migration metadata¶

• Linear issue: TAK-80
• Linear URL: https://linear.app/takayuki-komoda/issue/TAK-80/レコードウォッチと任意フォロー通知を追加する
• Linear status: Backlog
• Linear team: Takayuki Komoda
• Linear project: EPAA Core
• Linear assignee: Takayuki Komoda
• Linear labels: Improvement
• Linear created: 2026-06-15T00:00:16.744Z
• Linear updated: 2026-06-15T00:00:16.744Z
• Linear archived:

Original description¶

概要¶

生成CRUDのレコードに対して、ユーザーが任意にウォッチ/フォローできる機能を追加する。ウォッチ中のレコードに重要な更新があった場合、対象ユーザーへ通知する。

優先度¶

低め。コメント、添付ファイル、変更申請、申請結果通知、担当者通知などの基盤が整った後に実装する。

背景¶

担当者ではないが経過を追いたいレコード、関係者として更新を把握したいレコードを、ユーザー自身がフォローできると業務上便利。ただし通知が増えすぎるとノイズになるため、MVPでは通知トリガーを絞る。

要求¶

• レコード詳細画面でウォッチ開始/解除ができる。
• 自分がウォッチしているレコードかどうかを画面で確認できる。
• ウォッチ状態はユーザー単位、tenant単位、resource単位、record単位で保持する。
• 同一ユーザーの重複ウォッチを防ぐ。
• 閲覧権限のないレコードはウォッチできない。
• 閲覧権限を失ったレコードのウォッチ通知は届かない。
• tenant分離を必ず適用する。
• 通知対象イベントはMVPでは限定する。

初期MVP案¶

• 固定共通テーブル record_watches を追加する。
• 主な列案:
  • tenant_id
  • resource_code
  • record_id
  • user_id
  • created_at
• 通知対象イベントは初期では以下に限定する。
  • コメント追加
  • 添付追加/削除
  • 変更申請作成
  • 変更申請の承認/差戻/却下
• 担当者通知、申請結果通知、メンション通知とは責務を分ける。
• 自動ウォッチは初期MVPでは必須にしない。

受入条件¶

• ユーザーがレコードをウォッチ開始/解除できる。
• ウォッチ中のレコードで対象イベントが発生した場合、通知が作成される。
• 権限外・tenant外のレコードについて通知が作成/参照されない。
• 通知が過剰にならないよう、対象イベントが明確に限定されている。
• DB release SQL、ドキュメント、テスト、ブラウザ証跡をreports配下に記録する。

非対象¶

• 担当者フィールドに基づく自動通知。
• 申請者への承認/差戻/却下通知。
• メンション通知。
• 全更新イベントの通知。
• リアルタイムpush通知。
• メール/外部通知連携。