Dokumentace

Jak Elin funguje

Elin je deterministický plánovač servisního týmu Parking Pro. Každý běh projde stejnou pipeline: načte zdrojové Excely, sestaví horizont, aplikuje pravidla klienta a výsledek pustí přes gate. Do koordinačního plánu se zapisuje jen to, co gate schválí.

4 zdrojové Excelykoordinační plán, instalace,profylaxe, záruční dobyParserzaměstnanci, dny, backlog,rozpoznání lokalitBacklog a lhůtyfirst-seen, deadline (+X d),half-deadlineHorizont 28 dnídny, trasy, absence,pohotovostiPlánovací pravidlacykly, kancelářské zápisy,vkládání backlogu,limity a zajížďkyNávrhy přesunůjen když lhůta nejde splnit,nikdy se neprovádí samy,schvaluje člověkGateobjektivní kontrola všechtvrdých pravidel,jediný arbitr správnostiZápis do Excelunové zápisy žlutě, návrhyoranžově, lidské buňkyse nikdy nepřepisujíAI vrstva (jen poradní)čte nerozpoznané volné texty a radí u neřešitelných konfliktů, nikdy nerozhoduje

Průběh jednoho běhu

Načtení zdrojových Excelů
Čtyři soubory: koordinační plán práce (zápisník i výstup), harmonogram instalací, plán profylaxe a záruční doby. Koordinační plán je jediný soubor, do kterého se zapisuje.
Parser a rozpoznání lokalit
Z listů se přečtou zaměstnanci, dny, existující zápisy a sloupec plánovaných montáží (backlog). U každého zápisu se deterministicky rozpozná lokalita včetně překlepů a zkratek. Co se rozpoznat nepodaří, skončí v sekci nerozpoznaných zápisů a neplánuje se.
Backlog a lhůty
Zápis typu (+10 d) dostane lhůtu počítanou od prvního spatření zápisu, ne od dneška. Zápis, který ze sloupce zmizel, se považuje za hotový. Půlka lhůty (half-deadline) přepíná úkol do režimu, kdy dostane nejbližší volný den.
Horizont 28 dní
Z koordinačního plánu se sestaví mapa dnů na 4 týdny dopředu: kdo kde je, jaké má trasy, absence, školu a pohotovostní dny. Všechna další rozhodnutí se dělají nad tímto horizontem.
Cykly a kancelář
Rozhodne se o pravidelných návštěvách Ivančic a Frýdku-Místku (8týdenní cyklus) a rozdělí se kancelářské zápisy z harmonogramu instalací mezi Tomáše Hejla, Annu Hurt a Jiřího Koktana sr., maximálně 3 zápisy na den.
Vkládání backlogu
Krok 1: úkol se zkusí přidat k existující trase, pokud zajížďka nepřesáhne 50 km, den se neprodlouží o víc než hodinu a drží se denní limity. Krok 2: po půlce lhůty dostane úkol nejbližší volný pracovní den technika. Časy počítá Mapy.cz routing s koeficientem 1,2 a paušálem 30 minut na automat.
Návrhy přesunů
Když lhůtu nejde splnit ani krokem 1 ani krokem 2, Elin navrhne přesun existujícího úkolu s volnější lhůtou na jiný den. Návrh se nikdy neprovede sám: v Excelu má vlastní barvu, v přehledu vlastní sekci a čeká na schválení člověkem.
Gate
Nezávislá kontrola celého výsledku: denní limity, pohotovosti, kancelářské limity, cyklická okna, konzistence rozdělených cest. Gate je jediný arbitr. Když neprojde, výsledek se nezapisuje.
Zápis do koordinačního plánu
Nové zápisy se zapisují žlutě, návrhy přesunů oranžově s poznámkou. Buňky s lidským obsahem se nikdy nepřepisují.

Co je deterministické a co dělá AI

Deterministické jádro rozhoduje
  • Komu, kdy a kam se úkol naplánuje
  • Výpočty tras, časů a denních limitů
  • Lhůty, cykly, kancelářské zápisy, rozdělení cest
  • Gate kontrola a zápis do Excelu
  • Stejný vstup dá vždy stejný výsledek
AI vrstva jen čte a radí
  • Vytěžuje volné texty, které parser nerozpoznal
  • Vysvětluje návrhy lidsky čitelným jazykem
  • U neřešitelného konfliktu navrhne, co obětovat, rozhodnutí zůstává na jednateli
  • Nikdy nezapisuje do plánu a nikdy nepřebíjí pravidla