Agenda de Contatos

Agenda de Contatos preview

MEYU – Agenda de Contatos em Django

MEYU é uma aplicação web feita com Django que funciona como uma agenda de contatos simples, prática e moderna. É um projeto para demonstrar conhecimentos em desenvolvimento backend com Python e Django, além do uso de templates, formulários e autenticação.

Django 4.x Python 3.11

Funcionalidades

  • Sistema de autenticação (login/logout)
  • Cadastro de contatos com nome, telefone, e-mail, imagem e categoria
  • Filtro e busca de contatos por nome
  • Edição e exclusão de contatos
  • Formulários personalizados com mensagens de erro
  • Organização de contatos por categorias
  • Upload de fotos para cada contato
  • Somente usuários autenticados acessam os dados

Tecnologias Utilizadas

  • Python 3.11+
  • Django
  • HTML + CSS (via Templates Django)
  • SQLite/PostgreSQL (como banco de dados padrão)

Estrutura do Projeto

Contact-Me-Agend/
├── AddressBook/ # Configurações do projeto Django
│ ├── settings.py
│ ├── urls.py
├── contacts/ # App principal da agenda
│ ├── models.py
│ ├── views/
│ │ └── contact_views.py
│ ├── forms.py
│ ├── urls.py
│ └── templates/
├── db.sqlite3 # Banco de dados local
├── manage.py

Como Executar Localmente

  1. Clone o repositório: 
    git clone https://github.com/napolisiqueira/Contact-Me-Agend.git
cd Contact-Me-Agend
  2. Crie um ambiente virtual:

    Recomendação: Use o UV UltraViolet para fazer seu ambiente virtual ou Poetry.

    uv init # para inicializar um projeto
uv venv # para criar o ambiente virtual
uv sync # para instalar as dependências do pyproject.toml

    Ou, com o método padrão do Python:

    python -m venv .venv # crie um ambiente virtual
.venv\Scripts\activate # Ative no Windows
source .venv/bin/activate # Ou no Linux/macOS
  3. Instale as dependências: 
    pip install -r requirements.txt  # ou use `uv pip install -r requirements.txt`
  4. Rode as migrações: 
    python manage.py migrate
  5. (Opcional) Crie um superusuário: 
    python manage.py createsuperuser
  6. Inicie o servidor: 
    python manage.py runserver

Autor

Desenvolvido por @napolisiqueira