- TypeScript 94.8%
- Shell 1.8%
- JavaScript 1.7%
- Svelte 0.7%
- Makefile 0.5%
- Other 0.5%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Ein Totalausfall des Entwicklungslaufs, gemessen am 2026-10-24: `./dev.sh` kam
nicht hoch, und der Dienst `app` meldete
Error: Cannot find module '@plantdb/auth' imported from
/repo/apps/web/src/lib/server/sitzungsschluessel.ts
Die Stufe `deps` des `Dockerfile` kopierte `apps/web`, `packages/domain` und
`tools`. Das war vollstaendig, als es geschrieben wurde; seither sind
`packages/auth`, `packages/db`, `packages/git` und `packages/git-write`
entstanden, und `apps/web` haengt an allen vier. `pnpm install` im Container
legte ihre Verweise nie an, weil ihre Manifeste im Abbild fehlten.
**Warum der Bau dabei gruen war, und das ist der lehrreiche Teil.**
`--frozen-lockfile` vergleicht die Sperrdatei gegen die Manifeste, DIE DA
SIND. Ein Manifest, das gar nicht kopiert wurde, gehoert nicht zum Vergleich;
pnpm sah einen kleineren, in sich stimmigen Arbeitsbereich und installierte
ihn widerspruchsfrei. Der Fehler fiel erst beim ersten `import` zur Laufzeit --
dieselbe Gestalt wie `A17`: ein Lauf, der ueber einen Pfad gruen liest, den er
nicht beruehrt. Kein Test im Baum hielt die Liste gegen den Arbeitsbereich,
und das ist die Luecke, die das Verrotten erlaubt hat.
`BETRIEB-110` leitet die Erwartung aus `apps/web/package.json` ab und schreibt
sie nicht hin (`AGENTS.md` Abschnitt 2b): eine Liste von Hand waere die zweite
Wahrheit und veraltete beim naechsten Paket genauso lautlos. Gelesen wird nur
die Stufe `deps`; die Stufe `build` traegt ein `COPY . .` und haette jeden
Treffer vorgetaeuscht.
Mutant mit Grundlinie: die vier `COPY`-Zeilen entfernt faellt 1 von 3 in
`tools/tests/schnell/dockerfile-workspace-manifeste.test.ts` und 1 von 1800
ueber die Stufe `schnell`, und der Fall nennt die fehlenden Manifeste
namentlich.
**Die Klausel von `AP-14` ist damit erstmals wirklich belegt.** Sein
`Fertig wenn` verlangt, dass `docker compose ps` nach `make dev` fuer `app`
UND `db` den Zustand `healthy` zeigt; bis hierhin stand der Vermerk auf einem
Abbild, das gar nicht hochkam. Nach dem Neubau melden beide `healthy`, die
Oberflaeche antwortet auf Port 5399 mit 200, und sie listet alle vier Taxa des
Lesemodells.
`make ci-fast` laeuft durch, alle neun Ziele, Ausgangscode 0.
|
||
| .forgejo/workflows | ||
| .github/workflows | ||
| aliases | ||
| apps/web | ||
| cache | ||
| data | ||
| docs | ||
| e2e | ||
| migrations | ||
| packages | ||
| schema | ||
| scripts | ||
| tools | ||
| .env.example | ||
| .gitignore | ||
| .prettierignore | ||
| .prettierrc.json | ||
| AGENTS.md | ||
| CONTRIBUTING.md | ||
| dev.sh | ||
| docker-compose.override.yml | ||
| docker-compose.yml | ||
| Dockerfile | ||
| eslint.config.js | ||
| lefthook.yml | ||
| LICENSE | ||
| LICENSE-APP | ||
| LICENSE-CODE | ||
| Makefile | ||
| package.json | ||
| playwright.config.ts | ||
| pnpm-lock.yaml | ||
| pnpm-workspace.yaml | ||
| README.md | ||
| SECURITY.md | ||
| tsconfig.base.json | ||
| tsconfig.json | ||
| vitest.config.ts | ||
plantdb
Wissensbasis über essbare Gartenpflanzen, geführt als Git-Repository, plus eine Webanwendung, die darin stöbert, sucht, kuratiert und bearbeitet.
Zwei Artefakte, nie vermischt
Das Datenrepo (plantdb-data). YAML-Dateien, ein JSON Schema, eine
CI-Prüfung. Das ist der Vertrag. Wer plantdb konsumiert, hängt an diesen drei
Dingen und an nichts anderem.
Die Kurationsanwendung (plantdb-app). Öffentliche Oberfläche zum Stöbern
und Suchen, Import aus externen Quellen, KI-Kurationsstrecke, Erzeugung von
Pull Requests. Ein Werkzeug, das auf dem Datenrepo arbeitet. Konsumenten
brauchen es nicht.
Die beiden haben verschiedene Lebenszyklen und verschiedene Lizenzen. Wer sie in einem Paket zusammenzieht, hat den Vertrag aufgegeben.
Verhältnis zur Gartenanwendung
Die Gartenanwendung garden ist ein eigenes Projekt in einem eigenen
Repository. Sie braucht agronomische Pflanzendaten für die Bodenwasserbilanz
nach FAO-56, für Pflegeaufgaben, Fruchtfolgewarnungen und Beetbelegung.
Sie klont das Datenrepo und baut daraus ein eigenes Lesemodell. Sie ruft zur
Laufzeit keinen plantdb-HTTP-Endpunkt. Ein Ausfall von plantdb-app darf
keinen Garten lahmlegen.
Die Vertragsfläche umfasst genau drei Dinge: das YAML-Schema, das
Verzeichnislayout und die Versionsregeln. Sie steht vollständig in
docs/plantdb-contract.md, einer wörtlichen Kopie
aus $GARDEN_REPO/docs/plantdb-contract.md. Jede Änderung daran ist eine
Vertragsänderung und mit der Gartenanwendung abzustimmen.
$GARDEN_REPO, der Verweis auf das Nachbarrepositorium
Mehrere Dokumente hier verweisen auf eine Datei der Gartenanwendung, weil
dieses Projekt deren Verfahren spiegelt. Diese Verweise stehen als
$GARDEN_REPO/<pfad> und nicht als absoluter Pfad: ein Pfad aus dem Rechner
eines Entwicklers gilt auf keinem anderen, und nach der Veröffentlichung ist
das Ziel ohnehin eine Adresse im Netz und kein Verzeichnis.
Setze die Variable auf den Arbeitsbaum, wenn du beide Repositorien nebeneinander liegen hast:
export GARDEN_REPO=../garden # oder ein absoluter Pfad
less "$GARDEN_REPO/docs/testing/teststellen.md"
Liegt der Arbeitsbaum nicht vor, steht an derselben Stelle die Veröffentlichungsadresse der Gartenanwendung:
export GARDEN_REPO=https://git.buss-labs.de/<eigentuemer>/garden/raw/branch/master
Der Eigentümer trägt <eigentuemer> ein, sobald das Repositorium
veröffentlicht ist. Bis dahin ist dieser Teil ein Platzhalter und keine
erreichbare Adresse.
Status
AP-01, AP-02 und AP-05 sind gebaut. Es gibt das Verzeichnislayout aus
Vertrag 11.1, die Lizenzen je Pfad, die Namensnennung je Quelle, den
Herkunftsblock als Typ und den CI-Prüflauf des Datenrepos. Es gibt noch kein
Schema, keine Vokabulare und keine YAML-Daten; das sind AP-03, AP-04 und
AP-06.
Gebaut wird testgetrieben: kein Produktionscode, bevor ein fehlschlagender Test existiert.
Weiterlesen
- AGENTS.md — die Arbeitsvereinbarung. Verbindlich, nicht beratend. Zuerst lesen.
- docs/naechste-schritte.md — das nächste Arbeitspaket und die ersten Befehle.
- docs/plantdb-contract.md — der Vertrag und der Bauauftrag. 2560 Zeilen, selbsttragend. Wer schnell ein Bild vom Format braucht, liest Anhang A.
- docs/umsetzungsplan.md — 25 Arbeitspakete und 12 offene Entscheidungen.
Wer etwas beitragen will, liest CONTRIBUTING.md: was ein Datenbeitrag erfüllen muss, was ein Codebeitrag, die fünf Teststellen und die Prüfungen, die durchlaufen müssen. Eine Sicherheitslücke gehört nicht in ein öffentliches Issue — der Weg steht in SECURITY.md.
Entwicklung
Der Klickweg für den Arbeitsplatz steht in
docs/betrieb/entwicklungslauf.md: erster
Lauf, tägliche Schleife, Testbefehle. Dieser Abschnitt ist die Übersicht.
./dev.sh # Datenbank und Anwendung starten
./dev.sh logs # Protokoll mitlesen
./dev.sh stop # anhalten, die Daten bleiben
./dev.sh test # Teststufe schnell
./dev.sh ist ein dünner Aufsatz auf das Makefile und kein zweites
Startwerk: hinter jedem Unterbefehl steht ein Ziel (make dev, make dev-logs,
make down, make test-fast), und make help zeigt alle. Das Skript prüft
vorab die Voraussetzungen, legt .env und node_modules an, falls sie fehlen,
und nennt am Ende die Adresse samt dem Port aus DEV_HOST_PORT.
scripts/deploy-dev.sh aktualisiert den Online-Entwicklungsstand. Beide
Skripte beantworten --help vollständig.
Einen Migrationslauf gibt es heute nicht
migrations/ ist leer, die Kette MIGRATIONS in packages/domain ist die
leere Liste, und packages/db gibt es nicht. Die Datenbank läuft also mit
leerem Schema, und ./dev.sh sagt das, statt einen Lauf vorzutäuschen. Das
Lesemodell samt Migrationsweg entsteht in AP-15.
Voraussetzungen
Auf macOS:
brew install --cask docker # bringt docker compose v2 mit
brew install node@22 git
corepack enable pnpm
git ist hier Pflicht, nicht Zubehör: das Datenrepo ist die Quelle der
Wahrheit, und die Anwendung klont es.
Die Skripte prüfen jedes Werkzeug und nennen bei einem Fehlbefund den
Installationsbefehl. Keines ruft sudo. Die geforderte Node-Fassung liest
./dev.sh aus engines.node in package.json und trägt sie nicht als Zahl.
Der eine Befehl
./dev.sh
Der Lauf macht in dieser Reihenfolge:
- Voraussetzungen prüfen: docker, der Docker-Dienst selbst, pnpm, die
Node-Fassung aus
engines.node. .envaus.env.exampleanlegen, falls sie fehlt — übermake .env.- Abhängigkeiten holen, falls
node_modulesfehlt — übermake install. - Prüfen, ob der Entwicklungsport frei ist. Ist er von etwas Fremdem belegt,
endet der Lauf mit Code 5 und nennt
DEV_HOST_PORTals Ausweg; hält der eigene Dienst ihn, wird der Stand bestätigt und nicht verdoppelt. make devfahren, bisdbundapphealthymelden.- Die Adresse nennen, dazu den Weg zu Protokoll und Halt.
Ausgangscodes: 0 fertig, 2 unbekannter Unterbefehl, 3 Voraussetzung fehlt, 4 der Docker-Dienst antwortet nicht, 5 der Entwicklungsport ist belegt.
scripts/dev.sh leitet auf ./dev.sh weiter. Der Pfad bleibt, weil Vertrag
Anhang B.1 B-22, ADR 0012 und LICENSE ihn namentlich führen.
Postgres lauscht auf Host-Port 55433, nicht 55432. Auf 55432 läuft die
Datenbank der Gartenanwendung, und beide sollen gleichzeitig laufen können.
Was in .env zu füllen ist
Für den Start genügt .env, wie sie aus .env.example entsteht. Zu füllen
ist sie für den Schreibweg zum Datenrepo. Kein Skript gibt einen dieser Werte
aus, auch nicht gekürzt.
Ohne diese Werte läuft nichts Sinnvolles:
| Variable | Ohne ihn |
|---|---|
PLANTDB_DATA_URL |
nichts zu lesen und nichts zu kuratieren |
PLANTDB_DATA_REF |
der Abgleich wüsste nicht, welchen Zweig er liest, und erriete ihn still |
PLANTDB_DATA_OWNER |
die Git Data API braucht Eigentümer und Namen getrennt |
PLANTDB_DATA_REPO |
siehe PLANTDB_DATA_OWNER |
SESSION_SECRET |
keine Anmeldung. openssl rand -base64 48 |
TOKEN_ENCRYPTION_KEY |
die gespeicherten Git-Token sind nicht mehr lesbar. openssl rand -base64 32, und sichern. |
Für den Schreibweg, also das Öffnen von Pull Requests, eines von beiden.
Erste Wahl ist eine GitHub-App mit genau zwei Rechten, contents:write und
pull_requests:write: GITHUB_APP_ID, GITHUB_APP_INSTALLATION_ID und
GITHUB_APP_PRIVATE_KEY, alle drei zusammen oder keines. Das Token gilt eine
Stunde und hängt an keinem menschlichen Konto. Rückfall ist ein fein
granulierter PAT in GIT_WRITE_TOKEN, begrenzt auf dieses eine Repository und
dieselben zwei Rechte.
Bleibt beides leer, schaltet die Oberfläche auf Nur-Lesen und zeigt den Einrichtungsassistenten. Stöbern und Suchen funktionieren ohne Token, Pull Requests nicht.
Für den Import aus Permapeople: PERMAPEOPLE_KEY_ID und
PERMAPEOPLE_KEY_SECRET, beide zusammen oder keines. Schlüssel selbst anlegen
unter https://permapeople.org/knowledgebase/api-docs.html. Bleiben sie leer,
fällt der Import der Hauptquelle aus. Der Rest läuft.
APP_ENV
Die Prüfung ist APP_ENV === 'local', eine Gleichheit auf genau diesen Wert.
Jeder andere Wert und ein nicht gesetztes APP_ENV schalten die Anmeldung ohne
Passwort ab. In .env steht absichtlich production; nur die
Entwicklungs-Override setzt local, und sie wird beim Produktionsstart nicht
geladen.
Den Wert local setzt docker-compose.override.yml für den Dienst app, und
zwar nur dort. Einen Seed gibt es heute nicht; siehe den Abschnitt zum
fehlenden Migrationslauf weiter oben.
Den Online-Entwicklungsstand aktualisieren
export DEPLOY_HOST=kurator@dev.example.org
export DEPLOY_PATH=/srv/plantdb-dev
export DEPLOY_IMAGE=ghcr.io/<nutzer>/plantdb:latest
scripts/deploy-dev.sh --pull --dry-run # erst ansehen
scripts/deploy-dev.sh --pull # dann ausführen
Die Annahme über das Ziel
Der Auftrag lautete "updaten des online dev" und nannte kein Ziel. Das Skript nimmt die Form an, die zu den Entscheidungen dieses Projekts passt:
- Die Anwendung läuft auf einem Rechner, der über SSH erreichbar ist.
- Dort liegt ein Verzeichnis mit
docker-compose.ymlund.env. - Aktualisiert wird über ein fertiges mehrbogiges Abbild aus einer Registry,
amd64 und arm64, so wie
AP-14es vorsieht. - Die Migrationen laufen beim Containerstart über den Entrypoint.
Nichts davon steht im Quelltext. Drei Umgebungsvariablen beschreiben das Ziel, und ohne sie bricht der Lauf mit Code 4 ab:
| Variable | Beispiel | Bedeutung |
|---|---|---|
DEPLOY_HOST |
kurator@dev.example.org |
SSH-Ziel |
DEPLOY_PATH |
/srv/plantdb-dev |
Verzeichnis dort mit docker-compose.yml und .env |
DEPLOY_IMAGE |
git.example.de/kurator/plantdb:latest |
Abbild samt Marke. Nur bei --pull nötig. |
Weicht der echte Aufbau davon ab, etwa Kubernetes, ein PaaS oder ein Push aus
der CI heraus, dann ist scripts/deploy-dev.sh die Stelle zum Anpassen. Die
Reihenfolge der Schritte bleibt: sichern, aktualisieren, migrieren, neu
starten, Gesundheit prüfen, bei Fehlschlag zurückrollen.
Dazu fehlt heute die Veröffentlichungsstrecke: ein Arbeitsablauf unter
.github/workflows/, der das Abbild für beide Architekturen baut und in die
Registry schiebt. Vorbild ist
$GARDEN_REPO/.forgejo/workflows/release.yml. Ohne ihn hat
--pull keine Quelle.
Zwei Modi, die Wahl ist Pflicht
--pull holt das fertige Abbild aus der Registry. Der normale Weg: es ist
dasselbe Abbild, das die CI gebaut und geprüft hat, für beide Architekturen.
--build baut auf dem Zielrechner. Für den Fall, dass keine Registry
erreichbar ist. Langsam, und nur für die Architektur des Zielrechners. Ohne
Modus bricht der Lauf mit Code 2 ab und erklärt beide.
Zwei Sperren
Ein schmutziger lokaler Arbeitsbaum bricht ab (Code 5). Ein Ziel mit
APP_ENV=production in seiner .env oder prod im Pfad oder Rechnernamen
bricht ab (Code 6). Beide lassen sich mit --force übergehen, und beide sagen
vorher, was sie gefunden haben.
APP_ENV=local auf dem Ziel bricht immer ab, auch mit --force. Das wäre die
Anmeldung ohne Passwort auf einem erreichbaren Rechner, und damit der offene
Schreibweg in das Datenrepo.
Die Sicherung ist nicht optional
Vor der ersten Migration läuft pg_dump auf dem Zielrechner, gzip-gepackt,
nach DEPLOY_PATH/backups/plantdb-<Zeitstempel>.sql.gz. Der Pfad wird
ausgegeben. Schlägt die Sicherung fehl, bricht der Lauf ab, bevor eine
Migration läuft. Diese Sperre hat kein Flag zum Übergehen.
Ein Hinweis zur Einordnung, der die Sicherung nicht ersetzt: Postgres hält hier nur ein abgeleitetes Lesemodell, die Lease-Tabelle und die Laufprotokolle. Die Quelle der Wahrheit ist das Datenrepo in Git. Das Lesemodell ist neu herstellbar, die Lease-Tabelle und die Protokolle sind es nicht, und die Protokolle sind die Lückenliste des Projekts.
Das Schema wird beim Zurückrollen nicht mitgerollt. Eine Migration, die durchgelaufen ist, bleibt eingespielt. Passt das alte Abbild nicht zum neuen Schema, muss die Sicherung eingespielt werden. Das steht so in der Ausgabe, samt Pfad.
Flags und Exit-Codes
Flags: --pull, --build, --host, --path, --image, --service,
--db-service, --health-url, --health-path, --health-timeout,
--skip-health, --no-rollback, --force, --dry-run, --help. Weitere
Variablen: DEPLOY_SSH_OPTS, DEPLOY_SERVICE, DEPLOY_DB_SERVICE,
DEPLOY_HEALTH_URL, DEPLOY_HEALTH_PATH, DEPLOY_HEALTH_TIMEOUT,
DEPLOY_SKIP_HEALTH.
Exit-Codes: 0 fertig und gesund, 2 falscher Aufruf, 3 Voraussetzung fehlt, 4 Ziel nicht gesetzt, 5 Arbeitsbaum schmutzig, 6 Ziel sieht nach Produktion aus, 7 SSH, 8 Sicherung fehlgeschlagen und nicht migriert, 9 Abbild, 10 Migration, 11 Gesundheitsprüfung fehlgeschlagen und zurückgerollt, 12 Gesundheitsprüfung und Zurückrollen fehlgeschlagen, hier muss ein Mensch ran, 20 es gibt noch nichts auszuliefern, 130 Strg-C.
/healthz
GET /healthz liegt seit AP-14 und ist der Endpunkt, an dem die
Gesundheitstests in Dockerfile und docker-compose.yml hängen. Er meldet 200,
solange die Datenbank erreichbar ist, und 503, sobald sie es nicht ist;
BETRIEB-010 und BETRIEB-020 tragen die Belege dazu.
./dev.sh wartet nicht selbst darauf: make dev fährt
docker compose up --wait, und das kehrt erst zurück, wenn der Gesundheitstest
beider Dienste anschlägt. scripts/deploy-dev.sh liest den HTTP-Status vorab:
ein 404 heißt,
die Anwendung läuft und der Endpunkt fehlt, und das Skript fällt dann auf die
Wurzel zurück und meldet dies als die schwächere Prüfung. --skip-health lässt
die Prüfung ganz weg; dann rollt das Skript auch nicht zurück, und das steht in
der Ausgabe.
Geheimnisse
Keines der Skripte gibt ein Geheimnis aus. ./dev.sh liest aus .env allein
DEV_HOST_PORT. scripts/deploy-dev.sh redigiert in der Anzeige von
--dry-run Zeichenketten, die wie ein Token aussehen, sowie Kennwörter in
Verbindungsadressen und Zuweisungen an *PASSWORD, *SECRET, *TOKEN und
*KEY. pg_dump liest Nutzer und Datenbank aus der Umgebung des Containers,
darum steht kein Kennwort im Befehl und in keinem Protokoll.
Plattform
Entwickelt und geprüft auf macOS, arm64. Linux läuft mit. GNU-eigene Flags
werden gemieden: bei Mustern steht [[:space:]] statt \s, denn BSD grep
und BSD sed auf macOS verstehen \s nicht. sed -i bekommt immer eine
Endung mit. Für Zeitvergleiche steht [ datei -nt verzeichnis ] aus bash statt
stat, dessen Flags zwischen den Systemen auseinandergehen.
Lizenzen
Dieses Repository hat nicht eine Lizenz, sondern drei, je nach Pfad. Die
verbindliche Zuordnung steht in LICENSE; sie folgt der Tabelle in
docs/plantdb-contract.md, Abschnitt 14.1.
| Pfad | Lizenz | Volltext |
|---|---|---|
data/ |
CC BY-SA 4.0 | data/LICENSE |
schema/ |
CC BY-SA 4.0 | schema/LICENSE |
tools/ |
MIT | LICENSE-CODE |
migrations/ |
MIT | LICENSE-CODE |
packages/ |
AGPL-3.0 | LICENSE-APP |
Fünf Zeilen, und das sind die fünf aus 14.1. aliases/, docs/ und scripts/
stehen nicht darin, weil 14.1 sie nicht nennt; die offene Frage steht in
docs/adr/0012-lizenzkarte-je-pfad.md.
LAYOUT-040 weist eine erfundene Zeile ab, nicht nur eine fehlende.
Die Datei LICENSE in der Wurzel gewährt selbst nichts. Sie ordnet nur zu.
Der Grund: ein Lizenzvolltext in der Wurzel gilt für den gesamten Baum und
würde entweder CC BY-SA über den AGPL-Anwendungscode legen oder die AGPL über
die Daten. Vertrag 14.1 nennt diese Verwechslung im ersten Satz als den Fehler,
der in der Praxis dauernd passiert. LAYOUT-040 prüft genau das und weist eine
Wurzel-LICENSE mit einem Lizenzvolltext ab.
CC BY-SA 4.0 für die Daten ist keine freie Wahl: Permapeople ist die Hauptquelle
und steht unter dieser Lizenz, und ihre Share-alike-Pflicht ist ansteckend. Die
Entscheidung samt der verworfenen ODbL steht in
docs/adr/0001-ent-03-datenlizenz.md;
ENT-03 ist damit entschieden und nicht mehr offen.
Das Projekt ist nicht kommerziell, und das ist eine Voraussetzung, keine Haltung. Sie legalisiert die Nachnutzung der FAO-56-Tabellen und der Quellen unter NC-Lizenzen. Fällt sie, fällt die Datenbasis.
Namensnennung je Quelle
Vertrag 14.5 verlangt genau diese Form: je Quelle ein Abschnitt in
README.md mit Lizenz und der vorgeschriebenen Nennungsform. Die
Lizenzangaben sind wörtlich aus der Quellenübersicht in Vertrag 9.2
übernommen, ungekürzt. war CC0 sagt, dass der Dienst tot ist, und
CC BY-NC-SA, teils NC-ND trägt den ND-Teil, der nach 14.3 nicht nutzbar
ist; auf eine Kennung gekürzt verschwindet genau die Einschränkung, die über
die Nutzbarkeit entscheidet.
Diese Abschnitte sind die Nennung für den Menschen. Die maschinell prüfbare
Hälfte steht je Feld in _provenance.source_ref; daraus lässt sich auszählen,
welche Teile des Bestandes von Share-alike betroffen sind. Beides wird
gebraucht, keines ersetzt das andere.
Eine Quelle steht hier, sobald ein Feld aus ihr stammt. Der Bestand unter
data/ ist heute leer; die Abschnitte stehen trotzdem vollständig, weil die
Nennungsform vor dem ersten Import festliegen muss und nicht hinterher
rekonstruiert wird.
CPVO Variety Finder fehlt absichtlich. Vertrag 9.2 urteilt dort Fällt aus,
weil die Quelle nicht offen ist, und eine Nennung für eine nicht genutzte
Quelle wäre falsch.
LAYOUT-050 prüft diese Abschnitte: je Quelle aus 9.2 ein Abschnitt, die
Lizenzzeile wörtlich, und eine Nennungsform.
Permapeople
Lizenz: CC BY-SA 4.0
Nennungsform: Permapeople, CC BY-SA 4.0, https://permapeople.org
Hauptquelle für den Grundstock. Die Share-alike-Pflicht aus dieser Lizenz ist
ansteckend und der Grund, dass data/ unter CC BY-SA 4.0 steht. Siehe
docs/adr/0001-ent-03-datenlizenz.md.
Wikidata
Lizenz: CC0
Nennungsform: Wikidata, CC0 1.0, https://www.wikidata.org
Genutzt für Taxonomie, Synonyme und deutsche Bezeichnungen. CC0 verlangt keine Nennung; sie steht hier trotzdem, weil die Herkunft eines Namens nachprüfbar bleiben soll.
GBIF-Backbone
Lizenz: CC BY
Nennungsform: GBIF Secretariat, GBIF Backbone Taxonomy, CC BY 4.0, https://doi.org/10.15468/39omei
Pflicht als Namensprüfung im Schreibgatter.
World Flora Online
Lizenz: CC BY
Nennungsform: World Flora Online, CC BY 4.0, https://www.worldfloraonline.org
Zweite Instanz der Namensprüfung, wo GBIF unscharf ist.
IPNI
Lizenz: CC BY
Nennungsform: International Plant Names Index, CC BY 4.0, https://www.ipni.org
Nur bei Streitfällen der Nomenklatur.
FAO EcoCrop
Lizenz: CC BY-NC-SA 3.0 IGO
Nennungsform: FAO EcoCrop, CC BY-NC-SA 3.0 IGO, https://gaez.fao.org/pages/ecocrop
Nicht-kommerziell. Einmalig offline abgezogen, nicht im Betrieb abgefragt.
OpenFarm
Lizenz: war CC0
Nennungsform: OpenFarm, CC0, archiviert, https://openfarm.cc
Die Lizenzangabe steht in der Vergangenheitsform, weil 9.2 sie so druckt: der Dienst ist seit April 2025 abgeschaltet und das Repository archiviert. Genutzt wird allenfalls eine einmalige Wayback-Kopie; eine laufende Abhängigkeit ist nicht möglich.
Growstuff
Lizenz: CC BY-SA
Nennungsform: Growstuff, CC BY-SA 3.0, https://www.growstuff.org
Dünn, niedrige Priorität.
practicalplants / PFAF
Lizenz: CC BY-NC-SA, teils NC-ND
Nennungsform: Plants For A Future, CC BY-NC-SA 3.0, https://pfaf.org
Die Lizenz ist dort nicht einheitlich, und der ND-Teil ist der Grund, dass die Angabe hier ungekürzt steht: CC-BY-NC-SA-Teile sind nutzbar, NC-ND-Teile bleiben liegen, weil jede Übertragung in dieses Schema eine Bearbeitung ist. Je Teilbestand zu prüfen. Vertrag 14.3.
Bundessortenamt, Beschreibende Sortenliste Gemüse
Lizenz: Amtliches Werk nach §5 UrhG, frei nutzbar
Nennungsform: Bundessortenamt, Beschreibende Sortenliste Gemüse 1997, amtliches Werk nach §5 UrhG
Letzte Ausgabe 1997, nur als PDF; die Tabellen werden einmalig offline extrahiert.
EU Plant Variety Portal / Common Catalogue
Lizenz: EC-Weiterverwendungsbeschluss 2011/833, praktisch CC BY
Nennungsform: Europäische Kommission, EU Plant Variety Database, Weiterverwendungsbeschluss 2011/833/EU
Realitätsabgleich für Sortennamen gegen die Halluzinationsgefahr aus Vertrag 7.5. "Praktisch CC BY" ist das Urteil aus 9.2 und keine CC-BY-Gewährung; die Angabe steht deshalb ungekürzt.
Kaggle windrivergreens/plant-variety-database
Lizenz: CC BY 4.0
Nennungsform: windrivergreens, Plant Variety Database, CC BY 4.0, Kaggle
Nur als Hinweis, nie als Wahrheit. Die Herkunft ist ungeprüft; ein Treffer
daraus geht mit review_state: unreviewed und einer zweiten Quelle in die
Daten, nie allein.
BBCH
Lizenz: Codes und Zahlen sind Tatsachen und nicht schutzfähig
Nennungsform: BBCH-Monografie, Julius Kühn-Institut
Nicht aus der Tabelle in 9.2, sondern aus Vertrag 14.4. Die Stadienbeschreibungstexte der Monografie sind geschützt. Sie werden umformuliert und zitiert, nie wörtlich übernommen.
FAO-56
Lizenz: nicht-kommerzielle Nutzung bei Quellenangabe
Nennungsform: Allen, R.G. u. a., Crop evapotranspiration, FAO Irrigation and Drainage Paper 56, FAO 1998
Nicht aus der Tabelle in 9.2, sondern aus Vertrag 14.2. Quelle der
Pflanzenkoeffizienten und Stadiendauern. Jeder übernommene Wert trägt die
Tabellen- und Seitenangabe im Test und in _provenance.
Ein Repo, zwei Artefakte, und was wo liegt
Dieses Repository ist die PlantDB. Der Baum aus Vertrag 11.1 liegt deshalb in der Wurzel und nicht in einem Unterverzeichnis:
data/ der Bestand, YAML je Art, Typ und Sorte
schema/ plant.vN.json und vocab.vN.json, eingecheckt
migrations/ Schemawanderungen zwischen Hauptversionen
aliases/ alte taxon_id auf neue
tools/ Werkzeuge, siehe unten
packages/ die Anwendungspakete
Die Verzeichnisse unter data/, schema/, migrations/ und aliases/ sind
heute leer und tragen nur .gitkeep. Der Bestand entsteht ab AP-06.
tools/ heißt zwei Dinge, und deshalb gibt es tools/offline/
Vertrag 11.1 meint mit tools/ einmalige Offline-Skripte, deren Ergebnis
eingechecktes YAML ist, Python erlaubt. In diesem Repo ist tools/ zugleich
das Paket @plantdb/tools mit der Prüfinfrastruktur. Beide Bedeutungen in
einem Verzeichnis sind eine Falle.
Die Auflösung, ohne einen bestehenden Paketpfad zu bewegen:
| Pfad | Was dort liegt |
|---|---|
tools/src/ |
@plantdb/tools, die Prüfwerkzeuge. make coverage-matrix |
tools/validate/ |
der Prüflauf des Datenrepos. make validate-layout, Teststelle 2 |
tools/offline/ |
die einmaligen Offline-Skripte aus Vertrag 11.1, Python erlaubt |
tools/tests/ |
die Tests zu beiden, Stufe schnell |
Python läuft nur in tools/offline/, nur von Hand, nie als Dienst, und nie im
Docker-Image. AGENTS.md Abschnitt 10.
Was es nicht ist
Keine Laufzeit-API, kein Pflanzenschutzberater, keine Bilddiagnose, kein Shop. Keine Nutzerdaten: im Datenrepo liegt nichts, was einem einzelnen Garten, einem Nutzer oder einer Installation gehört. Beetverschattung, Pflanzungen, Klimadaten, Erntemengen und Produkttext gehören der Gartenanwendung, und keine Zeile davon wandert hierher. Dieses Repo trägt Aussagen über Pflanzenarten, und sonst nichts.