/* Stückliste */ Hinweis zur HW1

[stratum0-wiki.git] / Space-Status.mw

diff --git a/Space-Status.mw b/Space-Status.mw
index 68cc31c..e8b36c7 100644 (file)
--- a/Space-Status.mw
+++ b/Space-Status.mw
@@ -1,38 +1,62 @@
 {{Projekt
 {{Projekt

-|verantwortlich=[[Benutzer:Daniel Bohrer|Daniel Bohrer]]
+|verantwortlich=[[Benutzer:Daniel Bohrer|Daniel Bohrer]], teilweise auch {{Benutzer|comawill}}

 |status=aktiv
 |beschreibung=Anzeige/Bereitstellung des Space-Öffnungsstatus
 |status=aktiv
 |beschreibung=Anzeige/Bereitstellung des Space-Öffnungsstatus

+|source=[https://github.com/stratum0/StratumOpenCloseMonitor GitHub]

 }}
 
 == Idee ==
 Da nicht alle Mitglieder einen Schlüssel haben können, wird an diversen Stellen angezeigt, ob der Space gerade offen ist.
 
 == Momentane Situation ==
 }}
 
 == Idee ==
 Da nicht alle Mitglieder einen Schlüssel haben können, wird an diversen Stellen angezeigt, ob der Space gerade offen ist.
 
 == Momentane Situation ==

-Der Status kann im Moment nur per Hand aus dem [[IRC]] über die Befehle <tt>!open</tt>/<tt>!offen</tt> bzw. <tt>!close</tt>/<tt>!zu</tt> gesetzt werden. Die Befehle veranlassen unseren IRC-Bot [[ZombiePoet]], das Topic im IRC-Channel zu setzen (hier ist insbesondere wichtig, dass nach dem ersten und dem zweiten Vorkommen der Zeichenfolge <tt>||</tt> gesucht wird, und alles dazwischen durch den Status ersetzt wird). Die Grafik links in der Sidebar wird entsprechend aktualisiert.
+Der Status kann im Moment nur per Hand aus dem [[IRC]] über die Befehle <tt>sudo auf</tt> bzw. <tt>sudo zu</tt> (alleine am Anfang einer Zeile) gesetzt werden. Die Befehle veranlassen unseren IRC-Bot [[StratumGuardian]], das Topic im IRC-Channel zu setzen (hier ist insbesondere wichtig, dass nach dem ersten und dem zweiten Vorkommen der Zeichenfolge <tt>||</tt> gesucht wird, und alles dazwischen durch den Status ersetzt wird).

 
 

-Es soll in Zukunft einen Hardwareschalter zum Öffnen und Schließen geben, siehe [[/Hardware]].
+{{Hinweis|Es wird auch der Nickname desjenigen ins Topic geschrieben, der den Status auf „offen“ gesetzt hat. Die Konvention ist, dass diese Person dafür verantwortlich ist, den Status wieder auf „zu“ zu setzen, oder die Verantwortung dafür an eine andere Person weiterzugeben. '''Falls der Space-Status auf „offen“ steht und Leute längere Zeit vor verschlossener Tür stehen, schuldet der Verantwortliche diesen Leuten je drei Flaschen Club-Mate.'''}}
+
+Das aktuelle (manipulationsanfällige) System soll in Zukunft durch einen Hardwareschalter zum Öffnen und Schließen im Space ersetzt werden, siehe [[/Hardware]].
+
+=== Anzeige ===
+Der Öffnungsstatus wird menschenlesbar auf 5 Minuten genau an folgenden Stellen angezeigt:
+* im Topic des [[IRC]]-Channels
+* hier im Wiki links in der Seitenleiste
+* an der Tür oben auf einem 3.5"-Display
+* als bookmarkbare Version ohne viel Wiki-Overhead: https://status.stratum0.org/status.html
+* als Statistik über die aggregierte Öffnungszeit: http://bastinat0r.de:3000/#stratum0

 
 === API ===
 
 === API ===

-Es gibt eine minimale [[Open/Close-Monitor/API|API]] über HTTP, um die maschinelle Verarbeitung zu erleichtern.
+Im Artikel [[/API]] wird die API beschrieben, über die der Status maschinell ausgelesen werden kann. Für die Statistik gibt es ein Archiv der bisherigen offen/zu-Befehle inkl. Timestamps: https://status.stratum0.org/archive.txt

 
 

-Für diejenigen, die nur kurz den Öffnungsstatus als Grafik sehen wollen, gibt es eine bookmarkbare Version ohne viel Wiki-Overhead: https://rohieb.name/stratum0/status.html
+Die hackerspaceübergreifende [http://spaceapi.net SpaceAPI] wird unterstützt.
+Die entsprechende Endpoint-URL ist https://status.stratum0.org/status.json.

 
 

-Für die Statistik gibt es ein Archiv der bisherigen offen/zu-Befehle mit Timestamp: https://rohieb.name/stratum0/archive.txt
+=== SpaceVoice ===
+Um die reale Welt in der virtuellen Welt abzubilden, bekommen im Space anwesende Entitäten im [[Chat|IRC-Channel]] das Voice-Flag (+v). Das funktioniert auf Basis von {{Wikipedia|Internet Control Message Protocol|ICMP}}-Pings oder {{Wikipedia|mDNS}}-Hostnamen, die alle fünf Minuten im LAN detektiert werden. Um erkannt zu werden, müssen Entitäten eine oder mehrere ihrer MAC-Adressen oder mDNS-Hostnamen an [[Benutzer:Daniel Bohrer|Daniel Bohrer]] melden, der sie dann im System hinzufügt. Die Anwesenheitserkennung per MAC-Adresse basiert auf {{WP|nmap}} und funktioniert allerdings nur mit IPv4 und nur bei manchen Geräten/manchmal/bei Vollmond (oder Kombinationen davon, more investigation needed), und die Erkennung per mDNS hat wegen langer Standard-Timeouts zur Folge, dass Entitäten bis zu einer Stunde nach dem Verlassen des Spaces noch Voice haben. Eine Kombination aus mDNS und Ping ist denkbar, aber ist noch nicht umgesetzt. Es wird dran gearbeitet™.

 
 === Systemdokumentation ===
 
 
 === Systemdokumentation ===
 

-TODO: 
+Auf dem [[Plenum 2012-08-22]] gab es einen kurzen Vortrag über die Funktionsweise mit Beschreibung des aktuellen Stands und Ausblick für die Zukunft.

 
 

-Plugin für ZombiePoet ist [https://github.com/rohieb/StratumOpenCloseMonitor hier], das schreibt mod_rewrite-Config für Apache, Apache serviert status.png jeweils mit HTTP-302-Redirect auf closed.png oder open.png.
+* [[:Media:Open-close-Monitor 2012-08-06.pdf|Vortragsfolien]]
+
+tl;dr: Plugin für IRC-Bot ist [https://github.com/stratum0/StratumOpenCloseMonitor hier], das schreibt nginx-Config, nginx serviert status.png jeweils mit HTTP-302-Redirect auf closed.png oder open.png. Das ganze läuft auf einem Raspberry Pi im Space.

 
 == Apps ==
 Es gibt mehrere Apps, um den Space-Status anzuzeigen:
 * [[StratumsphereStatusWidget]] für Android
 * [[StratumsphereTrayIcon]] für Linux, Windows und Mac OS X
 
 == Apps ==
 Es gibt mehrere Apps, um den Space-Status anzuzeigen:
 * [[StratumsphereStatusWidget]] für Android
 * [[StratumsphereTrayIcon]] für Linux, Windows und Mac OS X

+* indirekt über die SpaceAPI werden auch entsprechende [http://spaceapi.net/app Apps] unterstützt.

 
 == Elektronische Türöffnung ==
 Eine elektronische Türöffnung wird im Artikel [[Spacegate]] geplant.
 
 
 == Elektronische Türöffnung ==
 Eine elektronische Türöffnung wird im Artikel [[Spacegate]] geplant.
 

+== To Do ==
+* <s>[[EVENTDISTR]]-Pakete senden</s> done in [https://github.com/stratum0/StratumOpenCloseMonitor/commit/2cf610db37da4c62963b00520352a489e699de4a 2cf610db]
+* Rewrite des SpaceVoice-Teils, vollständig als Daemon/cronjob (im Moment im supybot-Plugin realisiert, hat da eigentlich nichts zu suchen.)
+* Aufmachen, wenn mindestens n Entitäten anwesend sind?
+* Space-Voice: mDNS hat langen Timeout, wenn Geräte sich nicht explizit abmelden. Möglicherweise zusätzlich pingen und bei fehlendem Ping Geräte aus der Liste werfen
+* nmap findet manchmal nicht alle pingbaren MAC-Adressen… Timeout erhöhen? nmap nachbauen für mehr Flexibilität?
+* Rewrite mit Python Twisted für saubere API auch nach innen, mehr Flexibilität und einfachere Wartbarkeit
+

 == Ähnliche Systeme ==
 * Der [http://shackspace.de/wiki/doku.php?id=shack_open_close_monitor shack open/close monitor] aus Stuttgart
 * [https://www.das-labor.org/wiki/Status-Bot Status-Bot], Bochum --[[Benutzer:Sensorpixel|Sensorpixel]] 17:54, 13. Jan. 2012 (UTC)
 == Ähnliche Systeme ==
 * Der [http://shackspace.de/wiki/doku.php?id=shack_open_close_monitor shack open/close monitor] aus Stuttgart
 * [https://www.das-labor.org/wiki/Status-Bot Status-Bot], Bochum --[[Benutzer:Sensorpixel|Sensorpixel]] 17:54, 13. Jan. 2012 (UTC)