# Handball Ticketing Web Application This is a web application for managing and booking tickets for handball matches. It features an admin panel for managing matches and seating, and a user-facing interface for browsing matches and purchasing tickets. ## Features ### Admin Panel The admin panel allows administrators to manage matches, seating, and uploaded ticket files. * **Secure Access:** Protected by a password (can be set up on first access). * **Match Management:** Add new matches with details such as name, date, location, total seats, price (optional), and booking deadline. * **Seat Management:** * Upload PDF files for each seat (e.g., containing seat maps or specific ticket details). * Automatic extraction of seat direction (e.g., OUEST, SUD) and number from filenames in the format `DIRECTION_NUMBER.pdf`. * Option to manually set or override the seat number during upload. * View a list of existing matches. * Delete existing matches, which also removes associated seats, tickets, and uploaded PDF files. ### User Interface The user-facing part of the application allows users to browse and book tickets. * **Match Listing:** View a list of upcoming handball matches. * **Match Details:** See detailed information for each match, including date, location, available seats, price, and booking deadline. * **Seat Selection:** Visually select desired seats from the available options. * **Booking Process:** Provide contact information (name, email, phone) to book selected seats. * **Ticket Delivery:** Choose to receive the ticket(s) as a PDF download or via email. * **PDF Tickets:** Generated PDF tickets include match details, seat information (direction and number), and customer details. * **Dark Theme:** The application has a dark theme for a modern look. * **Contact Information:** A contact email is provided in the footer. ### Technical Details * **Backend:** Developed with Express.js. * **Frontend:** Built with React. * **Database:** Uses MariaDB. * **File Storage:** Handles PDF file uploads for seats and tickets. * **Emailing:** Integrates with Nodemailer to send tickets via email. * **PDF Generation:** Uses `pdfkit` to create ticket PDFs. * **Styling:** Utilizes Tailwind CSS for a responsive and modern design. ## Setup and Installation To configure the database and email settings, create a `.env` file in the `server` directory with the following variables: ``` DB_HOST=your_database_host DB_USER=your_database_user DB_PASSWORD=your_database_password DB_NAME=your_database_name EMAIL_HOST=your_email_server_host EMAIL_PORT=your_email_server_port EMAIL_USER=your_email_address EMAIL_PASS=your_email_password EMAIL_FROM=your_sending_email_address ``` Replace the placeholder values with your actual database and email server credentials. *(Instructions on how to set up and run the project - placeholder for now)* ## Usage *(Instructions on how to use the admin panel and book tickets - placeholder for now)*