A comprehensive Smart Home Automation System demonstrating the practical application of six fundamental software design patterns. Built as part of CTIS 417 - Software Design Patterns course at Bilkent University.
| Name | Role |
|---|---|
| Onurcan Genç | Developer |
| Efe Baran Durmaz | Developer |
| Moein Faghih | Developer |
- Features
- Design Patterns
- UML Class Diagram
- System Architecture
- Project Structure
- Installation
- Usage
- Configuration
- Demo Output
- Documentation
| Feature | Description | Pattern Used |
|---|---|---|
| 🌐 Multi-Protocol Support | WiFi 2.4GHz, WiFi 5GHz, IEEE 802.15.4 | Abstract Factory |
| 📡 Real-time Monitoring | Instant notifications to multiple clients | Observer |
| 🔐 Role-Based Access | Admin and User permission levels | Proxy |
| 🏢 Hierarchical Management | Building → Room → Device structure | Composite |
| 🎛️ Centralized Control | All devices coordinated through hub | Mediator |
| ⚙️ Global Configuration | Single source of system settings | Singleton |
| # | Pattern | Type | Class | Purpose |
|---|---|---|---|---|
| 1 | Singleton | Creational | SystemConfiguration |
Single instance for global system settings |
| 2 | Abstract Factory | Creational | DeviceFactory |
Protocol-specific device creation |
| 3 | Composite | Structural | BuildingComposite |
Hierarchical building/room/device structure |
| 4 | Proxy | Structural | SecureDeviceProxy |
Role-based access control |
| 5 | Observer | Behavioral | Subject/Observer |
Event notification system |
| 6 | Mediator | Behavioral | SmartHomeHubMediator |
Centralized device coordination |
┌─────────────────────────────────────────────────────────────┐
│ DESIGN PATTERNS │
├─────────────────┬─────────────────┬─────────────────────────┤
│ CREATIONAL │ STRUCTURAL │ BEHAVIORAL │
├─────────────────┼─────────────────┼─────────────────────────┤
│ • Singleton │ • Composite │ • Observer │
│ • Abstract │ • Proxy │ • Mediator │
│ Factory │ │ │
└─────────────────┴─────────────────┴─────────────────────────┘
The complete system architecture showing all classes, interfaces, and their relationships:
📖 Click to view diagram explanation
- CompositeComponent (Interface): Base interface for all controllable elements
- Device (Interface): Extends CompositeComponent, adds reset functionality
- Subject/Observer (Interfaces): Enables publish-subscribe pattern
- DeviceFactory (Interface): Abstract factory for creating device families
- SmartHomeHubMediator: Central coordinator for all device interactions
- SecureDeviceProxy: Protection proxy for access control
- Inheritance: Device classes implement Device interface
- Composition: BuildingComposite contains CompositeComponents
- Association: Mediator manages Device collection
- Dependency: Factories create Device instances
┌─────────────────────────────────────────────────────────────────┐
│ Main │
└─────────────────────────────────────────────────────────────────┘
│
┌──────────────────────┼──────────────────────┐
▼ ▼ ▼
┌───────────────┐ ┌─────────────────┐ ┌────────────────┐
│ SystemConfig │ │ DeviceFactory │ │ SecureDevice │
│ (Singleton) │ │ (Abstract Fact.)│ │ Proxy │
└───────────────┘ └─────────────────┘ └────────────────┘
│ │
┌───────────────┼───────────────┐ │
▼ ▼ ▼ ▼
┌──────────┐ ┌──────────┐ ┌──────────┐ │
│WiFi 2.4 │ │WiFi 5GHz │ │LowPower │ │
│ Factory │ │ Factory │ │ 802.15.4 │ │
└──────────┘ └──────────┘ └──────────┘ │
│ │ │ │
└───────────────┼───────────────┘ │
▼ │
┌─────────────────────────────────────────────────────────────────┐
│ SmartHomeHubMediator │
│ (Central Hub) │
└─────────────────────────────────────────────────────────────────┘
│
┌─────────┬───────────┼───────────┬─────────┐
▼ ▼ ▼ ▼ ▼
┌────────┐ ┌────────┐ ┌──────────┐ ┌────────┐ ┌────────┐
│ Light │ │Thermo- │ │ Motion │ │ Door │ │Building│
│ │ │ stat │ │ Sensor │ │ Lock │ │Compsite│
└────────┘ └────────┘ └──────────┘ └────────┘ └────────┘
│ │
└──────┬──────┘
▼
┌─────────────────────────────┐
│ Observers │
├─────────────────────────────┤
│ • DashboardView │
│ • MobileAppClient │
│ • AlertService │
└─────────────────────────────┘
CTIS417_Java/
│
├── 📄 CTIS417_Java.iml # IntelliJ IDEA module file
├── 📄 .gitignore # Git ignore rules
├── 📄 README.md # This file
├── 📄 LICENSE # MIT License
│
├── 📂 src/
│ ├── 📂 app/
│ │ └── 📄 Main.java # 🚀 Entry point
│ │
│ ├── 📂 config/
│ │ └── 📄 SystemConfiguration.java # ⚙️ Singleton
│ │
│ ├── 📂 device/
│ │ ├── 📄 Device.java # Interface
│ │ ├── 📄 Light.java # 💡 Light device
│ │ ├── 📄 Thermostat.java # 🌡️ Temperature control
│ │ ├── 📄 MotionSensor.java # 👁️ Motion detection
│ │ └── 📄 DoorLock.java # 🔒 Security lock
│ │
│ ├── 📂 factory/
│ │ ├── 📄 DeviceFactory.java # 🏭 Abstract Factory
│ │ ├── 📄 WiFi24GHzDeviceFactory.java # 2.4GHz implementation
│ │ ├── 📄 WiFi5GHzDeviceFactory.java # 5GHz implementation
│ │ └── 📄 LowPower80215DeviceFactory.java # 802.15.4 implementation
│ │
│ ├── 📂 composite/
│ │ ├── 📄 CompositeComponent.java # 🧩 Component interface
│ │ └── 📄 BuildingComposite.java # 🏢 Composite container
│ │
│ ├── 📂 observer/
│ │ ├── 📄 Observer.java # 👀 Observer interface
│ │ ├── 📄 Subject.java # 📢 Subject interface
│ │ ├── 📄 DashboardView.java # 📊 Dashboard client
│ │ ├── 📄 MobileAppClient.java # 📱 Mobile client
│ │ └── 📄 AlertService.java # 🚨 Alert service
│ │
│ ├── 📂 mediator/
│ │ └── 📄 SmartHomeHubMediator.java # 🎛️ Central mediator
│ │
│ └── 📂 proxy/
│ └── 📄 SecureDeviceProxy.java # 🛡️ Security proxy
│
├── 📂 docs/
│ ├── 📄 Class_Diagram.svg # 📊 UML Class Diagram
│ └── 📄 SmartHome_DesignPatterns_CTIS417.pptx # 📽️ Presentation
│
└── 📂 out/ # Compiled classes (ignored)
- ☕ Java JDK 17 or higher
- 💻 IntelliJ IDEA (recommended) or any Java IDE
- 🔧 Git
# Clone the repository
git clone https://github.com/yourusername/SmartHomeAutomation.git
# Navigate to project directory
cd SmartHomeAutomation- Open IntelliJ IDEA
- File → Open → Select project folder
- Trust the project
- Wait for indexing to complete
- Run
Main.java
# Compile all Java files
javac -d out src/**/*.java
# Run the application
java -cp out app.Main// 1. Get system configuration (Singleton)
SystemConfiguration config = SystemConfiguration.getInstance();
config.printCurrentConfiguration();
// 2. Create devices using Abstract Factory
DeviceFactory wifiFactory = new WiFi24GHzDeviceFactory();
Light light = wifiFactory.createLight();
Thermostat thermostat = wifiFactory.createThermostat();
// 3. Set up Observer pattern for notifications
DashboardView dashboard = new DashboardView();
AlertService alerts = new AlertService();
thermostat.addObserver(dashboard);
thermostat.addObserver(alerts);
// 4. Use Composite pattern for building structure
BuildingComposite building = new BuildingComposite();
BuildingComposite livingRoom = new BuildingComposite();
livingRoom.add(light);
livingRoom.add(thermostat);
building.add(livingRoom);
// Turn on all devices in building
building.turnOn();
// 5. Use Mediator for centralized control
SmartHomeHubMediator hub = new SmartHomeHubMediator();
hub.addDevice(light);
hub.addDevice(thermostat);
hub.resetSensors();
// 6. Use Proxy for access control
CompositeComponent secureLight = new SecureDeviceProxy(light, hub, "admin");
secureLight.turnOn(); // ✅ Access granted
CompositeComponent userLight = new SecureDeviceProxy(light, hub, "user");
userLight.turnOn(); // ❌ Access deniedThe SystemConfiguration singleton provides centralized configuration management:
| Setting | Default | Description |
|---|---|---|
hubIpAddress |
192.168.1.100 | Smart Hub IP |
hubPort |
8080 | Hub port number |
wifiSSID |
SmartHome_Network | WiFi network name |
maxConnectedDevices |
50 | Maximum devices |
networkTimeout |
30000ms | Connection timeout |
| Setting | Default | Description |
|---|---|---|
securityEnabled |
true | Enable security |
maxLoginAttempts |
3 | Login attempt limit |
sessionTimeoutMinutes |
30 | Session duration |
twoFactorEnabled |
false | 2FA status |
encryptionAlgorithm |
AES-256 | Encryption type |
| Setting | Default | Description |
|---|---|---|
minTemperatureThreshold |
16.0°C | Minimum comfortable |
maxTemperatureThreshold |
28.0°C | Maximum comfortable |
criticalHighTemperature |
40.0°C | Fire alarm trigger |
criticalLowTemperature |
5.0°C | Freeze warning |
| Setting | Default | Description |
|---|---|---|
energySavingMode |
false | Energy saving |
maxPowerConsumptionWatts |
5000W | Power limit |
peakHoursStart |
17:00 | Peak hours begin |
peakHoursEnd |
21:00 | Peak hours end |
╔════════════════════════════════════════════════════════════╗
║ SMART HOME SYSTEM CONFIGURATION LOADED ║
╠════════════════════════════════════════════════════════════╣
║ System: SmartHome Hub Pro ║
║ Version: 2.1.0 ║
║ Hub IP: 192.168.1.100:8080 ║
║ Security: ENABLED ║
║ Max Devices: 50 ║
╚════════════════════════════════════════════════════════════╝
=== Singleton Pattern ===
SystemConfiguration instance created.
Same instance: true
=== Abstract Factory Pattern ===
WiFi24GHzDeviceFactory: Creating Light.
WiFi24GHzDeviceFactory: Creating Thermostat.
LowPower80215DeviceFactory: Creating MotionSensor.
LowPower80215DeviceFactory: Creating DoorLock.
=== Observer Pattern ===
-- MotionSensor detects motion --
MotionSensor: Motion detected!
DashboardView: Received update notification. Motion detected!
AlertService: Received update notification. Motion detected!
-- Thermostat detects abnormal temperature --
⚠️ Thermostat: HIGH temperature detected! 45.0°C exceeds max threshold
DashboardView: Received update notification. Temperature Alert!
MobileAppClient: Received update notification. Temperature Alert!
=== Mediator Pattern ===
MotionSensor reset. No motion detected as default.
Thermostat reset. Temperature read as 25°C by default.
DoorLock reset. Unlocked by default.
Light reset. Off by default.
=== Composite Pattern ===
BuildingComposite: Turning on all children.
Light turned on.
Thermostat turned on.
MotionSensor turned on.
DoorLock locked.
=== Proxy Pattern ===
-- ADMIN user accessing Light --
Mediator: Checking access for role 'admin' to perform 'turnOn'
Mediator: Access GRANTED.
Light turned on.
-- USER accessing Light --
Mediator: Checking access for role 'user' to perform 'turnOn'
Mediator: Access DENIED.
| Document | Description | Link |
|---|---|---|
| 📊 UML Class Diagram | Complete system architecture | Class_Diagram.svg |
| 📽️ Presentation | Project presentation slides | PPTX |
| 📖 This README | Project documentation | You're here! |
- Language: Java 17+
- IDE: IntelliJ IDEA
- Build: Standard Java Compiler
- Version Control: Git & GitHub
- Documentation: Markdown, Mermaid (UML)
This project is licensed under the MIT License - see the LICENSE file for details.
MIT License
Copyright (c) 2024 Onurcan Genç, Efe Baran Durmaz, Moein Faghih
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software...
- 📚 CTIS 417 - Software Design Patterns Course
- 🎓 Bilkent University - Department of Computer Technology and Information Systems
- 📖 Gang of Four - Design Patterns: Elements of Reusable Object-Oriented Software
- 👨🏫 Our instructor for guidance and feedback
Made with ❤️ by Onurcan, Efe Baran & Moein
⭐ Star this repository if you found it helpful!