{"id":21683833,"url":"https://github.com/jmdotdev/eventz","last_synced_at":"2025-08-17T10:36:36.289Z","repository":{"id":255122057,"uuid":"843892773","full_name":"jmdotdev/Eventz","owner":"jmdotdev","description":" an event management platform that allows users to browse and purchase tickets for various events","archived":false,"fork":false,"pushed_at":"2025-02-07T11:17:38.000Z","size":3059,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-07T12:28:31.522Z","etag":null,"topics":["angular-17","font-awesome","postman-mock-api","reactive-forms","tailwindcss"],"latest_commit_sha":null,"homepage":"https://eventz-chi.vercel.app","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jmdotdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-17T18:28:52.000Z","updated_at":"2025-02-07T11:17:42.000Z","dependencies_parsed_at":"2025-02-07T12:34:50.306Z","dependency_job_id":null,"html_url":"https://github.com/jmdotdev/Eventz","commit_stats":null,"previous_names":["jmdotdev/eventz"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmdotdev%2FEventz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmdotdev%2FEventz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmdotdev%2FEventz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmdotdev%2FEventz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jmdotdev","download_url":"https://codeload.github.com/jmdotdev/Eventz/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244601978,"owners_count":20479534,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular-17","font-awesome","postman-mock-api","reactive-forms","tailwindcss"],"created_at":"2024-11-25T16:13:40.827Z","updated_at":"2025-03-20T11:23:58.328Z","avatar_url":"https://github.com/jmdotdev.png","language":"HTML","readme":"# EventZ\n\n**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.\n\n## Table of Contents\n\n- [Project Overview](#project-overview)\n- [Features](#features)\n- [Technologies](#technologies)\n- [Setup Instructions](#setup-instructions)\n- [Mock Server Usage](#mock-server-usage)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Project Overview\n\nThe 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.\n\n## Features\n\n### User Features\n- **Event Browsing:** Users can explore available events.\n- **Ticket Purchase:** Secure purchase system for event tickets.\n- **Print Tickets:** Users can print their purchased tickets.\n- **User Authentication:** Users can register, log in, and manage their accounts.\n\n### Admin Features\n- **CRUD for Events:** Admins can create, update, delete, and view event details.\n- **Ticket Management:** Admins can manage ticket sales and inventory.\n- **User Management:** Admins can view and manage users registered on the platform.\n\n## Technologies\n\n- **Frontend:** Angular (Version X)\n- **Backend:** .NET Core (API under development)\n- **Database:** PostgreSQL\n- **Mock Server:** Postman Mock Servers (For initial API development)\n\n## Setup Instructions\n\n### Prerequisites\n\n- **Node.js** (v14.x or later)\n- **Angular CLI** (v17.x or later)\n- **.NET Core SDK** (v8.x or later)\n- **Postman** (For API mocks)\n\n### Clone the Repository\n\n```bash\ngit clone https://github.com/yourusername/eventz.git\ncd eventz\n```\n\n### Install Dependencies\n\nFor the Angular Frontend:\n\n```bash\ncd frontend\nnpm install\n```\n\nFor the .NET Backend (API under development):\n\n```bash\ncd backend\ndotnet restore\n```\n\n### Running the Frontend (Angular)\n\n```bash\nng serve\n```\n\nOpen your browser and navigate to `http://localhost:4200`.\n\n### Running the Backend (When API is ready)\n\n```bash\ncd backend\ndotnet run\n```\n\n### Mock Server Usage\n\nSince 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. \n\n#### How to Use Postman Mock Servers\n\n1. Download and install Postman if you haven't already.\n2. Import the Postman collection provided in this repo (`postman_collection.json`).\n3. Start the mock server by selecting the collection and choosing \"Mock Server.\"\n4. Replace the base URLs in your Angular services with the mock server's URL until the API is ready.\n\n## Contributing\n\nWe welcome contributions to **EventZ**. Please follow these steps:\n\n1. Fork the repository.\n2. Create a feature branch (`git checkout -b feature-branch`).\n3. Commit your changes (`git commit -m 'Add some feature'`).\n4. Push to the branch (`git push origin feature-branch`).\n5. Open a pull request.\n\n## License\n\nThis project is licensed under the MIT License.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmdotdev%2Feventz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjmdotdev%2Feventz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmdotdev%2Feventz/lists"}