Benutzer-Werkzeuge

Webseiten-Werkzeuge


infrastruktur:container:icebox

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

Link zu der Vergleichsansicht

Beide Seiten, vorherige ÜberarbeitungVorherige Überarbeitung
Nächste Überarbeitung
Vorherige Überarbeitung
infrastruktur:container:icebox [05.01.2021 13:01] Lukas Rugeinfrastruktur:container:icebox [22.04.2022 20:16] (aktuell) Lukas Ruge
Zeile 1: Zeile 1:
 ===== IceBox ===== ===== IceBox =====
  
-|Verantwortung  |TVLuke                         +| Verantwortung  | TVLuke                              
-|Container      |icbox?                         +| Container      | icbox?                              
-|W. Ports       |keine                          +| W. Ports       | keine                               
-|OS             |?                              +| OS             docker mischmasch                   
-|Server         |[[infrastruktur:server:case]]    +| Server         | [[infrastruktur:server:case]] moby  
-|Zustand        |Produktiv                      |+| Zustand        | Produktiv                           |
  
-{{tag>infrasystem container case moby}}+{{tag>infrasystem container case moby productive}}
  
-Hier findet sich die technische Dokumentation der Icebox. **Nutzerdoku hier rausziehen und verlinken**+Hier findet sich die technische Dokumentation der Icebox. **Nutzungshinweise hier rausziehen und verlinken**
  
 ===== Services ===== ===== Services =====
Zeile 16: Zeile 16:
 |Icebox| ? | |Icebox| ? |
  
-====Icebox====+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.
  
-Die IceBox ist die digitale Strichliste des Kühlschranks. Man kann darüber auch Essen in der [[ :hackerspace:infrastruktur:snackbar|Snack Bar]] kaufen. 
  
-Die Icebox findet sich (solange man im nbsp-Netzwerk ist) unter  [[http://icebox.nobreakspace.org/|icebox.nobreakspace.org]] die API des Dienstes unter icebox.nobreakspace.org:8081+Alle Teilsysteme des Produktes "Icebox Getränkesystems für Hackspaces" können hier Bestellt werden: [[https://git.chaotikum.org/icebox|git.chaotikum.org/icebox]].
  
-Ein Admininterface für die Datenbank ist unter http://icebox.nobreakspace.org/pgadmin4 erreichbar.+==== Stack ====
  
-==== F.A.Q. ==== +Es gibt folgende Services:
-**Warum das alles?**+
  
-Das System erlaubt es dem Getränkeverantwortlichen zu sehen wann es notwendig ist, eine neue Bestellung aufzugeben und welche Getränke bestellt werden sollten. Es erlaubt dem Kassenwart des Vereins festzustellen welche Aktiva/Passiva wir in Form von Getränken oder Prepaid-Guthaben vorliegen (Dies ist für eine ordnungsgemäße Finanzbuchhaltung relevant). +  - **icebox-service**: Das backend 
 +  - **icebox-web: Web** Frontend zum kaufen und inventarisieren 
 +  - **icebox-vuetified**: Touch Frontend 
 +  - **icebox-image-service**: Service für Getränkebilder 
 +  - **prometheus-icebox-exporter**: statistiken für prometheus
  
-Zudem erlaubt das System (lustige) Experimente mit Ein- und Ausgabetechniken und Informationsverarbeitung und hilft damit die Umsetzung der Aufgabe des Vereins voranzutreiben. Durch die Abschaffung von Papierlisten für Prepaid-Guthaben schonen wir die Umwelt und sparen Zeit. 
  
-**Muss ich einen Account haben?**+Das alles wird von [[https://traefik.io/|traefik]] zusammengehalten. Das zugehörige docker-compose file findet sich [[https://git.chaotikum.org/chaotikum/infra/icebox-dockerized|hier]].
  
-Nein, du kannst das Getränk Anonym kaufen, dann kostet es dich 1.5 € anstelle von 1.25 €. //Warum: Dies ist ein Vereinsbeschluss und hat mit dem System nichts zu tun, es setzt diese Vorgabe lediglich um.// 
  
-**Ich habe das falsche Getränk/auf den falschen Account gekauft?**+=== Deploy ===
  
-Auf dem Touch-Client gibt es 10 Sekunden //Undo// danach hilft nur miteinander reden, wenn du fälschlicherweise einen Fremd-Account belastet hast. Wenn du das falsche Getränk gekauft hast ist das halb so wild, ab und zu wird Inventur (mehr zur Inventur unten) gemacht, das geht auf [[http://icebox.nobreakspace.org/|icebox.nobreakspace.org]], du kannst es auch gerne jederzeit machen.+Für jeden service wird über gitlab-ci ein docker-image gebaut, das dann auf die gitlab eigene docker-registry gepusht wirdIn dem docker-compose sind dann nur noch die urls zu den jeweiligen images
  
-**Bleibt mein Guthaben für immer?** 
  
-Nein, Guthaben //können// nach einem Jahr verfallen, wenn sie nicht genutzt wurden. //Warum: Dies ist ein Vereinsbeschluss und hat mit dem System nichts zu tun, es setzt diese Vorgabe lediglich um.//+=== Reboot ===
  
-**Kann ich digital bezahlen (ÜberweisungPaypall...)?**+Wenn das mal down istmuss man es per
  
-Nein, Icebox basiert auf VertrauenDu sagst, was du bezahlt hast, Icebox glaubt dir//WarumDies ist ein Vereinsbeschluss und hat mit dem System nichts zu tun, es setzt diese Vorgabe lediglich um.//+   docker-compose up -d 
 +    
 +rebooten. Dafür muss man auf moby und dann in den icebox OrdnerDas geht von außen z.B. über willi (LDAP) zu [[:infrastruktur:host:moby|Moby]] und dort in den Ordner.
  
-**Mein Name taucht auf dem Touchscreen nicht auf obwohl ich mich registriert habe?**+=== Services ===
  
-Kann es sein, dass du kein Guthaben hast? Dann wird dein Name unter den Namen von Nutzern mit Guthaben angezeigtWenn du auf deinen Namen drückst bekommst du die Gelegenheit deinen Account mit Guthaben zu versorgen.+Alle urls und domains sind in der docker-compose über labels festgelegt und traefik kümmert sich dann automagisch-> [[https://git.chaotikum.org/chaotikum/infra/icebox-dockerized/-/blob/master/docker-compose.yml|docker-compose.yml]]
  
-**Ein Getränk taucht im System auf aber nicht im Kühlschrank. Was tun?** 
  
-Wenn du Glück hast ist das Getränk nur nicht im Kühlschrank aber im Lager (das ist rechts neben dem Kühlschrank), nehme es dir gerne von dort. Wenn da auch keines ist, hat wohl jemand mal einen Fehler beim Verbuchen gemacht und das Getränk ist in Wirklichkeit nicht mehr da, das kann schon mal vorkommen. Du kannst den Fehler unter [[http://icebox.nobreakspace.org/|icebox.nobreakspace.org]] im Menü unter "Inventur" (mehr zur Inventur unten)  korrigieren, indem du den Bestand für das Getränk auf "0" setzt, danke.+== Backend und API ==
  
-**Der Barcode an der Flasche funktioniert beim Scannen nicht.**+Das Backend ist unter [[http://api.icebox.nobreakspace.org|api.icebox.nobreakspace.org]] zu erreichen.
  
-Bei einigen Getränken ist der Barcode auf der Flasche nicht (mehr) der selbe wie im System. Die Barcodes am Kühlschrank (gelbe Schilder) funktionieren, der Touchscreen auch. Ob und wann Barcodes angepasst werden hängt von denen ab, die es verbessern, das kannst auch du sein. Ein neues Getränk mit korrektem Barcode kann jeder unter [[http://icebox.nobreakspace.org/|icebox.nobreakspace.org]] im Bereich "Inventur" (mehr zur Inventur unten)  erstellen, wie ein **neues gelbes Schild** gedruckt werden kann ist unten auf dieser Seite beschrieben. 
  
-**Mein Guthaben ist Falsch, wie kann ich es korrigieren?**+== Web ==
  
-Du kannst dein Guthaben mit einem PUT-Request korrigieren. Wie das geht ist in der API-Doku ([[http://icebox.nobreakspace.org/|icebox.nobreakspace.org]]) im Detail beschrieben. Je nach Client-Implementierung kann dies auch darüber möglich sein, dies fällt nicht in den Scope des Serverdienstes.+[[http://icebox.nobreakspace.org|icebox.nobreakspace.org]]
  
-**Wo kann ich ein Problem melden?**+== Icebox-vuetified ==
  
-Für alles, auch Probleme die nicht zwangsläufig etwas mit Code zu tun haben bitte das git in unserem gitlab nutzenMails oder "im Space bescheid sagen" gehen leider doch recht schnell unter+[[http://vue.icebox.nobreakspace.org|vue.icebox.nobreakspace.org]] 
-==== Known Issues ====+ 
 + 
 +== Image service == 
 + 
 +[[http://images.icebox.nobreakspace.org|images.icebox.nobreakspace.org]] 
 + 
 + 
 + 
 +====Icebox==== 
 + 
 + 
 +<del>Ein Admininterface für die Datenbank ist unter http://icebox.nobreakspace.org/pgadmin4 erreichbar.</del> 
 + 
 +=== Known Issues ===
 **NoScript unter Firefox** **NoScript unter Firefox**
  
 Tut nicht. Auch wenn man alles erlaubt. Das ist doof, aber Fakt. Wir sagen, das ist die Schuld des Plugins. Tut nicht. Auch wenn man alles erlaubt. Das ist doof, aber Fakt. Wir sagen, das ist die Schuld des Plugins.
-==== Software ==== +=== Software === 
-=== Clients ===+== Clients ==
    * Webclient unter [[http://icebox.nobreakspace.org/|icebox.nobreakspace.org]]    * Webclient unter [[http://icebox.nobreakspace.org/|icebox.nobreakspace.org]]
    * Touch-client auf dem Pi am Kühlschrank ([[https://github.com/MotieDesign101/IceBoxTouch|Github]]) [Dies ist nicht mehr die genutzte Software, die genutzte Software hat aber wohl noch kein git, husqar fragen)    * Touch-client auf dem Pi am Kühlschrank ([[https://github.com/MotieDesign101/IceBoxTouch|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]]    * Android [[https://github.com/malteschmitz/icebox-android]]
-=== Dienste ===+== Dienste ==
    * Die Icebox twittert unter [[https://twitter.com/NbspIcebox|NbspIcebox]] ([[https://github.com/MotieDesign101/IceBox-Twitter|Code auf Github]])    * Die Icebox twittert unter [[https://twitter.com/NbspIcebox|NbspIcebox]] ([[https://github.com/MotieDesign101/IceBox-Twitter|Code auf Github]])
    * Es gibt einen Monitoringdienst, der den Bestand aufzeichnen lässt    * Es gibt einen Monitoringdienst, der den Bestand aufzeichnen lässt
    * Alias https://github.com/MotieDesign101/iceBoxAlias    * Alias https://github.com/MotieDesign101/iceBoxAlias
    * Liste der Einkaufspreise https://github.com/MotieDesign101/iceboxprices    * Liste der Einkaufspreise https://github.com/MotieDesign101/iceboxprices
-==== API-Doku ====+== API-Doku ==
    * http://docs.iceboxservice.apiary.io/    * http://docs.iceboxservice.apiary.io/
-==== Inventur ====+== Inventur ==
 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. 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.
  
Zeile 88: Zeile 100:
  
 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. 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.
-==== Alias anlegen ====+== Alias anlegen ==
 Getränke und User können sich Aliase anlegen. Dies geschieht unter icebox.nobreakspace.org:8085/alias Getränke und User können sich Aliase anlegen. Dies geschieht unter icebox.nobreakspace.org:8085/alias
  
Zeile 122: Zeile 134:
  
 http://icebox.nobreakspace.org:8087/ingred http://icebox.nobreakspace.org:8087/ingred
-==== Offene Ideen ====+== Offene Ideen ==
    * Anbindung von https://coffeestats.org/     * Anbindung von https://coffeestats.org/ 
    * Statistiken    * Statistiken
Zeile 147: Zeile 159:
       * ...           * ...    
  
-==== Hardware ==== +===== Wartung ===== 
-   * [[hackerspace:basteln:barcodescanner|Barcode Scanner]] +In das Textfeld einfach das Datum der Wartung eintragenam besten in der Form yyyy-mm-dd
-   * PI 2 +
-   * [[https://www.amazon.de/Official-Raspberry-Pi-Touchscreen-Display/dp/B0153406SS/ref=sr_1_2?ie=UTF8&qid=1466570148&sr=8-2&keywords=pi+touch|Pi Touch Monitor]] +
-   * NFC-Reader: [[https://www.amazon.de/Multi-ISO-Leser-Keyboard-Emulation-ISO14443-ISO15693/dp/B00K5S7F3W/ref=sr_1_1?ie=UTF8&qid=1470059905&sr=8-1&keywords=amid+rfid+multi+iso+leser|AMID RFID Multi-Iso Leser mit Tastatur Emulation]] +
- +
-==== Präsentation ==== +
-   * {{ :projekte:icebox:präsentation.pdf }} +
- +
-==== The Future CharlieThe Future ==== +
-   * Backend wird neu geschrieben +
-   * http://www.chalk-elec.com/?page_id=1280#!/10-universal-LCD-with-HDMI-interface-and-capacitive-multi-touch/p/42545413/category=3094861 +
-   * Mockup weil Design und so http://www.rbergmann.info/icebox/+
  
-==== Kühlschrankschilder ==== +{{NEWPAGE>infrastruktur:wartung:icebox#pagetemplates:wartungstemplate:icebox|icebox 
-Die Barcodes werden auf http://www.abarcode.net/online.aspx ertsellt. Size 20, Zoom 200%, FormatTransparent PNG. Danach das Schildformat aus dem [[https://github.com/Chaotikum/chaotikumSchilder|Github]].+}} 
  
-Schilder, die aktuell nicht im Einsatz sind, finden sich auf dem Kühlschrank beim Touchscreen.+{{topic>:infrastruktur:wartung?wartungsfenster +icebox &nodate&nouser&desc&table}}
  
-====Changlog==== 
-   * 2017-13-05: Delete jetzt auch ohne body, stattdessen einfach consumptions/:id/:barcode/:username mit delete und fertig. 
  
infrastruktur/container/icebox.1609851660.txt.gz · Zuletzt geändert: 05.01.2021 13:01 von Lukas Ruge