Skip to content

README.md

Latest commit

 

History

History
97 lines (67 loc) · 2.63 KB

README.md

File metadata and controls

97 lines (67 loc) · 2.63 KB

EventZ

EventZ is an event management platform that allows users to browse and purchase tickets for various events. Users can print their tickets upon successful purchase. The platform also includes an admin interface to manage events and tickets, offering full CRUD (Create, Read, Update, Delete) functionalities. Additional features include user registration, login, and role-based access control.

Table of Contents

Project Overview

EventZprovides users with an intuitive platform for discovering and purchasing tickets for events. Once the ticket purchase is complete, users can print their tickets. Admins can manage event details and ticket inventory through a secure, role-based dashboard.

Features

User Features

  • Event Browsing: Users can explore available events.
  • Ticket Purchase: Secure purchase system for event tickets.
  • Print Tickets: Users can print their purchased tickets.
  • User Authentication: Users can register, log in, and manage their accounts.

Admin Features

  • CRUD for Events: Admins can create, update, delete, and view event details.
  • Ticket Management: Admins can manage ticket sales and inventory.
  • User Management: Admins can view and manage users registered on the platform.

Technologies

  • Frontend: Angular (Version 17)
  • Backend: .NET Core (API under development)
  • Database: PostgreSQL
  • Mock Server: Postman Mock Servers (For initial API development)

Setup Instructions

Prerequisites

  • Node.js (v14.x or later)
  • Angular CLI (v17.x or later)
  • .NET Core SDK (v8.x or later)
  • Postman (For API mocks)

Clone the Repository

git clone https://github.com/yourusername/eventz.git
cd eventz

Install Dependencies

For the Angular Frontend:

cd frontend
npm install

For the .NET Backend (API under development):

cd backend
dotnet restore

Running the Frontend (Angular)

ng serve

Open your browser and navigate to http://localhost:4200.

Running the Backend (When API is ready)

cd backend
dotnet run

Contributing

We welcome contributions to EventZ. Please follow these steps:

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

License

This project is licensed under the MIT License.