https://github.com/thkox/uni_2023-smart-alert

The Smart Alert Android App is a team assignment designed for the "Current Topics of Software Engineering - Mobile Software" course, offered in the 7th semester of the 2023-2024 academic year at the University of Piraeus, Department of Informatics.
https://github.com/thkox/uni_2023-smart-alert

android cloud-storage department-of-informatics fcm-push-notification firebase firebase-auth google-maps-api gradle-kotlin kotlin realtime-database realtime-messaging sqlite-database university-of-piraeus

Last synced: 5 months ago
JSON representation

Host: GitHub
URL: https://github.com/thkox/uni_2023-smart-alert
Owner: thkox
License: mit
Created: 2024-02-09T16:40:21.000Z (over 2 years ago)
Default Branch: master
Last Pushed: 2024-10-19T22:36:23.000Z (over 1 year ago)
Last Synced: 2024-11-03T21:05:24.230Z (over 1 year ago)
Topics: android, cloud-storage, department-of-informatics, fcm-push-notification, firebase, firebase-auth, google-maps-api, gradle-kotlin, kotlin, realtime-database, realtime-messaging, sqlite-database, university-of-piraeus
Language: Kotlin
Homepage:
Size: 34.3 MB
Stars: 2
Watchers: 1
Forks: 1
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# Current Topics of Software Engineering (2024) - Smart Alert Android App

## Project Overview

The **Smart Alert Android App** is a team assignment designed for the "Current Topics of Software Engineering - Mobile Software" course, offered in the 7th semester of the 2023-2024 academic year at the University of Piraeus, Department of Informatics. The app provides real-time notifications to citizens during high-risk events such as natural disasters. It allows users to report emergencies, receive location-based alerts, and stay informed about ongoing hazardous situations. The app enables users to manage their safety by accessing vital information about their surroundings.

The Smart Alert system integrates with [Smart Alert Backend](https://github.com/thkox/current-topics-of-software-engineering_2023-smart-alert-server) that processes user-submitted reports, ranks them based on severity and proximity, and sends notifications to users in affected areas. This backend infrastructure ensures that only relevant alerts are delivered to those at risk.

## Course Information
- **Institution:** [University of Piraeus](https://www.unipi.gr/en/)
- **Department:** [Department of Informatics](https://cs.unipi.gr/en/)
- **Course:** Current Topics of Software Engineering (2024)
- **Semester:** 7th

## Technologies Used

- Kotlin
- Jetpack Compose
- Firebase Cloud Messaging (FCM)
- Firebase Authentication
- Firebase Realtime Database
- Firebase Cloud Storage
- SQLite

## App Features

### 1. User Roles

- **Citizen:** Users can report high-risk incidents by providing details such as the type of event (e.g., flood, fire), location, timestamp, and optionally attaching a photo.
- **Employee (Civil Protection):** Employees review, approve, or reject the reported incidents. They can also trigger notifications for citizens in affected areas.

### 2. Incident Reporting and Notification

- **Emergency Reporting:** Citizens can report emergencies categorized into pre-defined event types (floods, fires, earthquakes, etc.).
- **Location-Based Notifications:** Notifications are sent automatically to users in close proximity to the reported event, with information such as location, timestamp, and safety instructions.

### 3. Multilingual Support

- The app supports English and one additional language, allowing users to receive critical information in their preferred language.

### 4. Statistics and Event History

- **View Statistics:** Users can view statistics about past incidents, filterable by time and category, through a dedicated statistics interface.
- **Event History:** Users can access a history of reported incidents to stay informed about ongoing and past events in their area.

## Setup Instructions

1. Clone the repository:
```bash
git clone https://github.com/thkox/current-topics-of-software-engineering_2023-smart-alert.git
```

2. Open the project in Android Studio.
3. Configure Firebase credentials by adding the necessary `google-services.json` file.
4. Build and run the app on an Android device or emulator.

## Documentation and Resources

- Full project details can be found in the [Project-documentation.pdf](./docs/Project-documentation.pdf).
- A detailed walkthrough video is available: [Project-video.mp4](./video/Project-video.mp4).

## Screenshots

_{Report Incident}

_{Notifications}

_Statistics