Star Events - Online Ticketing System

Star Events is a feature-rich, full-stack ASP.NET Core MVC web application designed for online event ticketing in Sri Lanka. It provides a seamless platform for customers to discover and book tickets for events, for organizers to manage their offerings, and for administrators to oversee the entire system.

The application is built using repository pattern to ensuring separation of concerns and maintainability. It uses MySQL for data storage and integrates with Stripe for secure online payments.

✨ Key Features

For Customers

• User Authentication: Secure registration and login with role-based access control.
• Enhanced Profile Management: View and update personal details, contact information, and address with real-time validation.
• Event Discovery: Browse, search, and filter events by category, date, or location with advanced filtering options.
• Loyalty Points System: Earn loyalty points with every purchase and redeem them for discounts on future bookings.
• Enhanced Payment Processing:
  • Integrated with Stripe for secure payment processing
  • Support for multiple payment methods
  • Real-time payment status tracking
  • Payment history and transaction details
• Promotional System:
  • Apply discount codes for special offers
  • Support for both percentage and fixed amount discounts
  • Real-time promo code validation
• E-Ticketing: Receive unique, QR-coded e-tickets upon successful purchase with booking confirmation.
• Booking Management:
  • View complete booking history
  • Track booking status and payment details
  • Access to detailed transaction reports
• Customer Dashboard: Personalized dashboard with booking overview, loyalty points, and quick access to features.

For Event Organizers

• Event Management: Full CRUD (Create, Read, Update, Delete) functionality for events.
• Real-time Sales Tracking: Monitor ticket sales and revenue through a dedicated dashboard.
• Ticket Management: Define ticket types (e.g., VIP, General) and set pricing and availability.

For Administrators

• Advanced User Management:
  • Full CRUD operations for all users and their roles (Admin, Organizer, Customer)
  • User role assignment and management
  • User profile editing and account management
  • Automated password generation and email notifications
  • User activity tracking and account status management
• System-wide Management:
  • Manage core entities like Venues and Categories
  • Event approval and management
  • System configuration and settings
• Enhanced Promotions & Discounts:
  • Create and manage promotional codes with flexible discount types
  • Set promotion validity periods and usage limits
  • Track promotion usage and effectiveness
  • Support for both percentage and fixed amount discounts
• Comprehensive Reporting System:
  • Sales Reports: Detailed revenue and transaction reports with date filtering
  • User Activity Reports: User registration, login, and engagement analytics
  • Event Performance Reports: Event popularity, ticket sales, and revenue analysis
  • Payment Analytics: Payment method usage, success rates, and transaction trends
  • Export Functionality: Export reports in CSV and PDF formats
• Payment Management:
  • Monitor all payment transactions across the system
  • Payment status management and updates
  • Transaction history and detailed payment analytics
  • Payment method analysis and reporting
• Booking Oversight:
  • View all bookings across the platform
  • Booking status management
  • Customer booking history and patterns
  • Revenue tracking per booking

💻 Technology Stack

• Backend: C#, ASP.NET Core 8 MVC, Entity Framework Core 8
• Database: MySQL Server with Pomelo.EntityFrameworkCore.MySql
• Authentication: ASP.NET Core Identity (Users, Roles, Cookie-based auth)
• Frontend: Razor Views, HTML5, CSS3, JavaScript, Bootstrap 5
• Payment Gateway: Stripe integration with webhook support
• QR Code Generation: QRCoder Library for e-ticket generation
• PDF Generation: iTextSharp for report generation
• Email Services: Integrated email service for notifications
• Architecture: Layered Architecture, Repository Pattern, Dependency Injection
• Services: Custom services for password generation, email notifications, and PDF report generation

Project Structure

• Controllers/ — Handles HTTP requests for each entity (Event, Booking, User, Payment, Reports, etc.)
• Models/ — Entity classes and ViewModels (Models/ViewModels/)
• Repository/Interfaces/ and Repository/Services/ — Repository pattern for data access
• Services/ — Custom business services (Email, Password, PDF Report services)
• Data/ApplicationDbContext.cs — Entity Framework Core DB context with DbInitializer
• Migrations/ — Database schema migrations
• Areas/Identity/Pages/ — Razor Pages for authentication
• Views/ — Razor views organized by feature with enhanced UI components
• wwwroot/ — Static assets (CSS, JS, images, uploads, videos)
• wwwroot/uploads/ — File upload storage for event images and documents

🚀 Getting Started

Prerequisites

• .NET 8 SDK
• MySQL Server
• Stripe CLI (Optional for payment testing)

Setup & Installation

1. Clone the repository:

   git clone https://github.com/ZerfyT/star-events.git
   cd star-events

2. Configure Database Connection:

   Open appsettings.json and update the DefaultConnection string with your MySQL credentials.

   "ConnectionStrings": {
       "DefaultConnection": "Server=127.0.0.1;Port=3306;Database=star_events;Uid=root;Pwd=user_password;"
   }

3. Configure Stripe API Keys:

   Add your Stripe keys to appsettings.json.

   "Stripe": {
       "SecretKey": "sk_test_...",
       "PublicKey": "pk_test_..."
   }

4. Apply Database Migrations:

   This will create the database schema based on the Entity Framework models.

   dotnet ef database update

5. Run the Application:

   The application will start, and the database seeder (DbInitializer) will automatically run to populate the database with initial roles, users, venues, categories, and sample events.

   dotnet run

   The application will be available at https://localhost:5001 or a similar port.

6. (Optional) Start Stripe webhook forwarding:

   Run following command on Terminal:

   stripe listen --forward-to http://127.0.0.1:8000/webhook-stripe

Seeded Test Accounts

The following user accounts are automatically created by the data seeder:

Role	Email	Password
Admin	admin@starevents.lk	Admin@123
Event Organizer	organizer@starevents.lk	Organizer@123
Customer	customer@starevents.lk	Customer@123

License

MIT