Sessionplan

Sessionplan

Sessionplanは、インタラクティブなタイムラインを使ってワークショップ、研修、会議、イベントを視覚的に計画できる、無料のブラウザベースのプログレッシブウェブアプリです。

→ sessionplan.de で今すぐお試しください

機能

• 視覚的なタイムライン — ブロックをドラッグ＆ドロップしてアジェンダを作成できます
• 自動時間計算 — 開始時刻と所要時間がすぐに更新されます
• ライブモード — セッション中にリアルタイムでプランを確認できます
• ブロックの種類とテンプレート — カスタムカテゴリ、デフォルトライブラリ、再利用可能なテンプレート
• グループ分けとブレイクアウト — 並行セッション、設定可能なレーン、レーンごとの進行役
• 共有とエクスポート — スナップショットリンク、JSON のエクスポート／インポート、印刷用 PDF
• オフライン優先 — 初回読み込み後は完全にオフラインで動作します（PWA）
• 登録不要 — デフォルトでは、すべてのデータがブラウザ内に保存されます

技術スタック

• Vite · TypeScript · React 18 · Tailwind CSS · shadcn/ui
• react-router-dom · react-i18next · @dnd-kit · Vitest

はじめに

git clone <repository-url>
cd sessionplan
npm install
npm run dev

ブラウザで http://localhost:5173（または Vite が割り当てたポート）を開きます。

セルフホスト

Sessionplan は静的ウェブアプリです。依存関係をインストールしてビルドし、生成されたファイルを任意の静的ウェブサーバーから配信してください。プランはブラウザ内に保存され、URL リンクとして共有するか、JSON としてエクスポートできます。

Dynamic-Link セッション API（オプション）

公開配布版には、単一の PHP API data/sessions.php と、それが必要とする _shared モジュールが含まれています。この API は厳密なサーバーブラインド方式です。Dynamic Link はすべてアップロード前にブラウザ内で暗号化され、サーバーには暗号化されたエンベロープ、タイトル、技術メタデータ、書き込み権限のハッシュのみが保存されます。暗号化キーはサーバーに保存されません。このビルドには、復旧キーの預託機能もサーバー側の分析機能やイベントログとの連携もありません。

Dynamic Link を永続化したいセルフホストユーザーには、data/ ディレクトリを配信できる PHP ランタイムが必要です。

1. PHP が data/sessions.php を実行できるように data/ ディレクトリをデプロイします（エンドポイントは data/_shared/ にある共有モジュールを読み込みます）。
2. PHP プロセスの SP_SESSIONS_DIR に、ウェブルートの外部にあるパスを設定します（例：/var/lib/sessionplan/sessions）。このディレクトリは PHP プロセスが書き込み可能である必要があります。API はセッションごとに JSON ファイルを 1 つずつこのディレクトリに保存します。
3. プランナーをステージング用または別のホスト名で配信する場合は、必要に応じて SP_ALLOWED_ORIGIN に追加のオリジンを 1 つ設定します（完全一致）。
4. data/_shared/ へのウェブからの直接アクセスをブロックします（Apache/Nginx の設定などを使用）。共有モジュールは data/sessions.php から読み込まれますが、単独の URL として配信するものではありません。

追加の環境変数（どちらも安全な値がデフォルトで設定されており、インターネットに直接公開する場合は未設定のままでもかまいません）：

• SP_PUBLIC_BASE_URL — 分析用の追跡対象 Dynamic Link URL を再構築する際に使用するベース URL を上書きします。デフォルトは https://sessionplan.de です。
• SP_TRUSTED_CLIENT_IP_HEADER — 安全なヘッダー名（例：CF-Connecting-IP、X-Real-IP）を設定すると、レート制限と IP ごとの容量カウンターは REMOTE_ADDR の代わりに、そのヘッダーの値を使用します。API の前段に信頼できるフロントエンドプロキシがある場合にのみ有効にしてください。

参照用の Apache 設定は public/.htaccess にあります。PHP ランタイムがなくても、プランナーは引き続きローカルで動作し、URL フラグメントまたは JSON エクスポートでプランを共有できます。

API を使ったローカル開発（npm run dev:full）

セッション API と連携するプランナーをローカルで開発するには、次の手順を実行します。

1. npm run dev:full を実行します。Vite の開発サーバー（ポート 8080）と、API 用の PHP 組み込みサーバー（ポート 8081）が同時に起動します。
2. VITE_SESSIONS_API=http://localhost:8081/data/sessions.php を設定して、フロントエンドの接続先を API に指定します（.env.example を参照）。同一オリジンでデプロイする場合、プランナーは同一オリジンの data/sessions.php パスを代替先として使用しますが、Vite の開発サーバーではこのパスを提供できません。
3. CORS：dev:api は SP_ENV=development を設定し、任意のポートの localhost／127.0.0.1 オリジンも許可します。localhost 以外のステージング環境を確認する場合は、代わりに SP_ALLOWED_ORIGIN を設定してください。
4. ストレージ：セッションはデフォルトでリポジトリのルートにある sessions_data/（Git の追跡対象外）に保存されます。ローカルでの実験を超えて利用する場合は、SP_SESSIONS_DIR を、配信対象のドキュメントルート外にあるディレクトリに指定してください。

ターミナルを分けて個別に起動する場合は、npm run dev と npm run dev:api を実行してください（PHP 7.4 以上が必要です）。

ライセンス

Sessionplan は GNU Affero General Public License v3.0（AGPL-3.0） のもとでライセンスされています。

AGPL により、ネットワークサービスとして配布される改変版もオープンソースにする必要があります。これにより、プロジェクトが商用フォークから保護される一方、無料でのセルフホストが可能です。

全文については LICENSE を参照してください。

貢献

バグ報告やプルリクエストを歓迎します。詳細は CONTRIBUTING.md を参照してください。

セキュリティ

脆弱性の報告については SECURITY.md を参照してください。

一般公開用の配布

このリポジトリには、フロントエンドアプリケーションと中立的なサンプルコンテンツが含まれています。 アナリティクスの連携、運営者固有の連絡先情報、法的ページ、サーバー実装は含まれていません。public/data/ 内の静的なサンプルコンテンツは、本番コンテンツとは独立しています。

.public-export.json には、このエクスポートで生成されたファイルが記載されており、コンテンツから算出された publicRevision マーカーと generated 日付が含まれています。非公開のコミット参照やファイルごとのハッシュを公開せずに、配布物を識別できます。 working-tree-preview ソースはレビュー専用です。公開するエクスポートは、コミット済みのリリースリビジョンから生成してください。