このプロジェクトについて

Worship Presenter Webは、礼拝の進行表を完成したスライドに変換するために設計されたセルフホスト型ハブです。セブンスデー・アドベンチスト教会の会衆向けに構築されましたが、スライドテンプレートがコードではなくデータであるため、同様の礼拝プログラムを実施するどの教会にも適合できます。 中核となるワークフローは、Webフォームに貼り付けるか、チャットボットからシークレットゲート付きWebフックで投稿された進行表を受け取り、単一のハイドレート済みスライドプランから3つの出力を生成します。オフライン使用向けのダウンロード可能なPowerPointデッキ、全画面ブラウザスライドショー、独立したプロジェクターウィンドウを備えたデュアルスクリーン発表者モードです。つまり、同じレイアウトが4つの出力すべて(PowerPoint、Webスライドショー、プロジェクター、ライブプレビュー)を駆動し、フォーマットごとのレイアウトコードは不要です。 主な機能は次のとおりです。 - WebフォームまたはWebフックによる進行表の取り込み。認識されない行は黙って破棄されるのではなく表面化されます。 - 695の賛美歌からなるローカルコーパスからの賛美歌解決。番号で検索され、各節の後にリフレインを繰り返すタイトルスライドと歌詞スライドに展開されます。 - SQLiteレジストリに保存された28の編集可能なスライドテンプレート。要素の移動、サイズ変更、スタイル設定を行うキャンバスエディターに加え、カスタムテキストボックスや図形を追加する機能を備えています。 - 現在と次のスライド、サムネイルフィルムストリップ、スライドリスト、任意のスライドにジャンプできるグリッド、実行シート、およびプロジェクターにドラッグできる実際のセカンドウィンドウを備えた発表者モード。 - プロジェクターをブラックアウトし、位置を失わずに復元するブランクスクリーン機能。 - 選択可能なトランジション(なし、カット、フェード、ディゾルブ、プッシュ)をデッキとブラウザの両方に同一に適用。 - 礼拝中にKJVの聖句をプロジェクターに表示する聖句検索。 - 画像アップロードまたは許可リスト登録済みURLを使用した案内フライヤー。 - 個人ごとの管理者アカウントとオペレーターアカウント、レート制限付きサインイン、失効可能なセッションを備えたアカウントとロール。 アプリケーションには2つのデフォルトコーパスが同梱されています。賛美歌集コーパス(セブンスデー・アドベンチスト賛美歌集からの695の賛美歌)とKJV聖書コーパス(66巻、1,189章、31,102節)です。両方ともリポジトリにコミットされているため、クローンは起動時にネットワーク接続なしで賛美歌番号と聖書参照を解決できます。コーパスは起動のたびにコミット済みファイルから調整されます。 技術要件はGo 1.24とNode.js 22以降です。ストレージはSQLiteを使用し、別途データベースサーバーは不要です。スタックにはGo API、Viteで構築されたReact SPA、PPTXワーカーが含まれます。クイックスタートは、リポジトリをクローンし、npm install、npm run setup(.envを新しいシークレットで生成し、データベースを作成し、スライドレジストリをシードし、管理者パスワードを出力します)、およびnpm run devを実行して、Go APIをポート3000で、React SPAをポート5173で起動します。 プロジェクトには、プライベートデータの取り扱いに関するガイドライン、デプロイメントドキュメント、決定記録を含むconstitutionディレクトリが含まれています。会衆データが追跡対象ファイルに達するとテストが失敗し、機密情報の偶発的な公開を防ぎます。元のプライベートリポジトリには実際のメンバー名、未成年者を含む特定可能な人物の写真、プライベートメッセージのスクリーンショット、ライブ決済コードが含まれていたため、リポジトリは合成のサンプル会衆とともに単一の初期コミットから始まります。 コードはMITライセンスの下でライセンスされていますが、Worship Presenter Webという名前、頭字語WDI、およびアイコンまたはワードマークはMITライセンスの対象外です。賛美歌コーパスを含む第三者のコンテンツは、ATTRIBUTIONS.mdで別途カバーされています。このプロジェクトは、他の伝統や賛美歌集への適応を奨励しており、同梱されているコーパスに加えて追加の賛美歌集コーパスを追加することをサポートしています。