projeto-aprovacao-pedidos/QUICKSTART.md

⚡ Quick Start - Projeto Aprovação Pedidos

1️⃣ Instalação Rápida (2 min)

# Instalar dependências
pip install -r requirements.txt

# Criar banco de dados
python manage.py migrate

# Rodar o servidor
python manage.py runserver

Acesse: http://localhost:8000

---

2️⃣ Com Docker (3 min)

# Build e rodar
docker-compose up --build

# Acesse em background (Ctrl+C para parar)

Acesse: http://localhost:8000

---

3️⃣ Criar Superusuário (Admin)

python manage.py createsuperuser

# Acesse: http://localhost:8000/admin/

---

4️⃣ Estrutura de Arquivos Importante

├── home/templates/home/home_page.html  ← Edite aqui o HTML/CSS
├── home/views.py                        ← Edite aqui a lógica
├── aprovacao_pedidos/settings.py       ← Configurações Django
├── manage.py                            ← Comandos Django
└── requirements.txt                     ← Dependências

---

5️⃣ Comandos Úteis

Comando	O que faz
python manage.py runserver	Inicia servidor dev
python manage.py migrate	Aplica migrações BD
python manage.py makemigrations	Cria migrações
python manage.py createsuperuser	Cria admin
python manage.py collectstatic	Coleta arquivos estáticos
docker-compose up	Rodar com Docker

---

🎨 Customizar Layout

Edit: home/templates/home/home_page.html

Alterar cores principais:

:root {
  --accent: #03506B;           /* Mude aqui */
}

Adicionar novo card:

<div class="card">
  <p class="card-title">Meu Card</p>
  <p class="card-value">100</p>
</div>

---

🚀 Próximas Etapas

1. ✅ Rodar localmente
2. 📝 Customizar para suas necessidades
3. 🔌 Conectar APIs reais
4. 🚢 Deploy (Docker/servidor)

---

📞 Problemas?

• Porta 8000 já em uso? → python manage.py runserver 8001
• Módulo não encontrado? → pip install -r requirements.txt
• Banco de dados corrompido? → Delete db.sqlite3 e rode migrate novamente

---

Bom desenvolvimento! 🚀