Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -0,0 +1,227 @@
|
||||
# BILL-25 · Egress-resiliente Speicherpreise und Traffic-Transparenz
|
||||
|
||||
| | |
|
||||
| ----------------- | ------------------------------------------------------ |
|
||||
| **Typ** | Produktentscheidung · Billing-/Storage-Launch-Härtung |
|
||||
| **Owner** | Raffael |
|
||||
| **Phase** | Pilot-Härtung |
|
||||
| **Cycle/Fenster** | gestartet 2026-08-03 |
|
||||
| **Status** | In Arbeit |
|
||||
| **Plane** | HIVEGRID-248 |
|
||||
|
||||
## Abhängigkeiten & Parallelität
|
||||
|
||||
- **Blocked by:** `BILL-24` liefert die drei neu kaufbaren Speicherstufen,
|
||||
stabile technische Codes und die Trennung zwischen Neu- und Bestandsvertrag.
|
||||
- **Blocks:** `BILL-08` darf den Production-Katalog erst nach grünem
|
||||
Staging-Katalog-, Checkout-, Invoice- und Journey-Proof nachziehen.
|
||||
- **Abhängigkeitsschutz:** Basispläne, Inklusivspeicher, Wachstum je
|
||||
Zusatznutzer, Add-on-Codes, historische Preise und bereits ausgestellte
|
||||
Rechnungen bleiben unverändert. Nur künftige Neukäufe erhalten die neue
|
||||
Katalogversion.
|
||||
|
||||
## Was / Warum
|
||||
|
||||
Die Preise aus `BILL-24` decken direkte Speicherkosten, aber nur ungefähr 3,7
|
||||
vollständige externe Auslieferungen des gebuchten Zusatzspeichers, bevor die
|
||||
Deckung negativ wird. Für den Piloten soll der Katalog konservativ fünf
|
||||
vollständige Auslieferungen pro Monat tragen, ohne tatsächliche Nutzung
|
||||
vorzutäuschen oder Kunden mit variablen Traffic-Nachberechnungen zu überraschen.
|
||||
|
||||
Der neue Vertrag verwendet weiterhin drei feste, monatliche Zusatzpools:
|
||||
|
||||
| Zusatzpool | Preis netto | Speicher-COGS | 4× Egress-COGS | Marge bei 4× | 5× Egress-COGS | Marge bei 5× |
|
||||
| ---------- | ----------: | -------------: | --------------: | ------------: | --------------: | ------------: |
|
||||
| +500 GB | 6,99 EUR | 3,36 EUR | 2,15 EUR | 21,2 % | 2,68 EUR | 13,5 % |
|
||||
| +1 TB | 12,99 EUR | 6,72 EUR | 4,29 EUR | 15,2 % | 5,37 EUR | 6,9 % |
|
||||
| +5 TB | 60,99 EUR | 33,61 EUR | 21,47 EUR | 9,7 % | 26,84 EUR | 0,9 % |
|
||||
|
||||
Die Kalkulation verwendet 6,26 EUR/TB-Monat zusätzliche Speicherkosten und
|
||||
1,00 EUR/TB externen Mehrtraffic. HiveGrid gewährt Quota in Einheiten von
|
||||
`1024^3` Bytes, Hetzner rechnet dagegen dezimale TB; der Nachweis verwendet
|
||||
deshalb die tatsächlich gewährten Bytes statt einer vereinfachten
|
||||
GB-durch-1000-Rechnung. Hetzners monatlich ungefähr 1 TB großer,
|
||||
accountweiter Egress-Freibetrag ist ein gemeinsamer Plattformpuffer und wird
|
||||
keinem Workspace oder Paket versprochen. Ohne Egress liegt die direkte
|
||||
Rohmarge bei 51,9 / 48,3 / 44,9 Prozent. Die kleinste Stufe überschreitet die
|
||||
angestrebte 50-Prozent-Marke minimal: 5,99 EUR wäre unter realen Binäreinheiten
|
||||
bei 5× Egress negativ, 6,99 EUR ist die kleinste freigegebene `,99`-Stufe.
|
||||
|
||||
Hetzners Abrechnungsminimum von 64 kB je gespeichertem Objekt ist kein weiterer
|
||||
pauschaler Egress-Zyklus und rechtfertigt ohne reale Objektverteilung keine
|
||||
zusätzliche Preiserhöhung. Es wird im Pilot separat als Differenz zwischen
|
||||
logischen HiveGrid-Bytes und providerseitig abgerechnetem Speicher überwacht;
|
||||
bei auffälliger Abweichung werden Objektmix, unvollständige Multipart-Uploads,
|
||||
Versionen und fremde Account-Buckets geprüft.
|
||||
|
||||
Traffic-Transparenz trennt drei Werte sauber:
|
||||
|
||||
1. **Provider-Istkosten:** accountweiter, extern abgerechneter Hetzner-Egress.
|
||||
2. **Autorisierter Traffic:** Anzahl und Objektgröße der von HiveGrid
|
||||
freigegebenen Downloads, aggregiert nach stabiler Produktoberfläche ohne
|
||||
Tenant-/Datei-Labels in Prometheus.
|
||||
3. **Workspace-Näherung:** nur für Support-/Kostenprüfung; keine automatische
|
||||
Rechnung und keine Behauptung, ein ausgestellter Signed Link sei tatsächlich
|
||||
vollständig geladen worden.
|
||||
|
||||
Der komplette Registrierungs-, Verifikations-, Aktivierungs-, Mollie-TEST-,
|
||||
Welcome-, Invoice- und Add-on-Pfad wird gegen Staging neu geprüft. Nur konkret
|
||||
reproduzierte Fehler innerhalb dieser Journey werden in diesem Ticket behoben;
|
||||
weitergehende Features bleiben eigene Change-Requests.
|
||||
|
||||
## Nicht im Scope
|
||||
|
||||
- Kein Traffic-Overage-Billing, keine nachträgliche Einzel-GB-Rechnung und kein
|
||||
„unlimited traffic“-Versprechen.
|
||||
- Kein Tenant als Prometheus-Label, keine Dateinamen/Objektschlüssel in Logs
|
||||
und keine Speicherung von Signed URLs.
|
||||
- Kein Proxy aller Downloads durch den Webprozess und keine neue CDN-, Server-
|
||||
oder Bucket-Infrastruktur in diesem Ticket.
|
||||
- Keine eigenen Zahlungsfelder, kein Mollie-Iframe und keine echte
|
||||
Production-Zahlung vor den zwei externen Gates aus `BILL-08`.
|
||||
- Keine Änderung an Basisplan-, Sitz-, E-Mail-Marketing- oder Portalpreisen.
|
||||
|
||||
## Definition of Done
|
||||
|
||||
- [x] Neu buchbare Speicherpakete kosten 6,99 / 12,99 / 60,99 EUR netto pro
|
||||
Monat; stabile Codes und historische Verträge bleiben auflösbar.
|
||||
- [x] Automatisierte Kalkulation verwendet die tatsächlich gewährten
|
||||
Binärbytes und beweist für jede kaufbare Stufe positive Deckung nach fünf
|
||||
vollständig kostenpflichtigen externen Auslieferungen der Paketkapazität.
|
||||
- [x] Autorisierte Downloadanzahl und bekannte Objektbytes sind auf den
|
||||
zentralen Auslieferungspfaden niedrig-kardinal, secretsicher und
|
||||
ausfallsicher messbar; Signed-URL- und Provider-Blindspots sind im
|
||||
Betriebsvertrag ausdrücklich benannt.
|
||||
- [ ] Registrierung, Verifikation, Aktivierung, Welcome-Setup, Billing-Hub,
|
||||
Rechnungszugriff und Add-on-Käufe wurden UX-, Security- und
|
||||
Zustands-seitig geprüft; reproduzierte Launch-Blocker sind mit Tests
|
||||
behoben oder als externer Blocker dokumentiert.
|
||||
- [x] Typecheck, Lint, vollständige Testsuite sowie Billing-, Source-, i18n-,
|
||||
Security-, ticketbezogene A11y-, Hot-Swap- und Visual-Verifier sind
|
||||
grün; atomare Commits und geprüfte Screenshots liegen vor. Der gegenüber
|
||||
`main` unveränderte globale `no-autofocus`-Baseline-Drift ist als
|
||||
bestehender Repository-Nachzug ausgewiesen und nicht still hochgesetzt.
|
||||
- [ ] PR-CI, normaler Merge, kontrollierter Staging-Katalog-Sync, Deploy und
|
||||
ein ausschließlich mit Mollie TEST ausgeführter End-to-End-UAT sind grün.
|
||||
- [ ] Production erhält erst danach exakt dieselbe geprüfte Katalogversion und
|
||||
Invoice-Konfiguration; Provider-Side-Effects und echte Zahlungen bleiben
|
||||
bis `BILL-08` fail-closed.
|
||||
|
||||
**BILL-25: 4/7 DoD = ~57 % done. Offen: 3 Punkte; davon Production-Sync
|
||||
zusätzlich durch die externen `BILL-08`-Gates begrenzt.**
|
||||
|
||||
## Technische Bausteine
|
||||
|
||||
- `packages/entitlements/src/commercial-catalog.ts`
|
||||
- `packages/metrics` und die bestehenden service-scoped Registries
|
||||
- autorisierte Download-Routen und `mediaSigning.server.ts`
|
||||
- `scripts/billing-catalog`
|
||||
- Registrierungs-, Welcome-, Billing-, Invoice- und Add-on-Flows aus
|
||||
`BILL-14`, `BILL-19`, `BILL-20` und `BILL-22`
|
||||
- `docs/ops/lago-staging.md`, `docs/ops/lago-production-prep.md` und ein
|
||||
redaktierter Storage-Traffic-Betriebsvertrag
|
||||
|
||||
## Rollback
|
||||
|
||||
- Katalog und UI können gemeinsam auf Version `2026-08-03.1` zurückgesetzt
|
||||
werden. Bereits ausgestellte Rechnungen, Zahlungen und historische
|
||||
Providerobjekte werden nie gelöscht oder umgeschrieben.
|
||||
- Die neuen Metriken sind rein beobachtend. Ihr Ausfall darf keinen Download
|
||||
blockieren; ein Rollback entfernt nur die Beobachtung, nicht Auth-, RLS-,
|
||||
Scan- oder Signed-URL-Gates.
|
||||
- Production wird ausschließlich nach erfolgreichem Staging-Proof und über den
|
||||
kontrollierten idempotenten Katalog-Sync verändert. Der Zahlungs-Side-Effect-
|
||||
Gate bleibt unverändert geschlossen.
|
||||
|
||||
## Quellen
|
||||
|
||||
- `docs/CHANGE-REQUESTS.md` · CR-025
|
||||
- `.planning/ticket-docs/BILL-08.md`
|
||||
- `.planning/ticket-docs/BILL-22.md`
|
||||
- `.planning/ticket-docs/BILL-24.md`
|
||||
- https://www.hetzner.com/storage/object-storage/
|
||||
- https://docs.hetzner.com/storage/object-storage/overview/
|
||||
|
||||
## Umsetzungs-Notiz
|
||||
|
||||
2026-08-03 · gestartet
|
||||
|
||||
- Explizite Produktfreigabe im Chat: Preise nur so weit anheben, dass vier bis
|
||||
fünf vollständige externe Auslieferungen wirtschaftlich enthalten sind;
|
||||
Storage-Traffic sauber beobachtbar machen und den gesamten Billing-/Signup-
|
||||
Pfad erneut gegen Staging prüfen.
|
||||
- Korrektur nach Cross-Layer-Audit: HiveGrid-Quota nutzt `1024^3` Bytes pro GB,
|
||||
Hetzner rechnet dezimale TB. Die zunächst vereinfachte Kalkulation war damit
|
||||
bei 5× Egress leicht negativ. Der kleinste nötige `,99`-Nachzug ist 500 GB
|
||||
für 6,99 EUR, 1 TB für 12,99 EUR und 5 TB für 60,99 EUR netto pro Monat. Bei
|
||||
vollständig kostenpflichtigem 5×-Egress verbleiben 0,94 / 0,90 / 0,54 EUR
|
||||
positive Deckung.
|
||||
- Plane-Identität als `raffael@tool-ctrl.de` bestätigt; `HIVEGRID-248`
|
||||
angelegt, Raffael zugewiesen und auf In Progress gesetzt.
|
||||
- Isolierter Worktree auf `origin/main` (`b1f14d63e`). Workspace-Shape und
|
||||
EU-Provider-Guard sind sauber; Typecheck und vollständige Baseline mit 1.194
|
||||
Testdateien / 8.324 Tests grün (60 bewusst übersprungen).
|
||||
- Katalogversion `2026-08-03.3` ist implementiert. Automatisierte Tests pinnen
|
||||
Preis, unveränderte Codes, Bestandsauflösung, Rohmargen-Obergrenze und
|
||||
positive Deckung nach fünf vollen externen Auslieferungen.
|
||||
- Niedrig-kardinale Prometheus-Zähler erfassen autorisierte Downloads und nur
|
||||
serverseitig bekannte Objektbytes auf Core-, Vorschau-, Thumbnail- und
|
||||
Portalpfaden. Der Betriebsvertrag dokumentiert ausdrücklich: Das ist keine
|
||||
Provider-Egress-Messung; Hetzner-Istkosten werden accountweit manuell
|
||||
abgeglichen und führen nicht automatisch zu Kundenabrechnungen.
|
||||
- Das 64-kB-Abrechnungsminimum pro Hetzner-Objekt ist als eigener
|
||||
Speicherkosten-Blindspot aufgenommen. Es verändert die freigegebenen Preise
|
||||
ohne belastbare Objektverteilung nicht, wird im Pilot aber gegen die logischen
|
||||
HiveGrid-Bytes abgeglichen.
|
||||
- Journey-Härtung in atomaren Commits: Passwortregeln werden vor Submit
|
||||
validiert; die Billing-Präferenz wird atomar im Tenant-Bootstrap gebunden;
|
||||
die Aktivierung berechnet Tarifempfehlung und Preise serverseitig live neu;
|
||||
fehlgeschlagene Checkout-Aktionen entsperren die UI; Mollie-Zustände
|
||||
`open`/`pending`/`authorized` bleiben in Verarbeitung, während
|
||||
`cancelled`/`failed`/`expired` statt einer nutzlosen Status-Neuprüfung einen
|
||||
frischen Checkout starten; nur `paid` aktiviert Entitlements. Invoice-Listen
|
||||
paginieren vollständig und prüfen Downloads
|
||||
unabhängig von der ersten Seite. Welcome- und Registrierungstexte
|
||||
versprechen weder Direkt-Checkout noch Freischaltung vor bestätigter
|
||||
Zahlung; der Dashboard-Einstieg bleibt eine bewusste Aktion.
|
||||
- Read-only Staging-Audit vor Deploy: Katalog-Diff enthält exakt 16 erwartete
|
||||
Updates und keine Creates/Deletes; Invoice-Entity ist eindeutig und auf
|
||||
EUR/de, 14 Tage, Europe/Berlin, Per-Customer-Nummerierung sowie vorhandene
|
||||
Rechts-/Steuer-/Absenderdaten konfiguriert. Ein finalisiertes Testdokument
|
||||
war als PDF abrufbar. Mollie verwendet ausschließlich TEST, aber das Profil
|
||||
ist providerseitig `unverified`; deshalb bietet Mollie derzeit nur iDEAL und
|
||||
keine Karte/Recurring-Methode an. Das bleibt ein externer `BILL-08`-Blocker.
|
||||
- Read-only Registrierungs-Baseline gegen Staging grün: Account-, Team-,
|
||||
Swarm-Empfehlungs-, Core-Override- und Zurück-Navigation-Screenshots liegen
|
||||
vollständig geladen und visuell geprüft unter
|
||||
`~/Desktop/HiveGrid-BILL-25-Billing-Journey-2026-08-03/00-staging-before-deploy`.
|
||||
- Provider- und Nebenläufigkeits-Härtung aus dem finalen Cross-Layer-Audit:
|
||||
Basis-, E-Mail- und Portal-Checkouts werden tenantweit serialisiert und
|
||||
berücksichtigen bereits reservierte Erwerbungen bei der kombinierten
|
||||
Zahlungsmethoden-Policy. Wiederholte Tabs teilen ihre persistierte
|
||||
Checkout-Identität. Preis- oder Provider-Drift bricht fail-closed ab.
|
||||
Kündigungen sind nur noch für aktive wiederkehrende Add-ons mit exakt
|
||||
gebundener Lago-Subscription möglich; lokale Entitlements werden nie vor
|
||||
bestätigter Provider-Kündigung entfernt.
|
||||
- Quota-Härtung deckt neben Browser-Uploads auch KWP, öffentliche Formulare,
|
||||
E-Mail-Anhänge, Plantafel-Annahmen und Signatur-PDFs ab. Reservierungen
|
||||
erfolgen zentral pro Tenant. Schlägt das Löschen eines hochgeladenen
|
||||
Objekts fehl, bleibt die DB-Zeile quota-wirksam, statt das noch vorhandene
|
||||
Objekt unsichtbar aus der Abrechnung zu entfernen.
|
||||
- Lokaler Pre-Push-Proof nach allen Änderungen: `pnpm typecheck`, `pnpm lint`
|
||||
und `pnpm test` grün mit 1.202 Testdateien / 8.508 Tests (60 bewusst
|
||||
übersprungen). Zusätzlich grün: Billing-/Storage-Boundaries,
|
||||
Katalogverträge, i18n, Source-Health, CI-Baseline, Onboarding-Flow,
|
||||
Staging-UAT-Readiness, Hot-Swap, statische Visual-Baseline, 45
|
||||
Accessibility-Komponententests, Prisma-Validation, Migration-Parität und
|
||||
alle acht Live-RLS-Phasen einschließlich Portal und Tenant-Bootstrap.
|
||||
`verify:a11y-baseline` meldet auf Branch und `main` denselben bestehenden
|
||||
Stand von 70 `no-autofocus`-Fundstellen bei einer veralteten Baseline von
|
||||
56; diese Branch erhöht die Fundstellenzahl nicht und weitet die Baseline
|
||||
nicht auf.
|
||||
- Vor dem Push liegen 64 fachlich getrennte Commits vor. Der EU-Provider-Guard
|
||||
ist leer; Secrets- und Pre-Commit-Gates sind grün.
|
||||
|
||||
**BILL-25: 4/7 DoD = ~57 % done. Offen: vollständiger Post-Deploy-UAT,
|
||||
PR/CI/Merge/Deploy/Staging-Sync und der durch `BILL-08` gegatete
|
||||
Production-Abgleich.**
|
||||
Reference in new issue
Block a user