🚌 OniPix

---

📚 Tabela de Conteúdos

• Sobre o Projeto
• ✨ Funcionalidades
• 🛠️ Tecnologias Utilizadas
• 🚀 Rodando o Projeto Localmente
• 🤝 Como Contribuir
• 📄 Licença

---

📖 Sobre o Projeto

Aplicação Web com o objetivo de disponibilizar a compra de passagens de ônibus municipais por meio de pagamento PIX.

---

✨ Funcionalidades

• ✅ Funcionalidade 1: Compra de passagens rápida e com facilidade.
• ✅ Funcionalidade 2: Validação instantânea pelo motorista.
• ✅ Funcionalidade 3: Controle do fluxo de validações das passagens pela empresa.
• ✅ ...e muito mais!

---

🛠️ Tecnologias Utilizadas

Esta aplicação foi construída utilizando as seguintes tecnologias e ferramentas:

• Backend: Python, Django, Django REST Framework
• Frontend: HTML, CSS, JavaScript
• Banco de Dados: [SQLite (desenvolvimento), PostgreSQL (produção)]
• Pagamentos: API do Mercado Pago
• Outros: django-environ, qrcode etc.

---

🚀 Rodando o Projeto Localmente

Siga estas instruções para configurar e executar o projeto em seu ambiente de desenvolvimento local.

Pré-requisitos

Antes de começar, certifique-se de que você tem o seguinte instalado em sua máquina:

• Python 3.9+
• Git

Passos para a Instalação

1. Clone o Repositório

   git clone https://github.com/vitormarvulle/pix-onibus.git

2. Crie e Ative o Ambiente Virtual (venv)

   • Para macOS/Linux:

     python3 -m venv venv
     source venv/bin/activate

   • Para Windows:

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

3. Instale as Dependências

   pip install -r requirements.txt

4. Configure as Variáveis de Ambiente 🔑 Este projeto usa um arquivo .env para gerenciar chaves de API e configurações sensíveis.

   • Crie o arquivo .env no diretório raíz do projeto (onde está o manage.py) e preencha as variáveis com suas próprias credenciais. O arquivo .env não é rastreado pelo Git, então suas credenciais estarão seguras.

     # Exemplo de conteúdo do .env
     SECRET_KEY="sua_chave_secreta_aqui_gerada_pelo_django"
     DEBUG=True
     MERCADOPAGO_ACCESS_TOKEN="sua_chave_de_acesso_do_mercado_pago"

5. Aplique as Migrações do Banco de Dados

   python manage.py migrate

6. Execute a Aplicação! 🎉

   python manage.py runserver

   Acesse a aplicação em seu navegador: http://127.0.0.1:8000/

---

🤝 Como Contribuir

Contribuições são o que tornam a comunidade de código aberto um lugar incrível para aprender, inspirar e criar. Qualquer contribuição que você fizer será muito apreciada.

1. Faça um Fork do projeto.
2. Crie uma Branch para sua nova funcionalidade (git checkout -b feature/AmazingFeature).
3. Faça o Commit de suas alterações (git commit -m 'Add some AmazingFeature').
4. Faça o Push para a Branch (git push origin feature/AmazingFeature).
5. Abra um Pull Request.

---

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

---