Este é um projeto de adoção de bens, que visa facilitar a doação de objetos, pertences e recursos materiais de pessoas ou organizações para aqueles que mais precisam.
O projeto de adoção de bens possui as seguintes funcionalidades principais:
- Criação de contas para doadores e receptores.
- Autenticação de usuários com login e recuperação de senha.
- Listagem de doações disponíveis para adoção.
- Realização de doações por parte dos doadores.
- Recebimento e registro de doações por parte dos receptores.
O projeto utiliza as seguintes tecnologias:
- Linguagem de programação: Python
- Framework web: Django
- Banco de dados: SQLite
- HTML, CSS e JavaScript para a interface do usuário.
Siga as etapas abaixo para configurar o ambiente de desenvolvimento:
-
Certifique-se de ter o Python instalado. Recomenda-se utilizar a versão 3.7 ou superior.
-
Clone este repositório para o seu ambiente local:
git clone https://github.com/corteisjr/Desapego.git
-
Acesse o diretório do projeto:
cd Desapego
-
Crie um ambiente virtual para isolar as dependências do projeto:
python -m venv venv
-
Ative o ambiente virtual:
-
No Windows:
venv\Scripts\activate
-
No Linux ou macOS:
source venv/bin/activate
-
-
Instale as dependências do projeto:
pip install -r requirements.txt
-
Execute as migrações do banco de dados:
python manage.py migrate
-
Inicie o servidor de desenvolvimento:
python manage.py runserver
-
Acesse o aplicativo em seu navegador em http://localhost:8000.
Se você deseja contribuir para o projeto, siga as etapas abaixo:
-
Crie um fork deste repositório em sua conta do GitHub.
-
Clone o fork para o seu ambiente local:
git clone https://github.com/corteisjr/Desapego.git
-
Crie um branch para suas alterações:
git checkout -b minha-feature
-
Faça as alterações desejadas e adicione os arquivos modificados:
git add .
-
Faça um commit das suas alterações:
git commit -m "Minha feature: descrição das alterações"
-
Faça um push para o seu fork:
git push origin minha-feature
-
Abra um pull request no repositório original para revisão das suas alterações.
Este projeto é distribuído
sob a licença MIT. Sinta-se à vontade para utilizar, modificar e distribuir o projeto de acordo com os termos da licença.
Em caso de dúvidas ou sugestões, entre em contato conosco:
- Nome: Corteis
- Email: corteisjunior@gmail.com
- GitHub: corteisjr