provider-search

name	provider-search
description	福祉サービス事業所の検索・管理・口コミ評価を行うスキル。WAM NETから取得した事業所情報（ServiceProvider）と支援者による口コミ（ProviderFeedback）をNeo4jグラフデータベース（port 7687）で管理する。「事業所を探す」「事業所検索」「サービス事業所」「事業所の口コミ」「事業所の評価」「空き状況」「〇〇市の事業所」「通所先を探す」などの発言時に必ずこのスキルを使用すること。汎用neo4j MCPツール（execute_query）でCypherを実行する。

provider-search スキル

正本参照ルール（2026-07-12 追記・検収指摘対応）: 業務的意味・運用原則・ 指標の解釈は、まず docs/SEMANTIC_MODEL.md を読むこと（プロジェクト内は 同期コピー。正は ~/Dev-Work/shared-schema/SEMANTIC_MODEL.md。特に ENU-07〜09・ ENU-14 の列挙値の意味と MET-08 評価スコア）。リレーション名・列挙値・命名は docs/SCHEMA_CONVENTION.md が正。本スキルは索引に徹し、定義を二重化しない。

概要

福祉サービス事業所の検索・管理・口コミ評価を行うスキル。WAM NETから取得した事業所情報（ServiceProvider）と支援者による口コミ（ProviderFeedback）をNeo4jグラフデータベースで管理する。

対象Neo4jインスタンス

• support-db: bolt://localhost:7687（HTTP: 7474）
• neo4j MCPの execute_query（読み書き兼用の単一ツール。query に Cypher、任意で params）を使用

データモデル

ノード

ServiceProvider（福祉サービス事業所）

重要: WAM NETインポート時期により2種類のプロパティ命名規則が混在している。

新形式（camelCase）	旧形式（snake_case）	説明	件数目安
name	office_name	事業所名	新1002件 / 旧128件 / 空1496件
corporateName	corp_name	法人名
serviceType	service_type	サービス種類
city	―	市区町村	両形式共通
address	address	住所	両形式共通
phone	phone	電話番号	両形式共通
fax	―	FAX番号
fullAddress	―	完全住所	新形式のみ
postalCode	―	郵便番号	新形式のみ
capacity	―	定員	約1084件のみ
currentUsers	―	現在利用者数	ほぼ未設定
availability	―	空き状況	997件が'未確認'、残りはnull
targetDisability	―	対象障害種別	ほぼ未設定
features	―	特色・特徴	ほぼ未設定
closedDays	closed_days	休日
hoursWeekday	hours_weekday	平日営業時間
hoursSaturday	―	土曜営業時間	新形式のみ
hoursSunday	―	日曜営業時間	新形式のみ
hoursHoliday	―	祝日営業時間	新形式のみ
providerId	office_number	WAM NET事業所番号
wamnetId	―	WAM NET ID	新形式のみ
prefecture	―	都道府県	新形式のみ
municipalityCode	city_code	市区町村コード
serviceTypeCode	―	サービス種類コード	新形式のみ
serviceCategory	―	サービスカテゴリ	新形式のみ
latitude	latitude	緯度	両形式共通
longitude	longitude	経度	両形式共通
url	―	Webサイト	新形式のみ
dataSource	data_source	データソース（WAM_NET）
updatedAt	updated_at	最終更新日

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

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

サービス種類の解決:

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

ProviderFeedback（口コミ・評価）

プロパティ	型	説明
feedbackId	String	フィードバックID（UUID）
category	String	カテゴリ（行動障害対応/コミュニケーション/環境/送迎/食事/医療連携/その他）
content	String	口コミ内容
rating	String	評価（◎良い / ○普通 / △課題あり / ×不可）
source	String	情報源（支援者名 or 匿名）
date	String	登録日（ISO形式）
isConfirmed	Boolean	確認済みフラグ

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

リレーションシップ

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

USES_SERVICE プロパティ:

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

訂正（2026-07-12 河原氏決定）: 利用終了の status は旧 Ended から Inactive へ 統一（DRIFT-06）。Ended は SCHEMA_CONVENTION §7.6 の status 値域に無い独自値 だった。書き込みは Inactive のみ使用し、読み取りは旧データの Ended にも 後方互換でマッチさせる。

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

評価スコア換算

rating	スコア
◎良い	4
○普通	3
△課題あり	2
×不可	1

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

項目	件数
ServiceProvider総数	2621
名前あり（新形式）	1002
名前あり（旧形式）	128
名前なし	1496
capacity設定済み	1084
availability設定済み	997（すべて'未確認'）
ProviderFeedback	0（運用後に蓄積）
USES_SERVICE関係	0（運用後に作成）

Cypherテンプレート

── 読み取り系（execute_query / 読み取りクエリ） ──

テンプレート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 'Inactive' THEN 3
    WHEN 'Ended' THEN 3  // 旧値の後方互換（2026-07-12 訂正: 書き込みは Inactive のみ）
    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

── 書き込み系（execute_query / 書き込みクエリ） ──

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

MATCH (c:Client {name: $clientName})
MATCH (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 = 'Inactive' 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 / Inactive、デフォルト: Active。 旧 Ended は書き込み禁止 — 2026-07-12 訂正、DRIFT-06）
• $note: 備考（任意）

注意: MERGE ではなく MATCH を使う。MERGE (c:Client {name:...}) は氏名のタイプミス時に 幽霊クライアント/事業所を新規作成してしまう。両端は既存ノードでなければならないため、 必ず MATCH で照合する。該当が無ければクエリは 0 行を返し紐付けは作られないので、 事前にテンプレート1/2で $clientName と $providerName（完全一致）を確定してから実行すること。 返り値が空だった場合は「クライアントまたは事業所が見つからない」とユーザーに知らせる。

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

MATCH (sp:ServiceProvider {providerId: $providerId})
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

パラメータ:

• $providerId: 事業所の一意ID（テンプレート1/2の検索結果から取得する）
• $category: カテゴリ（行動障害対応/コミュニケーション/環境/送迎/食事/医療連携/その他）
• $content: 口コミ内容
• $rating: 評価（◎良い / ○普通 / △課題あり / ×不可、デフォルト: ○普通）
• $source: 情報源（支援者名 or 匿名、デフォルト: 匿名）

注意: 旧テンプレートは CONTAINS＋WITH sp LIMIT 1（ORDER BY なし）で、部分一致が複数 ヒットするとどの事業所に口コミが付くか不定だった。必ず providerId で一意に特定する。 名前しか分からない場合は先にテンプレート1/2で完全一致検索し、providerId を確定すること。

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

MATCH (sp:ServiceProvider {providerId: $providerId})
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

パラメータ:

• $providerId: 事業所の一意ID（テンプレート1/2の検索結果から取得する。部分一致の LIMIT 1 では対象事業所が不定になるため、必ず ID で一意特定する）
• $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を付ける

口コミ評価のカテゴリ

カテゴリ	観点
行動障害対応	パニック・他害・自傷等への対応力
コミュニケーション	意思疎通の工夫、家族との連携
環境	施設設備、衛生、バリアフリー
送迎	送迎の柔軟性、時間帯、対応範囲
食事	食事の質、アレルギー対応、嚥下配慮
医療連携	医療機関との連携、服薬管理
その他	上記に当てはまらないもの

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

サービス種類	件数
就労継続支援B型	494
生活介護	329
計画相談支援	325
放課後等デイサービス	299
グループホーム	174
共同生活援助	167
重度訪問介護	138
障害児相談支援	127
同行援護	88

注意事項

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