Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- infrastruktur:container:icebox [05.01.2021 12:58] – ↷ Seite von infrastruktur:service:icebox nach infrastruktur:container:icebox verschoben Lukas Ruge
+++ infrastruktur:container:icebox [17.11.2024 09:54] (aktuell) – Lukas Ruge
@@ Zeile 1: / Zeile 1: @@
 ===== IceBox =====
-  * Verantwortung: TVLuke
+| 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 vereinfachen. Das 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 €. //Warum: Dies 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 ===
-Nein, Icebox basiert auf Vertrauen. Du 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 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.
-**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 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.
+   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 [[: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 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.
+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 nutzen. Mails 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**
 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]]
    * 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]]
-=== Dienste ===
+== Dienste ==
    * 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
    * Alias https://github.com/MotieDesign101/iceBoxAlias
    * Liste der Einkaufspreise https://github.com/MotieDesign101/iceboxprices
-==== API-Doku ====
+== API-Doku ==
    * 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.
@@ 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.
-==== Alias anlegen ====
+== Alias anlegen ==
 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
-==== Offene Ideen ====
+== Offene Ideen ==
    * Anbindung von https://coffeestats.org/
    * Statistiken
@@ Zeile 135: / Zeile 158: @@
       * Uhrzeitverteilung des Kaufens
       * ...
-==== Hardware ====
-   * [[hackerspace:basteln:barcodescanner|Barcode Scanner]]
-   * 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 Charlie, The 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.
-====Changlog====
-   * 2017-13-05: Delete jetzt auch ohne body, stattdessen einfach consumptions/:id/:barcode/:username mit delete und fertig.
-{{tag>service case moby}}

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge