najma-hannan/events-hub

Phase 4 Project

Events Hub

Description

Events Hub is a user-friendly web application that simplifies event management. It provides a centralized platform for planning, organizing, and managing various events. With a powerful backend built on Ruby on Rails and a dynamic frontend powered by React.js, Events Hub offers a seamless and intuitive solution.

Prerequisites

• Ruby 2.7.4
• NodeJS (v16), and npm
• Render account
• Postgresql

Setup and installation

1. Clone the repository:

git clone [email protected]:najma-hannan/Events-Hub.git

2. Change into the project directory:

cd Events-Hub

3. When you're ready to start building your project, run:

bundle install npm install --prefix client

4. You can use the following commands to run the application

rails s: run the backend on http://localhost:3000

npm start --prefix client: run the frontend on http://localhost:4000

API Endpoints

Your application provides a comprehensive set of API endpoints to interact with the application programmatically:

• GET/events: Fetch a list of all events.
• POST /events: Create a new event.
• GET /events/: Fetch the details of a specific event.
• PUT /events/: Update a specific event.
• DELETE /events/: Delete a specific event.

For more information about the required request body and the response format for each endpoint, please refer to the API documentation.

Features

• Comprehensive Event Planning and Management: Easily create, plan, and manage all event details in one place. Get real-time data on ticket sales, attendee engagement, and other key metrics to make informed decisions.

• Seamless Ticketing and Registration: Effortlessly manage ticket sales and registrations with an integrated ticketing system. Support multiple ticket tiers and get real-time updates on sales.

• Enhanced Audience Engagement: Engage attendees with interactive features like real-time feedback. Foster a better experience for event participants.

Minimum Viable Product (MVP)

The minimum viable product (MVP) of the Events Hub application includes the following features:

• User authentication and authorization.
• Event creation, viewing, editing, and deletion.
• Ticket setup and pricing.
• User profiles.
• Ticketing system.
• Event registration by attendees.
• Event feedback and rating.

User Stories

As an Admin, you can:

• Log into the platform.
• Create, view, edit, and delete events.
• Set up ticket types and prices.
• Manage users and vendors.
• Monitor ticket sales.

As a normal user, you can:

• Sign up/log into the platform.
• View a list of upcoming events.
• Search and view events by categories.
• Add or remove tickets from the cart.
• Provide feedback for an event.
• Rate vendors.

Target Market

• Professional event organizers.
• Event attendees.
• Event management companies.

Test Credentials

For testing purposes, you can use the following credentials:

Admin Account Email: [email protected]

Password: admin123

User Account Email: [email protected]

Password: user123

Future Enhancements

We're constantly working to make Events Hub even better and more feature-rich. Some of the enhancements we're considering include:

Engage attendees with interactive features like real-time feedback. Foster a better experience for event participants. A feature for vendors to sell their products directly through the platform. A recommendation engine to suggest events to users based on their past attendance and ratings. Integration with popular calendar applications for automatic event reminders.

Conclusion

Events Hub offers an innovative and user-friendly solution for event management. By simplifying the event planning process and enhancing user satisfaction, Events Hub has the potential to revolutionize the industry. With the power of Rails and the flexibility of React, Events Hub provides a transformative event management experience.

License

Events Hub is open-source under the MIT License.