https://github.com/jmdotdev/eventz
an event management platform that allows users to browse and purchase tickets for various events
https://github.com/jmdotdev/eventz
angular-17 font-awesome postman-mock-api reactive-forms tailwindcss
Last synced: 6 months ago
JSON representation
an event management platform that allows users to browse and purchase tickets for various events
- Host: GitHub
- URL: https://github.com/jmdotdev/eventz
- Owner: jmdotdev
- Created: 2024-08-17T18:28:52.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-07T11:17:38.000Z (about 1 year ago)
- Last Synced: 2025-02-07T12:28:31.522Z (about 1 year ago)
- Topics: angular-17, font-awesome, postman-mock-api, reactive-forms, tailwindcss
- Language: HTML
- Homepage: https://eventz-chi.vercel.app
- Size: 2.92 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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](#project-overview)
- [Features](#features)
- [Technologies](#technologies)
- [Setup Instructions](#setup-instructions)
- [Mock Server Usage](#mock-server-usage)
- [Contributing](#contributing)
- [License](#license)
## Project Overview
The primary goal of **EventZ** is to provide 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 X)
- **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
```bash
git clone https://github.com/yourusername/eventz.git
cd eventz
```
### Install Dependencies
For the Angular Frontend:
```bash
cd frontend
npm install
```
For the .NET Backend (API under development):
```bash
cd backend
dotnet restore
```
### Running the Frontend (Angular)
```bash
ng serve
```
Open your browser and navigate to `http://localhost:4200`.
### Running the Backend (When API is ready)
```bash
cd backend
dotnet run
```
### Mock Server Usage
Since the API is under development, we will be using **Postman Mock Servers** to simulate API responses. The mock server provides endpoints for user login, event listing, ticket purchase, and admin CRUD operations.
#### How to Use Postman Mock Servers
1. Download and install Postman if you haven't already.
2. Import the Postman collection provided in this repo (`postman_collection.json`).
3. Start the mock server by selecting the collection and choosing "Mock Server."
4. Replace the base URLs in your Angular services with the mock server's URL until the API is ready.
## 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.