theyworkforyou
1.0.0
Olá pessoal,
Este é o código-fonte que alimenta o site TheyWorkForYou.com. É escrito principalmente em PHP, embora também existam alguns scripts Perl para carregamento e indexação de banco de dados. O código do analisador de back-end é separado e está disponível no GitHub. Você pode ler mais sobre isso na página de informações do analisador do TheyWorkForYou
O código-fonte do TheyWorkForYou nesta distribuição é lançado sob uma licença estilo BSD. Grosso modo, isso significa que você está livre para copiar, usar, modificar e redistribuir o código ou binários feitos a partir do código. O uso comercial ou não comercial é permitido. No entanto, isentamos a garantia e esperamos que você não use nosso nome sem nossa permissão. Consulte o arquivo LICENSE.md para obter informações legais exatas.
Tudo o que os deputados dizem na Câmara dos Comuns do Reino Unido está registado num documento chamado Hansard; TheyWorkForYou ajuda a dar sentido a este recurso democrático vital. Também inclui itens da Câmara dos Lordes, do Parlamento Escocês e da Assembleia da Irlanda do Norte.
Consulte INSTALL.md para questões de instalação.
Se você tiver dúvidas, o melhor lugar para perguntar é a lista de e-mail mySociety TheyWorkForYou em https://groups.google.com/a/mysociety.org/forum/#!forum/theyworkforyou
Você precisará de uma versão recente do Docker.
Executar docker compose up [ -d ] iniciará o ambiente. A primeira vez que você executar isso pode levar alguns minutos, pois várias imagens são baixadas e a imagem do aplicativo é criada localmente.
Quando terminar, você poderá visualizar a página inicial em http://localhost:8000 . No entanto, a compilação padrão não contém dados, então dê uma olhada em INSTALL.md para obter informações sobre como baixar e importar dados do Parlparse (membros, debates, votos, etc.).
Você pode interromper o ambiente executando docker compose down . Adicionar um -v removerá quaisquer volumes Docker que possam estar em uso, incluindo todos os seus dados.
DOCKER.md tem algumas notas mais detalhadas sobre o ambiente de desenvolvimento, juntamente com alguns comandos úteis e notas de configuração mais detalhadas específicas do Docker.
Para usar xdebug no VS Code ao usar WSL, você precisará definir uma variável ambiental do WSL_IP dentro do subsistema do endereço IP do subsistema.
Inicie um novo codespace no Github selecionando o menu suspenso Código (canto superior direito) e iniciando um novo codespace (ou use a CLI do GitHub).
Você também pode usar o emblema acima para usar uma pré-construção com uma quantidade básica de dados.
Isso configurará o contêiner e o ambiente do Docker. Ao finalizar, o link para o site deverá estar disponível na aba de portas do painel do terminal.
Para preencher com uma quantidade mínima de dados, execute scripts/quick-populate (cerca de 1 hora).
Se estiver trabalhando em uma página que usa o redesenho, você precisará compilar ativos estáticos após as alterações:
script/watch-cssou
cd www/docs/stylebundle exec compass compile para uma compilação única ou bundle exec compass watch para recompilar em caso de alterações script/lint executará php-cs-fixer para arquivos php.
TheyWorkForYou inclui um conjunto de testes, usando PHPunit. Para executar testes, certifique-se de que as variáveis de ambiente TWFY_TEST_DB_HOST , TWFY_TEST_DB_NAME , TWFY_TEST_DB_USER e TWFY_TEST_DB_PASS estejam configuradas e contenham informações relevantes para seu banco de dados de teste. O banco de dados será desmontado e reconstruído durante o teste, portanto, certifique-se de que não seja uma cópia importante.
Você pode descobrir que em algumas versões do PHPUnit são gerados erros em relação aos relatórios de cobertura de código. Se for esse o caso, a versão instalada pelo Composer e localizada em /vendor/bin/phpunit deverá rodar corretamente.
Obrigado ao Browserstack que nos permitiu usar suas ferramentas de teste entre navegadores baseadas na web para este projeto.
