CRUD Django com SweetAlert

Um projeto CRUD simples desenvolvido com Django e SweetAlert para gerenciar usuários com uma interface intuitiva e amigável.

📋 Descrição

Este projeto implementa um sistema básico de CRUD (Create, Read, Update, Delete) para gerenciar cadastros de usuários. Utiliza o framework Django no backend e SweetAlert para criar alertas interativos e personalizados na interface.

✨ Funcionalidades

• ✅ Criar novos usuários
• ✅ Visualizar lista de usuários
• ✅ Atualizar dados de usuários
• ✅ Deletar usuários
• ✅ Alertas visuais com SweetAlert
• ✅ Tratamento de erros customizado (404, 500)

🛠️ Tecnologias Utilizadas

• Python 3.x
• Django 6.0.7
• SQLite3 (banco de dados padrão)
• SweetAlert2 (alertas interativos)
• HTML/CSS (templates)

📦 Dependências

As principais dependências estão listadas em requirements.txt:

• Django 6.0.7
• asgiref 3.12.1
• sqlparse 0.5.5
• tzdata 2026.3

🚀 Como Instalar e Executar

1. Clone ou extraia o projeto

cd seu-projeto

2. Ative o ambiente virtual

No Windows:

env\Scripts\activate

No Linux/Mac:

source env/bin/activate

3. Instale as dependências (se necessário)

pip install -r requirements.txt

4. Execute as migrações

python manage.py migrate

5. Inicie o servidor de desenvolvimento

python manage.py runserver

O aplicativo estará disponível em http://localhost:8000/

📁 Estrutura do Projeto

crud/
├── manage.py              # Script de gerenciamento do Django
├── db.sqlite3             # Banco de dados
├── .gitignore             # Arquivos ignorados pelo Git
├── README.md              # Este arquivo
│
├── app/                   # Aplicação principal
│   ├── migrations/        # Migrações do banco de dados
│   ├── templates/         # Templates HTML
│   │   ├── home/
│   │   ├── usuarios/
│   │   ├── cadastro/
│   │   └── erros/
│   ├── admin.py          # Configuração do admin
│   ├── apps.py           # Configuração da app
│   ├── middleware.py     # Middlewares customizados
│   ├── models.py         # Modelos de dados
│   ├── views.py          # Views/controladores
│   ├── tests.py          # Testes
│   └── urls.py           # Rotas da aplicação
│
├── crud/                  # Configurações do projeto
│   ├── settings.py       # Configurações gerais
│   ├── urls.py           # URLs principais
│   ├── asgi.py           # Configuração ASGI
│   └── wsgi.py           # Configuração WSGI
│
└── env/                   # Ambiente virtual

📝 Uso da Aplicação

Página Inicial

Acesse / para ir à página inicial do projeto.

Gerenciar Usuários

• Listar: /usuarios/ - Visualize todos os usuários cadastrados
• Criar: /cadastro/ - Adicione um novo usuário
• Editar: Clique no usuário para editar seus dados
• Deletar: Utilize o botão de deletar (confirmação com SweetAlert)

🎨 SweetAlert Integration

O projeto utiliza SweetAlert2 para:

• Confirmar ações de deleção
• Exibir mensagens de sucesso
• Mostrar mensagens de erro
• Alertas customizados

Exemplo de uso no template:

<script src="https://cdn.jsdelivr.net/npm/sweetalert2@11"></script>

<script>
    // Confirmação de deleção
    function confirmarDelecao(id) {
        Swal.fire({
            title: 'Tem certeza?',
            text: 'Esta ação não pode ser desfeita!',
            icon: 'warning',
            showCancelButton: true,
            confirmButtonColor: '#3085d6',
            cancelButtonColor: '#d33',
            confirmButtonText: 'Sim, deletar!'
        }).then((result) => {
            if (result.isConfirmed) {
                // Executar ação de deleção
            }
        })
    }
</script>

🐛 Tratamento de Erros

O projeto inclui páginas de erro customizadas:

• 404: Página não encontrada (templates/erros/404.html)
• 500: Erro interno do servidor (templates/erros/500.html)
• Genérica: Tratamento geral de erros (templates/erros/erro.html)

🔧 Configurações Importantes

Verifique as seguintes configurações em crud/settings.py:

• DEBUG = True/False - Modo de desenvolvimento/produção
• ALLOWED_HOSTS - Hosts permitidos
• INSTALLED_APPS - Aplicações instaladas
• DATABASES - Configurações do banco de dados

📚 Recursos Adicionais

• Documentação Django
• SweetAlert2 Documentation
• SQLite Documentation

📄 Licença

Este projeto é de código aberto e disponível para uso educacional.

👤 Autor

Desenvolvido como um projeto de CRUD simples em Django.

---

Última atualização: 2026-08-05