Contact Book Django Project
Prerequisites
- Python 3.10+
- Docker & Docker Compose
- Git
Setup Instructions
1. Clone repository
git clone <repo-url>
cd contact-book-django2. Create virtual environment
python -m venv venv
venv\Scripts\activate # Windows
source venv/bin/activate # Mac/Linux3. Install dependencies
pip install -r requirements.txt4. Setup environment variables
cp .env.example .env
# Edit .env with your settings5. Start Docker services
docker compose up -d6. Run migrations
python manage.py migrate7. Create superuser
python manage.py createsuperuser8. Run development server
python manage.py runserverAccess Points
- Django Admin: http://localhost:8000/admin
- PgAdmin: http://localhost:5050
- API: http://localhost:8000/api
Docker Commands
# Start services
docker compose up -d
# Stop services
docker compose down
# View logs
docker compose logs -f postgres
# Database shell
docker exec -it contact_book_postgres psql -U contact_user -d contact_book_db