WECHANGE: Sync Spaces (Projects, Groups, Initiatives)

[flosse]

It would be great to sync entries and events with wechange.de. The joinig companies and initiaticves are slowtech, Wechange, karte von morgen (Ideen hoch drei), and others (possibly Open Knowledge Foundation for Wikimedia).

User-Story / Anwendungsbeispiel

• Definition des usecases: https://wechange.de/project/fairsync/document/usecase-karte-von-morgen-wechange/

Usecase für Karte von morgen:

• Kommune-1 möchte auf dem eigenen Portal öffentliche Inhalte von Wechange und mitunter anderen Kommunen anzeigen

• Wachstumswende nutzt ein wechange-Portal (https://wachstumswende.de/map/) zur Kommunikation und Zusammenarbeit, allerdings werden alle Initiativen global auf der Degrowth-Map (https://degrowth.info/en/get-involved/map) auf Basis der Karte vonmorgen kartiert, weil dort jeder alle Einträge aktualisieren kann. Doch wie kann man nun alles auf einer Karte sichtbar machen?

  • Die Aktiven nutzer auf wechange.de sollen alles Dort finden, aber gleichzeitig sollen alle öffentlichen, anonymen Interessenten die Inhalte im kvm-Iframe auf der Netzwerkseite finden.

• Das Commons-Institut möchte wechange.de als Kommunikationsplattform etablieren, dort eine Gruppe nutzen und bestenfalls registrieren sich dort auch alle Initiativen als Projekt/Organisation. Das wird aber niemals vollständig sein, da nicht alle das mitbekommen oder den Aufwand der Registrierung als Projekt/Organisation als notwendig erachten (weil sie privat ja schon alle infos bekommen). Dennoch will das Institut eine vollständige Commons-Karte der Öffentlichkeit zeigen, mit allen Projekten aus wechange und direktem Link dorthin, aber auch mit allen, die nur auf der kvm kartiert wurden.

• [ ] Alle öffentlichen Organisationen und Termine von wechange werden auch auf der kvm gefunden (bereits per CSV-Import ermöglicht)

• [ ] Jede Organisation mit einem WE-Profil hat auf ihrem kvm-Eintrag einen Button "Jetzt Mitarbeiten" der direkt zu deren Teamroom führt.

• Vision: Nutzerrechte für die Karte von morgen werden über wechange-Projekte verwaltet

  • Wer Teil eines bestimmten Wechange-Projektes ist, hat Regionalpilotenrechte in einer bestimmten Region auf der kvm (Beispielsweise könnte es eine Gruppe geben für alle Regionalpilot*innen in Weißrussland, oder bspw. alle Mitglieder der TT-Mannheim https://wechange.de/project/transition-town-mannheim/ haben RegPi-Rechte in Mannheim). Das setzt natürlich Single-Sign-On voraus. https://github.com/kartevonmorgen/openfairdb/issues/55
  • Wer Teil eines thematischen Wechange-Projektes ist, ist Themenpilot*in für das entsprechende Thema auf der kvm (Z.b. könnte es eine globale #upcycling-Gruppe geben...)

OUTGOING from Wechange (WE) -> Karte von morgen (kvm)

what should be exchanged?

• Nur Inhalte, die komplettt auf Öffentlich gestellt sind, in Projekten/Gruppen bzw. deren Organisationen
• WICHTIG: Alle diese Optionen sollen per setting per Portal an/ausschaltbar sein! We need to have API to send data out of the WECHANGE network: 1. public organisational profiles 2. Events

Technical steps

• Wechange API: https://wechange.de/swagger/
  • wechange.de/api/v3/navigation/spaces/ (neue Version der alten Gruppen, Projekte, Organiszations) (ruft nur Spaces ab, wo man selbst mitglied von ist)
  • /v2/groups/ https://wechange.de/api/v2/groups/?limit=100&offset=100 (alle öffentlichen)

Datenmodell

  "url": "https://wechange.de/group/verbund-rassismuskritische-psychotherapi/",
            "name": "Verbund Rassismuskritische Psychotherapie und Beratung",
            "slug": "verbund-rassismuskritische-psychotherapi",
            "description": "internes Organisationsboard des Verbunds Rassismuskritische Psychotherapie und Beratung",
            "description_long": "",
            "contact_info": "",
            "avatar": null,
            "website": "",
            "related": [],
            "child_projects": [
                "ag-entscheidungen",
                "ag-intervisionen",
            ],
            "topics": [],
            "tags": [],
            "locations": [],
            "created": "2024-03-28T08:30:38.345360+01:00",
            "last_modified": "2024-06-05T15:22:42.235869+02:00",
            "is_open_for_cooperation": false

- /v2/projects/ https://wechange.de/api/v2/projects/?limit=100&offset=100 (alle öffentlichen)
- /v2/organizations/ (vermutlich gibt es noch keine einträge zu)

Events

• [ ] Ist bereits per Wordpress-Plugin der kvm möglich und aktiviert. https://blog.vonmorgen.org/wordpress/
• Sämtliche öffeentliche WE-Events auf kvm: https://www.kartevonmorgen.org/m/main?c=50.5693%2C7.9980&z=6.00&type=event&tag=wechange-public

title, time, text about, picture, coordinates, town / city / adress, hashtags (WE-Categories become kvm-Tags), link to organisation / initiative - profile, web-adress

Prototype „Outgoing“ with Karte von Morgen:

• [ ] 1. API to send data out of the WECHANGE network: 1. public organisational profiles 2. Events
• [ ] 2. we need to clarify jurisdictional issues
• [ ] 3. we need to write and code import-scripts for Karte von morgen
• [ ] 4. we need to clarify if export-scripts or anything is needed on Wechange.

Änderungen bei WECHANGE

https://github.com/wechange-eg

• [ ] 1. Backend: Erstellen von zwei API-Endpunkten für das Auslesen aller öffentlichen Organisationen und Termine (Standard: ActivityPub + schema.org)
• [ ] 2. Backend/Frontend: Neues Feld „Organisationsart“ für Gruppen-/Projekt-Profile (Initiative oder Unternehmen)
• [ ] 3. Frontend: Popup, das Benutzer_innen einlädt die Organisationsart im Profil zu ergänzen und damit die Daten auf KVM zu veröffentlichen

Änderungen bei KVM

• Backend: Erweiterung von API und Datenbank und Such-Index um externe Organisationen und Termine
• Backend: Skript zum Import der Daten aus WECHANGE
  • Kategorien/Stichwörter (WECHANGE) werden dabei zu Stichwörtern (KVM)
  • bestmögliche Vermeidung von Duplikaten
• Frontend: Erweiterung der Karte um zwei neue Marker-Arten für externe Organisationen und Termine
• Frontend: Erweiterung der Karte um zwei neue Filter für externe Organisationen und Termine (als Opt-Out)

A) Syncronize

• Events with location
• Grouprs/ Project with location or just their Organisations (https://git.wechange.de/wechange/aktuell/cooperation/-/issues/172) from wechange to ofDB only if they are set public Issue: https://git.wechange.de/wechange/aktuell/cooperation/-/issues/171

INCOMING from Karte von morgen -> WECHANGE

This ticket just deals with INCOMING information from the Karte von morgen to WECHANGE.

MVP - Load Organisations directly from kvm

Motivated by Nexus collaboration: https://wechange.de/project/we-ag-produktentwicklung/document/nexus-orgprofile-und-kategorien-vorgehenswe/edit/ Discussed in https://chat.wechange.de/channel/weconnect-fairsync?msg=jdjTgxLGvPtonYEKE

• As we have no Org-Profils so far in wechange, we basically start from the scratch.
• This is the proposal, to cache and not store organisations in wechange, and to directly integrate the openfairDB.org
• If we do not store them in wechange.de, we dont need to sycronize it (duplicates!) and they are availiable to all other Portals in the same way.

Advantage

• Users do not need to enter all org-informations, if it is already mapped on kvm

  • Users have the feeling, as if many organisations would exist already in wechange

• In the moment of adding a new Organisation, the user just has to select the categories.

  • Everything else can be imported from ofDB

• We should skip the tab "Förderprogramme"-Tab from https://organisations.staging.wechange.de/organizations/add/ as this is too specific for civilsocietycooperation...

Solutions

• While editing the Group/Project Profile the user can choose the corresponding organisation
  • Similar to the field to select similar projects, there is another field to select several Organisations, which to project belongs to. (A project can be a cooperation of two or more orgs)
  • The field is directly linked to the ofDB-API GET ​/search https://app.swaggerhub.com/apis/Kartevonmorgen/openfairdb/0.12.2#/Search/get_search
  • As soon the user starts typing, it shows all corresponding names with the (city) in brackets
  • Even simpler could be to offer the field to add the kvm-URL of an entry. Below the field can be the description "Visit kartevonmorgen.org, search for your organisation, map it, if it does not exist and copy the entries URL in this field"
  • This could be the most simplest way of connecting WE-Projects to organisations
• If we want to keep a certain state of an Organisation in the way a user has left it, we can just save the version-number of the organisation too use the token system of ofDB. So the API knows the last version, which was approved with your token and loads it, no matter how many anonymous updates have been done on kvm. https://blog.vonmorgen.org/kontrollierte-karten/

Push Grouplink to kvm and add tag

• When the user has chosen one or many Organisations which his group/project belongs to, send a push-request to the ofDB

  • save the URL of the Group/Project as Custom-Link to the ofDB-Entry. (only if the Projekt/Group is publicly visible)
  • Link-title: Zum Teamspace auf wechange.de
  • Link-Description: Arbeitsbereich des Teams
  • And add the tag #wechange-group Like this the wechange-Projects get extra visibility on the kvm.

• [x] 1. we need to clarify jurisdictional issues: As we use only organisational information, we can publish them under creative commons licens.

• Organisations in wechange can only be public. No hidden or private organisations possible (Makes no sense, as no other user would be able to mark this organisation in his profile) Textfehler: Statt PRojekt müsste natürlich dort Organisationen stehen. die Checkbox am Ende (https://organisations.staging.wechange.de/organizations/add/) müsste eine pflichtbox sein, verlinkt mit der opensource lizenz https://creativecommons.org/publicdomain/zero/1.0/deed.de wie bei kvm:

Disadvantage

• There is no "owner" in wechange of an Organisation, as the organisations exists already
  • We need to find a way, who can accept new projects, which want to be part of an organisation
  • Maybe this whole procedure is not really needed?
• Creating a new org profile could be done inside wechange, if that is esier for the user
• But also now, to get from the option to choose an organisation to the formular to create one, could be esier, if there was a small link.

• Further Improvements

  1. API to show things from the Karte von morgen network: 1. public organisational profiles 2. Events
  2. we need to write and code import-scripts for WECHANGE
  3. we need to clarify if export-scripts or anything is needed on karte von morgen.

Änderungen bei WECHANGE

https://github.com/wechange-eg

1. Backend: Erweiterung Datenbank und Such-Index um externe Organisationen und Termine
2. Backend: Task zum regelmäßigen Import der Daten aus KVM
   1. bestmögliche Vermeidung von Duplikaten
3. Frontend: Erweiterung der Karte um zwei neue Marker-Arten für externe Organisationen und Termine
4. Frontend: Erweiterung der Karte um zwei neue Filter für externe Organisationen und Termine (als Opt-Out)
5. Stichwörter (KVM) werden zu Stichwörtern (WECHANGE)

Änderungen bei KVM

• [x] Backend: Erstellen von zwei API-Endpunkten für das Auslesen aller öffentlichen Organisationen und Termine
  • [ ] Improve it to the Standard: ActivityPub + schema.org
• [ ] Let user easily chose the WE-categoris We need to have API for KvM: 1. public organisational profile 2. Events We need to have import - scripts for Wechange

and sync

• Events
• Initiatives (and maybe Companies) from kvm to wechange to show it there on the map. Issue: https://git.wechange.de/wechange/aktuell/cooperation/-/issues/172

Wechange-Projects/Groups can be attached to Organisations from kvm: https://git.wechange.de/wechange/aktuell/cooperation/-/issues/172

Duplicate Checking

Für uns relevant ist momentan die Frage, wo dupletten gecheckt werden, wenn wir Datensätze per csv importieren. Es gibt 4 Optionen: https://docs.google.com/presentation/d/1EB__fBogN11JTaHiztxTbLx-6cUxqEjwjZfs_cY7eBw/edit?usp=sharing

Option 1

Option 2

Option 3

Helmut glaubt Option 3 ist am Sinnvollsten.

B) Duplicates

• B1. Make sure that no duplicates are created but changes are merged
• B2. Existing profiles are linked to each other
• An own interface for duplicate moderation will be needed: https://github.com/kartevonmorgen/openfairdb/issues/301

C) Match Content

• Hahstags from kvm -> to Categorien in wechange (other direction is simple)
• See also: https://github.com/kartevonmorgen/kartevonmorgen/issues/598

Ways to do it

C) Microservice Architektur

• Jede Plattform braucht eine einheitliche Schnittstelle und installiert eine Bibliothek
• Pull-Syncronisation
  • Jede Plattform kann einstellen, wie oft sie pulled
  • Jede Plattform bietet eine API wo die Einträge abgerufen werden können, die seit XX.XX.XXXX bearbeitet wurden

Budgeht

Best would be 4 People Hackathon for two weeks.

Task	Min- Tage	Max Tage
A) Pull-API	3	5
B) Dupletten-Check	3	4
C) Category Mapping (damit kvm Stichworte in wechange Kateogrien passen)	3	5
Zuzüglich 30% Risk-Budget	2,7	4,2
Gesamtzeit (Tage)	11,7	18,2

Related Issues

wechange:

• Same issue from wechange-Perspective: https://git.wechange.de/wechange/aktuell/cooperation/-/issues/170
• Milestone Organisations: https://git.wechange.de/groups/wechange/-/milestones/56#tab-issues
• Milestone Fair syn interface: https://git.wechange.de/groups/wechange/-/milestones/30#tab-issues

FairSync and further Interfaces

• Some Ideas have been made regarding Transition Connect: https://trello.com/c/GpwYJ76n/49-wandeljetzt-transition-connect-und-hubs4change

• See in how far we can allready go the direction of FairSync https://git.fairkom.net/fairsync/maps/-/issues/10 but do not get too complicated for this prototype (They use Activity-Pub: https://git.fairkom.net/fairsync/maps/-/issues/15)

  • Is WebDAV/ CalDAV also an option? https://git.fairkom.net/fairsync/maps/-/issues/17

• SSO with WE-Profil in kvm https://github.com/kartevonmorgen/openfairdb/issues/55

---

Better Struture of kvm-Data:

• Merge two databasis into one? https://github.com/kartevonmorgen/openfairdb/issues/316
• Implement Categories/ Meta-Tags https://github.com/kartevonmorgen/kartevonmorgen/issues/598

---

Kontakt Wechange: https://trello.com/c/GnQsVjDh/58-wechangede-angebot-f%C3%BCr-beratung-anfragen-richtpreise-recherchieren

[wellemut]

Habe den Usecase hier konkret aufgeschrieben: https://wechange.de/project/fairsync/document/usecase-karte-von-morgen-wechange/edit/

[wellemut]

Welche Gruppen und Projekte aus wechange.de dürfen auf der Karte von Morgen angezeigt werden? Wie werden die einzelnen Felder der Gruppen-/Projekteinstellungen gewertet?

Öffentliche Anzeige aktivieren

Standard: Ja

Ergo: Die meisten G/P haben das Häkchen gesetzt

Problem: G/P, die das Häkchen nicht gesetzt haben, sind offenbar trotzdem über die öffentliche API zu finden (auch für nicht-angemeldete User) , sind damit faktisch öffentlich

Dieses Projekt soll über andere Plattformen öffentlich auffindbar gemacht werden

Standard: Nein

Ergo: Die meisten G/P haben das Häkchen nicht gesetzt

Problem: Braucht es dieses Feld überhaupt?

Angenommen, ich habe öffentliche Anzeige aktiviert und Plattform-Auffindbarkeit deaktiviert, dann könnte ich überall gefunden werden, außer in den Partnerportalen (das ist sicherlich nur in Edge Cases gewollt)

Streng genommen: Wenn eine G/P hier das Häkchen nicht gesetzt hat (was auf die allermeisten zutrifft), dürfte die G/P auch nicht über die API öffentlich zu finden sein, weil sonst andere Plattformen die Inhalte anzeigen

Vorschlag von Helmut:

Den Text der Checkbox für "Öffentliche Anzeige" wie folgt ändern (und die Funktionalität entsprechend erweitern):

Gruppe/Projekt öffentlich sichtbar (optional) Soll deine Gruppe / dein Projekt auch für nicht eingeloggte Benutzer auffindbar sein? Die Microsite mit Namen, Kurzbeschreibung und Kontaktangaben ist dann im Internet auffindbar (Suchmaschienen, Partnerplattformen) und über die Suche im Portal.

Funktion "Sichtbarkeit auf anderen  Plattformen (optional)" dafür entfernten

Weitere Anforderungen an die groups / projects API

Last Edited-Zeitstempel

Weiterer Zeitplan

Import/Anzeigen von kvm Daten auf WE-Karte: Muss nicht sein, Nutzer erwarten das aktuell weniger

Duplettenfilter - wäre damit auch erledigt

Niemals werden Name, Kurzbeschreibung etc., die WE-User auf WE eingetragen haben, von aktuelleren aber anonymen Änderungen auf der kvm übertragen.