plantdb for saatly
  • TypeScript 94.8%
  • Shell 1.8%
  • JavaScript 1.7%
  • Svelte 0.7%
  • Makefile 0.5%
  • Other 0.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Thorsten Buss 78a3317dea
Some checks failed
validate / validate (push) Successful in 1m46s
validate / datenbank (push) Failing after 36s
validate / evidence (push) Failing after 32s
fix(betrieb): die Stufe deps kopiert jedes Manifest des Arbeitsbereichs
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.
2026-10-24 20:54:40 +02:00
.forgejo/workflows fix(ci): der Auftrag datenbank erreicht seinen Dienst, zstd liegt bereit 2026-10-24 20:41:32 +02:00
.github/workflows fix(ci): der Auftrag datenbank erreicht seinen Dienst, zstd liegt bereit 2026-10-24 20:41:32 +02:00
aliases feat(layout): neun Lizenzzeilen, apps/ erlaubt, docs/ ohne Fremdtext 2026-10-14 14:06:14 +02:00
apps/web test(stoebern): die abmeldende Ebene gilt fuer alle sechs Listen 2026-10-24 14:28:58 +02:00
cache feat(quelle): der Registerauszug liegt unter cache/varieties/ 2026-10-23 21:04:07 +02:00
data fix(quelle): die 0.6 der Tomatenzeile ist die Hoehe, nicht Kc ini 2026-10-20 23:42:36 +02:00
docs fix(betrieb): die Stufe deps kopiert jedes Manifest des Arbeitsbereichs 2026-10-24 20:54:40 +02:00
e2e feat(kuration): einen geerbten Erreger abmelden und wieder aufnehmen 2026-10-24 14:26:50 +02:00
migrations feat(ident): Ladeweg mit Versionsweiche vor der Schemapruefung, AP-10 2026-10-16 14:55:06 +02:00
packages feat(quelle): die Sortennamens-Vorpruefung urteilt in der Bibliothek 2026-10-24 02:46:02 +02:00
schema feat(schema): _remove an den sechs schluesselgefuehrten Listen 2026-10-23 21:02:36 +02:00
scripts fix(deploy): den Verweis auf das abgeloeste scripts/dev.sh nachziehen 2026-10-19 10:24:02 +02:00
tools fix(betrieb): die Stufe deps kopiert jedes Manifest des Arbeitsbereichs 2026-10-24 20:54:40 +02:00
.env.example feat(zugang): das Sitzungssiegel nimmt einen eigenen Schluessel 2026-10-23 19:01:43 +02:00
.gitignore fix(ignore): jedes var/ auf jeder Ebene, nicht nur das der Wurzel 2026-10-20 06:11:29 +02:00
.prettierignore refactor(schema): move vocabulary source out of packages/domain 2026-10-10 09:02:52 +02:00
.prettierrc.json chore(AP-01): add toolchain, coverage matrix and check gate 2026-10-09 09:31:24 +02:00
AGENTS.md feat(test): Stufe datenbank gegen echtes Postgres, GATTER-070 belegt 2026-10-14 10:39:45 +02:00
CONTRIBUTING.md ci+docs: Prüflauf für Forgejo, CONTRIBUTING, SECURITY, und ein Lauf, der nie anlief 2026-10-12 00:24:10 +02:00
dev.sh test(betrieb): PLANTDB_DATA_REF in das Wertaudit, BETRIEB-050 2026-10-20 08:49:45 +02:00
docker-compose.override.yml feat(web): AP-14, das Geruest der Kurationsanwendung 2026-10-17 00:42:40 +02:00
docker-compose.yml feat(web): AP-14, das Geruest der Kurationsanwendung 2026-10-17 00:42:40 +02:00
Dockerfile fix(betrieb): die Stufe deps kopiert jedes Manifest des Arbeitsbereichs 2026-10-24 20:54:40 +02:00
eslint.config.js feat(web): AP-14, das Geruest der Kurationsanwendung 2026-10-17 00:42:40 +02:00
lefthook.yml feat(format): kanonische Schluesselreihenfolge mit einer Quelle 2026-10-12 01:16:11 +02:00
LICENSE feat(layout): neun Lizenzzeilen, apps/ erlaubt, docs/ ohne Fremdtext 2026-10-14 14:06:14 +02:00
LICENSE-APP feat(data): add 11.1 tree at root, licences per path, layout check 2026-10-09 20:00:46 +02:00
LICENSE-CODE feat(data): add 11.1 tree at root, licences per path, layout check 2026-10-09 20:00:46 +02:00
Makefile feat(verteilung): Startabbild, Tarball und Pflichtsignatur, AP-25 2026-10-22 03:32:26 +02:00
package.json feat(web): AP-14, das Geruest der Kurationsanwendung 2026-10-17 00:42:40 +02:00
playwright.config.ts test(zugang): die Stufe e2e richtet ihre Gegenstelle selbst ein 2026-10-24 02:47:04 +02:00
pnpm-lock.yaml feat(kuration): der Ort kommt aus dem Lesemodell, AP-21 2026-10-22 16:07:22 +02:00
pnpm-workspace.yaml feat(abgleich): packages/git mit dem partiellen Klon und der Erkennung 2026-10-20 01:33:35 +02:00
README.md test(betrieb): PLANTDB_DATA_REF in das Wertaudit, BETRIEB-050 2026-10-20 08:49:45 +02:00
SECURITY.md ci+docs: Prüflauf für Forgejo, CONTRIBUTING, SECURITY, und ein Lauf, der nie anlief 2026-10-12 00:24:10 +02:00
tsconfig.base.json chore(AP-01): add toolchain, coverage matrix and check gate 2026-10-09 09:31:24 +02:00
tsconfig.json refactor(test): die Stufe e2e fahrt Playwright und nicht mehr Vitest 2026-10-17 00:43:29 +02:00
vitest.config.ts refactor(test): die Stufe e2e fahrt Playwright und nicht mehr Vitest 2026-10-17 00:43:29 +02:00

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

  1. AGENTS.md — die Arbeitsvereinbarung. Verbindlich, nicht beratend. Zuerst lesen.
  2. docs/naechste-schritte.md — das nächste Arbeitspaket und die ersten Befehle.
  3. docs/plantdb-contract.md — der Vertrag und der Bauauftrag. 2560 Zeilen, selbsttragend. Wer schnell ein Bild vom Format braucht, liest Anhang A.
  4. 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:

  1. Voraussetzungen prüfen: docker, der Docker-Dienst selbst, pnpm, die Node-Fassung aus engines.node.
  2. .env aus .env.example anlegen, falls sie fehlt — über make .env.
  3. Abhängigkeiten holen, falls node_modules fehlt — über make install.
  4. Prüfen, ob der Entwicklungsport frei ist. Ist er von etwas Fremdem belegt, endet der Lauf mit Code 5 und nennt DEV_HOST_PORT als Ausweg; hält der eigene Dienst ihn, wird der Stand bestätigt und nicht verdoppelt.
  5. make dev fahren, bis db und app healthy melden.
  6. 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.yml und .env.
  • Aktualisiert wird über ein fertiges mehrbogiges Abbild aus einer Registry, amd64 und arm64, so wie AP-14 es 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.