Education App with Calendar System

A Django-based education platform featuring an interactive calendar system, event management, and attendee tracking.

Features

• Interactive calendar with event visualization
• Upcoming events list
• Real-time attendee tracking
• Color-coded event status
• Responsive design using Tailwind CSS

Prerequisites

• Python 3.8 or higher
• pip (Python package manager)
• Git

Installation

1. Clone the repository

git clone <repository-url>
cd education_app

2. Create a virtual environment (recommended)

# On macOS/Linux
python -m venv venv
source venv/bin/activate

# On Windows
python -m venv venv
.\venv\Scripts\activate

3. Install required packages

pip install -r requirements.txt

4. Apply database migrations

python manage.py migrate

5. Create a superuser (admin account)

python manage.py createsuperuser

Follow the prompts to create your admin username and password.

Running the Application

1. Start the development server

python manage.py runserver

2. Access the application:

• Main application: http://localhost:8000
• Admin interface: http://localhost:8000/admin

Using the Admin Interface

1. Log in to the admin interface using your superuser credentials
2. Navigate to the Events section to create and manage events
3. Use the Event Attendees section to manage attendance

Creating Events

1. Go to Events in the admin panel
2. Click "Add Event"
3. Fill in:
   • Title
   • Description
   • Start time (YYYY-MM-DD HH:MM:SS)
   • End time
   • Color (e.g., 'blue', 'green', 'red')

Managing Attendees

1. Go to Event Attendees in the admin panel
2. Click "Add Event Attendee"
3. Select:
   • Event
   • User
   • Status (attending/declined/pending)

Project Structure

education_app/
├── education_app/    # Project settings
├── home/            # Main application
├── templates/       # HTML templates
├── manage.py        # Django management script
└── requirements.txt # Project dependencies

Dependencies

The project requires the following main packages:

• Django >= 4.2.0
• django-tailwind >= 3.8.0
• django-browser-reload >= 1.12.1

All dependencies are listed in requirements.txt

Troubleshooting

Port Already in Use

If you see "Error: That port is already in use", try:

# On macOS/Linux
sudo lsof -t -i:8000 | xargs kill -9

# On Windows
netstat -ano | findstr :8000
taskkill /PID <PID> /F

Database Issues

If you encounter database issues, try:

python manage.py migrate --run-syncdb

Contributing

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.