路線データ編集システム - data.json
※注意※　GitHub Pages単体ではJSONを直接更新できません。外部API（Cloudflare Workers）を設定すると保存可能です。

📖 このシステムについて

このシステムは、鉄道路線の運行データを編集・管理するためのツールです。表形式で編集し、保存すると JSON 形式の data.json を出力・更新します。Cloudflare Workers を設定すると外部正本へ保存でき、未設定時はローカル保存（ダウンロード）に切り替わります。

🚀 基本的な使い方

1. タブを選択：上部タブ（鉄道会社／列車種別／路線／駅／区間／直通運転／のりば乗換／保存/読込）から編集対象を選びます。
2. 追加・編集・削除：「+ 追加」→新規行が下部に追加／「編集」→行内の項目を変更／「削除」→行内に確認UIが表示（行内で確定・キャンセル）。
3. 並び替え：各表ヘッダ右端の「▲▼」で昇順・降順の表示切替（表示のみ／保存内容には影響しません）。
4. 必須の入力：必須項目が未入力のセルは赤色でハイライトされます。値を入れると自動で解除されます。
5. IDの重複警告：同一IDが複数ある行は行全体が赤色表示になります。重複を解消してから保存してください。
6. 保存：「保存/読込」タブの「保存」で反映。Workers設定時は外部正本へ保存し、未設定または失敗時は従来保存を試行し、それも不可なら data.json をダウンロードします。

🧭 共通の仕様・ヒント

• 読み取り専用の項目：グレー表示かチェック不可のものは編集できません（例：鉄道会社の「自社」、区間ID、会社IDなど）。
• 候補表示（サジェスト）：駅ID入力欄では、入力中に候補ポップアップが出ます（駅ID・駅名で最大30件）。クリックで入力に反映されます。
• 追加直後のスクロール：新規行は表の末尾に追加され、表コンテナは自動で末尾までスクロールします。
• プレビュー：「保存/読込」タブの「表示/非表示」で現在のJSONを整形表示できます（確認用）。
• のりば未入力の扱い：区間の「始点/終点のりば」は未入力でも保存可能です（セルはオレンジ表示）。

🏢 鉄道会社タブ

何を設定するか：運行会社の基本情報を登録します。

• 会社ID：短い記号（例：KT、HRA）。重複しないようにしてください（重複時は行が赤色になります）。
• 会社名：正式名称（例：Kトライア瑠璃、ヘルヴェティア鉄道局）。
• 自社：この項目は表示のみ（固定）で編集できません。自社となっている会社は meta.ownCompanyId として扱われます。

🚄 列車種別タブ

このタブは読み取り専用です。 種別の追加・編集・削除はできません。表示内容（色・優先度など）の確認にご利用ください。

• 種別ID／種別名／略称／優先度／色：表示のみ。必要に応じて元データ（JSON）側で管理してください。

🛤️ 路線タブ

何を設定するか：路線の基本情報を登録します。

• 路線ID：路線識別子。重複は不可（重複時は行が赤色）。
• 路線名：路線の名称。
• 運営会社ID：登録済みの会社から選択します。
• 路線カラー：新規追加時は見やすい色が自動提案されます。編集で変更可能です。
• 案内種別：[ID, 表示名] のタプルで保持します。区間IDや直通設定IDではこの案内種別IDを使用します。

🚉 駅タブ

何を設定するか：駅の情報を登録します。

• 駅ID：駅の識別子。重複は不可（重複時は行が赤色）。
• 駅名／駅名カナ：検索や候補表示に使用します。
• 緯度・経度：小数可。地図表示等に利用します。

ヒント：上部の検索ボックスで駅名・カナ・IDを部分一致で絞り込めます。

🔗 区間タブ

何を設定するか：駅間の運行区間を登録します（経路検索の基本要素）。

• 区間ID：SGM-路線ID-案内種別ID-始点駅ID-終点駅ID の形式で自動生成されます（編集不可）。案内種別IDは路線の案内種別（serviceCategories）のIDを使用し、ID が無い場合は表示名を用います。
• 路線ID：選択必須。選択すると 会社ID は自動で設定され、編集できません。
• 始点駅ID／終点駅ID：入力中に候補が表示されます。クリックで反映できます。
• のりば（始点／終点）：駅ID変更時、既存の区間に紐づくのりば設定がある場合は自動で引き継がれます。
• 案内種別：路線の案内種別（serviceCategories）から選択します。保存時は表示名（guidance）を保持し、旧データに trainType がある場合はそのまま温存します（UI からは編集しません）。区間IDには案内種別IDが埋め込まれます。
• 所要時間：秒単位で入力します（例：3分30秒 → 210）。
• 距離：キロメートル単位（小数可）。
• 双方向：フラグとして保持します。チェックしても逆方向のレコードは自動生成されません。
• 降車専用：チェック時、始点からの乗車は不可（終点での降車のみ）。

ヒント：上部の路線フィルタで該当路線のみ表示できます。

🔄 直通運転タブ

何を設定するか：路線間の直通関係を登録します。

• 設定ID：TSV-乗入元路線ID-元案内種別ID-乗入先路線ID-先案内種別ID の形式で自動生成されます（編集不可）。
• 乗入元路線／乗入先路線：対象路線を選択します（選択に応じて設定IDが自動更新）。
• 元案内種別／先案内種別：各路線の案内種別（serviceCategories）を選択します。保存時は表示名（fromGuidance/toGuidance）を保持し、案内種別IDは設定ID（configId）に組み込まれます（互換維持）。
• 直通方向：「相互直通」または「一方向」を選択します。
• 説明：任意のメモ（例：SUI⇔KT（普通））。

重複検出：同じ設定IDの重複だけでなく、逆向き（乗入元/先が入れ替わり、種別も逆）の重複も警告として行が赤色になります。

🚶 のりば乗換タブ

何を設定するか：同一駅構内での番線間移動時間を登録します。

• 乗換ID：TSF-駅ID-乗換元のりば-乗換先のりば の形式で自動生成（編集不可）。重複時は行が赤色になります。
• 駅ID：入力中に駅候補ポップアップが表示されます。クリックで反映。
• 乗換元のりば／乗換先のりば：番線名（自由入力）。
• 乗換時間：秒単位で入力します（例：4分 → 240）。

注意：同じ番線内での種別変更や直通関係は本タブではなく「直通運転」で設定してください。

💾 保存/読込タブ

読込：

• 「ファイル選択」で data.json を読み込むと即時反映します（編集中の内容は上書き）。

保存：

• Workers API URL 設定あり：保存時に認証を行い、外部正本（Cloudflare Workers）へ保存します。
• Workers API URL 未設定：従来のサーバー保存を試行します。
• サーバー保存も不可：data.json をダウンロードします。

プレビュー：

• 「表示/非表示」で現在のJSONを整形表示します。出力前の最終確認に便利です。

⚠️ 注意事項

• 保存の徹底：編集内容は「保存/読込」タブで保存しない限り反映されません。
• IDの一意性：各種IDは重複不可です。赤色表示は重複や未入力の警告です。
• 削除操作：削除は行内の確認UIで確定します。確定後は元に戻せないためご注意ください。
• 時間の単位：所要時間・乗換時間は秒で入力します。
• サーバー接続表示：画面上部に「サーバー接続: オンライン／オフライン（ローカルモード）」を表示します。

💡 よくある質問

Q: 編集を間違えました。元に戻せますか？

A: 編集中は「取消」で行の編集前状態に戻せます。保存前ならページ再読込で最後に保存した状態に戻ります。オンライン保存時はバックアップ（data.backup.●●●.json）から復元できます。

Q: 行が赤くなりました。

A: 必須未入力またはID重複、直通運転の逆向き重複検出などの警告です。該当箇所を修正して赤色表示を解消してください。

Q: データが多くて探しづらいです。

A: 駅タブの検索ボックスや、区間タブの路線フィルタを活用してください。各列の「▲▼」で並び替えも可能です。

Q: 保存ボタンを押しても何も起きません。

A: オフライン時はダウンロードが開始されます。ブラウザのダウンロードがブロックされていないかご確認ください。

📞 困ったときは

本システムに関する質問や不具合は、Kトライア瑠璃交通 デジタルソリューション本部へお問い合わせください。
「サーバー接続」表示の状態、操作手順、発生箇所などをお伝えいただくとスムーズです。