Flipper / pinball
Dwie strony jednej maszyny: co wpada, a ile oddaje gra.
in / outObiekty, urządzenia, nominały żetonów, uzupełnienia gotówki oraz rozliczenia – jeden panel obsługujący cały obiekt, wraz z generowanymi na jego podstawie raportami miesięcznymi.
Odczytuje machine/info i machine/config, wysyła liczniki do machine/telemetry, mówi, że żyje, na machine/telemetry/heartbeat, i zgłasza własny zegar na machine/config/ping — pięć POST-ów, jego dwa uuidy w ciele żądania. Każda paczka liczników jest archiwizowana 1:1, więc każdą liczbę w każdym raporcie można odtworzyć z surowych zdarzeń.
Miesięczne zestawienie per maszyna i per nominał, z detalami dziennymi i surowymi zdarzeniami pod każdą liczbą — niczego nie trzeba porównywać z notatnikiem.
Na sali
Wszystko, co potrafi policzyć żeton i zadzwonić do serwera. Tym, czym maszyna
może być, jest słownik machine_types — globalny, z nadpisaniem per
firma — więc nowa rodzina to wiersz dodany przez roota, nie nowe wydanie.
Dwie strony jednej maszyny: co wpada, a ile oddaje gra.
in / outWrzutnik monet, kredyt i sesje, które sprzedaje karta.
creditPoziom zasobnika i wypłata, która go opróżnia.
hopperPróby, wygrane i nagrody stojące za nimi.
attemptsNominał, który drukuje, i to, ile już wydrukował.
denominationWszystko, co potrafi policzyć żeton i zadzwonić do serwera.
any counterZa ladą
Żadnego modułu dokupianego później, żadnego panelu do składania. Firma loguje się i zastaje swoje własne lokalizacje, maszyny i pieniądze — i nic więcej.
Zobacz to opisane na całej stronieKanał maszyn
Cała część umowy przypadająca firmware'owi — pięć POSTów, para uuidów
w ciele każdego. Liczniki i obecność wędrują tymi samymi tematami po MQTT dla
urządzenia, które woli subskrybować.
POST /api/v1/machine/info
Własny wiersz maszyny, tak jak ustawił go operator: gdzie stoi, jak się nazywa i jakim jest typem maszyny.
POST /api/v1/machine/config
Co ta maszyna powinna oferować: jej nominały i flagi, którymi się rządzi. Maszyna, która nie może się z nami skontaktować, zachowuje ostatnią odpowiedź.
POST /api/v1/machine/telemetry
Paczka zdarzeń licznika — zużyte, naliczone, wydane — wysyłana jako całość, więc odrzucona paczka to po prostu paczka do poprawki i wysłania ponownie. Archiwizowana 1:1, by raport dało się odtworzyć.
POST /api/v1/machine/telemetry/heartbeat
Obecność, tania i mała. To ona robi maszynę zieloną lub szarą na ekranie operatora.
POST /api/v1/machine/config/ping
Własny zegar maszyny, trzymany obok chwili, w której dotarł do nas. Dwa czasy w jednym wierszu to to, co pokazuje rozjechany zegar urządzenia — zanim jego liczniki trafią na zły dzień.
Plan
Zestaw wywołań najemcy to jedna lista, publikowana przez samo API — oto ona, w trzech grupach. Agent per maszyna, opłata per zdarzenie i read, którego nie widać: nic z tych rzeczy.
To, co najemca odczytuje jako swoje:
Dwa zapisy, które ma najemca (D3):
To, co zamyka okres:
Lista jest czytana na żywo z własnego zestawu wywołań najemcy w API
(client/plans);
nazwy i ceny planów przyjdą wraz z fazą abonamentu (M7), więc tu ich nie widać.
Jedno logowanie, jeden obiekt, jedna maszyna — to wystarczy, by zobaczyć, jak wychodzi z niej miesięczny raport. Reszta sali może przyjść w przyszłym tygodniu.