diff --git a/docs/.pages b/docs/.pages new file mode 100644 index 0000000..c31e4e8 --- /dev/null +++ b/docs/.pages @@ -0,0 +1,16 @@ +hide: true + +nav: + - Home: index.md + - Fallstudien: fallstudien + - Tools: tools + - Installation: installation + - Releases: releases + - Organisation: organisation + - Glossar: glossar + - FAQ: faq.md + - Kontakt: feedback.md + - Source Code (Gitea): https://git.local-it.org + - Rechtliches: + - Datenschutz: https://local-it.org/datenschutzerklaerung/ + - Impressum: https://local-it.org/datenschutzerklaerung/ \ No newline at end of file diff --git a/docs/assets/.pages b/docs/assets/.pages new file mode 100644 index 0000000..0dcafb3 --- /dev/null +++ b/docs/assets/.pages @@ -0,0 +1 @@ +hide: true \ No newline at end of file diff --git a/docs/fallstudien/.pages b/docs/fallstudien/.pages new file mode 100644 index 0000000..42f72dc --- /dev/null +++ b/docs/fallstudien/.pages @@ -0,0 +1,7 @@ +hide: true + +nav: + - Todo: . + # - Holsteincloud: holsteincloud.md + # - Wandelgut: wandelgut.md + # - ... \ No newline at end of file diff --git a/docs/fallstudien/holsteincloud.md b/docs/fallstudien/holsteincloud.md new file mode 100644 index 0000000..7263b73 --- /dev/null +++ b/docs/fallstudien/holsteincloud.md @@ -0,0 +1,116 @@ +--- +status: draft +--- + +# Holsteincloud 3.0 2021 + +Durch regionale Fördergelder konnten die Stadtwerke Eutin +uns beauftragen, pilothaft für zwei Vereine eine kollaborationsplattform +einzuführen und zu betreiben. Darunter gab es die Hospiz Initative Euin und +die Freiwillige Feuerwehr Eutin, Fissau und Neubar . # TODO + +### Hospizinitative Eutin + +Kontakt entstand durch die Stadtwerke Eutin. +Verein mit hauptamtlichen und ehrenamtlichen. +hohes durchschnittsalter, gerine it-affinität + +Nutzen bisher Whatsapp, E-Mail, Dropbox, Google Kalendar, +IT-Dienstleister für Website, + +Haben Bedarf an Dateiaustausch für Dokumente, Bilder, gemeinsame Dokumentenbearbeitung, Projektmanagementtool für Feierlichkeit + +25 User:innen + + +#### Ablauf + + +1. Auftakt Veranstaltung, Vorstellung, **Anforderungs Workshops** + Welche digitalen Tools möchte der Verein gerne nutzen? + +2. Bereitstellung einer Pilotinstanz mit Authentik, Nextcloud, Wekan. + Verbindung per SSO + Installation von Authentik, Nextcloud, Onlyoffice, Wekan + Integration per openid connect + automatisierung, erstellen von coopcloud recipes + Integration von Backupbot + +3. Einführungsworkshop in die Tools + +4. Supportphase (Updates und Hilfe bei Anfragen) und regelmäßige Feedbackgespräche + + +#### Learnings + +* viel Früher Feedback von Einzelnen aus Pilotgruppe einholen +* Schulung mit kleinerer Gruppe machen +* Zur Bedarfsabfrage schon Demo-Zugang bereitstellen +* mehr Zeit mit Vereinen einplanen für Planung +* Nextcloud (Dateiverwaltung und Kalendar) kommt gut an und wird genutzt. +* Wekan wird nicht genutzt, weil es als zu kompliziert wahrgenommen wird. + Kamen vorher von linearer Projektmanagement. Kennen die Kanban Arbeitsweise nicht +* Im Workshop auch Mobilnutzung vorstellen +* Gruppenfunktionalität in Wekan fehlt +* Userbootstrapping noch schwierig + Wenn User selbst anlegen, nicht einheitliche user-namen + Wegen openid Anbindung werden User erst beim ersten login an die Apps übertragen + + +### Feuerwehr + +#### Ablauf + +1. +2. Workshopreihe + 1. Beispielszenarien und Erster Input + 2. Admin Workshop, Userverwaltung und Inhalte erstellen + 3. Reale Nutzung und Multiplikatoren Schulung +3. +4. + +#### Nutzung + +* Wekan als Reperaturbuch vom hauptamtlichen Gerätewart +* Lehrsaalnutzung und Fahrzeugnutzung und Werkstattnutzung +* Nextcloud als Dateiablage für Weiterbildungsunterlagen und Protokolle für den Vorstand +* gemeinsame Dokumentenbearbeitung für die Grundausbildung als Anwesenheitsliste und in der Ausbildung + + +Verbesserung von SSO in Wekan + + + +#### Learning + +* Haben es anderen Feuerwehren schon empfohlen! + +##### Wekan +* leichte Start-Schwierigkeiten, wegen falschen Berechtigungen (konnten sie selbst klären) +* Frage gehabt wie Benachrichtigungssystem funktioniert + +* LDAP +* Nutzungsszenarien gemeinsam in Workshop erarbeiten + Fast Organisationsberatung +* Direkt eigene Instanz bereitstellen und an produktiv + Szenarien testen lassen +* Wartungsfenster planen und kommunizieren + + + +Läuft Weiter mit Supportkontingent und 40€ Pro Instanz +Stadtwerke übernehmen 1. Level Support + + + +# fragen + +wie viele feedback gespräche haben stattgefunden und war das feedback so hilfreich? + oder brauchen wir vllt auch noch andere feedback technik? users in the wild + +warum eig kein bedarf an chat? + +Warum hat hospiz eig noch google kalender auf homepage? + +nutzt die hospiz auch onlyoffice? + diff --git a/docs/fallstudien/wandelgut.md b/docs/fallstudien/wandelgut.md new file mode 100644 index 0000000..e69de29 diff --git a/docs/feedback.md b/docs/feedback.md new file mode 100644 index 0000000..8dcefa1 --- /dev/null +++ b/docs/feedback.md @@ -0,0 +1,18 @@ +* Website: [local-it.org](https://local-it.org) +* Mail: [support@local-it.org](mailto:support@local-it.org) +* + + + + + + diff --git a/docs/glossar/.pages b/docs/glossar/.pages new file mode 100644 index 0000000..0dcafb3 --- /dev/null +++ b/docs/glossar/.pages @@ -0,0 +1 @@ +hide: true \ No newline at end of file diff --git a/docs/glossar/index.md b/docs/glossar/index.md new file mode 100644 index 0000000..28176a1 --- /dev/null +++ b/docs/glossar/index.md @@ -0,0 +1,18 @@ + +Was ist eine Instanz von einem Tool / Föderierbarkeit + +Was ist open-source / was ist FOSS (Mona am Anfang warum foss) + +p2p, server-client + +VM, Port, HTTPS, + +LDAP: Das Lightweight Directory Access Protocol (LDAP), ist ein Netzwerkprotokoll zur Abfrage und Änderung von Informationen verteilter Verzeichnisdienste. + +Reverse Proxy: + +Ports: Ist ein teil der Netzwerk-Adresse, der die Zuordnung einer Netzwerk-Verbindung zu einem Programm durch das Betriebssystem bewirkt. + +SSO: Single Sign On ist der zentrale Login eine:r User:in für unterschiedliche Anwendungen + +- Fork = Abspaltung von Entwicklern aus einem Software-Projekt. Hier wird eine Tool mit einem bestimmten Versionsstand übernommen und üblicherweise unter anderem Namen und mit anderen Prioritäten weiter entwickelt. diff --git a/docs/index.md b/docs/index.md index f941c7b..a5bf279 100644 --- a/docs/index.md +++ b/docs/index.md @@ -27,4 +27,4 @@ Apps: --- -Ein Projekt von [local-it](https://local-it.org) +Ein Projekt von [local-it](https://local-it.org) \ No newline at end of file diff --git a/docs/installation/matrix.md b/docs/installation/matrix.md index 338cf6e..5579b54 100644 --- a/docs/installation/matrix.md +++ b/docs/installation/matrix.md @@ -20,7 +20,7 @@ abra app deploy chat.example.org ### Restore -secrets importieren +secrets importieren signing-key kopieren media-store kopien /data/media_store db dump importieren @@ -38,9 +38,3 @@ check that user 991 has ownership of /data/media_store https://www.matrix.org/docs/api/#overview https://www.matrix.org/docs/guides/client-server-api - - -curl -X POST -d '{"type":"m.login.password", "user":"admin", "password":""}' http://localhost:8008/_matrix/client/r0/login -{"user_id":"@admin:matrix.local-it.org","access_token":"syt_YWRtaW4_nNAvEJZqiMqOCOqizuIQ_1oR29V","home_server":"matrix.local-it.org","device_id":"YSZDLGKMQI","well_known":{"m.homeserver":{"base_url":"https://matrix.local-it.org/"}}} - -curl --header "Authorization: Bearer secretsecret" -X POST -d '{"user_id": "@yksflip:matrix.kaputt.cloud"}' http://localhost:8008/_synapse/admin/v1/rooms/\!TvsvJVDwEFtMnPCbkA:matrix.local-it.org/make_room_admin \ No newline at end of file diff --git a/docs/organisation/entscheidungen/.pages b/docs/organisation/entscheidungen/.pages new file mode 100644 index 0000000..678e656 --- /dev/null +++ b/docs/organisation/entscheidungen/.pages @@ -0,0 +1,2 @@ +nav: + - ... \ No newline at end of file diff --git a/docs/organisation/entscheidungen/2022-09-07-dashboard-zurück-button.md b/docs/organisation/entscheidungen/2022-09-07-dashboard-zurück-button.md new file mode 100644 index 0000000..9c4311c --- /dev/null +++ b/docs/organisation/entscheidungen/2022-09-07-dashboard-zurück-button.md @@ -0,0 +1,104 @@ +--- +title: "2022-09-07 Zurück Button, Dashboard" +--- + + +Datum: 2022-09-07 + +Beteiligt: pf, pr, jh, mh + +[Issue](https://git.local-it.org/local-it/ska/issues/5) + + +Infos +----- + +??? example "fork" + + pros: + + * theming teilsweise auch als plugin möglich (nextcloud) + * evtl. müssen wir das eh irgendwann, wenn wir sehr viel ui anpassen wollen? + * meiste kontrolle + * müssen vllt trotzdem nen fork maintainen + + cons: + + * Fork maintainen (upgrades, ...) (kann aber vllt automatisiert werden?) + * Einarbeitungsaufwand in alle Apps + + +??? example "iframe" + + + pros: + + * (perspektivisch frontend, das viel mehr werden kann) + * relativ geringer aufwand + + cons: + + * x-frame-options headers, csp + müssen in allen apps gesetzt werden (recipes anpassen) + * share-links (z.B nextcloud) referenzieren nicht auf dashboard. sondern auf app direkt, dh. kein Zurückbutton mehr + url kann nicht gebookmarkt werden + (vllt über reverse-proxy hacken?) + * nicht so einfach zu sylen (damits auch mobil gut aussieht) + + +??? example "nextcloud als dashboard" + + auch iframes, + framing um nextcloud + könnte auch noch mal exploriert werden + + pros: + + * sehr simpel + + cons: + + * nicht so hübsch + + +??? example "CSS Injection "yunohost"" + + * bischen hacky, aber auch cool + * funktioniert mit traefik nicht mehr? + +??? example "browser plugin" + + pros: + + * schnell umzusetzen + * könnte das link teilen problem vllt lösen + (rewrite von .local-it.org domains) + + cons: + + * muss extra installiert werden + * sogar vom store verifiziert werden + * portabilität + für mehrere browser unterschiedlich + * mobil schwierig + * security/privacy (plugin hat viel mehr rechte im browser) + kann ein ungutes gefühl machen + * + +??? example "desktop / mobile app" + + vllt garnicht so schwer mit integrierter webapp + + + pros: + * leichtere zugänglichkeit / onboarding + + cons: + * gleiches "link teilen" problem + + +Entscheidung +------------ + +Wir bauen ein Dashboard das Wekan und Nextcloud als Iframe einbindet, Nextcloud als Dashboard wird als variante nochmal betrachtet. +Parallel explorieren wir forks (Aufwand, technische Umsetzung). diff --git a/docs/releases/.pages b/docs/releases/.pages new file mode 100644 index 0000000..ed2330a --- /dev/null +++ b/docs/releases/.pages @@ -0,0 +1,3 @@ +nav: + - Next: + - v0.1.md \ No newline at end of file diff --git a/docs/releases/v0.1.md b/docs/releases/v0.1.md new file mode 100644 index 0000000..3941632 --- /dev/null +++ b/docs/releases/v0.1.md @@ -0,0 +1,30 @@ +--- +status: draft +--- + +## v0.1 + +### Allgemein + +* Liste mit kollaborativen Tools gibt es [hier](./../tools/) + +### Wekan + +* Update auf v6.31 +* Vor dem Schließen Dialog für ungespeicherte Änderungen von Kartenbeschreibungen anzeigen [#4598](https://github.com/wekan/wekan/pull/4598) +* Verbesserungen der openid-connect Anbindung für SSO +[#4379](https://github.com/wekan/wekan/pull/4379) +[#4392](https://github.com/wekan/wekan/pull/4392) +[#4404](https://github.com/wekan/wekan/pull/4404) +[#4588](https://github.com/wekan/wekan/pull/4588) +* Labels können per Shortcut zugewiesen werden [#4377](https://github.com/wekan/wekan/pull/4377) + +### Nextcloud + +* Update auf v24.03 +* Verbesserung der Automatisierten Installation und Konfiguration + +### Authentik + +* Update auf v. +* diff --git a/docs/scratch/.pages b/docs/scratch/.pages new file mode 100644 index 0000000..42f72dc --- /dev/null +++ b/docs/scratch/.pages @@ -0,0 +1,7 @@ +hide: true + +nav: + - Todo: . + # - Holsteincloud: holsteincloud.md + # - Wandelgut: wandelgut.md + # - ... \ No newline at end of file diff --git a/docs/scratch/Architekturdiagram.drawio b/docs/scratch/Architekturdiagram.drawio new file mode 100644 index 0000000..a6fbcf8 --- /dev/null +++ b/docs/scratch/Architekturdiagram.drawio @@ -0,0 +1,1000 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/scratch/coopcloud_recipe_detail.drawio b/docs/scratch/coopcloud_recipe_detail.drawio new file mode 100644 index 0000000..20863c3 --- /dev/null +++ b/docs/scratch/coopcloud_recipe_detail.drawio @@ -0,0 +1,78 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/scratch/coopcloud_recipe_detail.png b/docs/scratch/coopcloud_recipe_detail.png new file mode 100644 index 0000000..8371b59 Binary files /dev/null and b/docs/scratch/coopcloud_recipe_detail.png differ diff --git a/docs/scratch/coopcloud_recipe_flow_0.drawio b/docs/scratch/coopcloud_recipe_flow_0.drawio new file mode 100644 index 0000000..9b0d3fb --- /dev/null +++ b/docs/scratch/coopcloud_recipe_flow_0.drawio @@ -0,0 +1,68 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/scratch/coopcloud_recipe_flow_0.png b/docs/scratch/coopcloud_recipe_flow_0.png new file mode 100644 index 0000000..ef311bf Binary files /dev/null and b/docs/scratch/coopcloud_recipe_flow_0.png differ diff --git a/docs/scratch/komponenten.drawio b/docs/scratch/komponenten.drawio new file mode 100644 index 0000000..4f6a1ad --- /dev/null +++ b/docs/scratch/komponenten.drawio @@ -0,0 +1,58 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/scratch/komponenten.png b/docs/scratch/komponenten.png new file mode 100644 index 0000000..36c0198 Binary files /dev/null and b/docs/scratch/komponenten.png differ diff --git a/docs/scratch/layesrs.drawio b/docs/scratch/layesrs.drawio new file mode 100644 index 0000000..c5236be --- /dev/null +++ b/docs/scratch/layesrs.drawio @@ -0,0 +1,136 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/docs/scratch/organisationell.drawio b/docs/scratch/organisationell.drawio new file mode 100644 index 0000000..c4247f7 --- /dev/null +++ b/docs/scratch/organisationell.drawio @@ -0,0 +1,25 @@ + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index 2ef5904..48accc0 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -27,15 +27,9 @@ repo_name: LIT/docs repo_url: https://git.local-it.org/local-it/docs edit_uri: _edit/main/docs/ -nav: - - Home: index.md - - ... - - FAQ: faq.md - - Source Code (Gitea): https://git.local-it.org - - Rechtliches: - - Datenschutz: https://local-it.org/datenschutzerklaerung/ - - Impressum: https://local-it.org/datenschutzerklaerung/ +# nav: +# - Fallstudien: fallstudien + - extra_css: - extra.css \ No newline at end of file