Řízení servisních zakázek s auditovatelným workflow.
Projekt vychází z modelového provozního scénáře servisní firmy, ve kterém je potřeba dostat požadavky z e-mailů a tabulek do společného pracovního toku. Navrhl a implementoval jsem interní aplikaci pro dispečery, techniky, zákazníky a administrátory.
V živém demu lze ověřit pracovní přehled, role i navazující změny stavů.
Nejasná odpovědnost a chybějící přehled o stavu zakázky.
Projekt vychází z modelové servisní firmy, kde požadavky přicházejí e-mailem, telefonicky a z tabulek. Bez společného pracovního prostoru se odpovědnost rozpadá mezi jednotlivé pracovníky a předání závisí na osobní komunikaci.
Nejasná odpovědnost: není zřejmé, kdo má požadavek právě řešit.
Obtížné dohledání změn: důležitý kontext zůstává v komunikaci jednotlivců.
Chybějící jednotný stav: tým pracuje s různými představami o tom, co je hotové.
Slabé předávání práce: další role nemá spolehlivý podklad pro svůj krok.
02 / Výsledný pracovní tok
Od přijetí požadavku po uzavření zakázky.
Zakázku přebírá dispečer, který ji naplánuje a předá technikovi. Po provedení zásahu následuje kontrola a schválení zákazníkem; proces končí uzavřením zakázky.
01Přijetí požadavkunová zakázka
02Převzetí dispečeremodpovědnost
03Naplánovánítermín a technik
04Provedení technikemzáznam práce
05Kontroladispečer
06Schválení zákazníkemuzavření
03 / Klíčová technická rozhodnutí
Konzistence dat, řízení oprávnění a dohledatelnost změn.
Nejdůležitější částí je způsob, jakým systém drží konzistentní pracovní postup a chrání odpovědnosti jednotlivých rolí.
01
Stavový model jako doménové pravidlo
Zakázka se v provozu nemůže volně pohybovat mezi libovolnými kroky. Proto je průchod vyjádřený explicitními stavy a povolenými přechody, které odpovídají jednotlivým předáním práce.
Praktický důsledek: pracovní postup je čitelný a změny procesu lze udržovat na jednom místě.
02
Autorizace podle role a aktuálního stavu
Stejná zakázka nabízí v různých okamžicích jinou práci dispečerovi, technikovi a zákazníkovi. Oprávnění podle role a aktuálního stavu zakázky vyhodnocují Laravel Policies. API předává frontendu seznam povolených akcí, podle kterého rozhraní nabízí dostupné kroky. Při jejich provedení se oprávnění znovu ověřuje na straně API.
Praktický důsledek: uživatel dostává jen navazující kroky, které může skutečně provést.
03
Datový model a vazby mezi provozními údaji
Zakázka odkazuje na servisní lokalitu zákazníka a odpovědné pracovníky. Pracovní záznamy na ni navazují jako samostatná data, zatímco zákazníci a lokality jsou sdílené napříč zakázkami.
Praktický důsledek: každá zakázka má dohledatelný kontext a údaje o zákazníkovi a místě zásahu se nemusí evidovat znovu.
04
Záznam změn řízený backendem
Každou změnu zakázky řídí backendová služba a změna se zapisuje do samostatné auditní tabulky. Historie tak vzniká na straně backendu, nezávisle na tom, jak ji uživatelské rozhraní zobrazuje.
Praktický důsledek: průběh zakázky lze zpětně dohledat bez závislosti na e-mailech nebo osobní komunikaci.
04 / Podoba řešení
Pracovní rozhraní pro jednotlivé role.
Backend řídí životní cyklus zakázky a oprávnění jednotlivých rolí. Frontend poskytuje přehledné rozhraní pro každodenní práci dispečerů a techniků a zákazníkům přehled o aktuálním stavu jejich zakázek.
PRACOVNÍ PŘEHLEDJedno místo pro orientaci v zakázkách
Dashboard dává dispečerovi rychlý přehled o práci a stavech, takže další krok nevzniká hledáním v několika zdrojích.
DETAIL ZAKÁZKYKontext pro další krok
Detail soustředí stav, termín, přiřazení a údaje potřebné pro předání práce bez hledání v dalších zdrojích.
PRÁCE TECHNIKAZáznam provedeného zásahu
Technik zapisuje průběh práce přímo do zakázky, takže další role dostane konkrétní podklad pro kontrolu.
AUDITNÍ HISTORIEDohledatelné změny
Časová osa zachovává sled událostí a stavových změn, které jsou důležité pro kontrolu i předávání odpovědnosti.
ADMINISTRACEZákazníci a servisní lokality
Stabilní data jsou spravovaná odděleně, aby pracovní tok mohl odkazovat na konkrétní místo zásahu.
05 / Technologie a testování
Technologie jsou rozdělené podle odpovědnosti.
Pracovní rozhraníAngular
Role pracují se zakázkou v jednom pracovním rozhraní.
Doménová vrstvaLaravel API
Pravidla, autorizace a stavové přechody drží proces konzistentní.
Data a historieMySQL
Provozní data a auditní záznamy zůstávají dohledatelné.
Automatizované testování
Backend: Více než 100 testů v PHPUnit ověřuje přihlašování, oprávnění rolí a práci se zakázkami. Integrační scénáře procházejí celý životní cyklus zakázky od vytvoření po schválení zákazníkem a uzavření, včetně auditní stopy. Testy kontrolují také neplatné vstupy a zamítnutí neoprávněného přístupu.
Frontend: Vitest a Angular TestBed pokrývají přihlašování, přístup podle rolí, operace se zakázkami a práci s daty API. Součástí jsou i vybrané chybové a okrajové scénáře.
Nasazení dema: Laravel backend běží na Railway, Angular frontend na Netlify.
Technický detail: endpointy, datová schémata a operace pracovního toku popisuje OpenAPI dokumentace ↗.
06 / Výsledek a další rozvoj
Funkční MVP k vyzkoušení.
Současné MVP pokrývá základní průchod servisní zakázky od přijetí po uzavření a správu uživatelů, zákazníků a servisních lokalit. Navazující provozní funkce uvádím odděleně jako náměty pro další rozvoj, nikoli jako součást prezentovaného MVP.