theyworkforyou
1.0.0
こんにちは、みんな、
これは、TheyWorkForYou.com Web サイトを動かすソース コードです。これは主に PHP で書かれていますが、データベースのロードとインデックス作成用の Perl スクリプトもいくつかあります。バックエンド パーサー コードは別のものであり、GitHub で入手できます。これについて詳しくは、TheyWorkForYou のパーサー情報ページをご覧ください。
このディストリビューションの TheyWorkForYou ソース コードは、BSD スタイル ライセンスに基づいてリリースされています。これは、大まかに言うと、コードまたはコードから作成されたバイナリを自由にコピー、使用、変更、再配布できることを意味します。商用または非商用の使用は許可されています。ただし、当社は保証を否認し、当社の許可なく当社の名前を使用しないことを期待します。正確な法的情報については、ファイル LICENSE.md を参照してください。
英国下院での国会議員の発言はすべてハンサードと呼ばれる文書に記録されている。 TheyWorkForYou は、この重要な民主的リソースを理解するのに役立ちます。貴族院、スコットランド議会、北アイルランド議会のものも含まれます。
インストールに関する質問については、INSTALL.md を参照してください。
ご質問がある場合は、mySociety TheyWorkForYou メール リスト (https://groups.google.com/a/mysociety.org/forum/#!forum/theyworkforyou) が最適です。
最新バージョンの Docker が必要です。
docker compose up [ -d ]実行すると、環境が起動します。これを初めて実行するときは、さまざまなイメージがダウンロードされ、アプリケーション イメージがローカルに構築されるため、数分かかる場合があります。
完了すると、 http://localhost:8000でフロント ページを表示できるようになります。ただし、デフォルトのビルドにはデータが含まれていないため、Parlparse データ (メンバー、ディベート、投票など) のダウンロードとインポートについては INSTALL.md を参照してください。
docker compose down実行すると、環境を停止できます。 -v追加すると、使用されている可能性のある Docker ボリューム (すべてのデータを含む) が削除されます。
DOCKER.md には、開発環境に関するいくつかの詳細なメモと、いくつかの便利なコマンドおよびより詳細な Docker 固有の設定メモが含まれています。
WSL の使用中に VS Code で xdebug を使用するには、サブシステムの IP アドレスのサブシステム内で WSL_IP の環境変数を設定する必要があります。
[コード] ドロップダウン (右上) を選択し、新しいコードスペースを開始して (または GitHub CLI を使用して)、Github で新しいコードスペースを開始します。
上のバッジを使用して、基本的な量のデータを含むプリビルドを使用することもできます。
これにより、Docker コンテナーと環境がセットアップされます。完了すると、ターミナル パネルの [ポート] タブでサイトへのリンクが利用できるようになります。
最小限のデータを入力するには、 scripts/quick-populateを実行します (約 1 時間)。
再デザインを使用するページで作業している場合は、変更後に静的アセットをコンパイルする必要があります。
script/watch-cssまたは
cd www/docs/stylebundle exec compass compile 、または変更時に再コンパイルする場合はbundle exec compass watch script/lint php ファイルに対して php-cs-fixer を実行します。
TheyWorkForYou には、PHPunit を使用したテスト スイートが含まれています。テストを実行するには、環境変数TWFY_TEST_DB_HOST 、 TWFY_TEST_DB_NAME 、 TWFY_TEST_DB_USERおよびTWFY_TEST_DB_PASSが設定されており、テスト データベースの関連情報が含まれていることを確認します。データベースはテスト中に削除されて再構築されるため、重要なコピーではないことを確認してください。
PHPUnit の一部のバージョンでは、コード カバレッジ レポートに関してエラーがスローされる場合があります。この場合、Composer によってインストールされ、 /vendor/bin/phpunitにあるバージョンは正しく実行されるはずです。
このプロジェクトで Web ベースのクロスブラウザ テスト ツールを使用できるようにしてくれた Browserstack に感謝します。
