Winter-Project

Introduction

The "Winter-Project" is designed to facilitate the registration and management of participants in the "Khadmeen e Ummat Seerat Un Nabi SWS Competition." This competition is targeted at school and college students, with events occurring at both district and state levels. The project aims to streamline the registration process and manage participant data efficiently.

System Overview

The system will serve as a platform for students to register for the competition, providing necessary details such as personal information, competition type, and payment status. It will also manage the progression of participants from district-level competitions to state-level events, culminating in a winners' program.

Functional Requirements

• As a student, I should be able to register for the competition by providing my name, father's name, school name, place, state, WhatsApp number, class, and type of competition to enroll in.
• As a student, I should be able to confirm the fee payment status during registration.
• As an administrator, I should be able to view and manage the list of registered participants.
• As an administrator, I should be able to track participants' progression from district-level to state-level competitions.
• As an administrator, I should be able to schedule the winners' program after the completion of state-level competitions.

User Personas

• Student: A school or college student interested in participating in the competition.
• Administrator: A person responsible for managing the competition, including registration, participant tracking, and event scheduling.

Core User Flows

• Student registers for the competition -> Provides personal and competition details -> Confirms fee payment -> Receives confirmation.
• Administrator reviews participant list -> Tracks participant progression -> Schedules winners' program.

Visuals Colors and Theme

• primary: #1E3A8A (Deep Blue)
• primary_light: #3B82F6 (Light Blue)
• secondary: #F59E0B (Amber)
• accent: #EF4444 (Red)
• highlight: #FBBF24 (Gold)
• bg: #F3F4F6 (Light Gray)
• surface: rgba(255, 255, 255, 0.8) (White with transparency)
• text: #111827 (Dark Gray)
• text_muted: #6B7280 (Muted Gray)
• border: rgba(209, 213, 219, 0.5) (Light Gray)

Signature Design Concept

The homepage will feature an interactive "Competition Journey Map" using @react-three/fiber and @react-three/drei. This 3D map will visually represent the journey from district to state-level competitions. Users can click on different stages to view details, hover to see participant stats, and drag to explore the map. The map will dynamically update as participants progress, providing a visually engaging and interactive experience.

Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model. Layers of content will move at different speeds as users scroll, creating a sense of depth and engagement. This model will be complemented by animated transitions and hover effects to enhance user interaction and maintain a visually rich experience.

Non-Functional Requirements

• The system should ensure data security and privacy for all participants.
• The application should be responsive and accessible across various devices and screen sizes.
• The system should handle concurrent user registrations efficiently.

Tech Stack

• Frontend: React for Web
• Backend: Python, FastAPI
• Database: MySQL or MariaDB, using Alembic for migrations
• AI Models: Not applicable
• AI Tools: Not applicable
• Local Orchestration: Docker, docker-compose
• Server-side Orchestration: Kubernetes

Assumptions and Constraints

• The system assumes internet connectivity for registration and data management.
• The application will be developed and deployed within a timeframe that aligns with the competition schedule.
• The system will comply with local data protection regulations.

Glossary

• Participant: A student who registers for the competition.
• Administrator: A person managing the competition logistics.
• District-Level Competition: The initial stage of the competition held at the district level.
• State-Level Competition: The subsequent stage of the competition for district winners.
• Winners' Program: The event scheduled for state-level competition winners.