SpaceCache/readme.md

# SpaceCache

**Sinn:** Frage Spaces cached ab anstatt yolo-like bei jeder Request alles gleichzeitig anzuhauen.

## Wie bedienen?

Mach 'ne GraphQL Request. Ist eigentlich recht simpel, aber du kannst auch Graph*i*QL nutzen um dir eine Request zu erarbeiten.
Wenn du alle Spaces haben willst kannst du zum Beispiel sowas basteln.

```
{ spaces {
  id
  open
} }
```

Wenn du aber nur Bock auf einen Space hast, kannst du auch diesen stupiden Oneliner bringen:

```
{ isOpen(id: "unhb") }
```

#### Spaces und Config

So sieht ein Eintrag in der `spaces.json` aus:

```json
{
  "name": "CCC Aachen",
  "id": "cccaachen",
  "area": "DE-NW",
  "endpoint": "https://status.aachen.ccc.de/api/v0/status/current?public",
  "path": "$.changed.status",
  "expected": "public"
}
```
`id` ist eine einfache ID des Spaces. Sollte sich natürlich nicht überschneiden.  
`name` ist eine Art Friendly Name. Kann man benutzen damit es schön aussieht.  
`area` ist ein optionaler Value, der den Standort nach [`ISO 3166-2:DE`](https://www.iso.org/obp/ui/#iso:code:3166:DE) beschreibt. Kann benutzt werden, um später nach Region zu filtern.  
`endpoint` beschreibt die URL, die der Server anhauen soll.  
`path` ist ein JSONPath zum Wert, der beschreibt, ob der Space offen ist. Das ist nur nötig, wenn die API vom SpaceAPI Standard abweicht.  
`expected` kann einen Value beschreiben, wenn der Wert sich nicht durch einen Boolean darstellen lässt (also nicht `true`, `"true"`, `1`, usw.). Das sollte auch nur nötig sein, wenn die API vom SpaceAPI Srandard abweicht.  

Die `config.json` ist eigentlich selbsterklärend.

## Deployment
Aktuell läuft eine Instanz auf https://spaceapi.ryzetech.live/graphql und wird manuell durch ryze deployt. CD ist für irgendwann geplant.  
Wenn du das Bedürfnis hast, den Quatsch selbst zu hosten, mach folgendes:
```
yarn
yarn prisma migrate dev
yarn run start
```
Dann bau dir die Config wie du willst. Wenn du Fragen hast, schreib mir gerne auf Matrix: @ryze:matrix.un-hack-bar.de

## Warum?

@CyReVolt:matrix.org hat eine Seite gebaut, die die Hackspaces in NRW auf ihren Status abfragt => https://metaspora.org/hackerspaces/.  
Mich hat es irgendwie gewurmt, dass jeder Status direkt vom Client abgefragt wird. Daraufhin hab ich ein Backend vorgeschlagen, was die Space Server periodisch anhaut und schaut was Phase ist, die Ergebnisse in einer SQLite DB vermerkt und cached.

CyReVolt so:  
![](https://i.ryzetech.live/Screenshot_20230119_085321.png)

ryze so:  
![](https://i.ryzetech.live/accepted.jpg)