diff --git a/docs/architektur/16_MVP_Slice.md b/docs/architektur/16_MVP_Slice.md index ccc64b1..28d0b97 100644 --- a/docs/architektur/16_MVP_Slice.md +++ b/docs/architektur/16_MVP_Slice.md @@ -1,5 +1,7 @@ # 16 – Zusätzlicher erster marktfähiger Schnitt (MVP-Slice) +> **Aktualisierung 20.11.2026 – Warenkorb:** Der Auftraggeber hat für den neuen Shopausbau ausdrücklich einen Warenkorb mit mehreren Angeboten angefordert. Der Warenkorb-Ausschluss in §3.3 ist damit für diesen Folgeauftrag aufgehoben; er bleibt unten nur als historischer Umfang des ersten Schnitts nachvollziehbar. Siehe [FACH-59 und Shopentscheidung](../ux/verwaltung/04-fachliche-anforderungen.md). Bestehende Lizenz- und Bestellregeln werden dadurch nicht ersetzt. + **Phase D, Schritt 17.** Dieser Schnitt ist eine **Planungsansicht der Zielarchitektur**, keine Begrenzung des Zielbilds (SCOPE-001, SCOPE-002). Er entspricht Stufe A1 der Roadmap. Alles, was hier fehlt, hat seinen Platz in `15`, Abschnitt 5. **Nach der Challenger-Prüfung geändert** (`13`, Abschnitte 8 und 9): Der Schnitt verkauft ausschließlich an **Einzelpersonen**; die frühere „Überbrückung“ von Organisationslizenzen durch persönliche Vergaben ist gestrichen (ID-004, Befund CH-24). Das Fundament enthält zusätzlich Erwerb, Gegenstandsprüfung, getrennte Rechte je Prozess und die Sicherungsbasis. Die Updatepolitik ist keine offene Startentscheidung mehr. diff --git a/docs/ux/verwaltung/04-fachliche-anforderungen.md b/docs/ux/verwaltung/04-fachliche-anforderungen.md index 9014747..72d366a 100644 --- a/docs/ux/verwaltung/04-fachliche-anforderungen.md +++ b/docs/ux/verwaltung/04-fachliche-anforderungen.md @@ -67,6 +67,10 @@ ## Kontext und Anforderungen | FACH-53 | Informationen eines Fachobjekts für CMS-Bausteine stammen gegebenenfalls aus dem gemeinsamen Redaktionsmanager | Vom Auftraggeber ausdrücklich hervorgehoben; ergänzt FACH-43/44 | Fachobjektgebundene Bausteine referenzieren zentrale Daten; lokale Abweichungen bewusst kennzeichnen. Reine Seitenbausteine dürfen eigene Seiteninhalte besitzen; keine obligatorische neue Produktquelle für jeden Text | | FACH-54 | Die gesamte Webpräsenz mit Seitenreihenfolge, Menüs, versteckten Seiten und übergreifenden Einstellungen verwalten | Vom Auftraggeber als bisher fehlende UX-Ebene ausdrücklich benannt | Gemeinsamer Arbeitsplatz oberhalb des einzelnen Seiteneditors. Vorhandene Seiten- und Navigationsverwaltung zusammenführen; genaue Aufteilung und visuelle Referenz bleiben Entwurf | | FACH-55 | Veröffentlichungszustand einer Seite und Eigenschaften ihrer Menüeinträge sind unabhängig | Dokumentierter und rein lesend geprüfter Bestand | Menübeschriftung, Bereich, Reihenfolge, Unterpunkte und Sichtbarkeit nicht mit Seiteninhalt, Seitenveröffentlichung oder Suchmaschinenauffindbarkeit gleichsetzen. Eine Seite kann in mehreren oder keinem Menü vorkommen | +| FACH-56 | Fachliche Materialarten, Altersbereich/Zielgruppen, Einsatzbereiche und redaktionelle Verwendungszwecke zentral selbst pflegen | Bedarf vom Auftraggeber am 20.11.2026 ausdrücklich bestätigt | Gemeinsame Stammdatenpflege; bestehende Tabellen und Beziehungen wiederverwenden. Fachliche Säulen behalten ihre vorhandene Pflege und werden nicht dupliziert. Keine Codeänderung für jeden neuen redaktionellen Auswahlwert verlangen | +| FACH-57 | Auswahlwerte entsprechend ihrem fachlich zulässigen Objektkontext anbieten | Bedarf aus Gespräch vom 20.11.2026; konkrete Zuordnungsregeln am Bestand abzugleichen | Ungefilterten Gesamtkatalog nicht überall anbieten. Medienfilter, Medieneditor und Picker verwenden dieselbe kontextgerechte Auswahl; Objektarten wie Modul/Programm nicht als Materialart eines Mediums anbieten | +| FACH-58 | Einheitliche Begriffe und dieselben Stammdaten in Bearbeitung, Filtern und Picker verwenden | Zusammenhang im lokalen Code geprüft; UX-Benennung inkonsistent | Das derzeit als „Inhaltsart“ beschriftete Feld und der Filter „Fachliche Materialart“ referenzieren editorial_content_kind_id. Durchgängige Bezeichnung „Fachliche Materialart“; technische Art, Präsentationsrolle, tatsächliche Verwendung und Rechte davon unterscheiden | +| FACH-59 | Warenkorb mit mehreren Angeboten in den neuen Shopumfang aufnehmen | Vom Auftraggeber am 20.11.2026 ausdrücklich gegenüber der früheren Planung geändert | Der frühere Ausschluss in 16_MVP_Slice §3.3 gilt nicht für den neuen Shopauftrag. Mehrere ausgewählte Angebote vor dem Kauf gemeinsam prüfen und bestellen können; je Bestellposition Angebotsfassung, Preis/Konditionen und aufgelösten Lizenzumfang erhalten. Keine neue Produkt- oder Lizenzhierarchie daraus ableiten | ## Bewusst offene Entscheidungen @@ -98,6 +102,46 @@ ## Bewusst offene Entscheidungen | OFF-24 | Welche konkrete Wirkung sollen „versteckte Seiten“ erhalten? | Menüausblendung, Seite ohne öffentliche Revision und Suchmaschinenauffindbarkeit sind zu unterscheiden. Die vorhandenen Zustände verständlich anbieten; keine unscharfe neue Gesamtfreigabe oder vermeintlichen Zugriffsschutz erfinden | | OFF-25 | Welche übergreifenden Website-Einstellungen gehören tatsächlich in den neuen Arbeitsplatz? | Kopf-/Fußnavigation ist vorhanden; freie Startseitenzuweisung, globale Abschnitte, gemeinsame Darstellungs- und weitere Grundeinstellungen sind nicht durch den Namen eines Konfigurators als umgesetzt oder beschlossen anzunehmen | +## Ergänzung 20.11.2026 – redaktionelle Stammdatenpflege + +Der Auftraggeber benötigt zusätzlich zur vorhandenen Säulenpflege eine zentrale Pflege der redaktionellen Auswahlwerte. Gemeint sind die im Redaktionsmanager sichtbaren fachlichen Materialarten, Altersbereiche/Zielgruppen, Einsatzbereiche und redaktionellen Verwendungszwecke. Dies ergänzt den ursprünglichen Umbau; dieser Dokumentationsschritt ändert keine Anwendung und startet keinen parallelen Coding-Auftrag. + +### Rein lesend geprüfte Grundlage + +`EditorialContentKind::selectOptions()` liest den gemeinsamen Begriffskatalog aus der Datenbank. `EditorialDimension` und `EditorialDimensionValue` speichern die weiteren Gruppen und deren Werte ebenfalls in Tabellen. Die initialen Werte sind durch Migrationen vorbelegt. In den geprüften Filament-Ressourcen wurde keine eigene Pflegeoberfläche dafür gefunden; das ist kein Nachweis über den vollständigen Stand einer gegebenenfalls inzwischen ausgelieferten Instanz. + +Das bestehende Modell unterscheidet bereits Objektkontexte, etwa Säulen am Medium gegenüber der Säulen-Dimension anderer Objekte. Diese Unterscheidung und technische Kennungen nicht durch freies Umbenennen oder Löschen beschädigen. Eine UI-Pflege ist keine Erlaubnis, Rechte, Fassungszustände oder die technische Ausgabeart frei neu zu definieren. + +### Vorgeschlagene Bedienung für den Folgeauftrag + +Ein gemeinsamer Arbeitsplatz „Redaktionelle Stammdaten“, gegliedert nach Materialarten, Zielgruppen/Altersbereich, Einsatzbereichen und Verwendungszwecken. Fachliche Säulen aus ihrer bestehenden Pflege verlinken beziehungsweise diese gemeinsam einordnen; keinen zweiten Säulenkatalog anlegen. + +Pro Gruppe Werte suchen, ergänzen, deren sichtbare Bezeichnung bearbeiten und Reihenfolge pflegen. Verwendungen beziehungsweise Anzahl der Zuordnungen sichtbar machen. Nicht mehr benötigte Werte für neue Zuordnungen deaktivieren können, während bestehende Zuordnungen erkennbar erhalten bleiben. Benutzte Werte nicht still löschen oder einem anderen Begriff zuordnen. Zusammenführen oder vollständiges Entfernen ist kein automatisch beauftragter Bereinigungslauf. + +Bei Materialarten den zulässigen Objektkontext berücksichtigen; dieselbe Einschränkung in Editor, Filter und Picker anwenden. Die Stammdatenpflege zeigt den vollständigen Katalog des jeweiligen Kontexts. Filter können darüber hinaus die im Bestand vorkommenden Werte und Trefferzahlen anbieten; ein aktiver Filter bleibt auch bei null Treffern sichtbar. Diese bestandsabhängige Filterdarstellung ist ein UX-Vorschlag und ersetzt keine Zulässigkeitsprüfung. + +Die vorhandenen Werte bleiben Ausgangsbestand. Keine zusätzlichen Pflichtklassifikationen, automatische Neuzuordnungen, neue Freigaben oder frei konfigurierbare Fachobjektmodelle aus dieser Ergänzung ableiten. Präsentationsrollen sind verwendungsbezogene Angaben mit bestehenden Funktionsregeln und werden nicht ungeprüft in dieselbe frei erweiterbare Werteliste aufgenommen. + +### Prüffälle für die spätere Umsetzung + +1. Einen neuen Zielgruppenwert anlegen und im Redaktionsmanager anbieten; nach Zuordnung ist das Medium darüber auffindbar. +2. Einen sichtbaren Begriff umbenennen; bestehende Zuordnungen bleiben am selben Wert und neue Bezeichnung wird konsistent dargestellt. +3. Einen verwendeten Wert deaktivieren; bestehende Zuordnungen bleiben erkennbar, neue Zuordnung wird nicht versehentlich angeboten. +4. Medieneditor, Medienfilter und Picker zeigen dieselben zulässigen Materialarten; Modul/Programm werden nicht als Materialart eines Mediums angeboten. +5. Säulenpflege bleibt erhalten; keine doppelte Themenzuordnung und keine neue Rechte- oder Fassungswirkung. + +Die Stammdatenpflege ist eine neue bestätigte Anforderung, keine bereits implementierte oder abgenommene Funktion. Die genannten Bedienmöglichkeiten konkretisieren den Bedarf als Folgeauftrag; technisch erforderliche Anpassungen sind unter den bestehenden Repository- und Migrationsregeln umzusetzen. + +## Shopentscheidung 20.11.2026 – Warenkorb jetzt erforderlich + +Der Auftraggeber bestätigt, dass ein Warenkorb in der ursprünglichen Planung bewusst ausgeschlossen war, ihn für den nun anstehenden Shopausbau jedoch ausdrücklich benötigt. Das ist eine neue Umfangsentscheidung und keine rückwirkend behauptete alte Anforderung oder ein bloß unentdeckter Implementierungsfehler. + +Die Vereinfachung „Kein Warenkorb mit mehreren Angeboten, sondern Kauf je Angebot“ aus [MVP-Slice §3.3](../../architektur/16_MVP_Slice.md) ist für den neuen Shopauftrag damit aufgehoben. Alte Website-/Strategiehinweise, die darauf verweisen, beschreiben den früheren Planungsstand und dürfen den neuen Warenkorb nicht verhindern. + +Der Warenkorb führt mehrere ausgewählte bestehende Angebote in einen gemeinsamen Bestellabschluss. Die vorhandene Trennung von Inhalt, Lizenzartikel, Paket, Angebot, Bestellung und Erwerb bleibt erhalten. Jede Bestellposition hält ihren vereinbarten Umfang und ihre Konditionen nachvollziehbar fest; Zahlungsverarbeitung, Rechtevergabe und Rückabwicklung müssen alle Positionen korrekt behandeln. Dies beauftragt keinen frei konfigurierbaren Kunden-Paketbaukasten und keine automatische Verrechnung überlappender Rechte. + +Detailregeln zu zulässigen Mengen, Persistenz, Zusammenführung bei Anmeldung, Preisänderungen und Rabattkombinationen werden im Shopauftrag konkretisiert. Sie sind durch die bloße Warenkorbentscheidung noch nicht sämtlich beschlossen. Die grundsätzliche Entscheidung für einen Warenkorb muss nicht erneut zur Abstimmung gestellt werden. + ## Gegenprüfung mit vorhandenen Projektquellen | Quelle | Bereits dokumentierte Aussage | Umgang damit | diff --git a/docs/ux/verwaltung/paket-manifest.json b/docs/ux/verwaltung/paket-manifest.json index 80f5265..d0ada08 100644 --- a/docs/ux/verwaltung/paket-manifest.json +++ b/docs/ux/verwaltung/paket-manifest.json @@ -1,7 +1,7 @@ { - "date": "2026-11-19", + "date": "2026-11-20", "target": "C:\\Dev\\Lara-und-felix.de\\docs\\ux\\verwaltung", - "status": "Agreed administrative design consolidated as binding execution standard with ready coding-agent brief; historical draft start barriers superseded; business questions retained; no application changes or agent started", + "status": "Explicit user decision adds multi-offer basket to new shop scope, superseding historical MVP exclusion; master-data requirements preserved; no application changes", "files": [ { "path": "02-designentscheidungen.md", @@ -10,13 +10,13 @@ }, { "path": "03-auswahl-und-zuordnung-entwurf.md", - "bytes": 13031, - "sha256": "01afc98a377f83590471b8ff09a1f6de12a64bbf58875fd8b5387db1526580da" + "bytes": 12882, + "sha256": "557cf2c50370497fc4b44ab2273cc56f60c91e37c196bff0b59485411029caf7" }, { "path": "04-fachliche-anforderungen.md", - "bytes": 30110, - "sha256": "3ed79a485e93810d661965b5e885db52a10744096b8bc16f98540e16491daa3b" + "bytes": 37524, + "sha256": "80ba12e6878c289b384400478c79d20554a0ee5e1f5033bc6e3912a2b31e8502" }, { "path": "05-coder-uebergabe-arbeitsstand.md", @@ -73,10 +73,20 @@ "bytes": 7052, "sha256": "d75cf9babc34c7c57f4158c2a6e6dcaeeaa76760f1ca8690607ebc9f1c326a36" }, + { + "path": "16-funktionszuordnung.md", + "bytes": 11858, + "sha256": "73344806771b72c12531eaf9e38cffd12ac0a54e0a32fcdadf9ce72daea8ab62" + }, { "path": "README.md", - "bytes": 15404, - "sha256": "dddaa8dfa5da2f2717191e681cca72d28254f46d1445fcbe8e57f959185a4ce1" + "bytes": 15316, + "sha256": "8bd352eaddb938cc96f18e61108a9fd0a74d36bf50a5cf0890bb7906870b1208" + }, + { + "path": "abnahme/teil-a.md", + "bytes": 27975, + "sha256": "f0375f38e1d73f0db74d25eadf5ac1d89ad89d27cd55e46c1d8ca48b1c173ad1" }, { "path": "audit/01-dashboard.jpg", @@ -315,28 +325,28 @@ }, { "path": "audit/Belege.html", - "bytes": 13543, - "sha256": "d5a1993a1416e412d889baa4d8ae49fdf8124a0de67e4874accc2641e61931ed" + "bytes": 13401, + "sha256": "ae6aabdf98bdc6441af0c0c836f39866d042b0c7eb329fbe0db4e020277dcb48" }, { "path": "audit/Belege.md", - "bytes": 10604, - "sha256": "5da77a547e2582bb36c881fbfdaee3d05dd75a591e3c87420b8c0b8319e23739" + "bytes": 10321, + "sha256": "955a4aa79fc2d2332f978b4f689062b4c3c13925380b1943d545e4fc554907ab" }, { "path": "audit/Belegregister.json", - "bytes": 18239, - "sha256": "7089079e071d9afefa76a193d0d0a5fea8bf31fcbce1e99833a29301418e19a5" + "bytes": 17774, + "sha256": "5779408147efd5a2f8329efe3e80dafe291343c6c6829d41e272e856dbd500a6" }, { "path": "audit/UX-Audit.html", - "bytes": 35280, - "sha256": "118fd49fa448b85c5ff3a6dfdafdeaf59bbf2e8f33dd20b232a0fef885ba7bf2" + "bytes": 34887, + "sha256": "8b4b86bff1d83f3019c7aeddc0df54043896a58958a1bae1d115218f18bf1b8f" }, { "path": "audit/UX-Audit.md", - "bytes": 30884, - "sha256": "eeeffa7279db9254c519d18787355d6e85a9febb295815bed5eea1d5dc19d28e" + "bytes": 30599, + "sha256": "3800afa6cc9f296a0a280788e24fa17bbb6c0cf3a4459641f8c38482f923742b" }, { "path": "audit/cms-nachpruefung/01-anmeldung-erforderlich.png", @@ -552,6 +562,11 @@ "path": "regeln/ux-abnahme-vorlage.md", "bytes": 1760, "sha256": "ea692889261ef50247a6d3592b699f344d6ca51c50e3de6efa3b295915d26c96" + }, + { + "path": "tokens.md", + "bytes": 3142, + "sha256": "06b305ca87344f70c6ead67f66e7368e9f7d2bb5a5e89289d36dce283c360575" } ] }