Sistema de gerenciamento de dados de corridas de Fórmula 1
Antes de executar o projeto, certifique-se de ter as seguintes dependências instaladas:
- Antes de começar, verifique se você possui o
Python
instalado em sua máquina. Se não tiver, você pode baixar oPython
aqui.
Há duas formas de executar o projeto, a primeira é utilizando o docker
e a segunda é executando o projeto pelo GUI do POSTGRESQL
.
Portanto, caso opte por utilizar o docker
, é necessário que o mesmo esteja instalado em sua máquina. Para isso, siga as instruções de instalação do docker e do docker-compose.
Caso opte por utilizar o GUI do POSTGRESQL
(PG_ADMIN), é necessário que o mesmo esteja instalado em sua máquina. Para isso, siga as instruções de instalação do postgresql.
Siga as etapas abaixo para executar o projeto em sua máquina local:
Execute os seguintes comandos a partir da pasta raiz do projeto:
git clone https://github.com/Ryrden/Formula-1.git
Este link pode ser encontrado no botão verde acima Code
.
sem nix:
pip install .
com nix:
nix develop
crie um arquivo .env na raiz do projeto e coloque as seguintes variáveis de ambiente:
DB_HOST=
DB_PORT=
DB_USER=
DB_PASSWORD=
DB_DATABASE=
A partir daqui você deve conectar ao banco de dados utilizando as seguintes credenciais (ou as que você definiu no arquivo .env):
- Host: localhost
- Port: 5432
- login: postgres
- password: postgres
- database: postgres
- url: jdbc:postgresql://localhost:5432/postgres
Após isso, dentro do script init_schema.SQL
na pasta database/
, substitua a string
DirLocal pelo endereço onde se encontra as tabelas CSV para inserção dos dados. exemplo:
Caso esteja utilizando o docker
:
substitua a string DirLocal
por /database/tables_csv/
:
Caso esteja utilizando o GUI do POSTGRESQL
:
substitua a string DirLocal
pelo endereço completo de uma pasta que contenha os arquivos CSV dentro do GUI do POSTGRESQL.
por exemplo, se o PG_ADMIN estiver instalado em C:\Program Files\pgAdmin 4\
, então crie a pasta tables_csv
ai dentro e substitua a string DirLocal
por C:\\Program Files\\pgAdmin 4\\tables_csv\\
. (É necessário utilizar duas barras invertidas somente se estiver utilizando o SO Windows).
Outra opção para inserir os dados pelo PG_ADMIN
é utilizar a interface de Import/export para arquivos csv, para saber mais, acesse Import/Export Data.
Para executar o projeto utilizando o docker
, basta executar o seguinte comando na raiz do projeto:
docker compose up -d
Assim que terminar a utilização e quiser parar o projeto, basta executar o seguinte comando:
docker compose down
se deseja apagar os dados do banco de dados, basta executar o mesmo comando anterior, porém com a flag -v
:
docker compose down -v
python -m proj_labbd
Por fim, execute os scripts da pasta database para uso do sistema
Se você deseja contribuir para este projeto, siga as etapas abaixo:
- Faça um fork deste repositório.
- Crie um branch:
git checkout -b <nome_branch>
. - Faça suas alterações e confirme-as:
git commit -m '<mensagem_commit>'
- Envie para o branch original:
git push origin <nome_do_projeto> / <local>
- Criar a solicitação de pull.
Como alternativa, consulte a documentação do GitHub sobre como criar uma solicitação de pull.
Joaolucasp |
Joelcoelho29 |
Ryrden |
Este projeto está sob licença. Consulte LICENSE para obter mais informações.