https://github.com/maronworks/pi-sync
Thesis Computer Engineering
https://github.com/maronworks/pi-sync
android computer-engineering django-rest-framework embedded-systems raspberry-pi thesis
Last synced: 4 months ago
JSON representation
Thesis Computer Engineering
- Host: GitHub
- URL: https://github.com/maronworks/pi-sync
- Owner: maronworks
- License: mit
- Created: 2024-10-13T13:12:51.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-21T08:11:27.000Z (7 months ago)
- Last Synced: 2025-06-17T04:30:34.723Z (6 months ago)
- Topics: android, computer-engineering, django-rest-framework, embedded-systems, raspberry-pi, thesis
- Language: Kotlin
- Homepage:
- Size: 82.3 MB
- Stars: 4
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Pi-Sync 🏢🔐
Pi-Sync is a thesis project designed to revolutionize access control in condominiums by integrating modern technologies with centralized management. The system features a Django Rest Framework API as the central brain, syncing mobile and desktop platforms with Raspberry Pi devices for seamless door management and access tracking.
## Features ✨
### Centralized Dashboard 🖥️
- Built with **C# WinForms**, running on the desktop for admin users.
- Manage users and rooms with full CRUD functionality.
- Log all door access activities for monitoring and security.
### Tenant Mobile App 📱
- **Mobile App**: Developed with Kotlin and Jetpack Compose Material 3 for Android tenants.
- Provides tenants with door access controls and status.
### Access Methods 🔑
1. **Physical Key**: Used only as a backup when the system is not functioning, acknowledging that no system is perfect.
2. **Fingerprint Recognition**: Authenticate users with stored biometric data.
3. **Mobile Control**: Unlock doors via the mobile app over the network.
### Synchronization 🔄
- Real-time syncing of access data and logs between the mobile app, desktop admin dashboard, and Raspberry Pi devices.
## Activity Logging 📝
- Tracks and records door access events, providing a complete audit trail.
## System Architecture 🏗️
- The **Django Rest Framework API** serves as the **central brain** 🧠, managing data, authentication, and synchronization across platforms.
- The **Raspberry Pi 5** acts as a hardware controller 🖲️, directly managing door components like solenoids and fingerprint sensors.
## Repository Structure 📂
```
pi-sync/
├── api/ # Django Rest Framework backend API
source code (central brain)
├── android/ # Kotlin-based Android app
source code (tenant mobile app)
├── desktop/ # Desktop admin dashboard
source code (C# WinForms)
├── postman/ # Postman collection files
and endpoints.md for API testing
├── raspberrypi/ # Raspberry Pi source code managing
hardware (solenoid, fingerprint, etc.)
```
## Tech Stack 🛠️
### Hardware 💻
- **Raspberry Pi 5**: Hardware controller managing physical door components.
### Software 💾
- **Django Rest Framework**: Backend API serving as the system’s central brain.
- **Kotlin Jetpack Compose**: Mobile app for tenant users.
- **C# WinForms**: Desktop admin dashboard for managing users and logs.
- **Fingerprint Modules**: Integrated with the Raspberry Pi for biometric authentication.
## License 📜
This project is licensed under the MIT License. See the [LICENSE](LICENSE.txt) file for details.
## About 💡
Pi-Sync is developed as part of our thesis project by Ralph Maron Eda, Jack Cabigayan, Triesha Mae Olunan, and Jezlyn Cabbab. The system aims to enhance security and convenience in condominium access management through synchronized mobile and desktop applications integrated with hardware controllers.