Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lucaspmartins/project-agenda-django
This is a Django-based web application for managing contacts.
https://github.com/lucaspmartins/project-agenda-django
django python3 webapp
Last synced: 3 days ago
JSON representation
This is a Django-based web application for managing contacts.
- Host: GitHub
- URL: https://github.com/lucaspmartins/project-agenda-django
- Owner: LucasPMartins
- Created: 2024-12-17T13:27:00.000Z (29 days ago)
- Default Branch: main
- Last Pushed: 2025-01-07T10:40:25.000Z (8 days ago)
- Last Synced: 2025-01-07T11:38:53.193Z (8 days ago)
- Topics: django, python3, webapp
- Language: Python
- Homepage:
- Size: 54.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://git.io/typing-svg)
## Contact Management System
This is a Django-based web application for managing contacts. It allows users to create, update, delete, and search for contacts. Each contact can have a picture, and users can register, log in, and manage their profiles.
## Table of Contents
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [Models](#models)
- [Forms](#forms)
- [Templates](#templates)
- [Static Files](#static-files)
- [Tools](#-tools)
- [Languages](#-languages)
## Features
- User authentication (registration, login, logout)
- Create, update, delete, and view contacts
- Search contacts by name, email, or phone
- Pagination for contact list
- User profile management
- Upload and display contact pictures
## Installation
1. Clone the repository:
```sh
git clone
cd
```
2. Create and activate a virtual environment:
```sh
python -m venv venv
source venv/bin/activate # On Windows use `venv\Scripts\activate`
```
3. Install the required packages:
```sh
pip install -r requirements.txt
```
4. Apply migrations to set up the database:
```sh
python manage.py makemigrations
python manage.py migrate
```
5. Create a superuser for accessing the admin site:
```sh
python manage.py createsuperuser
```
6. Run the development server:
```sh
python manage.py runserver
```
7. Open your browser and go to `http://127.0.0.1:8000` to access the application.
## Usage
- **Admin Site**: Access the admin site at `http://127.0.0.1:8000/admin` to manage users and contacts.
- **User Registration**: Register a new user at `http://127.0.0.1:8000/user/register`.
- **Login**: Log in at `http://127.0.0.1:8000/user/login`.
- **Create Contact**: Create a new contact at `http://127.0.0.1:8000/contact/create`.
- **View Contacts**: View the list of contacts at `http://127.0.0.1:8000`.
- **Search Contacts**: Search for contacts using the search bar on the homepage.
## Models
- **Category**: Represents a category for contacts.
- **Contact**: Represents a contact with fields for first name, last name, phone, email, description, picture, category, and owner.
## Forms
- **ContactForm**: Form for creating and updating contacts.
- **RegisterForm**: Form for user registration.
- **RegisterUpdateForm**: Form for updating user profile.
## Templates
- **base.html**: Base template for the application.
- **contact.html**: Template for viewing a single contact.
- **create.html**: Template for creating and updating contacts.
- **index.html**: Template for listing contacts.
- **login.html**: Template for user login.
- **register.html**: Template for user registration.
- **user_update.html**: Template for updating user profile.
## Static Files
- **style.css**: CSS file for styling the application.
## 🛠 Tools:
## 👨💻 Languages
