Parking Garage Management System 🚗

A comprehensive smart parking garage system implemented using Test-Driven Development (TDD) methodology with AI-assisted development.

This is an enhanced implementation of the original sromano-courses/parkinggaragepy project, extending it with complete functionality and comprehensive testing.

• 6/6 User Stories Implemented
• 9/9 Unit Tests Passing (100% success rate)
• All features fully functional

• Infrared sensors on pins 11, 12, 13 detect vehicle presence
• Returns True if car detected, False otherwise
• Comprehensive error handling for invalid pins

• Counts occupied parking spots in real-time
• Supports all 3 parking spots
• Uses check_occupancy() from User Story #1

• Base rate: 2.50€ per hour (rounded up)
• Weekend surcharge: +25% on Saturday & Sunday
• Integrates with RTC (DS3231) for accurate time tracking
• Example: 3 hours on Monday = 7.50€; 8 hours on Saturday = 25€

• Servo motor control on pin 16
• PWM-based angle calculation: duty_cycle = (angle / 18) + 2
• 0° = Fully closed, 180° = Fully open
• Real-time door status tracking

• Red LED on pin 18
• turn_on_red_light() & turn_off_red_light() methods
• Implemented using GAI4-TDD plugin (AI-assisted)
• Intelligent GPIO state management

• Automatically controls red light based on parking availability
• ON: When garage is full (3/3 spots occupied)
• OFF: When parking spots available
• Implemented using GAI4-TDD plugin (AI-assisted)

parkinggaragepy/
├── src/
│   └── parking_garage.py          # Main implementation (105 lines)
├── test/
│   └── test_parking_garage.py     # Unit tests (9 test cases)
├── mock/
│   ├── GPIO.py                    # Mock GPIO library
│   └── SDL_DS3231.py              # Mock RTC module
├── .gitignore
└── README.md

test_something                                    ✅ PASSED
test_calculate_parking_fee_monday                 ✅ PASSED (7.50€)
test_calculate_parking_fee_saturday               ✅ PASSED (25.00€)
test_open_garage_door                             ✅ PASSED
test_close_garage_door                            ✅ PASSED
test_turn_on_red_light                            ✅ PASSED (AI-assisted)
test_turn_off_red_light                           ✅ PASSED (AI-assisted)
test_manage_red_light_on_when_full                ✅ PASSED (AI-assisted)
test_manage_red_light_off_when_not_full           ✅ PASSED (AI-assisted)

python -m pytest test/test_parking_garage.py -v

git clone https://github.com/Mustafa99Ab/parkinggaragepy.git
cd parkinggaragepy

python -m pytest test/test_parking_garage.py -v

from src.parking_garage import ParkingGarage

# Initialize the system
garage = ParkingGarage()

# Check occupancy
car_detected = garage.check_occupancy(garage.INFRARED_PIN1)

# Get total occupied spots
occupied = garage.get_number_occupied_spots()

# Calculate fee (entry_time: datetime object)
fee = garage.calculate_parking_fee(entry_time)

# Control garage door
garage.open_garage_door()
garage.close_garage_door()

# Manage lights
garage.manage_red_light()  # Auto-control based on availability

This project follows the Red-Green-Refactor cycle:

1. Red Phase 🔴: Write failing test cases
2. Green Phase 🟢: Implement code to pass tests
3. Refactor Phase 🔵: Optimize and improve code

User Stories #5 and #6 were developed using GAI4-TDD plugin:

• Automated code generation based on test requirements
• GPT-4o model for intelligent suggestions
• Human review and approval of generated code

• ✅ 100% Test Coverage for implemented features
• ✅ TDD Methodology ensures code reliability
• ✅ Comprehensive Comments for maintainability
• ✅ Error Handling with custom exceptions
• ✅ Mock Objects for hardware abstraction

def calculate_parking_fee(self, entry_time: datetime) -> float:
    current_time = self.rtc.read_datetime()
    time_diff = current_time - entry_time
    hours = math.ceil(time_diff.total_seconds() / 3600)
    price = hours * 2.50
    if current_time.weekday() >= 5:  # Saturday or Sunday
        price *= 1.25
    return price

def manage_red_light(self) -> None:
    occupied_spots = self.get_number_occupied_spots()
    if occupied_spots >= 3:
        self.turn_on_red_light()
    else:
        self.turn_off_red_light()

This project demonstrates:

• Software Engineering: TDD best practices
• Testing: Unit testing with comprehensive coverage
• Hardware Integration: GPIO, PWM, sensors, RTC
• AI Development: AI-assisted code generation
• System Design: Multi-component smart system
• Problem Solving: Real-world automation challenges

• Web dashboard for real-time monitoring
• Mobile app for parking management
• Payment integration (credit card, mobile wallet)
• Reservation system
• Analytics and reporting
• Multi-garage support

This is a fork of sromano-courses/parkinggaragepy

Enhancements in this version:

• Complete implementation of all 6 User Stories
• Comprehensive unit testing (9 test cases)
• AI-assisted development using GAI4-TDD
• Enhanced documentation and code quality

MIT License - See original project for details

Mustafa99Ab

• GitHub: @Mustafa99Ab
• Project: Enhanced Parking Garage Management System

• Original Project: sromano-courses/parkinggaragepy
• GAI4-TDD Plugin: AI-assisted TDD development for PyCharm

For questions or issues:

1. Check existing issues
2. Review test cases for usage examples
3. Examine code comments for implementation details

Last Updated: November 2025 Status: ✅ Complete & Production Ready