エコマップ（Ecomap）

エコマップについて

「エコマップ」（ecomap）は、中心に個人または家族を置き、その周囲に外部システムのネットワーク — 拡大家族、学校、教会、クリニック、雇用主、サポートグループ — を配置した 1 枚の図です。各接続線は関係の質（強い、希薄な、ストレス的）と方向（誰が与え、誰が受け取るか）を記録します。ソーシャルワーカー、スクールカウンセラー、ケースマネージャー、地域保健師は、クライアントがどこに支えを持ち、セーフティネットが薄い部分はどこかを一目で把握するためにエコマップを使用します。

Schematex は Hartman (1978) エコマップモデル に従います — この表記法を紹介したオリジナルの Social Casework 論文 — 現代の臨床ソーシャルワーク実践の慣習で拡張されています。背景については Wikipedia: Ecomap を参照してください。このページは今日のパーサーが受け付けるものを文書化しています。

1. 最初のエコマップ

最小限の実用的なエコマップ：1 つの中心と 3 つの外部システム。

使用法の 80% をカバーする 4 つのルール：

1. キーワード ecomap で始めます。オプションでクォートされたタイトル。
2. 中心を独自の行で宣言します：center: id [label: "…"]。ダイアグラムごとに中心は 1 つだけです。
3. 各外部システムを独自の行で宣言します：id [label: "…", category: …]。
4. 宣言された任意の 2 つの ID を 接続演算子 で接続します — ===（強い）、---（普通）、<->（双方向）など。完全なテーブルはセクション 3 を参照。末尾の [label: "…"] でエッジラベルを追加します。

コメントは #、//、または Mermaid スタイルの %% で始まる独立した行でなければなりません。インラインの末尾コメントはパーサーを壊します。

2. 中心と外部システム

すべてのエコマップには 1 つの中心と任意の数の外部システムがあります。両方とも同じ id [attrs] 構文を使用します。唯一の違いは center: プレフィックスです。

ID のルール。 [a-zA-Z][a-zA-Z0-9_-]* に一致する必要があります。ID は大文字小文字を区別しません。元のトークンはデフォルトラベルとして保持されます。

今日のパーサーが受け付ける属性：

2.1 システムカテゴリー

カテゴリーは外部システムをその生活領域で色分けします。パーサーは任意の文字列を受け付けます — これらはレンダラーがテーマパレットを持っている値です：

3. 接続

接続は 1 行：fromId OP toId の後にオプションで [label: "…"]。両方の ID がすでに宣言されている必要があります（中心も含む）。

3.1 関係品質演算子

3.2 エネルギーフロー演算子

強いまたは普通の線に矢印の方向を重ねます：

パーサーは方向を正規化するため、矢印は中心に対して相対的に読まれます。family === resettlement と書いても resettlement === family と書いても同じダイアグラムが生成されます。clinic --> family と family <-- clinic も同様に、診療所から家族へ向かう同じ矢印を生成します。

3.3 エッジラベル

末尾の [label: "…"] は接続行が受け付ける唯一の属性です。スケジュール、性質、または短いメモをここに入れます：

family === temple [label: "weekly service"]
clinic --> family [label: "vaccinations"]
caseworker <-> family [label: "every Tuesday"]

4. ラベルとコメント

• タイトル： ecomap "Nguyen Family" — 最初の行のみ。
• ノードラベルの上書き： family [label: "The Nguyens"]。
• エッジラベル： 接続行の末尾の [label: "…"]。
• モードサフィックス： ecomap:strengths "Smith family" は受け付けられます。サフィックスは metadata.mode として保存されます。現在のレンダラーはこれを無視します。
• コメント： 行の先頭（先頭の空白の後）の #、//、または %%。インラインの末尾コメントはサポートされていません。

ecomap "Marcus Intake"
  # caseworker's notes — fine
  // also fine
  %% Mermaid-style comments are fine
  mom [category: family]   # ← THIS trailing comment breaks the parser

5. 予約語とエスケープ

行頭で予約済み： ecomap、center:。

予約演算子トークン — 行内でこれらのシーケンスを ID 内で使用しないでください： ===、==、---、- -、~~~、~=~、~x~、-/-、およびセクション 3.2 にリストされた方向バリアント。

スペースを含む文字列はダブルクォートが必要です：タイトルと任意のラベル。シングルクォートとバッククォートは認識されません。

6. よくあるミス

実際のパーサーエラー、何がトリガーするか、修正方法。

7. 文法（EBNF）

document       = header (blank | comment | center | system | connection)*

header         = "ecomap" ( ":" mode )? ( WS quoted-string )? NEWLINE
mode           = [A-Za-z] [A-Za-z0-9_-]*
quoted-string  = '"' any-char-but-quote* '"'

center         = "center:" WS id ( "[" attrs "]" )? NEWLINE
system         = id ( "[" attrs "]" )? NEWLINE
connection     = id WS op WS id ( WS "[" "label:" quoted-string "]" )? NEWLINE

op             = "===" | "==" | "---" | "- -" | "~~~" | "~=~" | "~x~" | "-/-"
               | "===>" | "<===" | "<=>" | "==>" | "<=="
               | "-->" | "<--" | "<->"

id             = [a-zA-Z] [a-zA-Z0-9_-]*
attrs          = attr ("," attr)*
attr           = "label" ":" quoted-string
               | "category" ":" category
               | "size" ":" ("small" | "medium" | "large")
               | "importance" ":" ("major" | "moderate" | "minor")
               | "sector" ":" ("top" | "right" | "bottom" | "left")
               | "age" ":" digits
               | "male" | "female" | "unknown"
               | key ":" value                  // custom, stored as metadata

category       = "family" | "friends" | "work" | "education" | "health"
               | "mental-health" | "religion" | "recreation" | "legal"
               | "government" | "financial" | "community" | "cultural"
               | "substance" | "technology" | "pet" | "other"

comment        = ( "#" | "//" | "%%" ) any NEWLINE

権威ある情報源：src/diagrams/ecomap/parser.ts。これがパーサーと異なる場合、パーサーが優先されます — イシューを開いてください。

8. 標準準拠

Schematex のエコマップはコア表記について Hartman (1978), Diagrammatic Assessment of Family Relationships に従います：外部システムに囲まれた境界付きの中心、品質と方向性の両方をエンコードした接続線。カテゴリーパレットと拡張された演算子セット（ストレス的-強い、相互矢印）は現代の臨床ソーシャルワークと看護研究の慣習に従います。

現在実装済みの内容：

• ✅ 中心 + 外部システム放射状構造
• ✅ 8 つの品質演算子（強い / 中程度 / 普通 / 弱い / ストレス的 / ストレス的-強い / 対立的 / 破綻）
• ✅ 8 つの方向演算子（一方向と相互、3 つの強度で）
• ✅ カテゴリー色分け（17 カテゴリー）
• ✅ エッジラベル
• ⏳ 中心として埋め込まれたミニジェノグラム（セクション 10 を参照）
• ⏳ 現在の 4 つの基本方位を超えたセクターベースのレイアウトヒント

参考文献：

• Hartman, A. (1978). Diagrammatic assessment of family relationships. Social Casework, 59(8), 465–476.
• Ray, R.A. & Street, A.F. (2005). Ecomapping: An innovative research tool for nurses. Journal of Advanced Nursing, 50(5), 545–552.
• Rempel, G.R., Neufeld, A., & Kushner, K.E. (2007). Interactive use of genograms and ecomaps in family caregiving research. Journal of Family Nursing, 13(4), 403–419.

9. 関連例

サンプルギャラリーからすぐに使えるシナリオ：

10. ロードマップ

計画中 — まだ解析できません。 今日の生成 DSL では使用しないでください。パーサーが拒否または静かに無視します。

• 中心としての埋め込みミニジェノグラム — center: ノード内でフル家族ブロックを宣言（インデントされたカップルと子供）することで、中心を単一の形状ではなく小さなジェノグラムにします。パーサーは現在、center: 下のインデントされたコンテンツをスキップされた行として読み取ります。
• カテゴリーごとのデフォルト矢印意味論 — 例：health システム（受信）と work システム（送信）の自動方向矢印。
• 複数の中心 — 一部のシステムを共有する 2 人のクライアントのエコマップ。
• カスタム色の上書き — システムまたは接続の [color: "#…"]。

早急にこれらが必要な場合は GitHub イシューで追跡してください。