組織図

組織図について

組織図（organizational chart）は、組織の公式な報告関係をマッピングします。誰が誰を管理し、どのチームがどのリーダーの下にあり、未充足のポジションや外部アドバイザーがどこに位置するかを示します。HR チームは人員計画時に参照し、創業者は取締役会前に使用し、運営管理者は組織再編時に配布します。汎用のフローチャートとは異なり、組織図は人物（およびポジション）を主要なエンティティとして扱い、階層はインデントや明示的なエッジでエンコードされます。

Schematex は、空きポジション・マトリックス（点線）報告・アシスタント関係の拡張を含む一般的な組織図の慣習に従っています。組織図に単一の ISO 標準はなく、ここで実装されている慣習は HR の実践とソフトウェア業界の規範から引用しています。学術的な背景については Fayol (1916) と Wikipedia の組織図記事 を参照してください。

1. はじめての組織図

最小限の実用的な組織図：1つの空きポジションを含む3階層の階層構造。

以下の4つのルールで利用の80%をカバーできます。

1. キーワード orgchart で始め、オプションで引用符付きタイトルを続けます。
2. 各人物はノード — id: "Name" | "Title" | "Department" [props]。| で名前、タイトル、部署のフィールドを区切ります。
3. インデントが階層を決定します — スペース2つ（以上）を増やすごとに、ノードが直上の最も少ないインデントのノードの1段深い子になります。
4. 空きポジションは open id: または draft id: で宣言し、外部アドバイザーは advisor id: で宣言します。

コメントは単独行の # で始める必要があります（インラインの末尾 // も削除されます）。

2. ノード

ノード行の形式は [kind] id: fields [props] です。id は [A-Za-z][A-Za-z0-9_-]* にマッチする必要があります。

2.1 フィールド（パイプ区切り）

: の後、オプションの [props] ブロックの前の部分が | で分割されます。

alice: "Alice Zhang"                                # name only
alice: "Alice Zhang" | "VP Engineering"             # name + title
alice: "Alice Zhang" | "VP Eng" | "Platform"        # name + title + department
alice: "Alice Zhang" | "VP Eng" | "Platform" | "x@co.com"  # + info line

2.2 ノードの種類

ID の前のオプションの種類キーワードでノードの描画方法が変わります。

2.3 ノードプロパティ

プロパティはノード行の末尾の [key: value, …] に記述します。

ロールアイコン — role: の値が表示アイコンに対応します。受け付けるキーワード（大文字・小文字不問）：

3. 階層

階層はインデントで表現します。最も一般的なパターンです。各ノードはその上でインデントが小さいノードの子になります。タブはスペース2つとして扱われます。

ceo: "CEO"
  cto: "CTO"           # child of ceo (indent 2)
    eng: "Engineer"    # child of cto (indent 4)
  cfo: "CFO"           # child of ceo (indent 2, same level as cto)

または、reports: プロパティを使って、インデントに関係なく親を明示的に設定することもできます。

orgchart "Flat file"
ceo: "CEO"
cto: "CTO" [reports: ceo]
eng: "Engineer" [reports: cto]

4. エッジ

エッジには2種類あります。ほとんどの報告ラインはインデント階層から自動的に生成されます。明示的に書くことも、マトリックス（点線）ラインを追加することもできます。

明示的なエッジは、両方のノード ID がすでに宣言されている必要があります。インデントで既に示されている同じ関係は、明示的に report エッジを書いても重複しません。

エッジラベルもサポートされています。

pm1 -.-> design [label: "product partnership"]

5. 設定

config: 行でレイアウトと方向を調整します。各行を独立した行に記述します。

レイアウトの注意：

• tree — 分岐コネクターを持つ標準的な階層ツリー。ほとんどの組織図に最適。
• list / directory / compact — コンパクトなインデント付きディレクトリビュー。ツリーの分岐が扱いにくくなる大人数リストに適しています。

ツリーレイアウト（デフォルト）— 分岐コネクターと部署カラーコーディングを持つアバターカード。〜30人以下のチームに最適。

リストレイアウト — インデントガイド付きのコンパクトなディレクトリ行。ツリーの分岐が扱いにくくなる大チームに最適。

6. ラベルとコメント

• タイトル： orgchart "Acme Corp" — 最初の行のみ。
• 名前フィールド： コロンの後の最初のパイプ区切りフィールド。引用符あり（"Alice Zhang"）または引用符なし（Alice）。
• タイトル/部署フィールド： 2番目と3番目のパイプ区切りフィールド。
• 情報行： 4番目のパイプ区切りフィールド、または note:、email:、phone:、location: プロパティで設定。最初に見つかったものが優先。
• コメント： 行頭（先頭スペースの後）の #。インラインの // も削除されます。

7. 予約語とエスケープ

行頭の予約語： orgchart（ヘッダー）、config:、role、open、draft、tbh、advisor、external。

予約演算子トークン — ID 内でこれらのシーケンスを避けてください：->、-.->.

ID ルール： [A-Za-z][A-Za-z0-9_-]* にマッチする必要があります。スペースを含む名前は、ID ではなく引用符付き名前フィールドに入れてください。

スペースを含む props 値（例：department: "Platform Eng"）はダブルクォートで囲む必要があります。

8. よくある間違い

9. 文法（EBNF）

document       = header (blank | comment | config | edge | node)*

header         = "orgchart" ( WS quoted-string )? NEWLINE
quoted-string  = '"' any-char-but-quote* '"'

config         = "config" WS ":" WS key WS "=" WS value NEWLINE
key            = "direction" | "layout"

node           = INDENT* kind? id ":" WS fields ( "[" node-attrs "]" )? NEWLINE
kind           = "role" | "open" | "draft" | "tbh" | "advisor" | "external" | "person"
fields         = field ( "|" field )*
field          = quoted-string | unquoted-text
node-attrs     = node-attr ("," node-attr)*
node-attr      = "role:" role-keyword
               | "icon:" role-keyword
               | "department:" text
               | "status:" ( "new" | "leaving" | "on-leave" )
               | "avatar-color:" quoted-hex
               | "gender:" ( "male" | "female" )
               | "note:" text
               | "email:" text
               | "phone:" text
               | "location:" text
               | "assistant-of:" id
               | "matrix:" id-list
               | "reports:" id
               | bare-flag

bare-flag      = "open" | "draft" | "tbh" | "external"

edge           = id WS edge-op WS id ( "[" edge-attrs "]" )? NEWLINE
edge-op        = "->" | ".->"  // -.-> for matrix
edge-attrs     = "label:" quoted-string

id             = [A-Za-z] [A-Za-z0-9_-]*
comment        = ( "#" | "//" ) any NEWLINE

権威ある情報源：src/diagrams/orgchart/parser.ts。このドキュメントとパーサーが乖離している場合、パーサーが優先されます。Issue を立ててください。

10. ロードマップ

計画中 — 現在はパース不可。 生成する DSL でこれらを使用しないでください。パーサーが拒否または無視します。

• assistant-of: の視覚的レンダリング — プロパティはパースされ AST に格納されますが、レンダラーはまだアシスタントのエルボーコネクターを描画しません。
• 設定 coloring — 部署ベースのカラーテーマ（coloring: department）。
• 設定 compact サイズ段階 — 明示的なカードサイズ制御（size: small | medium | large）。
• span: ノード幅 — ツリーレイアウトで複数の兄弟列にまたがるノード。
• 写真 / アバター URL — avatar: "https://…" で実際の顔写真を表示。
• HRIS フォーマットへのエクスポート — SVG に加えて JSON/CSV 構造化出力。

早急に必要な場合は GitHub の Issue でトラッキングしてください。

関連サンプル

サンプルギャラリーから使用可能なシナリオ：