SOLUTION_README.md

md9 kBIn solution.zip

🎯 Event Management System - Complete Solution

📋 Overview

This is the complete solution for the React Event Management System exam. This serves as the answer key for instructors.


✅ Implementation Summary

Components Implemented

All components have been fully implemented with all TODO items completed:

1. App.jsx - Main Application
  • ✅ State management with useState
  • ✅ Derived state for filtering (no useEffect)
  • ✅ Combined filter logic (type, capacity, search)
  • ✅ Event handlers for all user interactions
  • ✅ Conditional rendering for empty states
  • ✅ Sample data initialization
2. EventCard.jsx - Event Display Component
  • ✅ Availability calculations (sold out, almost full)
  • ✅ Dynamic badge rendering based on status
  • ✅ Capacity display (registered/total)
  • ✅ Selected state styling
  • ✅ Click handling with event propagation control
3. FilterPanel.jsx - Filtering Controls
  • ✅ Controlled inputs (search, type, capacity toggle)
  • ✅ Dynamic filter summary
  • ✅ Conditional "Clear Filters" button
  • ✅ Active filters detection
  • ✅ Filter state management
4. EditEventForm.jsx - Event Editing
  • ✅ Form state management
  • ✅ Validation with error display
  • ✅ Touched field tracking
  • ✅ Conditional fields for workshops
  • ✅ Change detection for unsaved warning
  • ✅ Modal overlay with proper UX
5. StatsDashboard.jsx - Statistics Display
  • ✅ Derived statistics calculations
  • ✅ Occupancy rate computation
  • ✅ Event type breakdown
  • ✅ Conditional high occupancy alert
  • ✅ No state management (all computed)
6. RegistrationForm.jsx (Bonus)
  • ✅ Registration form with validation
  • ✅ Email validation
  • ✅ Available seats display
  • ✅ Full event handling
  • ✅ Form reset after submission

🎓 React Concepts Demonstrated

State Management

  • useState for component state
  • Derived state for filtering (computed during render)
  • State lifting (filters managed in App, passed to children)
  • State updates with functional updates (prev => ...)

Event Handling

  • Form submissions
  • Input changes
  • Click events with propagation control
  • Conditional event handlers

Conditional Rendering

  • Empty states
  • Dynamic badges
  • Modal display
  • Error messages
  • Alert displays

Form Management

  • Controlled components
  • Form validation
  • Error display logic
  • Touched field tracking
  • Multi-field forms

Props & Component Composition

  • Props drilling
  • Callback props
  • Component reusability
  • Event bubbling control

Derived Calculations

  • Statistics without state
  • Filtered arrays
  • Computed values during render
  • No unnecessary useEffect

🏗️ Project Structure

src/
├── App.jsx                         # Main application component
├── main.jsx                        # Entry point
├── index.css                       # Complete styling (400+ lines)
└── components/
    ├── EventCard.jsx               # Event display card
    ├── FilterPanel.jsx             # Filter controls
    ├── EditEventForm.jsx           # Edit modal form
    ├── StatsDashboard.jsx          # Statistics display
    └── RegistrationForm.jsx        # Bonus registration form

🚀 Running the Solution

Installation

Shell
npm install

Development

Shell
npm run dev

Build

Shell
npm run build

🧪 Testing Checklist

Filter Functionality

  • ✅ Type filter (All/Workshops/Talks)
  • ✅ Search filter (title and speaker)
  • ✅ Capacity filter (hide full events)
  • ✅ Combined filters work together
  • ✅ Filter summary displays correctly
  • ✅ Clear filters button appears/works

Event Cards

  • ✅ All events display
  • ✅ Badges show correct status
  • ✅ Capacity displays correctly
  • ✅ Selected state highlights
  • ✅ Click to select works

Edit Form

  • ✅ Opens when event is clicked
  • ✅ Pre-fills with event data
  • ✅ Validation works
  • ✅ Errors show only after touch
  • ✅ Conditional workshop fields
  • ✅ Save updates the event
  • ✅ Cancel closes form
  • ✅ Unsaved changes warning

Statistics

  • ✅ Counts update with filters
  • ✅ Occupancy rate calculates correctly
  • ✅ Event type breakdown shows
  • ✅ High occupancy alert (>90%)

Edge Cases

  • ✅ No events found (empty state)
  • ✅ All events filtered out
  • ✅ Sold out events
  • ✅ Almost full events
  • ✅ Form validation edge cases

📊 Sample Data

The solution includes 6 sample events:

  • 3 Workshops (2 almost full, 1 with seats)
  • 3 Talks (1 sold out, 2 with seats)
  • Various capacity levels for testing
  • Different speakers and requirements

🎯 Grading Rubric Coverage

Q1: Event Dashboard (35 pts) ✅

  • State initialized correctly
  • Filtering uses derived state (no useEffect)
  • All filter conditions combined with &&
  • Event cards render with correct badges
  • Selected state highlighted
  • Empty state displays appropriately

Q2: Filter Panel (20 pts) ✅

  • All inputs are controlled
  • Filter summary updates correctly
  • Reset button conditionally visible
  • Reset functionality works

Q3: Edit Form (30 pts) ✅

  • Form initialized from event data
  • Validation implemented correctly
  • Errors show only after field touched
  • Conditional workshop fields
  • Form saves and closes properly
  • Cancel confirmation on unsaved changes

Q4: Statistics Dashboard (15 pts) ✅

  • All statistics calculated correctly
  • Derived state (no useState for stats)
  • Conditional alert for high occupancy
  • Event type breakdown displays

Bonus: Registration Form (+10 pts) ✅

  • Form validation implemented
  • Email validation working
  • Handles sold out events
  • Form resets after submission

💡 Key Learning Points

1. Derived State Pattern

JSX
// ✅ CORRECT - Calculate during render
const filteredEvents = events.filter(event => {
  return matchesType && matchesCapacity && matchesSearch;
});

// ❌ WRONG - Don't use useEffect for filtering
useEffect(() => {
  setFilteredEvents(...);
}, [events, filters]);

2. Controlled Components

JSX
// ✅ CORRECT - Controlled input
<input
  value={formData.title}
  onChange={(e) => handleChange('title', e.target.value)}
/>

// ❌ WRONG - Uncontrolled
<input defaultValue={event.title} />

3. Conditional Rendering

JSX
// ✅ CORRECT - Conditional display
{errors.title && touched.title && (
  <span className="form-error">{errors.title}</span>
)}

4. Event Propagation

JSX
// ✅ CORRECT - Stop propagation for nested buttons
onClick={(e) => {
  e.stopPropagation();
  onSelect(event.id);
}}

🔍 Common Student Mistakes (Avoided)

❌ Using useEffect for Filtering

JSX
// Students might do this (WRONG):
useEffect(() => {
  const filtered = events.filter(...);
  setFilteredEvents(filtered);
}, [events, filters]);

// Correct approach (in solution):
const filteredEvents = events.filter(...);

❌ Not Merging Filter Updates

JSX
// Wrong - replaces all filters:
setFilters(newFilters);

// Correct - merges:
setFilters(prev => ({ ...prev, ...newFilters }));

❌ Showing Errors Before Touch

JSX
// Wrong - shows errors immediately:
{errors.title && <span>{errors.title}</span>}

// Correct - only after touch:
{errors.title && touched.title && <span>{errors.title}</span>}

📝 Notes for Instructors

What This Tests

  • Core React hooks (useState)
  • Derived state patterns
  • Form handling and validation
  • Conditional rendering
  • Props and callbacks
  • Event handling
  • Component composition

What This Doesn't Require

  • CSS/Styling knowledge
  • useEffect (intentionally)
  • Custom hooks
  • Context API
  • External libraries
  • API integration

Time Expectations

  • Setup: 5 minutes
  • Implementation: 60-75 minutes
  • Testing: 10 minutes
  • Total: 90 minutes

Difficulty Level

  • Medium - Suitable for mid-semester exam
  • Requires understanding of core concepts
  • No advanced patterns needed
  • Focus on fundamentals

  • TEMPLATES/ - Contains all student-facing documentation
  • index.css - Complete styling (students don't modify)
  • package.json - Project dependencies

✨ Features Implemented

  1. Event Management

    • View all events in card layout
    • Filter by type, search, and capacity
    • Select and edit events
    • Real-time statistics
  2. Filtering System

    • Multi-criteria filtering
    • Search across title and speaker
    • Hide full events toggle
    • Filter summary display
  3. Event Editing

    • Modal form interface
    • Comprehensive validation
    • Conditional fields based on type
    • Unsaved changes warning
  4. Statistics Dashboard

    • Total events count
    • Capacity and registration tracking
    • Occupancy rate calculation
    • Event type breakdown
    • High occupancy alerts
  5. Bonus Registration (Extra Credit)

    • User registration form
    • Email validation
    • Available seats tracking
    • Sold out handling

🎉 Solution Complete

This solution demonstrates best practices for React development and covers all exam requirements. Students should be able to achieve 100% + bonus points by implementing all features as shown.

Total Possible Points: 110/100 (with bonus)

In solution.zip