{"id":20098644,"url":"https://github.com/encryptex/firestation-alerts","last_synced_at":"2025-07-13T07:40:24.386Z","repository":{"id":116032193,"uuid":"530385754","full_name":"EncryptEx/firestation-alerts","owner":"EncryptEx","description":"The definitive platform to handle and montior all incoming firestation alerts.","archived":false,"fork":false,"pushed_at":"2024-08-14T19:45:02.000Z","size":345,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-13T03:45:38.628Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EncryptEx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2022-08-29T20:37:42.000Z","updated_at":"2024-08-14T19:45:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"96a815b5-5a9d-42da-aa6d-e1ee5b73542c","html_url":"https://github.com/EncryptEx/firestation-alerts","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EncryptEx%2Ffirestation-alerts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EncryptEx%2Ffirestation-alerts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EncryptEx%2Ffirestation-alerts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EncryptEx%2Ffirestation-alerts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EncryptEx","download_url":"https://codeload.github.com/EncryptEx/firestation-alerts/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241536850,"owners_count":19978413,"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":[],"created_at":"2024-11-13T17:06:08.833Z","updated_at":"2025-03-02T16:30:14.386Z","avatar_url":"https://github.com/EncryptEx.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"https://external-content.duckduckgo.com/iu/?u=https%3A%2F%2Fwww.pinclipart.com%2Fpicdir%2Fbig%2F234-2340249_fire-station-icon-clipart.png\u0026f=1\u0026nofb=1\" alt=\"Firestation\" height=\"60\"/\u003e\u003c/p\u003e\n\u003ch1 align=\"center\"\u003eFirestation Alerts\u003c/h1\u003e\n\u003cp align=\"center\"\u003eThe definitive platform to handle and montior all incoming firestation alerts.\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://img.shields.io/github/languages/code-size/EncryptEx/firestation-alerts\"/\u003e\n\u003cimg src=\"https://img.shields.io/github/languages/top/EncryptEx/firestation-alerts\"/\u003e\n\u003cimg src=\"https://img.shields.io/github/last-commit/EncryptEx/firestation-alerts\"/\u003e\n\u003c/p\u003e\n\nA platform part of a [Research Project](##Research%20Project) (TR of 2nd Batxillerat in Catalunya). The functionality is pretty simple to understand: When endpoint `/api/newNotification.php` is requested with correct credentials and passing the [necessary parameters](##Api%20Parameters), it will pop up an alert to all connected clients whithin the country affected. In case that the coordinates point to international waters, the alert will pop up in all clients with no restriction at all.\n\n---\n\n## Architecture\n\nThis project is using\n\n- PHP\n- MySQL (pdo conections)\n- Composer, to use:\n  - vlucas/**phpdotenv** (credentials management)\n  - phpmailer/**phpmailer** (SMTP email library)\n  - cboden/**ratchet** (WebSocket PHP library)\n- Bootstrap 5\n- Material Symbols and Icons\n- FREE APIs used:\n  - Maps API: [Open Street Map](https://wiki.openstreetmap.org/) and [Leaftlet](https://wiki.openstreetmap.org/wiki/Leaflet)\n  - Street info trough Geocoords, ([Geocode.maps.co](https://geocode.maps.co/))\n\n---\n\n## Demo\n\nThis is only a little part of the final practical part of the research project. For more information, I strongly recommend to check out the entire research paper: [PDF link](##Research%20Project)\n\n---\n\n## Installation\n\nThe installation process will be described in the PDF of the [Research Project](##Research%20Project)\n\n---\n\n## Research Project\n\nLink to Research Paper can be found [here](https://jaumelopez.dev/projects.php)\n\n---\n\n### Suggestions or questions\n\nIf you feel that something is wrong in this README file or you need help while setting up this project, feel free to contact or open a [GitHub Issue](https://github.com/EncryptEx/firestation-alerts/issues/new).\n\n---\n\n\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/EncryptEx/hammer/\"\u003e\u003cimg src=\"http://randojs.com/images/barsSmallTransparentBackground.gif\" alt=\"Animated footer bars\" width=\"100%\"/\u003e\u003c/a\u003e\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fencryptex%2Ffirestation-alerts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fencryptex%2Ffirestation-alerts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fencryptex%2Ffirestation-alerts/lists"}