# Bauauftrag: Stellplatz-Logik im Riccardo Partnerportal

Stand 29.09.2026. Entschieden vom Kopf (Master-Session) auf Franciscos Delegation
(„Mach wie du für richtig hältst"). Von Riccardo noch nicht bestätigt – alle
Werte sind als Parameter im Admin änderbar, nichts wird fest verdrahtet.

## 1. Kostenbasis

Vollkostensatz je SKU-Platz und Monat je Filiale aus PYLAX
(`parameter/filialkosten.yaml`, PARAM-FILIALKOSTEN-2026-V1.0 vom 24.07.2026,
Basis `Sortiment_Optimierung_3.xlsx`, Blatt „Store-Kosten & Kapazität",
Vollkosten Miete + Personal + IT, Durchschnitt Januar–Juni 2026, Umlage auf die
vorhandenen Plätze).

- Ins Portal als eigene Parametertabelle „Filialplätze", jede Zeile mit Quelle
  und Stand-Datum. **Kein Live-Zugriff auf Pylax.**
- Globaler Korrekturfaktor, Standard 1,00. Hinweis im Admin: Die Pylax-Nachtschicht
  hält den Satz für rund 25 % zu hoch, 0,75 ist die mögliche Alternative.
- Zeitbasis: Monat. Woche = Monat × 12 / 52. Tag = Monat / 30,44 (Pylax-Konvention).
- Gesamtsatz = Filialsatz × Korrekturfaktor × Lagefaktor.

| kWarenlager (Offline-Wawi) | Filiale | SKU-Plätze | € je Platz und Monat |
|---|---|---|---|
| 2 | Berlin Alexa | 1301 | 9,07 |
| 3 | Bonn Sternstr. | 1755 | 5,70 |
| 4 | Erfurt Hauptbahnhof | 1250 | 11,77 |
| 5 | Essen Limbecker Platz | 1300 | 7,97 |
| 6 | Flensburg Citti Park | 1670 | 8,19 |
| 7 | Frankfurt MTZ | 2052 | 7,43 |
| 8 | Frankfurt NWZ | 2200 | 5,06 |
| 9 | Freudenstadt Loßburger Str. | 1870 | 3,25 |
| 10 | Halle Leipziger Str. | 1631 | 6,03 |
| 11 | Hannover Karmarschstr. | 1745 | 10,20 |
| 12 | Kiel Citti Park | 1780 | 6,27 |
| 13 | Leipzig Promenaden | 1299 | 7,74 |
| 14 | Kiel Holstenstr. | 1940 | 5,10 |
| 15 | Lübeck Citti Park | 1970 | 6,65 |
| 16 | Dortmund Westenhellweg | 2270 | 4,08 |
| 17 | Leipzig Paunsdorf | 1647 | 9,18 |
| 18 | Lübeck Holstenstr. | 2752 | 4,12 |
| 19 | Ludwigsburg Pflugfelder Str. | 2269 | 4,57 |
| 20 | Mönchengladbach Minto | 1700 | 8,02 |
| 21 | Neubrandenburg | 2082 | 3,27 |
| 22 | Nordenstadt | 1971 | 4,08 |
| 23 | Pforzheim | 1410 | 5,92 |
| 24 | Rostock Kröpeliner Str. | 1507 | 8,70 |
| 25 | Rostock Ostseepark | 1466 | 7,42 |
| 26 | Stuttgart Marienstr. | 1910 | 5,04 |
| 27 | Worms | 2152 | 4,08 |

Summe: 46.899 Plätze, 290.200 € je Monat, Mittel 6,19 € je Platz und Monat.
Lokale Kopie der Quelle: `C:\Claude\Pylax\PYLAX-Filialplaetze-Platzkosten-2026-09-07.xlsx`.

## 2. Lage A bis D

In keinem System gibt es eine Lagen-Zuordnung von Plätzen. Lage wird als
Zuschlagsfaktor auf den Filialsatz abgebildet, im Admin editierbar.

| Lage | Faktor | Beschreibung (Vorschlag, im Admin änderbar) |
|---|---|---|
| A | 1,50 | Kassenzone / Augenhöhe |
| B | 1,20 | Hauptgang |
| C | 1,00 | Regal Standard |
| D | 0,80 | Randfläche / unten |

Kennzeichnung im Admin: „Vorgabe Master 29.09.2026, von Riccardo noch zu bestätigen".

## 3. Mindestrendite und Gebührenlogik je Partnerartikel und Filiale

- Erwarteter Rohertrag je Monat = (VK netto − EK netto) × geplante Absatzmenge je
  Monat. Der Partner gibt die Absatzerwartung an, Riccardo kann sie überschreiben.
- Sollrendite = 11 % vom erwarteten Nettoumsatz + 8 % p. a. Kapitalzins auf den
  durchschnittlichen Bestandswert zu EK (beides Pylax-Zielwerte aus
  `filialkosten.yaml`, als Parameter im Admin).
- Platzkosten = Gesamtsatz × belegte Plätze (Standard 1 Platz je SKU) × Monate.
- Fehlbetrag = Platzkosten + Sollrendite − erwarteter Rohertrag.
  - Fehlbetrag > 0: Vorschlag als Listungsgebühr oder Werbekostenzuschuss.
    Riccardo entscheidet die Aufteilung.
  - Fehlbetrag ≤ 0: Listung ohne Gebühr möglich.
- Die Rechnung mit allen Zwischenwerten ist im Admin sichtbar. Der Partner sieht nur
  Gebühr, Zeitraum, Filialen und Lage – niemals Riccardos interne Kostensätze,
  Renditeziele oder Einkaufspreise anderer Partner.

## 4. Pflegehoheit

Pylax (Konferenz-PC, Stephan Endler) bleibt führend für die Filialkosten. Das Portal
hält Kopien mit Stand-Datum. Der Portal-Admin darf Werte überschreiben; jede Änderung
mit Datum, Benutzer und altem Wert im Ereignisprotokoll. Hinweis im Admin:
„Stand der Filialkosten: <Datum> – Abgleich mit Pylax alle 6 Monate".

## Weitere Regeln

- Vertraulichkeit wie bisher: Hersteller sehen keine Einkaufspreise.
- Keine JTL-Schreibzugriffe, der Testmodus bleibt bis zur Freigabe durch Francisco.
- Deploy nach dem bekannten Weg (tar, `npm ci --omit=dev`, `systemctl restart partnerportal`).
- Ende-zu-Ende-Test auf dev-partner.riccardozigarette.com mit einem Beispiel
  (z. B. Extrade-Artikel, 3 Filialen, Lage B, 3 Monate); die Zwischenwerte der
  Rechnung in der Rückmeldung an Master zeigen.

## Danach (Plan)

1. Pilot mit Extrade (Händlerkonto, echte Produkte durch den kompletten Ablauf).
2. JTL-Anlage freigeben (Francisco), Feldzuordnung gegen die Wawi-Version prüfen.
3. Go-live: echte Domain, Demo-Konten raus, noindex weg, echte Partnerlogins,
   Datenschutzhinweis für Lieferantendaten.

Weitere Lesequellen für spätere Verfeinerung: reine Miete je qm in Pylax
`parameter/filialakten.yaml` (Mietliste „Riccardo stores 7 2024", Stand 24.10.2024);
gebuchte Raumkosten je Filiale im Veniri-Cockpit (`veniri-bab.js`, DATEV-BAB Zeile 1120,
21 Monate je Kostenstelle).