Skip to content
Snippets Groups Projects
inventory.md 10.1 KiB
Newer Older
Lukas Ruge's avatar
Lukas Ruge committed
![Header](https://chaotikum.org/assets/header.png)

## Inventar

Wir haben einige Sachen als Inventar erfasst. Das ist keine ausführliche Inventarisierung, das brauchen und wollen wir nicht, aber für manche Sachen ist es praktisch.

* Sie können dadurch auf unserer [Werkstatt Website](https://chaotikum.org/nobreakspace/werkstatt/) auftauchen.
* Sie tauchen in unserem [Inventar](https://chaotikum.org/nobreakspace/inventory/) auf.
* Wir können Sicherheitsvorschriften im Sinne der [Werkstattordnung](https://chaotikum.org/verein/werkstattsordnung/) definieren
* Wir können sie in Sets aufnehmen um sie zu [verleihen](https://chaotikum.org/loancal/)

Lukas Ruge's avatar
Lukas Ruge committed
Auch Schäden an Geräten, Verfügbarkeit von Geräten, Einweisungsleitfäden, Sicherheitshinweise und Gruppen von Geräten, Kalender wann ein Gerät gebucht ist, Verleih und Reservierung werden über die Website definiert. Wie immer ist alles eine Makrdown Datei. Die folgenden Abschnitte erklären, wo diese ebgelegt werden und was drinstehen sollte.

### Geräte dem Inventar hinzufügen

Um ein Gerät hinzuzufügen, kommt eine Markdon Datei in den Ordner `_inventory`.

Lukas Ruge's avatar
Lukas Ruge committed
Je nachdem, was es ist, können diese Dateein durchaus unterschiedlich ausfallen. Aktuell gibt es primär zwei Ausführungen: Gerät in der Werkstatt und Videoausstattung. Aber einiges anderes liegt da auch rum. Grundsätzlich kann alles im Inventar auftauchen, wenn es für irgendwen hilfreich ist.

Ein Gerät in der Werkstatt (oder ein Gerät, das technisch nicht in der Werkstatt steht aber auf der Werkstatt Seite aufgelistet werden soll) sieht z.B. so aus und ist primär im Set `werkstatt`:

```
---
layout: device
name: "CNC-Fräse"
#https://www.uuidgenerator.net/
uid: 3fe2ca58-932a-440a-8c1f-b0f9f8db6ade
safetybriefing: true
safetylink: https://wiki.chaotikum.org/hackspace:werkstatt:sicherheitsbelehrung:fraese
wikilink: https://wiki.chaotikum.org/hackspace:infrastruktur:cncfraese
calcolor: "#96aa3d"
imagetag: cncfraese
Lukas Ruge's avatar
Lukas Ruge committed
contact:
 - person
Lukas Ruge's avatar
Lukas Ruge committed
sets:
 - werkstatt
hints:
 - "Nutzung nur nach Einweisung bzw. Überprüfung deiner Kenntnisse"
 - "Gefahr durch rotierende Teile sowie Quetschungen."
 - "Niemals unbeaufsichtigt laufen lassen."
commandsigns:
 - M002
 - M003
 - M004
 - M016
---
Eine CNC-Fräse ist ein Gerät, welches Materialbearbeitung durch Subtraktion
durchführt. Grundlegende Infos dazu findest du z.B. auf
[dieser Seite](https://prototechasia.com/de/cnc-bearbeitung/cnc-bearbeitung-erklaerung).

CNC steht für *Computerized Numerical Control*, also durch Computer
kontrollierte, numerische Kontrolle. Das heißt, mit einer speziellen Software werden
die erstellten Modelle in Befehle für die Fräse übersetzt.

Wir verwenden eine Fräse mit einer Grundfläche von 30cm x 40cm, über die Du in
[diesem Video mehr erfahren kannst (wir nutzen allerdings eine andere Software zur Steuerung)](https://www.youtube.com/watch?v=SYKNvL7CEH0).
Zudem wurde die Hardware individuell angepasst.

Das richtige Bedienen einer CNC-Fräse erfordert viel Erfahrung. Ein einfaches
Tutorial Video kann nur schlecht alle erforderlichen Kenntnisse vermitteln.
Es ist deshalb notwendig sich von jemanden mit Betriebserfahrung einarbeiten zu
lassen. Um einen ersten Eindruck zu bekommen, empfehlen wir folgende Infomaterialien:

- [Software zum Kommunizieren mit der Fräse](https://github.com/winder/Universal-G-Code-Sender)
```

* `layout` MUSS immer „device“ sein.
* `name` Name des Geräts. Gerne spezifischer als nur Fräse…
* `uid` Jedes Gerät im Inventar hat eine eindeutige UUID
* `safetybriefing` Wenn dies True ist benötigt das Gerät eine Einweisung nach Werkstattordnung. Default ist false, dann kann man es einfach weglassen. Die Sicherheitshinweise und andere Hinweise für die Einweisung selbst werden im Ordner _briefing gelegt.
* `wikilink` Geräte können auch eine Wiki Seite haben. Wenn ja, hier hin.
Lukas Ruge's avatar
Lukas Ruge committed
* `manual`: Link zum Manual. Wir verlinken nicht ins freie Internet, die Dateien verschwinden immer. Beachte die Anleitung im Kapitel [Anleitungen zu Geräten](/docs/content/manuals.md).
Lukas Ruge's avatar
Lukas Ruge committed
* `contact` eine oder mehrere Kontaktpersonen. Bei geräten die ein `safetybriefing` benötigen, sind dies die Menschen, die eine Einweisung geben dürfen und entsprechend auch eine haben müssen.
* `out_of_service` kann mit true gesetzt werden, wenn das Gerät kaput ist, dann wird das auf entsprechenden Seiten angezeigt. Default ist false, das muss nicht gesetzt werden.
* `calcolor`: Nur Relevant für verleihbare Geräte, definiert welche Farbe sie im Verleih-Kalender haben, um sie besser unterscheiden zu können. Aber bitte immer was neues eintragen und nicht kopieren, es könnte auch für Werkzeug mal so ein Kalender Feature geben…
* `imagetag` Auf der Werkstattseite gibt es Bilder von Geräten, diese werden mit diesem Tag gefunden (Siehe Howto: Bilder und Galerien).
* `sets` Für Werkstattgeräge primär werkstatt.
Lukas Ruge's avatar
Lukas Ruge committed
* `hints` Hinweise im Orangen Warnkasten.
Lukas Ruge's avatar
Lukas Ruge committed
* `commandsigns` Gebotszeichen damit das funktioniert muss das Gebotszeichen auch im git sein, das gilt nur für einige übliche. (Mehr siehe weiter unten)

Für Geräte z.B. aus dem Bereich Video oder so sieht das ggf anders aus, hier sind gebotszeichen und Warnhinweise vermutlich unnötig, Aber das Konzept Sets relevanter:

```
---
layout: device
name: "ATEM Mini Extreme ISO (Koffer Blau)"
#https://www.uuidgenerator.net/
uid: e8b93fff-0f17-4a5a-ae97-611de68a86c5
wikilink: https://wiki.chaotikum.org/hackspace:equipment:atem_mini_extreme_iso_1
calcolor: "#69808e"
Lukas Ruge's avatar
Lukas Ruge committed
sets:
 - video
 - leihbar
 - kofferblau
hints:
 - "Es empfiehlt sich, das Gerät vor der Nutzung kennenzulernen und einzurichten. Es ist nicht alles einfach."
commandsigns:
 - M002
---

ATEM Mini Extreme ISO
```

Ansonsten alles wie oben beschrieben.

Lukas Ruge's avatar
Lukas Ruge committed
#### Hints und commandsigns
Für die Hinweise und den orangen Kasten zu einem Gerät gibt es die Felder *hints* und *commandsigns*.

- Die *hints* sind einfach eine Liste. Möglichst nicht zu viele, möglichst nur wichtiges.
- Die *commandsigns* sind eine Codierung nach [EN ISO 7010](https://de.wikipedia.org/wiki/Gebotszeichen), die entsprechenden Bilder sind im Ordner `assets/iso7010`, zur Verfügung stehen
   - M001
   - M002
   - M003
   - M004
   - M011
   - M016

Lukas Ruge's avatar
Lukas Ruge committed
### Sets

Sets dienen der Grupierung von Invatargegegständen aus verschienden Gründen. Mehr dazu im Kapitel [Sets](/docs/content/sets.md).

Lukas Ruge's avatar
Lukas Ruge committed
## Briefing

Lukas Ruge's avatar
Lukas Ruge committed
In `_briefing` kann man Hinweise zur Nutzung des Gerätes aufschreiben. Daraus kann ein Dokument zur [Sicherheitseinweisung nach Werkstattordnung](https://chaotikum.org/verein/werkstattsordnung/) werden. Zudem können die Hinweise auch auf den A3-Aushnag gedruckt werden.
Lukas Ruge's avatar
Lukas Ruge committed

So eine Datei kann so aussehen:
```
---
layout: briefing
inventory_id: 10992f1f-fb14-491f-9e68-6b1b84154674
Lukas Ruge's avatar
Lukas Ruge committed
size-on-poster: 400
---

* Hier stehen demnächst ein paar schlaue Sätze darüber, wie man eine Fräse bedient.
* Hiuer Am Anfang sollten die wichtigsten Punkte zu finden sein
* Nicht nur was sicherheit angeht sondern auch andere Hinweise zur Nutzung
* Die man sich gerne vor jeder Nutzung in Erinnerung rufen sollte
* Denn was am Anfang steht, kommt auch auf die Print Version des A4-Aushangs zum Gerät

### Kapitel

* Kapitel sind auch gut sie strukturieren diese Hinweise

Lukas Ruge's avatar
Lukas Ruge committed
Man muss auch nicht alles mit Spiegelstrichen/Punkten machen, man kann auch Texte schreiben. Je nachdem wie es eben am meisten Sinn ergibt.
Lukas Ruge's avatar
Lukas Ruge committed

### Mehr Infos

* Punkt 1
* Punkt 2
* Punkt 3

<!--more-->

Lukas Ruge's avatar
Lukas Ruge committed
* Was nach dem "more" kommt, sind hinweise, die auch vermittel werden sollten bei der erstmaligen Einweisung.
Lukas Ruge's avatar
Lukas Ruge committed
* Sie bleiben auch online einsehbar
* aber sie stehen nicht auf dem Aushnag in der Werkstatt.
* Dafür kann man davon beliebig viele haben
Lukas Ruge's avatar
Lukas Ruge committed
Im ordner `_damagereport` können Schäden an Objekten festgehaltenw werden. Dies ist insbesondere für das Verleihen wichtig, so dass Personen, die ein Objekt leihen, sich darauf berufen können, dass ein Schaden bereits bestand.

Die markdown datei ist sehr simpel:

```
---
layout: damage
device_uid: 6171339f-382b-4ae2-90a2-b161951e7f11
date: 2023-04-25 00:00:00 +0200
---

Hier dokumentieren wir einen Schaden beispielhaft als Text. Natürlich könnte. an auch ein Bild hinzufügen... Aber vermutlich reicht eine kleine Beschreibung.
```

Lukas Ruge's avatar
Lukas Ruge committed
Sie werden auf der Seite eines Geräts angezeigt und im Verleihvertrag eingebunden.

Lukas Ruge's avatar
Lukas Ruge committed
Es kann sinnvoll sein, dass ein Gerät, für verschiedenen Zwecke exklusiv einer person oder Gruppe für einen Zeitraum zugesichert wird. Der Überbrgriff hierfür ist das Buchen von Objekten. Es kann im Kontext unterschiedlicher Bereiche geschehen:

- Events: Bei der durchführung von Workshops, Vorträgen, der Nook, einem Sommerfest usw.. ist es notwendig sicherzustellen, dass bestimmte Dinge da sind, die benötigt werden. In Events ist es daher möglich direkt einzutragen, dass man Objekten aus dem Inventar bucht.
- Verleih: Es ist möglich als Privatperson oder gruppe gewisse dafür vorgesehene Objekte aus dem Inventar zu leihen. Dafür füllt man ein Formular aus, unterscheibt einen Leihvertrag und erhält dan das Objekt oder die Objekte.
Lukas Ruge's avatar
Lukas Ruge committed
- Reservieren für Aktivitäten: Akltivitäten (früher Projekte) sind langfristige Tätigkeiten von personen oder Gruppen im Rahmen des Vereinszwecks innerhalb (oder zumindest teilweise innerhalb) der Vereinsräume. Manchmal sind diese Zeitkritisch oder verlangen Teamarbeit und es ist sinnvoll, dafür Objekte aus dem Inventar zu reservieren.
Lukas Ruge's avatar
Lukas Ruge committed

Lukas Ruge's avatar
Lukas Ruge committed
Welche Dateien und Ordner hier involviert sind, wie das funktioniert und auch, welche grundsätze hier zu beachten sind, um das gemeinsame Arbeiten im Space nicht unnötig zu erschweren, beschreibt der nächste [Abschnitt der Dokumentation](/docs/content/booking.md) .
Lukas Ruge's avatar
Lukas Ruge committed

Um einem Gerät oder Werkzeug einen Kalender geben zu können, damit Menschen sehen können, ob es verfügbar ist, muss eine ics Datei pro Werkzeug existieren. Da Jekyll pro Markdown-Datei lediglich ein Layout erlaubt, brauchen wir hier eine Behelfsdatei. Diese kommt in den Ordner `_loancal` und beinhaltet neben dem obligatorischen Feld für das zu wählende Layout lediglich die uid des Inventarobjekts

```
---
layout: [loancal]
device: 34eaa382-de42-4f1e-8f4d-987af077a613
---
```

Lukas Ruge's avatar
Lukas Ruge committed
Ohne eine solche Datei wird keine Ical Datei erzeugt, was für potentiuelle Leihende die Sache etwas unübersichtlicher macht.