Files
place4bees.com/TODO.md
T
torbinus c31c474ed8 Bienenpatenschaft ohne Versandpflicht
Geklärt: Beim Kauf geht nur die Urkunde per Brief raus, die vier
Honiggläser à 250 g folgen im Okt/Nov in einem Paket — beides von Hand.
Der Shop soll dafür kein automatisches DHL-Label erzeugen und an der
Kasse keine Versandart verlangen.

setup-sponsorship.ts entfernt deshalb das Versandprofil (wie beim
Gutschein) -> requires_shipping = false. Geprüft: Patenschaft-Posten
hat requires_shipping=false, Kauf läuft ohne Versandart durch, nach
Zahlungseingang meldet auto-fulfill "nichts zu verschicken", kein Label.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-10-27 08:03:57 +01:00

207 lines
9.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Offene Punkte
Stand: 3. September 2026. Gepflegt von Claude — bitte ergänzen oder abhaken.
---
## 1. Zugangsdaten, auf die alles Weitere wartet
Diese vier Blöcke sind der Grund, warum Versand und Abo aktuell nicht live gehen
können. Der Code steht jeweils, ist aber nie gegen die echte Schnittstelle
gelaufen.
### DHL Paket DE Versenden v2 — Code fertig, ungetestet
Benötigt aus dem DHL-Geschäftskundenportal:
| Variable | Was das ist |
| --- | --- |
| `DHL_API_KEY` | API-Key der App im DHL Developer Portal |
| `DHL_USERNAME` / `DHL_PASSWORD` | Zugang zum Geschäftskundenportal (Basic Auth) |
| `DHL_BILLING_NUMBER` | Abrechnungsnummer, 14-stellig (EKP + Verfahren + Teilnahme) |
| `DHL_SHIPPER_NAME`, `_STREET`, `_POSTAL_CODE`, `_CITY`, `_COUNTRY` | Absenderadresse auf dem Label |
Schutzschalter, solange getestet wird — **beide erst nach erfolgreichem Test umlegen**:
- `DHL_SANDBOX=true` → Sandbox statt Produktion
- `DHL_VALIDATE_ONLY=true` → schickt `?validate=true`, es wird **kein** Porto gezogen
Prüfen mit: `npx medusa exec ./src/scripts/check-carriers.ts`
Produktcodes stehen in `DHL_PRODUCTS`. **V62WP läuft zum 31.05.2026 aus**, Nachfolger
ist V62KP — der ist bereits hinterlegt.
### Internetmarke — noch gar nicht gebaut
Fehlt komplett, weil die Zugänge fehlen. Benötigt:
- Portokasse-Konto bei der Deutschen Post (mit Guthaben)
- Partnerkennung: `PARTNER_ID` und `SCHLUESSEL_DPWN_MARKTPLATZ` aus dem Post-Partnerprogramm
Danach: Provider analog zu `src/modules/dhl-fulfillment/` anlegen.
### Hermes — blockiert
Hermes gibt die HSI-Schnittstellendoku nur an Vertragskunden heraus. Ohne die
Unterlagen lässt sich nichts schreiben, das mehr als geraten wäre. Sobald die
Doku da ist, sagen Sie Bescheid.
### Mollie — im Testmodus durchgespielt (26.10.2026)
Läuft für Abos und für normale Bestellungen ("Online bezahlen" an der
Kasse). Getestet: Kauf, Abbruch, Teilerstattung im Admin, Storno mit
Resterstattung, Folgezahlung, gescheiterte Folgezahlung (nachgestellt).
- `MOLLIE_API_KEY` — jetzt `test_…`, zum Livegang `live_…`
- Im Mollie-Dashboard noch freischalten: **PayPal, SEPA-Lastschrift**. Dann
den Text der Zahlart in `src/api/store/payment-methods/route.ts` ergänzen.
- Webhook-URL muss von außen erreichbar sein: `https://<domain>/hooks/mollie`
(lokal über einen Tunnel, z. B. cloudflared)
Mollie ist **kein** Medusa-Zahlungsanbieter, sondern wird direkt über
`src/lib/mollie.ts` angesprochen. In Medusa laufen die Zahlungen über den
manuellen Anbieter; die Mollie-Zahlung steht als `mollie_payment_id` an der
Bestellung. Erstattungen im Admin (auch per Storno) gehen automatisch an
Mollie (`src/lib/mollie-erstattung.ts`).
---
## 2. Rechtlich offen
- [x] ~~**§ 312k BGB — Bestätigung in Textform.**~~ Seit 26.10.2026: Beide
Kündigungswege (`/kuendigung` und Kundenkonto) schicken eine
Kündigungsbestätigung per Mail. Geht erst wirklich raus, wenn SMTP im
Stack gesetzt ist — bis dahin steht sie nur im Log.
- [ ] Kontaktformulare haben **kein `action`**. Sie sehen richtig aus, senden
aber nirgendwohin: `/kontakt`, `/business/kontakt`, `/business/anfrage`.
---
## 3. Daten, die vor dem Livegang stimmen müssen
- [x] ~~59 von 59 Produktvarianten haben kein Versandgewicht.~~ 42 Gewichte sind
am 16.9.2026 aus dem alten Shopify-Shop übernommen worden
(`src/scripts/import-hhonig-inhalte.ts`). Das sind Bruttogewichte inkl.
Glas, also das, was DHL braucht.
- [x] ~~Buchweizenhonig ohne Versandgewicht~~ — am 26.10.2026 auf 400 g / 100 g
gesetzt wie alle anderen Honige, ebenso das Honig-Abo (400 / 700 g).
Der Schnupperkurs verschickt nichts.
- [x] ~~**Bienenpatenschaft: Was geht beim Kauf raus?**~~ Geklärt (27.10.2026):
Beim Kauf geht nur die Urkunde per Brief raus, die 4 Honiggläser à 250 g
(2 Sommer, 2 Frühjahr) folgen im Okt/Nov in einem Paket — beides von Hand.
Deshalb ist der Patenschaft das Versandprofil entfernt
(`requires_shipping = false`, wie beim Gutschein): keine DHL-Versandart an
der Kasse, kein automatisches Label. Die Honigsendung im Herbst legt ihr
im Admin von Hand an. Gesetzt über `setup-sponsorship.ts`.
- [ ] **Schnupperkurs: neue Termine.** Der Termin 25.04.2026 ist entfernt,
buchbar ist nur noch der Kurs-Gutschein ("Neue Termine folgen in Kürze").
- [ ] **Honigseife Lavendel**: Sorte angelegt (3,50 €), aber ohne eigenes
Foto.
- [ ] **7 neue Partner ohne Koordinate**: Ahrens Hausverwaltung, BRUHN,
E-Center Schleswig, intersoft consulting, JUFA Hotels, P+R, Radkultur
Hamburg. Sie stehen in der Logo-Wand, aber nicht auf der Karte.
- [ ] **Alle 18 Partner-Koordinaten sind Platzhalter** (`src/lib/partners.ts`,
oben im Code mit ⚠️ markiert). Sie verteilen sich plausibel über Hamburger
Stadtteile, sagen aber nichts darüber aus, wo die Völker wirklich stehen.
Von 34 Partnern haben 18 überhaupt eine Koordinate — die übrigen 16
erscheinen nicht auf der Karte.
- [ ] **Abo-Preise sind Platzhalter**: 6,90 € / 10,90 €.
- [ ] **DHL-Versandoptionen sind Preis-Platzhalter.**
- [ ] Abo-Rabatt in Prozent ist im Admin unter „Honig-Abo" einstellbar — der
aktuelle Wert ist nie bewusst gesetzt worden.
---
## 4. Inhalte
- [x] ~~Business-Startseite~~ — steht jetzt im Wortlaut von place4bees.com
(„Geben Sie Bienen ein Zuhause", „Zum Hintergrund / Aktiver Bienenschutz",
„Erlebbares Nachhaltigkeitsengagement / Mittendrin statt nur dabei!",
Leitbild-Zitat unter „Was uns antreibt").
- [ ] Noch von mir formuliert und ohne Vorlage auf der Live-Seite:
Private-Startseite, `/business/angebot`, `/business/presse`.
- [ ] Auf place4bees.com stehen brauchbare Überschriften, die wir noch nicht
übernommen haben: `/philosophie` („Verantwortung. Regionalität.
Wertschätzung." / „Unsere Vision" / „Unsere Werte" / „Zusammenarbeit")
und `/ihr-projekt` („So funktioniert's", „Highlights / Leistungen").
Sagen Sie Bescheid, dann ziehe ich die nach.
- [ ] **Abschnitt „Versand und Verpackung"** — gewünscht als Band aus Text und
Foto (Vorbild: `image003.png`, Blick in den gepackten Karton), darunter
eine Icon-Reihe. Wartet auf drei Dinge von Björn: ein Foto der echten
Verpackung, die belastbare Lieferzeit (im Vorbild „2–4 Werktage") und die
Bestätigung, dass „ohne Plastikmüll" wirklich stimmt. Björn kümmert sich
um die Verpackung, gebaut wird erst danach.
- [ ] **Team-Fotos und -Namen** auf `/business/ueber-uns` stammen 1:1 von
place4bees.com. Die Zuordnung Foto → Person habe ich aus der
Reihenfolge im dortigen Quelltext abgeleitet — bitte einmal
gegenlesen, bevor es live geht. Es sind echte Personen.
---
## 5. Gestaltung — was am 3.9.2026 umgestellt wurde
Zur Information, hier ist nichts offen:
- **Bebas Neue** als Display-Schrift statt Oswald. Das ist die Schrift, die
place4bees.com tatsächlich benutzt (Avada-Typografie 1). Sie kennt nur
Versalien und nur einen Schnitt — h1/h2, Ziffern und die Wortmarke laufen
darüber, Karten-, Formular- und Rechtstextüberschriften bewusst nicht.
- **Neutrale Graustufen** (#ffffff / #f7f7f7 / #f2f3f5, Dunkel #212326) statt
der warmen Beigetöne. Ebenfalls die Werte der Live-Seite.
- **Video-Hero** auf `/business`, dieselbe Aufnahme vom Flugloch wie dort,
mit dem dreiteiligen Claim unten rechts. **1,3 MB mp4 / 1,8 MB webm** —
falls das zu schwer ist, sagen Sie Bescheid, dann bleibt nur das Standbild.
- **Echte Fotos** aus der Mediathek von place4bees.com auf allen Seiten. Die
bisherigen Platzhalterbilder liegen unter `frontend/_alt-bilder/` und
werden nicht mehr ausgeliefert.
- Die honiggelbe Leiste am rechten Rand jedes Abschnitts ist weg — die
Live-Seite hat sie nicht, und im Ergebnis sah sie wie ein Darstellungsfehler
aus.
## Entschieden
- **Kauf auf Rechnung: Versand von Hand** (26.10.2026). Bei Online-Zahlung
entsteht das Label automatisch, sobald Mollie bestätigt. Bei Rechnung
nicht: Die Bestellung wird im Admin von Hand verpackt ("Fulfill items"),
damit vor dem Versand ein Mensch draufschaut. Die Zahlung bucht ihr im
Admin ("Capture payment"), wenn die Überweisung da ist.
---
## 6. Aufräumen
- [ ] **Sendcloud-Modul ist noch in `medusa-config.ts` registriert** (Zeile ~114,
`src/modules/sendcloud-fulfillment/`), obwohl wir uns für die direkte
Carrier-Anbindung entschieden haben. Toter Code — nicht von mir gelöscht,
weil Sie das entscheiden.
- [ ] **Testdaten in der Datenbank**: Bestellung 15 samt Fulfillment und ein
Abo-Warenkorb stammen aus meinen Tests. Sollen die raus?
- [ ] Backend läuft auf **Port 9001**, nicht 9000 — auf 9000 sitzt php-fpm
(Herd). Falls irgendwo noch 9000 hinterlegt ist, geht das ins Leere.
---
## 7. Design, wenn Zeit ist
Kein Blocker, aber vom Design-Skill angemerkt:
- [ ] Dark Mode fehlt (gilt für Consumer-Seiten als Standard)
- [ ] Pfeil-Icons sind handgezeichnete SVGs statt einer Icon-Bibliothek
- [ ] Split-Header-Muster im Partner-Abschnitt
---
## Was fertig und getestet ist
Zur Abgrenzung — hier ist nichts mehr offen:
- Redesign über alle 21 Seiten, Scroll-Animationen, View Transitions
- Partnerkarte aus echten Geodaten (Projektion, Elbe, Stadtgrenzen)
- Automatisches Fulfillment nach Zahlungseingang (`payment.captured` → Fulfillment)
- Abo-Datenmodell inkl. Monatsarithmetik (31.01. → 28.02. geprüft)
- Abo als normales Shop-Produkt mit Größe × Intervall
- Rabatt über die Medusa-Promotion-Engine, im Admin einstellbar
- Selbstverwaltung: `/konto/abos` (pausieren, ändern, kündigen)
- Kündigung ohne Login nach § 312k: `/kuendigung` + Footer-Link
- Rückkehrseite `/bestellung/abo` nach Mollie-Zahlung