System Requirements Document (SRD) for zinc-event

1. Introduction

The zinc-event project is an online event booking system designed to cater to both event organizers and attendees. This platform aims to provide a seamless, real-time booking experience, ensuring accurate availability and efficient event management. Given the vibrant event culture in India, this system is tailored to meet the needs of a diverse audience, offering features that simplify event creation, ticket management, and attendee participation.

This document outlines the system's requirements, including functional and non-functional aspects, user personas, design concepts, and the technical stack to be used.

2. System Overview

The zinc-event platform will serve as a comprehensive solution for event management and booking. It will allow event organizers to create, manage, and monitor events, while attendees can browse, book, and participate in events effortlessly. The system will operate in real-time, ensuring up-to-date availability and instant confirmations.

Key features include:

• Real-time ticket inventory management.
• Seamless booking flow for attendees.
• Support for both web and mobile platforms.
• Localization for Indian users, including currency (INR) and time zones (IST).

The platform will leverage modern technologies to ensure scalability, reliability, and an intuitive user experience.

3. Functional Requirements

• As an Organizer, I should be able to create events with details like name, date, time, venue, and ticket pricing.
• As an Organizer, I should be able to manage ticket inventory in real-time.
• As an Organizer, I should be able to view and analyze event performance metrics (e.g., ticket sales, attendee demographics).
• As an Attendee, I should be able to browse events by category, location, or date.
• As an Attendee, I should be able to book tickets in real-time and receive instant confirmation.
• As an Attendee, I should be able to select seats (if applicable) during the booking process.
• As an Admin, I should be able to manage users, events, and system settings.
• As a Guest, I should be able to view events but will need to register to book tickets.

4. User Personas

4.1 Organizer

• Description: Event creators who manage and promote events.
• Goals: Simplify event creation, track ticket sales, and manage attendees.
• Pain Points: Difficulty in managing ticket inventory and analyzing event performance.

4.2 Attendee

• Description: Individuals looking to book tickets for events.
• Goals: Discover events, book tickets seamlessly, and receive instant confirmations.
• Pain Points: Lack of real-time availability and cumbersome booking processes.

4.3 Admin

• Description: System administrators who oversee platform operations.
• Goals: Ensure smooth functioning of the platform and manage user activities.
• Pain Points: Managing a large volume of users and events efficiently.

4.4 Guest

• Description: Unregistered users exploring the platform.
• Goals: Browse events and decide whether to register.
• Pain Points: Limited access to features without registration.

5. Visuals Colors and Theme

Color Palette

• Background: #F9F6F1 (Warm Beige)
• Surface: #FFFFFF (Pure White)
• Text: #2C2C2C (Charcoal Black)
• Accent: #FF6F61 (Coral Red)
• Muted Tones: #B2B2B2 (Soft Gray)

This palette reflects a modern, vibrant, and approachable aesthetic, aligning with the dynamic nature of events.

6. Signature Design Concept

Interactive Event Galaxy Homepage

The homepage will feature an interactive galaxy map where each "star" represents an event. Users can navigate the galaxy by dragging, zooming, or clicking on stars to explore events. Each star will glow brighter as the event date approaches, creating a sense of urgency and excitement.

• Animations: Stars will twinkle subtly, and when hovered over, they will expand slightly with a soft glow.
• Transitions: Clicking a star will zoom into a detailed event page with a smooth transition.
• Color Shifts: The galaxy background will subtly shift colors based on the time of day (e.g., warm tones in the morning, cool tones at night).
• Micro-Interactions: Hovering over stars will display a tooltip with the event name and date.

This design will make the platform unforgettable and engaging, encouraging users to explore and book events.

7. Non-Functional Requirements

• Performance: The system must handle up to 10,000 concurrent users with minimal latency.
• Scalability: The platform should scale to accommodate growing user and event data.
• Security: Implement robust authentication and data encryption to protect user information.
• Localization: Support Indian currency (INR) and time zones (IST).
• Availability: Ensure 99.9% uptime for critical services.

8. Tech Stack

Frontend

• React for Web
• React Native for Mobile App

Backend

• Python
• FastAPI

Database

• MySQL (primary RDBMS, with Alembic for migrations)
• MongoDB (for unstructured data)

AI Models

• GPT 5.4 for user-friendly responses
• Claude 4.6 Opas for coding-related tasks
• Google Nano Banana for image generation

AI Tools

• Litellm for LLM Routing
• Langchain

Orchestration

• Docker and docker-compose for local development
• Kubernetes for server-side orchestration

9. Assumptions and Constraints

• The platform will primarily target users in India.
• Real-time booking functionality will depend on stable internet connectivity.
• Initial deployment will focus on mobile platforms, with web support as a secondary priority.
• The system will adhere to Indian data protection laws.

10. Glossary

• Real-Time Booking: The ability to book tickets with immediate confirmation and updated availability.
• Event Organizer: A user who creates and manages events on the platform.
• Attendee: A user who books tickets for events.
• Admin: A system user responsible for managing the platform.
• Guest: An unregistered user exploring the platform.