Files
place4bees.com/TODO.md
T
torbinus 794322d346 Online bezahlen an der Kasse, Storno- und Erstattungsmails
Normale Bestellungen gingen bisher nur auf Rechnung. Jetzt gibt es
"Online bezahlen" über Mollie (Karte, Sofortüberweisung, Überweisung),
gebaut wie die Abo-Kasse: Die Kasse legt die Zahlung an, der Webhook
schließt den Warenkorb ab, sobald Mollie bestätigt. Die Rückkehrseite
/bestellung/zahlung wartet darauf und leitet zur Dankeseite — oder sagt
bei Abbruch, dass nichts abgebucht wurde und der Warenkorb noch da ist.

Abschluss für Abo und Bestellung gemeinsam in lib/mollie-bestellung.ts,
neu mit Betragsprüfung: Passt der bezahlte Betrag nicht mehr zum
Warenkorb, wird nichts abgeschlossen.

Erstattungen: Die Mollie-Zahlung steht an der Bestellung. Erstattung im
Admin und Storno (dort ohne payment.refunded) gleichen mit Mollie ab und
buchen nur die Differenz zurück — gerechnet über amountRemaining, weil
amountRefunded eine frische Erstattung noch nicht zeigt.

Neue Mails: Storno, Erstattung, Abo-Abbuchung fehlgeschlagen, Abo
pausiert. Scheitert eine Abo-Abbuchung, wird die unbezahlte Lieferung
storniert, in drei Tagen neu versucht und nach drei Fehlversuchen
pausiert.

Im Testmodus durchgespielt: Kauf mit Karte (Bestellung, Label, Mails),
Abbruch, Teilerstattung 2,80 € im Admin, Storno mit Resterstattung
5,49 €, gescheiterte Folgezahlung nachgestellt.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-26 11:51:34 +01:00

9.1 KiB
Raw Blame History

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

  • § 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

  • 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.
  • 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.
  • Bienenpatenschaft: Was geht beim Kauf raus? Rückfrage läuft (Stand 26.10.2026). Der Honig kommt laut Beschreibung erst im Oktober/November. Wird beim Kauf nichts per DHL verschickt (Urkunde per Brief oder Mail), darf für die Patenschaft kein Label entstehen. Geht ein Paket raus, braucht die Variante ein Versandgewicht.
  • 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

  • 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.

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