Skip to content

Puistis/Django

Repository files navigation

Fantasy Events Platform 🎭

A modern Django-based event management system designed for fantasy and themed events. Create, manage, and host extraordinary events with comprehensive venue management, performer scheduling, and budget tracking.

Disclaimer This is a school project and 100% AI generated code, because the task was to create Django webapp using AI.

🌟 Features

Event Management

  • Create and manage fantasy-themed events
  • Set event details, including title, description, date, and time
  • Track attendee registration and capacity
  • Define age restrictions and special requirements
  • List prohibited items for safety

Venue Management

  • Browse and select from available venues
  • Automatic capacity management based on venue selection
  • View venue amenities and rules
  • Track venue availability and booking status
  • Calculate venue costs automatically

Budget Tracking

  • Automatic budget creation and management
  • Track expenses by category (venue, performers, etc.)
  • Real-time budget updates with venue bookings
  • Monitor remaining budget and expenses
  • Generate financial reports

Performer Scheduling

  • Book and manage event performers
  • Track performer availability
  • Manage performance schedules
  • Handle technical requirements

🚀 Upcoming Features

Stage Management

  • Multiple stages within venues
  • Stage capacity and specifications
  • Technical equipment tracking
  • Stage availability calendar

Enhanced Performer Management

  • Assign performers to specific stages
  • Stage-specific technical requirements
  • Performance time slots
  • Stage setup coordination

Advanced Venue Features

  • Virtual venue tours
  • Interactive venue maps
  • Real-time availability checking
  • Automated contract generation

🚀 Getting Started

Prerequisites

  • Python 3.13.0
  • Django 5.0.1
  • Other dependencies listed in requirements.txt

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/fantasy-events.git
cd fantasy-events
  1. Create and activate a virtual environment:
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
  1. Install dependencies:
pip install -r requirements.txt
  1. Run migrations:
python manage.py migrate
  1. Create a superuser:
python manage.py createsuperuser
  1. Start the development server:
python manage.py runserver

💻 Usage

Creating an Event

  1. Log in to your account
  2. Click "Create Event" button
  3. Fill in event details:
    • Title and description
    • Date and time (start and end)
    • Select a venue (optional)
    • Set maximum attendees (auto-filled based on venue)
    • Add special requirements and prohibited items
  4. Submit the form to create your event

Managing Venues

  1. Access the venue management section
  2. View available venues and their details
  3. Check venue capacity and amenities
  4. Book venues for events
  5. Track venue expenses in the budget

Budget Management

  1. Access event budget through event details
  2. View automatic venue cost calculations
  3. Track expenses and remaining budget
  4. Add additional expense categories
  5. Monitor financial status

🔧 Configuration

Environment Variables

Create a .env file in the project root:

DEBUG=True
SECRET_KEY=your-secret-key
DATABASE_URL=your-database-url

Database Setup

The project uses PostgreSQL by default. Configure your database settings in settings.py or through environment variables.

📚 Documentation

Detailed documentation is available in the docs/ directory:

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📝 License

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

🙏 Acknowledgments

  • Django Framework
  • Bootstrap for UI components
  • All contributors who have helped shape this project

📞 Support

For support, please open an issue in the GitHub repository or contact the development team.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors