Hat-Ya-Seedy-El-Computer

A comprehensive event management platform for the German University in Cairo (GUC)

Features • Installation • Usage • API Documentation • Contributing

About the Project

Hat-Ya-Seedy-El-Computer is a full-stack event management platform designed specifically for the German University in Cairo (GUC). The system provides a centralized solution for managing various campus activities including workshops, conferences, trips, bazaars, gym sessions, court reservations, and vendor management.

Why This Project?

Educational institutions often struggle with fragmented event management systems. This platform solves that problem by providing:

Unified Platform: Single system for all event types
Role-Based Access: 7 different user roles with specific permissions
Payment Integration: Stripe payments and internal wallet system
Automated Workflows: Email notifications, QR codes, automatic refunds
Comprehensive Reporting: Analytics and export capabilities for administrators

Built With

This project leverages modern web technologies to deliver a fast, scalable, and maintainable application:

Frontend:

React - UI library
Vite - Build tool and dev server
Tailwind CSS - Utility-first CSS framework
React Router - Client-side routing
Axios - HTTP client

Backend:

Node.js - JavaScript runtime
Express - Web framework
MongoDB - NoSQL database
Mongoose - MongoDB ODM

Additional Services:

Stripe - Payment processing
Nodemailer - Email service
JWT - Authentication tokens

Features

Event Management

✅ Multiple Event Types: Workshops, Trips, Bazaars, Conferences, Booths, Gym Sessions
✅ Advanced Filtering: Search by name, location, type, date, and professor
✅ Smart Sorting: Sort events by date, popularity, or availability
✅ Event Archiving: Automatic archiving of past events
✅ Role-Based Restrictions: Limit events to specific user groups
✅ QR Code Generation: For external visitors and event check-ins
✅ Favorites System: Users can bookmark events

Workshop Workflow

✅ Professor Submission: Faculty can submit workshop proposals
✅ Review System: Events Office approval/rejection workflow
✅ Status Tracking: pending, accepted, rejected, needs_edits
✅ Edit Requests: Office can request modifications
✅ Participant Management: View registered users and capacity

Payment System

✅ Stripe Integration: Secure credit/debit card payments
✅ Digital Wallet: Internal wallet for payments and refunds
✅ Automatic Refunds: Money returned to wallet on cancellation
✅ Email Receipts: Automatic payment confirmation emails
✅ Transaction History: Complete payment audit trail

Vendor Management

✅ Vendor Registration: Complete onboarding with document upload
✅ Tax Card Verification: Upload tax cards and company logos
✅ ID Management: Upload IDs for booth attendees
✅ Participation Requests: Apply for bazaars and booths
✅ Fee Management: Pay participation fees online
✅ Loyalty Program: Apply to GUC loyalty program with custom discounts
✅ Booth Polling: Voting system for booth selection

Gym & Court Reservations

✅ Gym Session Management: Create, edit, and cancel sessions
✅ Court Reservations: Basketball, Tennis, Football courts
✅ Real-time Availability: See available time slots
✅ Auto-cancellation: Unconfirmed reservations auto-cancel
✅ Email Notifications: Alerts for changes and cancellations

Ratings & Reviews

✅ Event Ratings: 5-star rating system
✅ Comments: Users can leave detailed feedback
✅ Moderation: Admins can remove inappropriate comments
✅ Attendance Verification: Only attendees can rate/comment

Notifications & Communication

✅ In-app Notifications: Real-time system notifications
✅ Email Verification: Account activation emails
✅ Payment Receipts: Automatic receipt generation
✅ Workshop Updates: Acceptance/rejection notifications
✅ Attendance Certificates: Email certificates after events
✅ Cancellation Alerts: Notify users of cancelled events

Reporting & Analytics

✅ Attendance Reports: Filter by event name, type, and date
✅ Sales Reports: Revenue tracking with filtering and sorting
✅ Export Functionality: Download registrations as XLSX
✅ User Analytics: Track participation and engagement
✅ Revenue Insights: Analyze income by event type

Administration

✅ User Management: Block/unblock users
✅ Content Moderation: Remove inappropriate comments
✅ Workshop Review Dashboard: Centralized approval interface
✅ Vendor Requests: Approve/reject vendor applications
✅ System-wide Settings: Configure platform parameters

Technologies Used

Frontend Stack

Technology	Version	Purpose
React	19.1.1	UI component library
Vite	7.1.7	Build tool and dev server
Tailwind CSS	3.4.3	Utility-first styling
React Router DOM	7.9.4	Client-side routing
Axios	1.12.2	HTTP requests
Framer Motion	12.23.24	Animations
Lucide React	0.545.0	Icon library
React Hot Toast	2.6.0	Toast notifications
Sonner	2.0.7	Advanced notifications
DayJS	1.11.19	Date manipulation
QRCode	1.5.4	QR code generation
XLSX	0.18.5	Excel export

Backend Stack

Technology	Version	Purpose
Node.js	ES Modules	JavaScript runtime
Express	5.1.0	Web framework
MongoDB	Atlas	NoSQL database
Mongoose	8.18.2	MongoDB ODM
JWT	9.0.2	Authentication
Bcrypt	6.0.0	Password hashing
Stripe	19.3.0	Payment processing
Nodemailer	7.0.6	Email service
Resend	6.4.2	Email API
Multer	2.0.2	File uploads
Node-cron	4.2.1	Task scheduling
Joi	18.0.1	Validation
QRCode	1.5.4	QR generation
XLSX	0.18.5	Excel export
Canvas	3.2.0	Image manipulation
CORS	2.8.5	Cross-origin requests

System Architecture

┌─────────────────────────────────────────────────────────────┐
│                        Client Layer                          │
│   (React SPA - Role-based routing and state management)     │
└─────────────────────┬───────────────────────────────────────┘
                      │ HTTPS/REST API
                      │
┌─────────────────────▼───────────────────────────────────────┐
│                   Application Layer                          │
│  ┌──────────────┐ ┌──────────────┐ ┌─────────────────────┐ │
│  │   Express    │ │ Middleware   │ │  Authentication     │ │
│  │   Router     │ │  - Auth      │ │  - JWT Tokens       │ │
│  │              │ │  - Upload    │ │  - Role Validation  │ │
│  └──────────────┘ └──────────────┘ └─────────────────────┘ │
└─────────────────────┬───────────────────────────────────────┘
                      │
┌─────────────────────▼───────────────────────────────────────┐
│                   Business Logic Layer                       │
│  ┌──────────────────────────────────────────────────────┐   │
│  │              Controllers (12 modules)                 │   │
│  │  • Events  • Users  • Vendors  • Payments            │   │
│  │  • Registrations  • Notifications  • Analytics       │   │
│  └──────────────────────────────────────────────────────┘   │
└─────────────────────┬───────────────────────────────────────┘
                      │
┌─────────────────────▼───────────────────────────────────────┐
│                    Data Layer                                │
│  ┌──────────────────────────────────────────────────────┐   │
│  │         MongoDB Atlas (22 Collections)               │   │
│  │  Users • Events • Workshops • Trips • Bazaars        │   │
│  │  Registrations • Payments • Wallets • Notifications  │   │
│  └──────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘
        │                    │                    │
┌───────▼──────┐    ┌───────▼──────┐    ┌───────▼──────┐
│    Stripe    │    │  Nodemailer  │    │   File       │
│   Payment    │    │    Email     │    │  Storage     │
│   Gateway    │    │   Service    │    │  (Uploads)   │
└──────────────┘    └──────────────┘    └──────────────┘

Getting Started

Prerequisites

Before you begin, ensure you have the following installed:

Node.js (v18.0.0 or higher)
```
node --version
```
npm (v9.0.0 or higher) or yarn
```
npm --version
```
MongoDB Atlas Account (or local MongoDB instance)
Stripe Account (for payment processing)
Gmail Account (for email notifications)

Installation

Follow these steps to set up the project locally:

1. Clone the Repository

git clone https://github.com/Advanced-Computer-Lab-2025/Hat-Ya-Seedy-El-Computer.git
cd Hat-Ya-Seedy-El-Computer

2. Install Backend Dependencies

cd backend
npm install

3. Install Frontend Dependencies

cd ../frontend
npm install

Environment Variables

Backend Configuration

Create a .env file in the backend directory:

cd backend
touch .env

Add the following environment variables:

# Server Configuration
PORT=5001
NODE_ENV=development

# Database Configuration
MONGODB_URI=your_mongodb_connection_string

# JWT Configuration
JWT_SECRET=your_super_secret_jwt_key_min_32_characters
JWT_EXPIRE=7d

# Stripe Configuration
STRIPE_SECRET_KEY=your_stripe_secret_key
STRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key

# Email Configuration (Gmail)
EMAIL_HOST=smtp.gmail.com
EMAIL_PORT=587
EMAIL_USER=your_email@gmail.com
EMAIL_PASSWORD=your_app_specific_password
ADMIN_EMAIL=admin@guc.edu.eg

# Frontend URL
FRONTEND_URL=http://localhost:5173

# File Upload
MAX_FILE_SIZE=5242880
UPLOAD_PATH=./uploads

Frontend Configuration

Create a .env file in the frontend directory:

cd ../frontend
touch .env

Add the following:

VITE_API_URL=http://localhost:5001/api
VITE_STRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key

Running the Application

Development Mode

Open two terminal windows:

Terminal 1 - Backend:

cd backend
npm run dev

Server will start on http://localhost:5001

Terminal 2 - Frontend:

cd frontend
npm run dev

Application will open on http://localhost:5173

Production Mode

Build Frontend:

cd frontend
npm run build

Start Backend:

cd backend
npm start

User Roles

The system supports 7 distinct user roles, each with specific permissions:

1. Student

Access Level: Basic User

Capabilities:

Browse and filter all events
Register for workshops, trips, and conferences
Reserve courts (basketball, tennis, football)
Make payments via Stripe or wallet
Rate and comment on attended events
Manage favorites list
View wallet balance and transaction history
Receive email notifications and certificates

2. Staff

Access Level: Basic User+

Capabilities:

All student capabilities
Additional permissions for staff-only events
Priority registration for certain events

3. Teaching Assistant (TA)

Access Level: Academic User

Capabilities:

All student capabilities
Participate in academic events
Provide feedback on workshops
Access to TA-specific resources

4. Professor

Access Level: Content Creator

Capabilities:

All TA capabilities
Submit workshop proposals
Track workshop approval status
View workshop participants and remaining spots
Receive notifications on workshop acceptance/rejection
Edit submitted workshops based on feedback

5. Events Office

Access Level: Event Manager

Capabilities:

All event browsing capabilities
Review and approve/reject workshop proposals
Create and manage all event types
Archive past events
Generate QR codes for external visitors
Create polls for vendor booth selection
Manage gym sessions (create, edit, cancel)
Generate attendance and sales reports
Export registration data to Excel
Restrict events to specific user groups

6. Admin

Access Level: System Administrator

Capabilities:

All Events Office capabilities
User management (block/unblock users)
Content moderation (delete comments)
View system-wide analytics
Access to all reports and data
System configuration

7. Vendor

Access Level: External Partner

Capabilities:

Apply for bazaar participation
Request booth reservations
Upload required documents (tax card, IDs, logo)
Pay participation fees
Apply for GUC loyalty program
Manage booth details and promotions
Cancel participation requests

API Documentation

Base URL

http://localhost:5001/api

Authentication

Most endpoints require JWT authentication. Include the token in the Authorization header:

Authorization: Bearer <your_jwt_token>

Main Endpoints

Authentication

Method	Endpoint	Description	Auth Required
POST	`/users/register`	Register new user	No
POST	`/users/login`	User login	No
GET	`/users/verify-email/:token`	Verify email	No
POST	`/users/forgot-password`	Request password reset	No

Events

Method	Endpoint	Description	Auth Required
GET	`/events`	Get all events	Yes
GET	`/events/:id`	Get event by ID	Yes
POST	`/events`	Create event	Yes (Events Office)
PUT	`/events/:id`	Update event	Yes (Events Office)
DELETE	`/events/:id`	Delete event	Yes (Events Office)
GET	`/events/filter`	Filter events	Yes

Workshops

Method	Endpoint	Description	Auth Required
POST	`/events/workshop`	Submit workshop	Yes (Professor)
PUT	`/events/workshop/:id/status`	Update status	Yes (Events Office)
GET	`/events/workshops/pending`	Get pending workshops	Yes (Events Office)

Registrations

Method	Endpoint	Description	Auth Required
POST	`/registrations`	Register for event	Yes
GET	`/registrations/user/:userId`	Get user registrations	Yes
DELETE	`/registrations/:id`	Cancel registration	Yes

Payments

Method	Endpoint	Description	Auth Required
POST	`/payments/create-intent`	Create payment intent	Yes
POST	`/payments/confirm`	Confirm payment	Yes
GET	`/wallet/balance`	Get wallet balance	Yes

Vendors

Method	Endpoint	Description	Auth Required
POST	`/vendors/apply`	Apply as vendor	Yes
PUT	`/vendors/:id`	Update vendor info	Yes
POST	`/vendors/booth-request`	Request booth	Yes (Vendor)

Courts

Method	Endpoint	Description	Auth Required
GET	`/courts/available`	Get available slots	Yes
POST	`/courts/reserve`	Reserve court	Yes
DELETE	`/courts/:id`	Cancel reservation	Yes

Gym Sessions

Method	Endpoint	Description	Auth Required
GET	`/gymsessions`	Get all sessions	Yes
POST	`/gymsessions`	Create session	Yes (Events Office)
PUT	`/gymsessions/:id`	Update session	Yes (Events Office)
DELETE	`/gymsessions/:id`	Cancel session	Yes (Events Office)

For complete API documentation with request/response examples, see API_DOCS.md (to be created).

Project Structure

Hat-Ya-Seedy-El-Computer/
│
├── backend/
│   ├── src/
│   │   ├── config/
│   │   │   └── db.js                    # MongoDB connection
│   │   │
│   │   ├── controllers/
│   │   │   ├── eventController.js       # Event CRUD operations
│   │   │   ├── userController.js        # User management
│   │   │   ├── vendorController.js      # Vendor operations
│   │   │   ├── paymentController.js     # Payment processing
│   │   │   ├── registrationController.js # Event registrations
│   │   │   ├── notificationController.js # Notifications
│   │   │   ├── gymSessionController.js  # Gym management
│   │   │   ├── courtReservationController.js # Court bookings
│   │   │   ├── pollController.js        # Vendor polls
│   │   │   ├── walletController.js      # Wallet operations
│   │   │   └── analyticsController.js   # Reports & analytics
│   │   │
│   │   ├── models/                      # 22 Mongoose schemas
│   │   │   ├── User.js                  # User model
│   │   │   ├── Event.js                 # Base event model
│   │   │   ├── Workshop.js              # Workshop model
│   │   │   ├── Conference.js            # Conference model
│   │   │   ├── Trip.js                  # Trip model
│   │   │   ├── Bazaar.js                # Bazaar model
│   │   │   ├── Booth.js                 # Booth model
│   │   │   ├── GymSession.js            # Gym session model
│   │   │   ├── CourtReservation.js      # Court reservation model
│   │   │   ├── Registration.js          # Event registration model
│   │   │   ├── Payment.js               # Payment model
│   │   │   ├── Wallet.js                # Wallet model
│   │   │   ├── Transaction.js           # Transaction model
│   │   │   ├── Vendor.js                # Vendor model
│   │   │   ├── VendorRequest.js         # Vendor application model
│   │   │   ├── Notification.js          # Notification model
│   │   │   ├── Comment.js               # Comment model
│   │   │   ├── Rating.js                # Rating model
│   │   │   ├── Poll.js                  # Poll model
│   │   │   ├── LoyaltyApplication.js    # Loyalty program application
│   │   │   └── LoyaltyPartner.js        # Loyalty partner model
│   │   │
│   │   ├── routes/                      # API route definitions
│   │   │   ├── userRoutes.js
│   │   │   ├── eventRoutes.js
│   │   │   ├── vendorRoutes.js
│   │   │   ├── paymentRoutes.js
│   │   │   ├── registrationRoutes.js
│   │   │   ├── notificationRoutes.js
│   │   │   ├── gymSessionRoutes.js
│   │   │   ├── courtRoutes.js
│   │   │   ├── pollRoutes.js
│   │   │   ├── walletRoutes.js
│   │   │   └── analyticsRoutes.js
│   │   │
│   │   ├── middlewares/
│   │   │   ├── authMiddleware.js        # JWT authentication
│   │   │   └── uploadMiddleware.js      # File upload handling
│   │   │
│   │   ├── validation/
│   │   │   ├── signupValidationSchema.js
│   │   │   ├── adminCreationSchema.js
│   │   │   ├── facultyApprovalSchema.js
│   │   │   └── vendorValidation.js
│   │   │
│   │   ├── utils/
│   │   │   ├── sendEmail.js             # Email utility
│   │   │   ├── stripe.js                # Stripe configuration
│   │   │   └── scheduler.js             # Cron jobs
│   │   │
│   │   └── server.js                    # Application entry point
│   │
│   ├── uploads/                         # Uploaded files storage
│   ├── .env                             # Environment variables (DO NOT COMMIT)
│   ├── .env.example                     # Environment template
│   ├── package.json                     # Backend dependencies
│   └── .gitignore
│
├── frontend/
│   ├── public/                          # Static assets
│   │
│   ├── src/
│   │   ├── features/                    # Feature-based modules
│   │   │   ├── admin/                   # Admin components
│   │   │   ├── auth/                    # Authentication
│   │   │   ├── student/                 # Student features
│   │   │   ├── professor/               # Professor features
│   │   │   ├── staffTA/                 # Staff/TA features
│   │   │   ├── vendor/                  # Vendor features
│   │   │   ├── eventOffice/             # Events Office features
│   │   │   ├── gym/                     # Gym management
│   │   │   └── polls/                   # Polling system
│   │   │
│   │   ├── api/                         # API service layer
│   │   │   ├── axiosInstance.js         # Axios configuration
│   │   │   ├── eventApi.js              # Event API calls
│   │   │   ├── userApi.js               # User API calls
│   │   │   ├── vendorApi.js             # Vendor API calls
│   │   │   ├── registrationApi.js       # Registration API calls
│   │   │   ├── gymApi.js                # Gym API calls
│   │   │   ├── adminApi.js              # Admin API calls
│   │   │   ├── notificationApi.js       # Notification API calls
│   │   │   ├── pollApi.js               # Poll API calls
│   │   │   └── courtsApi.js             # Court API calls
│   │   │
│   │   ├── routes/                      # Route configurations
│   │   │   ├── AppRoutes.jsx            # Main router
│   │   │   ├── AdminRoutes.jsx          # Admin routes
│   │   │   ├── StudentRoutes.jsx        # Student routes
│   │   │   ├── ProfessorRoutes.jsx      # Professor routes
│   │   │   ├── StaffTARoutes.jsx        # Staff/TA routes
│   │   │   ├── VendorRoutes.jsx         # Vendor routes
│   │   │   ├── eventsOfficeRoutes.jsx   # Events Office routes
│   │   │   └── gymRoutes.jsx            # Gym routes
│   │   │
│   │   ├── context/                     # React Context API
│   │   │   ├── AuthContext.jsx          # Authentication context
│   │   │   └── NotificationContext.jsx  # Notification context
│   │   │
│   │   ├── components/                  # Shared components
│   │   │   ├── common/                  # Reusable UI components
│   │   │   ├── layout/                  # Layout components
│   │   │   └── forms/                   # Form components
│   │   │
│   │   ├── hooks/                       # Custom React hooks
│   │   │
│   │   ├── utils/                       # Utility functions
│   │   │
│   │   ├── assets/                      # Images, fonts, etc.
│   │   │
│   │   ├── App.jsx                      # Root component
│   │   ├── main.jsx                     # Application entry
│   │   └── index.css                    # Global styles
│   │
│   ├── dist/                            # Build output
│   ├── index.html                       # HTML template
│   ├── vite.config.js                   # Vite configuration
│   ├── tailwind.config.js               # Tailwind CSS config
│   ├── postcss.config.js                # PostCSS config
│   ├── eslint.config.js                 # ESLint configuration
│   ├── package.json                     # Frontend dependencies
│   └── .env                             # Frontend env vars (DO NOT COMMIT)
│
├── .git/                                # Git repository
├── .gitignore                           # Git ignore rules
├── README.md                            # This file
└── LICENSE                              # License file

Database Schema

Core Collections

Users Collection

{
  _id: ObjectId,
  name: String,
  email: String (unique),
  password: String (hashed),
  role: Enum ['student', 'staff', 'ta', 'professor', 'eventsOffice', 'admin', 'vendor'],
  isVerified: Boolean,
  isBlocked: Boolean,
  createdAt: Date,
  updatedAt: Date
}

Events Collection

{
  _id: ObjectId,
  type: Enum ['workshop', 'trip', 'bazaar', 'conference', 'booth'],
  title: String,
  description: String,
  location: String,
  startDate: Date,
  endDate: Date,
  capacity: Number,
  remainingSpots: Number,
  price: Number,
  restrictions: [String], // User roles
  status: Enum ['active', 'archived', 'cancelled'],
  organizerId: ObjectId (ref: User),
  createdAt: Date,
  updatedAt: Date
}

Registrations Collection

{
  _id: ObjectId,
  eventId: ObjectId (ref: Event),
  userId: ObjectId (ref: User),
  paymentStatus: Enum ['pending', 'paid', 'refunded'],
  paymentMethod: Enum ['stripe', 'wallet'],
  attendanceStatus: Enum ['registered', 'attended', 'absent'],
  registrationDate: Date
}

Payments Collection

{
  _id: ObjectId,
  userId: ObjectId (ref: User),
  amount: Number,
  type: Enum ['event_registration', 'vendor_fee', 'court_reservation'],
  status: Enum ['pending', 'completed', 'failed', 'refunded'],
  stripePaymentId: String,
  createdAt: Date
}

Wallets Collection

{
  _id: ObjectId,
  userId: ObjectId (ref: User),
  balance: Number,
  transactions: [{
    amount: Number,
    type: Enum ['credit', 'debit'],
    description: String,
    date: Date
  }]
}

For complete schema documentation, see DATABASE.md (to be created).

Screenshots

Landing Page

Event Browsing

Workshop Submission

Payment Flow

Admin Dashboard

Vendor Portal

Roadmap

Phase 1 - Core Features ✅ (Completed)

User authentication and authorization
Event management (CRUD operations)
Workshop submission and approval workflow
Payment integration (Stripe + Wallet)
Email notification system
Court reservation system
Vendor management
Reporting and analytics

Phase 2 - Enhanced Features 🚧 (In Progress)

Mobile app (React Native)
Push notifications
Advanced analytics dashboard
Calendar integration (Google Calendar, iCal)
Social media sharing
Multi-language support (Arabic/English)

Phase 3 - Advanced Features 📋 (Planned)

AI-powered event recommendations
Chatbot for event inquiries
Video streaming for online workshops
Blockchain-based attendance verification
Integration with university systems (SIS)
Mobile payment options (e-wallets)

Phase 4 - Optimization 🎯 (Future)

Performance optimization
CDN integration for static assets
Advanced caching strategies
Load testing and scaling
Microservices architecture migration

Contributing

We welcome contributions from the community! Here's how you can help:

How to Contribute

Fork the Repository

git clone https://github.com/Advanced-Computer-Lab-2025/Hat-Ya-Seedy-El-Computer.git
cd Hat-Ya-Seedy-El-Computer

Create a Feature Branch
```
git checkout -b feature/amazing-feature
```
Make Your Changes
- Write clean, maintainable code
- Follow the existing code style
- Add comments where necessary
- Update documentation if needed
Commit Your Changes
```
git add .
git commit -m "Add: amazing new feature"
```
Commit Message Guidelines:
- Add: for new features
- Fix: for bug fixes
- Update: for updates to existing features
- Refactor: for code refactoring
- Docs: for documentation changes
Push to Your Fork
```
git push origin feature/amazing-feature
```
Open a Pull Request
- Go to the original repository
- Click "New Pull Request"
- Provide a clear description of your changes
- Reference any related issues

Code Style Guidelines

JavaScript/React

Use ES6+ features
Use functional components with hooks
Follow Airbnb JavaScript Style Guide
Use meaningful variable and function names
Keep functions small and focused
Add JSDoc comments for complex functions

CSS/Tailwind

Use Tailwind utility classes
Follow mobile-first responsive design
Maintain consistent spacing and colors
Use custom classes sparingly

Git Best Practices

Write clear, descriptive commit messages
Keep commits atomic (one feature/fix per commit)
Pull latest changes before creating PR
Resolve conflicts before submitting PR

Reporting Bugs

Found a bug? Please create an issue with:

Clear, descriptive title
Steps to reproduce
Expected vs actual behavior
Screenshots (if applicable)
Your environment (OS, browser, Node version)

Feature Requests

Have an idea? We'd love to hear it! Open an issue with:

Clear description of the feature
Use cases and benefits
Potential implementation approach

License

This project is licensed under the ISC License.

ISC License

Copyright (c) 2025, Advanced Computer Lab - GUC

Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Contact

Development Team

German University in Cairo - Advanced Computer Lab 2025

Project Repository: GitHub
Issue Tracker: GitHub Issues
Email: acl2025@guc.edu.eg

Maintainers

For questions or support, please open an issue on GitHub or contact the development team.

Acknowledgments

Technologies

React - The amazing UI library
Express - Fast, unopinionated web framework
MongoDB - The database for modern applications
Stripe - Payment processing platform
Tailwind CSS - Utility-first CSS framework

Inspiration

GUC community needs and feedback
Modern event management platforms
Educational institution requirements

Special Thanks

German University in Cairo for supporting this project
Advanced Computer Lab instructors and TAs
All contributors and testers
Open source community

Made with ❤️ by the Advanced Computer Lab Team

⬆ Back to Top

Name		Name	Last commit message	Last commit date
backend		backend
frontend		frontend
.gitignore		.gitignore
README.md		README.md

Latest commit

History

Folders and files

Repository files navigation

Hat-Ya-Seedy-El-Computer

Table of Contents

About the Project

Why This Project?

Built With

Features

Event Management

Workshop Workflow

Payment System

Vendor Management

Gym & Court Reservations

Ratings & Reviews

Notifications & Communication

Reporting & Analytics

Administration

Technologies Used

Frontend Stack

Backend Stack

System Architecture

Getting Started

Prerequisites

Installation

1. Clone the Repository

2. Install Backend Dependencies

3. Install Frontend Dependencies

Environment Variables

Backend Configuration

Frontend Configuration

Running the Application

Development Mode

Production Mode

User Roles

1. Student

2. Staff

3. Teaching Assistant (TA)

4. Professor

5. Events Office

6. Admin

7. Vendor

API Documentation

Base URL

Authentication

Main Endpoints

Authentication

Events

Workshops

Registrations

Payments

Vendors

Courts

Gym Sessions

Project Structure

Database Schema

Core Collections

Users Collection

Events Collection

Registrations Collection

Payments Collection

Wallets Collection

Screenshots

Landing Page

Event Browsing

Workshop Submission

Payment Flow

Admin Dashboard

Vendor Portal

Roadmap

Phase 1 - Core Features ✅ (Completed)

Phase 2 - Enhanced Features 🚧 (In Progress)

Phase 3 - Advanced Features 📋 (Planned)

Phase 4 - Optimization 🎯 (Future)

Contributing

How to Contribute

Code Style Guidelines

JavaScript/React

CSS/Tailwind