Hier findet sich die technische Dokumentation der Icebox. Nutzungshinweise hier rausziehen und verlinken

Das Icebox ist ein Lösung für Hackspaces um die Getränkeverwalutng und den Verkauf zu vereinfachen. Das System ist als Microservice Architektur aufgebaut und setzt auf state-of-the-art Technologien wie Docker, nodejs und traefik.

Alle Teilsysteme des Produktes „Icebox Getränkesystems für Hackspaces“ können hier Bestellt werden: git.chaotikum.org/icebox.

Es gibt folgende Services:

1. icebox-service: Das backend
2. icebox-web: Web Frontend zum kaufen und inventarisieren
3. icebox-vuetified: Touch Frontend
4. icebox-image-service: Service für Getränkebilder
5. prometheus-icebox-exporter: statistiken für prometheus

Das alles wird von traefik zusammengehalten. Das zugehörige docker-compose file findet sich hier.

Für jeden service wird über gitlab-ci ein docker-image gebaut, das dann auf die gitlab eigene docker-registry gepusht wird. In dem docker-compose sind dann nur noch die urls zu den jeweiligen images.

Wenn das mal down ist, muss man es per

 docker-compose up -d
 

rebooten. Dafür muss man auf moby und dann in den icebox Ordner. Das geht von außen z.B. über willi (LDAP) zu Moby und dort in den Ordner.

Alle urls und domains sind in der docker-compose über labels festgelegt und traefik kümmert sich dann automagisch. → docker-compose.yml

Das Backend ist unter api.icebox.nobreakspace.org zu erreichen.

icebox.nobreakspace.org

vue.icebox.nobreakspace.org

images.icebox.nobreakspace.org

Ein Admininterface für die Datenbank ist unter http://icebox.nobreakspace.org/pgadmin4 erreichbar.

NoScript unter Firefox

Tut nicht. Auch wenn man alles erlaubt. Das ist doof, aber Fakt. Wir sagen, das ist die Schuld des Plugins.

• Webclient unter icebox.nobreakspace.org
• Touch-client auf dem Pi am Kühlschrank (Github) [Dies ist nicht mehr die genutzte Software, die genutzte Software hat aber wohl noch kein git, husqar fragen)
• Android https://github.com/malteschmitz/icebox-android

• Die Icebox twittert unter NbspIcebox (Code auf Github)
• Es gibt einen Monitoringdienst, der den Bestand aufzeichnen lässt
• Alias https://github.com/MotieDesign101/iceBoxAlias
• Liste der Einkaufspreise https://github.com/MotieDesign101/iceboxprices

• http://docs.iceboxservice.apiary.io/

Nachdem der Getränkelieferant da war ist es sinnvoll eine Inventur durchzuführen, dabei sollte sowohl die Anzahl der vorhandenen Getränke um die eingekaufte Menge erhöht werden (einfach die ausgegraute Zahl + die Neueinkäufe) als auch bei allen Getränken die Leergutmenge auf 0 gesetzt werden.

Inventur ist unter icebox.nobreakspace.org möglich, einfch den in Menü befindlichen Link „Inventur“ nutzen. Dort das Getränk auswählen und die korrekte Information angeben. Felder die nicht verändert werden sollen einfach so belassen wie sie sind.

Neue Getränke können in der selben Maske unten angegeben werden. Es ist aktuell nicht ohne weiteres Möglich ein Bild für ein neues Getränk hinzuzufügen. Als Baarcode sollte der auf der Flasche abgedruckte Baarcode genutzt werden sofern vorhanden. Um neue Schilder zu drucken befindet sich weiter unten ein Link zur entsprechenden tex-Datei.

Getränke und User können sich Aliase anlegen. Dies geschieht unter icebox.nobreakspace.org:8085/alias

per POST mit

 {
  "input": "123456789",
  "alias": "tvluke"
 }

Kann man einen registrieren. Wenn man nun GET auf icebox.nobreakspace.org:8085/alias/123456789 macht so erhällt man

 {
  "input": "123456789",
  "alias": "tvluke"
  }
  

zurück. Der Touch-Client am PI nutzt den ALIAS Service, wenn er einen Input bekommt, den er so nicht kennt. Dies kann genutzt werden, wenn sich der Barcode eines Getränks ändert. Registriert man z.B.

 {
  "input": "neuer Barcode",
  "alias": "alter Barcode"
 }

So sollte ab jetzt auch der neue Barcode funktionieren, weil er auf den alten gemappt wird.

Genauso kann die UID eines RFID-Chips auf einen username gemappt werden, damit ein User einen NFC-Chip zur Id am System nutzen kann.

Einkaufspreise:

http://icebox.nobreakspace.org:8086/prices

Nährwerte:

http://icebox.nobreakspace.org:8087/ingred

• Anbindung von https://coffeestats.org/
• Statistiken
  • Verbrauchsprojektion
  • Coole Rankings oder Stats als Website
• Aktiva/Passiva Rechnung für Kassenwart
• Licht Im Kühlschrank
  • Erhöhte Komplexität: UDP Multicast bei Getränkeauswahl am Touch-Client, Licht-Client kennt Getränkeposition im Kühlschrank.
• Case für den Touch-Client am Kühlschrank
• Mobile-App (Bonjour kann man z.B. nutzen, um automatisch beim verbinden mit WLAN die Icebox zu finden)
• Vorschlagsmodus (personalisiert oder über den Space)
• Koffeein- oder Zuckersummierung für User (Un-Health-Monitoring/bestenliste)
• Twitter-Client besser machen
  • Einkaufen via Twitter
  • @NbspIcebox könnte sich mit @DasBein unterhalten oder so
• Monatlicher IceBox Bericht
  • Wie viele Getränke wurden gekauft
  • Wie viele User sind registriert
  • Wie viele User waren im letzten Monat aktiv
  • Wie viel Guthaben liegt auf den Accounts
  • Welche User verlieren im nächsten Monat wegen „ein Jahr inaktiv“ ihr Geld
  • Welche Getränke waren populär, welche nicht
  • Uhrzeitverteilung des Kaufens
  • …