Provider Search

名前解決パターン: 事業所名の表示には必ず以下のCOALESCEを使うこと:

COALESCE(sp.name, sp.office_name, sp.corporateName, sp.corp_name, '名称未登録') AS displayName

サービス種類の解決:

COALESCE(sp.serviceType, sp.service_type, '') AS serviceType

ProviderFeedback（口コミ・評価）

注意: ProviderFeedbackノードは運用で登録するもの。初期状態では0件。

リレーションシップ

(:Client)-[:USES_SERVICE {startDate, endDate, status, note}]->(:ServiceProvider)
(:ServiceProvider)-[:HAS_FEEDBACK]->(:ProviderFeedback)

USES_SERVICE プロパティ:

• startDate: 利用開始日
• endDate: 利用終了日
• status: Active（利用中）/ Pending（調整中）/ Ended（利用終了）
• note: 備考

注意: USES_SERVICE関係も運用で作成するもの。初期状態では0件。

評価スコア換算

データ統計（2026年1月時点）

Cypherテンプレート

── 読み取り系（read_neo4j_cypher） ──

テンプレート1: 事業所検索（基本）

サービス種類・地域で絞り込む。名前があるレコードのみ返す。 条件は任意で組み合わせ可能（不要なWHERE行を削除して使う）。

MATCH (sp:ServiceProvider)
WHERE (sp.name IS NOT NULL AND sp.name <> '')
  AND COALESCE(sp.serviceType, sp.service_type, '') CONTAINS $serviceType
  AND sp.city CONTAINS $city
RETURN COALESCE(sp.name, sp.office_name) AS name,
       COALESCE(sp.corporateName, sp.corp_name, '') AS corporateName,
       COALESCE(sp.serviceType, sp.service_type, '') AS serviceType,
       sp.city AS city,
       COALESCE(sp.address, sp.fullAddress, '') AS address,
       sp.phone AS phone,
       sp.capacity AS capacity,
       COALESCE(sp.availability, '未確認') AS availability,
       COALESCE(sp.closedDays, sp.closed_days, '') AS closedDays,
       sp.hoursWeekday AS hoursWeekday
ORDER BY
  CASE COALESCE(sp.availability, '未確認')
    WHEN '空きあり' THEN 1
    WHEN '要相談' THEN 2
    WHEN '未確認' THEN 3
    WHEN '満員' THEN 4
    ELSE 5
  END,
  COALESCE(sp.name, sp.office_name)
LIMIT $limit

使い方: 条件を自由に組み合わせる。

• サービス種類のみ: AND COALESCE(sp.serviceType, sp.service_type, '') CONTAINS '生活介護' のWHERE行のみ残す
• 地域のみ: AND sp.city CONTAINS '北九州' のWHERE行のみ残す
• キーワード検索追加: AND (COALESCE(sp.name, sp.office_name, '') CONTAINS $keyword OR COALESCE(sp.corporateName, sp.corp_name, '') CONTAINS $keyword)
• 空き状況絞り込み: AND COALESCE(sp.availability, '未確認') = '空きあり'
• 旧形式も含める: WHERE (sp.name IS NOT NULL AND sp.name <> '') OR (sp.office_name IS NOT NULL AND sp.office_name <> '')

パラメータ:

• $serviceType: サービス種類（部分一致、例: '生活介護', 'グループホーム', '就労継続支援B型'）
• $city: 市区町村（部分一致、例: '北九州', '久留米'）
• $limit: 取得件数（デフォルト20）

テンプレート2: クライアントの利用事業所一覧

MATCH (c:Client)-[r:USES_SERVICE]->(sp:ServiceProvider)
WHERE c.name CONTAINS $clientName
RETURN COALESCE(sp.name, sp.office_name, sp.corporateName, '名称未登録') AS providerName,
       COALESCE(sp.serviceType, sp.service_type, '') AS serviceType,
       sp.phone AS phone,
       r.status AS status,
       r.startDate AS startDate,
       r.endDate AS endDate,
       r.note AS note
ORDER BY
  CASE r.status
    WHEN 'Active' THEN 1
    WHEN 'Pending' THEN 2
    WHEN 'Ended' THEN 3
    ELSE 4
  END,
  r.startDate DESC

パラメータ:

• $clientName: クライアント名（部分一致）

注意: USES_SERVICE関係が存在しない場合は空の結果が返る。

テンプレート3: 代替事業所検索

現在利用中のサービスと同種の事業所で、まだ利用していないものを検索する。

MATCH (c:Client)-[r:USES_SERVICE]->(current:ServiceProvider)
WHERE c.name CONTAINS $clientName
  AND r.status = 'Active'
WITH c, collect(COALESCE(current.name, current.office_name)) AS currentNames,
     collect(DISTINCT COALESCE(current.serviceType, current.service_type)) AS serviceTypes
UNWIND serviceTypes AS st
MATCH (alt:ServiceProvider)
WHERE COALESCE(alt.serviceType, alt.service_type, '') = st
  AND COALESCE(alt.name, alt.office_name, '') <> ''
  AND NOT COALESCE(alt.name, alt.office_name) IN currentNames
RETURN COALESCE(alt.name, alt.office_name) AS name,
       COALESCE(alt.corporateName, alt.corp_name, '') AS corporateName,
       COALESCE(alt.serviceType, alt.service_type, '') AS serviceType,
       alt.city AS city,
       alt.phone AS phone,
       COALESCE(alt.availability, '未確認') AS availability,
       alt.capacity AS capacity
ORDER BY
  CASE COALESCE(alt.availability, '未確認')
    WHEN '空きあり' THEN 1
    WHEN '要相談' THEN 2
    WHEN '未確認' THEN 3
    WHEN '満員' THEN 4
    ELSE 5
  END,
  COALESCE(alt.name, alt.office_name)
LIMIT 20

パラメータ:

• $clientName: クライアント名（部分一致）

テンプレート4: 事業所の口コミ取得

MATCH (sp:ServiceProvider)-[:HAS_FEEDBACK]->(f:ProviderFeedback)
WHERE COALESCE(sp.name, sp.office_name, sp.corporateName, '') CONTAINS $providerName
RETURN f.category AS category,
       f.content AS content,
       f.rating AS rating,
       f.source AS source,
       f.date AS date
ORDER BY f.date DESC
LIMIT $limit

パラメータ:

• $providerName: 事業所名（部分一致）
• $limit: 取得件数（デフォルト20）

カテゴリ絞り込み: AND f.category = $category をWHEREに追加。

テンプレート5: 事業所の評価サマリー

MATCH (sp:ServiceProvider)-[:HAS_FEEDBACK]->(f:ProviderFeedback)
WHERE COALESCE(sp.name, sp.office_name, sp.corporateName, '') CONTAINS $providerName
WITH sp,
     count(f) AS totalFeedbacks,
     sum(CASE WHEN f.rating STARTS WITH '◎' THEN 1 ELSE 0 END) AS excellent,
     sum(CASE WHEN f.rating STARTS WITH '○' THEN 1 ELSE 0 END) AS good,
     sum(CASE WHEN f.rating STARTS WITH '△' THEN 1 ELSE 0 END) AS fair,
     sum(CASE WHEN f.rating STARTS WITH '×' THEN 1 ELSE 0 END) AS poor,
     avg(CASE
       WHEN f.rating STARTS WITH '◎' THEN 4.0
       WHEN f.rating STARTS WITH '○' THEN 3.0
       WHEN f.rating STARTS WITH '△' THEN 2.0
       WHEN f.rating STARTS WITH '×' THEN 1.0
       ELSE 0.0
     END) AS avgScore
RETURN COALESCE(sp.name, sp.office_name, sp.corporateName) AS providerName,
       totalFeedbacks,
       excellent, good, fair, poor,
       round(avgScore * 100) / 100 AS avgScore

パラメータ:

• $providerName: 事業所名（部分一致）

テンプレート6: 口コミ評価で事業所検索

特定カテゴリの口コミが良い事業所を探す。

MATCH (sp:ServiceProvider)-[:HAS_FEEDBACK]->(f:ProviderFeedback)
WHERE f.category = $category
WITH sp,
     count(f) AS feedbackCount,
     avg(CASE
       WHEN f.rating STARTS WITH '◎' THEN 4.0
       WHEN f.rating STARTS WITH '○' THEN 3.0
       WHEN f.rating STARTS WITH '△' THEN 2.0
       WHEN f.rating STARTS WITH '×' THEN 1.0
       ELSE 0.0
     END) AS avgScore,
     collect(f.content)[0..3] AS topExamples
WHERE feedbackCount >= 1
RETURN COALESCE(sp.name, sp.office_name, sp.corporateName) AS providerName,
       COALESCE(sp.serviceType, sp.service_type, '') AS serviceType,
       sp.city AS city,
       COALESCE(sp.availability, '未確認') AS availability,
       feedbackCount,
       round(avgScore * 100) / 100 AS avgScore,
       topExamples
ORDER BY avgScore DESC, feedbackCount DESC
LIMIT $limit

パラメータ:

• $category: 口コミカテゴリ（行動障害対応/コミュニケーション/環境/送迎/食事/医療連携）
• $limit: 取得件数（デフォルト20）

追加フィルタ:

• 評価絞り込み: AND f.rating STARTS WITH '◎'
• サービス種類: AND COALESCE(sp.serviceType, sp.service_type, '') CONTAINS $serviceType
• 地域: AND sp.city CONTAINS $city

── 書き込み系（write_neo4j_cypher） ──

テンプレート7: クライアントと事業所の紐付け

MERGE (c:Client {name: $clientName})
MERGE (sp:ServiceProvider {name: $providerName})
MERGE (c)-[r:USES_SERVICE]->(sp)
ON CREATE SET
  r.startDate = $startDate,
  r.status = $status,
  r.note = $note
ON MATCH SET
  r.status = $status,
  r.note = $note,
  r.endDate = CASE WHEN $status = 'Ended' THEN toString(date()) ELSE r.endDate END
RETURN c.name AS client, sp.name AS provider, r.status AS status, r.startDate AS startDate

パラメータ:

• $clientName: クライアント名
• $providerName: 事業所名（既存のServiceProvider.nameと完全一致させること）
• $startDate: 利用開始日（YYYY-MM-DD、空の場合は事前にdate().toString()をセット）
• $status: 利用状況（Active / Pending / Ended、デフォルト: Active）
• $note: 備考（任意）

注意: MERGE (sp:ServiceProvider {name: $providerName}) で名前完全一致が必要。事前にテンプレート1で正確な名前を確認すること。

テンプレート8: 口コミ・評価の登録

MATCH (sp:ServiceProvider)
WHERE COALESCE(sp.name, sp.office_name, sp.corporateName, '') CONTAINS $providerName
WITH sp LIMIT 1
CREATE (f:ProviderFeedback {
  feedbackId: randomUUID(),
  category: $category,
  content: $content,
  rating: $rating,
  source: $source,
  date: toString(date()),
  isConfirmed: false
})
CREATE (sp)-[:HAS_FEEDBACK]->(f)
RETURN COALESCE(sp.name, sp.office_name, sp.corporateName) AS provider,
       f.feedbackId AS feedbackId,
       f.category AS category,
       f.rating AS rating

パラメータ:

• $providerName: 事業所名（部分一致で最初の1件にマッチ）
• $category: カテゴリ（行動障害対応/コミュニケーション/環境/送迎/食事/医療連携/その他）
• $content: 口コミ内容
• $rating: 評価（◎良い / ○普通 / △課題あり / ×不可、デフォルト: ○普通）
• $source: 情報源（支援者名 or 匿名、デフォルト: 匿名）

テンプレート9: 事業所の空き状況更新

MATCH (sp:ServiceProvider)
WHERE COALESCE(sp.name, sp.office_name, sp.corporateName, '') CONTAINS $providerName
WITH sp LIMIT 1
SET sp.availability = $availability,
    sp.updatedAt = toString(datetime())
WITH sp, $currentUsers AS newUsers
FOREACH (_ IN CASE WHEN newUsers >= 0 THEN [1] ELSE [] END |
  SET sp.currentUsers = newUsers
)
RETURN COALESCE(sp.name, sp.office_name, sp.corporateName) AS provider,
       sp.availability AS availability,
       sp.currentUsers AS currentUsers,
       sp.updatedAt AS updatedAt

パラメータ:

• $providerName: 事業所名（部分一致で最初の1件にマッチ）
• $availability: 空き状況（空きあり / 要相談 / 満員 / 未確認）
• $currentUsers: 現在利用者数（-1の場合は更新しない）

運用ガイドライン

検索のベストプラクティス

1. 名前付きレコードのみ検索: 最初のWHERE句に sp.name IS NOT NULL AND sp.name <> '' を入れる
2. 旧形式も含める場合: (sp.name <> '' OR sp.office_name <> '') に変更
3. COALESCEを必ず使う: 表示名とサービス種類は両形式に対応するCOALESCEが必須
4. 空き優先ソート: availability は null が多いため COALESCE(sp.availability, '未確認') でnull安全に
5. LIMIT必須: 2621件のデータがあるため必ずLIMITを付ける

口コミ評価のカテゴリ

サービス種類一覧（主要なもの）

注意事項

• データ混在: 新形式（camelCase）と旧形式（snake_case）が混在。テンプレートのCOALESCEパターンを必ず使うこと
• 名前なしレコード: 約1500件は名前が空。検索時は名前のフィルタを入れること
• availability: 初期状態では 'または null。運用中にテンプレート9で更新する
• ProviderFeedback: 初期状態では0件。運用中にテンプレート8で蓄積する
• USES_SERVICE: 初期状態では0件。運用中にテンプレート7で作成する