anabeatrizzz / pi-um-univesp

Site divulgando doações de sobras de materiais de construção - Projeto Integrador I da UNIVESP

Configurações

Windows

1. Instale Python:

• Acesse https://www.python.org/downloads/ e clique em Download Python.
• Depois de instalado, acesse o Prompt de comando pressionando a teclado do Windows + X e selecionando a opção Prompt de comando. Pesquise como abrir o Prompt de comando se isso não funcionar.
• Escreva py --version (ou python --version se der erro) para saber a versão Python instalada.

2. Instale pip:

• Escreva py get-pip.py (ou python get-pip.py) no Prompt de comando. Se não funcionar escreva python -m ensurepip --upgrade.

3. Crie um ambiente virtual:

• Abra uma nova janela de Prompt de comando
• Vá até a pasta onde quer que o ambiente virtual fique. Faça isso escrevendo cd e o nome da pasta em seguida, por exemplo, cd Documentos.
• Escreva py -m venv pi-um (ou python -m venv pi-um se der erro). Que criará uma pasta chamada pi-um e o ambiente virtual.
• Para ativar o ambiente virtual escreva pi-um\Scripts\activate.bat.

4. Instale Django:

• Na mesma janela de Prompt de comando usada para ativar o ambiente virtual escreva py -m pip install Django.
• Depois da instalação escreva django-admin --version para saber a versão Django instalada.

5. Instale yarn com npm:

• Acesse https://nodejs.org/en/download/ e siga as instruções para instalar NodeJS.
• Escreva node -v e em seguida, npm -v para verificar se a instalação ocorreu com sucesso.
• Escreva npm install --global yarn.

6. Instale git

• Acesse https://gitforwindows.org/ e clique em Download.
• Abra o Prompt de Comando e escreva git version para verificar a versão e constatar que git foi instalado corretamente.
• Siga para o tópico Instalando e executando este projeto

MacOS

1. Instale Python:

• Abra uma nova janela de terminal e escreva brew install python3.

2. Instale pip:

• sudo easy_install pip

3. Crie um ambiente virtual:

• sudo pip install virtualenv
• virtualenv pi-um
• cd pi-um
• source bin/activate

4. Instale Django:

• sudo pip install django
• python -m django --version

5. Instale yarn com npm:

• Escreva brew install node.
• Escreva node -v e em seguida, npm -v para verificar se a instalação ocorreu com sucesso.

6. Instale git

• Escreva brew install git no terminal e depois veja a versão escrevendo git version.
• Siga para o tópico Instalando e executando este projeto

Linux

1. Instale Python

• Primeiro veja se Python já está instalado escrevendo py --version ou python --version no terminal.
• Se a versão não for retornada vá até https://www.python.org/downloads/ e clique em Download Python.

2. Instale pip

• Escreva python get-pip.py (ou python -m ensurepip --upgrade se não funcionar).

• sudo pip install virtualenv

• virtualenv pi-um

• cd pi-um

• source bin/activate

4. Instale Django:

• sudo pip install django
• python -m django --version

5. Instale yarn com npm:

• Acesse https://nodejs.org/en/download/package-manager/#debian-and-ubuntu-based-linux-distributions e escolha sua distribuição e siga as instruções.

6. Instale git:

• Acesse https://github.com/git-guides/install-git#install-git-on-linux, escolha sua distribuição e siga as instruções.
• Siga para o tópico Instalando e executando este projeto

Instalando e executando este projeto

1. Acesse a pasta pi-um

• cd pi-um

2. Clone este repositório (opcional se já feito antes)

• git clone https://github.com/anabeatrizzz/pi-um-univesp.git
• Se aparecer a mensagem "Support for password authentication was removed" siga este tutorial

3. Entre na pasta frontend-pi-um pelo terminal/prompt de comando

• cd pi-um-univesp/frontend-pi-um

4. Crie a pasta node_modules (opcional se já feito antes e nenhuma dependência nova foi adicionada)

• yarn install

5. Crie a pasta build (opcional se já feito antes)

• yarn build

Executando backend

1. Acesse a pasta pi-um

• cd pi-um

2. Inicie o ambiente virtual se não estiver iniciado

• Windows: pi-um\Scripts\activate.bat
• MacOS: source bin/activate

3. Entre na pasta pi-um-univesp

• cd pi-um-univesp

4. Execute o servidor:

• python manage.py runserver.

5. Acesse http://127.0.0.1:8000/

Executando frontend

1. Entre na pasta frontend-pi-um

• cd pi-um/pi-um-univesp/frontend-pi-um

2. Escreva yarn start

O que cada pasta representa

• frontend-pi-um: Guarda todos os arquivos relacionados ao framework web React.
• pi-um-univesp: Guarda todos os arquivos relacionados ao framework Django.

Referencias

• Setup Django Mac: How To Install Django On Mac
• How to install Django on Windows
• Documentação para instalar pip
• Install git