{"id":18221200,"url":"https://github.com/thkox/uni_2023-smart-alert","last_synced_at":"2026-02-08T21:32:30.477Z","repository":{"id":229887721,"uuid":"755205761","full_name":"thkox/uni_2023-smart-alert","owner":"thkox","description":"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.","archived":false,"fork":false,"pushed_at":"2024-10-19T22:36:23.000Z","size":35987,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-11-03T21:05:24.230Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thkox.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-09T16:40:21.000Z","updated_at":"2024-10-20T00:20:10.000Z","dependencies_parsed_at":"2024-03-26T19:52:35.896Z","dependency_job_id":"32be55bc-8b97-44f2-ae9c-470a2bbeaf4a","html_url":"https://github.com/thkox/uni_2023-smart-alert","commit_stats":null,"previous_names":["thkox/smart-alert","thkox/current-topics-of-software-engineering_2023-smart-alert","thkox/uni_2023-smart-alert"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thkox%2Funi_2023-smart-alert","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thkox%2Funi_2023-smart-alert/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thkox%2Funi_2023-smart-alert/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thkox%2Funi_2023-smart-alert/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thkox","download_url":"https://codeload.github.com/thkox/uni_2023-smart-alert/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246921868,"owners_count":20855339,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2024-11-03T21:05:33.902Z","updated_at":"2026-02-08T21:32:30.401Z","avatar_url":"https://github.com/thkox.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Current Topics of Software Engineering (2024) - Smart Alert Android App\n\n## Project Overview\n\nThe **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.\n\nThe 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.\n\n## Course Information\n- **Institution:** [University of Piraeus](https://www.unipi.gr/en/)\n- **Department:** [Department of Informatics](https://cs.unipi.gr/en/)\n- **Course:** Current Topics of Software Engineering (2024)\n- **Semester:** 7th\n\n## Technologies Used\n\n- Kotlin\n- Jetpack Compose\n- Firebase Cloud Messaging (FCM)\n- Firebase Authentication\n- Firebase Realtime Database\n- Firebase Cloud Storage\n- SQLite\n\n## App Features\n\n### 1. User Roles\n\n- **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.\n- **Employee (Civil Protection):** Employees review, approve, or reject the reported incidents. They can also trigger notifications for citizens in affected areas.\n\n### 2. Incident Reporting and Notification\n\n- **Emergency Reporting:** Citizens can report emergencies categorized into pre-defined event types (floods, fires, earthquakes, etc.).\n- **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.\n\n### 3. Multilingual Support\n\n- The app supports English and one additional language, allowing users to receive critical information in their preferred language.\n\n### 4. Statistics and Event History\n\n- **View Statistics:** Users can view statistics about past incidents, filterable by time and category, through a dedicated statistics interface.\n- **Event History:** Users can access a history of reported incidents to stay informed about ongoing and past events in their area.\n\n## Setup Instructions\n\n1. Clone the repository:\n    ```bash\n    git clone https://github.com/thkox/current-topics-of-software-engineering_2023-smart-alert.git\n    ```\n\n2. Open the project in Android Studio.\n3. Configure Firebase credentials by adding the necessary `google-services.json` file.\n4. Build and run the app on an Android device or emulator.\n\n## Documentation and Resources\n\n- Full project details can be found in the [Project-documentation.pdf](./docs/Project-documentation.pdf).\n- A detailed walkthrough video is available: [Project-video.mp4](./video/Project-video.mp4).\n\n## Screenshots\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003cimg src=\"./images/ReportIncident.png\" alt=\"Report Incident\"/\u003e\n      \u003cbr/\u003e\n      \u003csub\u003e\u003cb\u003eReport Incident\u003c/b\u003e\u003c/sub\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003cimg src=\"./images/Notifications.png\" alt=\"Notifications\"/\u003e\n      \u003cbr/\u003e\n      \u003csub\u003e\u003cb\u003eNotifications\u003c/b\u003e\u003c/sub\u003e\n    \u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003cimg src=\"./images/Statistics.png\" alt=\"Statistics\"/\u003e\n      \u003cbr/\u003e\n      \u003csub\u003e\u003cb\u003eStatistics\u003c/b\u003e\u003c/sub\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## Contributors\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/ApostolisSiampanis\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/75365398?v=4\" width=\"100px;\" alt=\"Apostolis Siampanis\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eApostolis Siampanis\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/thkox\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/79880468?v=4\" width=\"100px;\" alt=\"Theodore Koxanoglou\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eTheodore Koxanoglou\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/AlexanderCholis\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/66769337?v=4\" width=\"100px;\" alt=\"Alexander Cholis\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAlexander Cholis\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthkox%2Funi_2023-smart-alert","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthkox%2Funi_2023-smart-alert","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthkox%2Funi_2023-smart-alert/lists"}