🚗 ConsultaVeicular

Sistema web para consulta completa de veículos, desenvolvido em Python/Flask. Responsivo para celular, com geração de relatório em PDF.

---

🚀 Instalação no Ubuntu (Desktop ou Server)

1. Instalar dependências do sistema

sudo apt update
sudo apt install python3 python3-pip python3-venv git -y

2. Clonar o projeto do GitHub

git clone https://github.com/SEU_USUARIO/consultaveicular.git
cd consultaveicular

3. Criar ambiente virtual e instalar pacotes

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

4. Rodar o sistema

python app.py

Acesse em: http://localhost:5000

---

🔐 Usuários padrão

Usuário	Senha
admin	admin123
corretor	corretor123

⚠️ Troque as senhas antes de usar em produção! Edite o dicionário USUARIOS em app.py.

---

🔌 Configurar API do AvaliService

1. Contrate o plano em: https://avaliservice.com.br
2. Copie seu token de acesso
3. Abra app.py e substitua:

   AVALISERVICE_TOKEN = 'SEU_TOKEN_AQUI'

   pelo seu token real.

Enquanto o token não estiver configurado, o sistema roda em modo demonstração com dados fictícios.

---

☁️ Deploy no Oracle Cloud (gratuito)

1. Criar conta

• Acesse: https://cloud.oracle.com/free
• Crie conta (cartão de crédito exigido, mas não cobra)

2. Criar VM gratuita

• Compute → Instances → Create Instance
• Shape: VM.Standard.A1.Flex (ARM, até 4 OCPU + 24GB RAM grátis)
• OS: Ubuntu 22.04
• Gere ou faça upload da sua chave SSH

3. Configurar Firewall no Oracle Cloud

• Networking → Virtual Cloud Networks → sua VCN → Security Lists
• Adicionar regra de entrada (Ingress): TCP, porta 5000 (desenvolvimento) ou 80 (produção)

4. Conectar via SSH e subir o projeto

ssh -i sua_chave.pem ubuntu@IP_DA_VM
# Siga os passos de instalação acima

5. Rodar em background (produção)

# Instalar gunicorn
pip install gunicorn

# Rodar com gunicorn
gunicorn -w 2 -b 0.0.0.0:5000 app:app --daemon

6. (Opcional) Configurar Nginx como proxy reverso

sudo apt install nginx -y

Crie /etc/nginx/sites-available/consultaveicular:

server {
    listen 80;
    server_name SEU_IP_OU_DOMINIO;

    location / {
        proxy_pass http://127.0.0.1:5000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

sudo ln -s /etc/nginx/sites-available/consultaveicular /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl restart nginx

---

📁 Estrutura do projeto

consultaveicular/
├── app.py              # Backend principal (Flask)
├── requirements.txt    # Dependências Python
├── historico.json      # Histórico de consultas (gerado automaticamente)
├── reports/            # Relatórios PDF gerados
└── templates/
    ├── base.html       # Template base (nav, estilos)
    ├── login.html      # Tela de login
    ├── dashboard.html  # Painel principal
    ├── consultar.html  # Formulário de consulta
    ├── resultado.html  # Resultado da consulta
    └── historico.html  # Histórico de consultas

---

📤 Subir para o GitHub

git init
git add .
git commit -m "primeiro commit"
git remote add origin https://github.com/SEU_USUARIO/consultaveicular.git
git push -u origin main

---

💡 Dicas de segurança antes de produção

• Troque app.secret_key por uma string aleatória longa
• Mude as senhas dos usuários em USUARIOS
• Use HTTPS (Let's Encrypt + Nginx)
• Nunca suba o token da API para o GitHub (use variável de ambiente)