LINE セルフ登録フロー設計

既存「受付登録 + 本人確認」モデル → 「LINE 直接セルフ登録」への移行設計 — 視覚要素 + 詳細仕様併存版

1. 背景・現状の課題

現在の受付業務では、手作業での情報確認や対応時間の長さがボトルネックになっています。本章では、解決すべき現場のリアルな課題を整理します。

現行システムでは患者の利用開始までに以下のフローが必要で、受付スタッフの業務負荷と新規患者の取りこぼしが恒常化している。

現状フロー

1. 来院 → 受付スタッフが紙カルテをシステムに手動入力（数分〜十数分）
2. 患者は自身の LINE / Google アカウントでログイン
3. 本人確認画面で 氏名・電話番号・生年月日の 3 要素突合 を実施
4. 突合成功 → カルテと予約アカウントが紐付き、予約可能
5. 突合失敗 → 来院時に受付スタッフが手動修正

定量的な課題（運用観測値）

本設計のゴール

• 受付の初期登録業務を 廃止 し、患者がいつでもセルフで登録できる状態にする
• 突合の失敗を構造的に発生させない（突合自体を行わない）
• 認証経路を LINE 一本に集約し、保守対象を削減

2. Before / After 比較

新たな LINE セルフ登録フローを導入することで、患者の体験とスタッフの業務負荷がどのように改善されるかを具体的に比較します。

3. 設計方針（振る舞い・割り切り）

開発期間と運用効果のバランスを最適に保つため、今回実装する機能とあえて見送る（割り切る）スコープの基準を明確にします。

シナリオ別の振る舞い

割り切り（採否と理由）

4. 認証シーケンス

LINE アカウントと患者情報を安全かつ確実に紐付けるための、システム間の連携手順と通信の流れを解説します。

5. API 仕様（完全版）

アプリケーションとサーバ間で正確に情報をやり取りするための、エンドポイントや通信フォーマットの詳細を定義します。

エンドポイント

POST /api/v1/auth/oauth/register — 新設

Request

POST /api/v1/auth/oauth/register HTTP/1.1
Host: api.example-clinic.jp
Authorization: Bearer <LINE access_token>
Content-Type: application/json
X-Request-Id: <uuid>

{
  "name":  "山田 太郎",
  "kana":  "ヤマダ タロウ",
  "phone": "090-1234-5678",
  "dob":   "1990-01-01"
}

Request フィールド制約

Response 201 Created

HTTP/1.1 201 Created
Content-Type: application/json

{
  "user_id":    "usr_01HXY3K9P5R2J7Q1",
  "jwt":        "eyJhbGciOiJSUzI1NiIs...",
  "expires_at": "2026-05-18T03:00:00Z",
  "registration_type": "line_self_registered"
}

非機能要件

6. データモデル

新しい予約フローを実現するために必要となる、情報の保存形式や各データの関連性を設計図として示します。

User テーブル拡張

registration_type enum

マイグレーション順序

1. registration_type カラムを追加（default manual_registered）
2. 既存全レコードをバックフィル（Google ログイン者は google_legacy）
3. NOT NULL 制約を付与
4. line_user_id に UNIQUE インデックス追加

7. UI フロー・バリデーション

患者が迷わず操作できる画面遷移と、誤入力を未然に防ぐためのシステム的なチェック機構について説明します。

8. エラー分岐とレスポンス

通信障害や予期せぬ操作が行われた際に、ユーザーへどのようなメッセージを返し、どう解決へ導くかを定義します。

{
  "error": "validation_error",
  "request_id": "req_01HXY...",
  "details": [
    { "field": "kana",  "code": "non_katakana", "message": "フリガナはカタカナで入力してください" },
    { "field": "phone", "code": "invalid_format", "message": "電話番号の形式が正しくありません" }
  ]
}

{
  "error": "invalid_token",
  "request_id": "req_01HXY...",
  "message": "LINE アクセストークンが無効または期限切れです"
}

{
  "error": "rate_limited",
  "request_id": "req_01HXY...",
  "retry_after": 60,
  "message": "リクエストが多すぎます。60 秒後に再試行してください"
}

{
  "error": "server_error",
  "request_id": "req_01HXY...",
  "message": "サーバエラーが発生しました。サポートまでご連絡ください"
}

9. 実装スコープ

プロジェクトを計画通りに進めるため、初期フェーズで確実に対応する機能と、次期開発へ回す機能の境界線を整理します。

10. セキュリティ・テスト

医療データを扱う上で必須となるセキュリティ対策と、リリース前の品質を担保するための具体的なテスト手法について説明します。

脅威モデル

テスト戦略