The Event Application API serves as the backend for an event management application. It allows users to create, manage, and attend events. Key features include user authentication, event creation, ticket booking, notifications, and event analytics.
Before setting up the project locally, ensure you have the following prerequisites installed:
- Python (>=3.11.4)
- Django
- Django Rest Framework
- A Database System (e.g., PostgreSQL, MySQL, SQLite) - Django Database Installation
-
Clone the repository:
git clone https://github.com/hngx-org/Panthers-events-backend.git
-
Change into the parent directory:
cd Panthers-events-backend
-
Change into the project directory:
cd backend
-
Set up a virtual environment:
py -m venv ENV
-
Activate your virtual environment:
ENV\Scripts\activate
-
Install the Python dependencies:
pip install -r requirements.txt
-
Configure the database settings in the
settings.py
file according to your chosen database system. -
Apply migrations to create the database schema:
python manage.py migrate
-
Create a superuser for administrative access:
python manage.py createsuperuser
-
Start the development server:
python manage.py runserver
The API should now be running locally at http://localhost:8000/.
- /api/events/: Create, list, and search for events.
- /api/events/{event_id}/: Retrieve, update, or delete a specific event.
- /api/events/{event_id}/attendees/: Manage event attendees.
- /api/groupevents/: Create, list, and search for events.
- /api/groupevents/{event_id}/: Retrieve, update, or delete a specific event.
- /api/groupevents/{event_id}/attendees/: Manage event attendees.
- /api/groups/: Create, list, and search for events.
- /api/groups/{event_id}/: Retrieve, update, or delete a specific event.
- /api/groups/{event_id}/attendees/: Manage event attendees.
- /api/usergroups/: Create, list, and search for events.
- /api/usergroups/{event_id}/: Retrieve, update, or delete a specific event.
- /api/usergroups/{event_id}/attendees/: Manage event attendees.
To get started with the project, refer to the Installation Instructions and Usage Instructions sections. Familiarize yourself with the API endpoints by exploring the API Documentation provided.
Configuration details can be found in the project's settings.py
file. Make sure to configure the required environment variables or configuration files as needed. Additionally, if any API keys or secrets are required, they should be mentioned in this section.
The project follows specific coding standards outlined in our Coding Style Guide. We use linting and code formatting tools to maintain code quality.
You can access the API documentation here when the server is running. It provides comprehensive information on how to use the API endpoints.
This project is open-source and is licensed under the MIT License. For the full license text, please click here.
We acknowledge and appreciate the contributions of the following individuals to this project:
- View the list of contributors in Contributors.md
© 2023 Team Panther Backend - HNG