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 12:58] – ↷ Seite von infrastruktur:service:icebox nach infrastruktur:container:icebox verschoben Lukas Rugeinfrastruktur:container:icebox [22.04.2022 20:16] (aktuell) Lukas Ruge
Zeile 1: Zeile 1:
 ===== IceBox ===== ===== IceBox =====
  
-  * VerantwortungTVLuke +Verantwortung  TVLuke                              | 
-  * Umgebung: Docker-Container auf [[infrastruktur:server:case|case]] +Container      | icbox?                              | 
-  * Laufende version:  +| W. Ports       | keine                               | 
-  * OS:  +| OS             | docker mischmasch                   | 
-  * Zustand: Läuft+| Server         [[infrastruktur:server:case]] moby  | 
 +Zustand        | Produktiv                           |
  
-Die IceBox ist die digitale Strichliste des Kühlschranks. Man kann darüber auch Essen in der [[ :hackerspace:infrastruktur:snackbar|Snack Bar]] kaufen.+{{tag>infrasystem container case moby productive}}
  
-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+Hier findet sich die technische Dokumentation der Icebox**Nutzungshinweise hier rausziehen und verlinken**
  
-Ein Admininterface für die Datenbank ist unter http://icebox.nobreakspace.org/pgadmin4 erreichbar.+===== Services ===== 
 +^ Serviceübersicht^Version^ 
 +|Icebox| ? |
  
-==== F.A.Q. ==== +Das Icebox ist ein Lösung für Hackspaces um die Getränkeverwalutng und den Verkauf zu vereinfachenDas System ist als Microservice Architektur aufgebaut und setzt auf state-of-the-art Technologien wie Docker, nodejs und traefik.
-**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).  
  
-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.+Alle Teilsysteme des Produktes "Icebox Getränkesystems für Hackspaces" können hier Bestellt werden: [[https://git.chaotikum.org/icebox|git.chaotikum.org/icebox]].
  
-**Muss ich einen Account haben?**+==== Stack ====
  
-Nein, du kannst das Getränk Anonym kaufen, dann kostet es dich 1.5 € anstelle von 1.25 €. //WarumDies ist ein Vereinsbeschluss und hat mit dem System nichts zu tun, es setzt diese Vorgabe lediglich um.//+Es gibt folgende Services:
  
-**Ich habe das falsche Getränk/auf den falschen Account gekauft?**+  - **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
  
-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. 
  
-**Bleibt mein Guthaben für immer?**+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, 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.// 
  
-**Kann ich digital bezahlen (Überweisung, Paypall...)?**+=== Deploy ===
  
-NeinIcebox basiert auf VertrauenDu sagst, was du bezahlt hast, Icebox glaubt dir. //Warum: Dies ist ein Vereinsbeschluss und hat mit dem System nichts zu tun, es setzt diese Vorgabe lediglich um.//+Für jeden service wird über gitlab-ci ein docker-image gebautdas dann auf die gitlab eigene docker-registry gepusht wirdIn dem docker-compose sind dann nur noch die urls zu den jeweiligen images
  
-**Mein Name taucht auf dem Touchscreen nicht auf obwohl ich mich registriert habe?** 
  
-Kann es sein, dass du kein Guthaben hast? Dann wird dein Name unter den Namen von Nutzern mit Guthaben angezeigt. Wenn du auf deinen Namen drückst bekommst du die Gelegenheit deinen Account mit Guthaben zu versorgen.+=== Reboot ===
  
-**Ein Getränk taucht im System auf aber nicht im Kühlschrank. Was tun?**+Wenn das mal down ist, muss man es per
  
-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 dortWenn 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 vorkommenDu 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.+   docker-compose up -d 
 +    
 +rebootenDafü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.
  
-**Der Barcode an der Flasche funktioniert beim Scannen nicht.**+=== Services ===
  
-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 seinEin 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.+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]]
  
-**Mein Guthaben ist Falsch, wie kann ich es korrigieren?** 
  
-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.+== Backend und API ==
  
-**Wo kann ich ein Problem melden?**+Das Backend ist unter [[http://api.icebox.nobreakspace.org|api.icebox.nobreakspace.org]] zu erreichen.
  
-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+ 
-==== Known Issues ====+== Web == 
 + 
 +[[http://icebox.nobreakspace.org|icebox.nobreakspace.org]] 
 + 
 +== Icebox-vuetified == 
 + 
 +[[http://vue.icebox.nobreakspace.org|vue.icebox.nobreakspace.org]] 
 + 
 + 
 +== 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 77: 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 111: 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 136: 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 ==== +
-Die Barcodes werden auf http://www.abarcode.net/online.aspx ertsellt. Size 20, Zoom 200%, Format: Transparent 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.+{{NEWPAGE>infrastruktur:wartung:icebox#pagetemplates:wartungstemplate:icebox|icebox 
 +}} 
  
-====Changlog==== +{{topic>:infrastruktur:wartung?wartungsfenster +icebox &nodate&nouser&desc&table}}
-   * 2017-13-05Delete jetzt auch ohne body, stattdessen einfach consumptions/:id/:barcode/:username mit delete und fertig.+
  
  
-{{tag>service case moby}} 
infrastruktur/container/icebox.1609851491.txt.gz · Zuletzt geändert: 05.01.2021 12:58 von Lukas Ruge