Jednoduchá webová aplikácia informačného systému pre mestskú dopravu (manažment a vyhladávanie spojov).
Filip Roman - xroman16@stud.fit.vutbr.cz - vedúci, backend, výpomoc s frontendom, dokumentácia
Nikolas Nosál - xnosal01@stud.fit.vutbr.cz - frontend, dizajn aplikácie, výpomoc s backendom, testovanie
Samuel Zima - xzimas01@stud.fit.vutbr.cz - backend, výpomoc s frontendom, video dokumentácia, nasadenie aplikácie
Systém je testovaný pre PHP 8.1, Laravel Framework 10, Livewire 3 a MySQL 8.
- Inštálácia Laravelu .
composer global require "laravel/installer"
- Pridaj Laravel medzi premenné prostredia aby sme k nemu malí prístup globálne.
- Inštalácia chýbajúcih balíčkov.
composer install && composer update
- Inštálácia knižnice Livewire.
composer require livewire/livewire
- Spustenie aplikácie.
php artisan serve
Ako server sme použili hosting portal InfinityrFree. Tu je postup inštalácie:
- Skopíruj priečinok IS_app/public do priečinku htdocs/ na server infinityfree.
- Skopíruj všetky súbory a priečinky z lokálneho priečinku IS_app okrem priečinku public do priečinku htdocs/IS_app na server infinityfree.
- Na infinityfree zmeň v súbore htdocs/index.php '..' cestu k pričinku IS_ap' vo funkciách skriptu.
- Ak existuje tak odstráň súbor config.php v priečinku htdocs/IS_app/bootsrap/cache/.
- Zmeň nastavenia databázi v súbore .env podľa databázi infinityfree.
- Vytvorenie tabuliek databázy + naplnenie tabuliek prvotnými dátami
php artisan migrate
- Zaplnenie databázy základnými dátami
php artisan db:seed
- Vytvorenie celého SQL súboru z migrácii
mysqldump -u username -p database_name output_file_name.sqltento vygenerovaný súbor sa premiestni do databázy na infinityfree
Existující zástupcovia všetkých rolí uživateľov.
| Login | Heslo | Role |
|---|---|---|
| root@dpmb.cz | root | Administrátor |
| jan.novak@gmail.com | novak | Správca |
| jozef.dobry@gmail.com | dobry | Technik |
| anna.neumannova@gmail.com | neumannova | Dispečer |
| frantisek.novotny@gmail.com | novotny | Vodič |
Informačný systém sme implementovali pomocou frameworku Laravel 10 s knižnicou Livewire ktorá nám pomohla s tvorbou interaktívnej pomocou komponentov.
Ako databázový systém sme použili MySQL 8. Jednotlivé stránky sa skladajú z rôznych komponentov ktoré pomocou controllerov komunikujú s databázou, príjmajú uživateľský vstup, spracúvavajú ho a akualizujú modely.
Na pridávanie uživateľou používame komponentu ManageUsersAdd kde môžeme vytvoriť uživateľa a priradiť mu príslušnú rolu. Zoznam všetkých uživateľoch zobrazíme pomocou ManagaeUsersList kde následne administrátor môžeme upravovať profily a taktiež ich vymazať.
Vymazať môžeme všetkých registrovaných uživateľov okrem administrátora a to len vtedy keď vymazaný uživateľ už nemá pridelené žiadne povinnosti, napr. údržbu vozidla, naplánovaný spoj a pod.. Heslá v zozname zašifrujeme kvôli bezpečnosti pomocou funkcie bcrypt().
Všetci uživatelia majú možnosť vyhľadávať spoje. Zoznam všetkých liniek a zastávok cez ktoré spoje prechádzajú si vieme zobraziť pomocou HomeAddSearch na následne pomocou komponentu HomeAddSearch vyhľadať spoj ktorý prechádza cez uživateľom zvolenu zastávku v daný dátum a čas.
Po úspešnom vyhľadaní zastávky v plánovaných spojoch, sa nám zobrazí pomocou SearchListDepartures všetky aktívne spoje ktoré prechádzajú danou zastávkou v daný čas, taktiež si môžeme pozrieť zoznam nasledujúcih zastávok a čas odchodu zo zastávky. Taktiež môžeme znovu vyhľadať nový spoj pomocou SearchAddSearch.
| Užívateľ - Domovská stránka | Užívateľ - Vyhladávanie | Administrátor - Správa užívateľov |
|---|---|---|
 |
 |
 |
Informačný systém umožnuje správcovi spravovať spoje, to znamená že náš systém hormadnej dopravy sa skladá z liniek, zástávok a trás. Pomocou ManageLinksAddStop dokáže správca vytvárať zástavky, a následen prechádzať a upravovať existujúce zastávky pomocou ManageLinksListOfStops.
Taktiež dokáže vytvárať ManageLinksAddLine nové linky a upravovať existujúce v ManageLinksLinesList. Pri odstránení určtej linky musí správca najpr vymazať alebo presmerovať trasy ktoré pôsobia na danej linke. Následne vytvorí trasu v ManageLinksAddRoute do kotrej priradí list zastávok cez ktoré prechádza a trasa sa priradí linke na ktorej bude premávať a tiež dokáže pomocou ManageLinksListRoutes upravať existujúcu trasu a upravovať a pridávať nové zástavky.
Spoje sa v našom systéme vytvára správca. Spoj sa vytvára v ScheduleRouteAdd kde zadáme informácie o spoji ako trasa na ktorej bude premávať, čas, dátum od kedy do kedy bude tento spoj aktívny a taktiež či tento spoj bude premávať každý deň alebo iba výnimočno. Po vytvorení plánovaného spojo si môžeme pozrieť históriu naplánovaných spojov ScheduleRouteListHistory a tiež spravovať už naplánované spoje, to je upraviť a vymazať ich.
O správu vozidiel sa stará ManageVehiclesAdd kde môže správca pridávať nové vozidlá do systému, prezerať ich v ManageVehiclesList a taktiež ich spravovať.
Vozidlám správca plánuje ich údržbu v OrganizeMaintenanceAdd a priradí údržbu technikovi, ktorý následne vytvorí záznam o údržbre pomocou RecordMaintenanceList. Ďalej vieme prezerať a upraviť list aktívnych údrž OrganizeMaintenanceListActive, jej históriu OrganizeMaintenanceListActiveHistory a taktiež spravovať náhlásené závady v OrganizeMaintenanceListRequest.
| Správca - Správa liniek a spojov | Správca - Plánovanie spojov | Správca - Správa vozidiel | Správca - Plán údržby vozidiel |
|---|---|---|---|
 |
 |
 |
 |
O hlásenie závad sa stara vodič, ktorý hlási všetky závadi ReportIssueAdd ktoré si vie následen správca pozrieť v OrganizeMaintenanceListRequest a priradiť novu údržbu pre poškodené vozidlo.
Vodiči si dokážu pozrieť svoj plán služby v AssignedPlan ktorý mu vytvoril dispečer, vie si tam vyhľadať kedy mu je priradený spoj a taktiež aké vozidlo je mu pre daný spoj priradené.
| Vodič - Priradený plán | Vodič - Nahlásiť závadu vozidla | Technik - Záznam údržieb | Dispečer - Správa dispečinku |
|---|---|---|---|
 |
 |
 |
 |
Grafická schéma relačnej databázi:
