Instalação

Siga estas etapas para configurar o projeto localmente:

1. Clone o repositório

   git clone https://github.com/usuario/nome-do-repositorio.git

2. Navegue até o diretório do projeto

   cd nome-do-repositorio

3. Crie e ative um ambiente virtual

   Para Windows:

   python -m venv venv
   .\venv\Scripts\activate

   Para macOS e Linux:

   python3 -m venv venv
   source venv/bin/activate

4. Instale as dependências

   pip install -r requirements.txt

5. Configure as variáveis de ambiente

   • Instale o python-dotenv se ele não tiver sido instalado do arquivo requirements.txt, para gerenciar variáveis de ambiente a partir de um arquivo .env:

     pip install python-dotenv

   • Crie um arquivo .env na raiz do projeto e adicione as seguintes variáveis (ajuste os valores conforme necessário):

     DEBUG=True
     SECRET_KEY=sua_chave_secreta
     DATABASE_URL=postgres://usuario:senha@localhost:5432/nome_do_banco

   • Certifique-se de que o arquivo .env está listado no .gitignore para não ser commitado no repositório.

     Exemplo de entrada no .gitignore:

     .env

   • Para carregar variáveis do .env em seu projeto Django, adicione o seguinte código no início do seu settings.py:

     from dotenv import load_dotenv
     import os
     
     load_dotenv()
     
     SECRET_KEY = str(os.getenv('SECRET_KEY'))
     DEBUG = str(os.getenv('DEBUG'))

6. Gerar uma Nova SECRET_KEY

   Para gerar uma nova SECRET_KEY, execute o seguinte comando no terminal:

   python -c 'from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())'

   Copie a saída e adicione ao arquivo .env como o valor para SECRET_KEY.

7. Execute as migrações do banco de dados

   python manage.py makemigrations

   python manage.py migrate

8. Crie um superusuário (opcional, para acessar o painel de administração)

   python manage.py createsuperuser

9. Inicie o servidor de desenvolvimento

   python manage.py runserver

   O projeto estará disponível em http://127.0.0.1:8000/.