Referenz & Datenmodell
Komponentenanforderung (technical_structure_requirement)
Eine Komponentenanforderung ist ein Platzhalter für ein noch nicht gewähltes Gut: Materialtyp plus technische Anforderungen, gegen die Aligia Varianten prüft.
Die Komponentenanforderung (technical_structure_requirement) beschreibt, was gebraucht wird, bevor feststeht, welches Gut es wird. Sie nennt einen Materialtyp (good_type) und trägt Technische Anforderungen (technical_structure_spec_req), je eine Bedingung pro Spezifikation des Materialtyps. Das Spec-Matching bewertet alle Varianten des Typs gegen diese Bedingungen und wandelt die Anforderung in eine technische Komponente um. (Planungsdaten)
Wo in der App
Abschnitt betitelt „Wo in der App“Projekt › Engineering. Button „Anforderung hinzufügen“ öffnet „Neue Komponentenanforderung“ mit Titel und Materialtyp-Suche. Baumzeile: Titel und Materialtyp. Detailfenster: Kopfzeile mit Titel, Status-Badge und Materialtyp, Beschreibung, „Allgemeine Anforderungen“, Tabelle „Technische Anforderungen“ (gruppiert nach Spezifikationskategorie, mit den Spalten „Spezifikation“, „Einheit“, „Anforderung“) und rechts der Button „Spec-Matching“ bzw. „Zuordnung ersetzen“. Siehe Guides › Spec-Matching.
| Feld | Technisch | Typ | Pflicht | Bedeutung | Besonderheit |
|---|---|---|---|---|---|
| Titel | name |
Text | ja | Bezeichnung | Leer im Dialog → Aligia setzt „Anforderung“ |
| Materialtyp | good_type_id |
Verweis | nein | Materialtyp, dessen Spezifikationen und Varianten gelten | Ohne Materialtyp keine technischen Anforderungen und kein Spec-Matching (Hinweis „Warentyp wählen, um Spezifikationen festzulegen.“) |
| Allgemeine Beschreibung | description |
Text | nein | Kurzbeschreibung | Editor unter dem Titel |
| Allgemeine Anforderungen | general_requirements |
Text | nein | Freitext-Anforderungen | Editor im Detailfenster |
| Status | status |
Auswahl | ja | „offen“ / „erfüllt“ | System: nicht direkt editierbar; sichtbar als Badge, siehe Zustände |
| Übergeordneter Knoten | technical_structure_node_id |
Verweis | nein* | Strukturordner | Bearbeiten-Dialog › „Übergeordneten Knoten wechseln“ |
* Im Schema optional, die Oberfläche setzt den Ordner immer.
Technische Anforderung (technical_structure_spec_req)
Abschnitt betitelt „Technische Anforderung (technical_structure_spec_req)“Hilfsentität, eine Zeile je (Anforderung, Spezifikation). Angelegt über „+“ in der Zeile der Tabelle „Technische Anforderungen“ (Dialog „Technische Anforderungen für …“), bearbeitet per Doppelklick, gelöscht über „Anforderung löschen“.
| Feld | Technisch | Typ | Pflicht | Bedeutung | Besonderheit |
|---|---|---|---|---|---|
| Spezifikation | good_type_spec_id |
Verweis | ja | Spezifikation des Materialtyps oder eines übergeordneten Typs | Zur Auswahl stehen die Spezifikationen des Typs und aller Elterntypen |
| Operator + Anforderungswert | value |
Auswahl + Wert | ja | Bedingung als JSON {op, value} bzw. {op, min, max} bzw. {op, values} |
Operatoren je Datentyp: Zahl „=“, „≥“, „≤“, „zwischen“; Auswahlliste „=“, „einer von“; Text „=“; Ja/Nein „=“ („Zutreffend“) |
Anzeige in der Spalte „Anforderung“: = 100 kW, ≥ 5 A, ≤ 40 °C, 10 – 20 mm, A | B.
Beziehungen: gehört zu Komponentenanforderung (Pflicht, cascade) und zu Spezifikation good_type_spec (Pflicht, cascade – wird die Spezifikation im Katalog gelöscht, verschwindet die Bedingung).
Beziehungen
Abschnitt betitelt „Beziehungen“| Zu | Art | Pflicht | Beim Archivieren | Beim Löschen |
|---|---|---|---|---|
Strukturordner (technical_structure_node) |
gehört zu | nein* | – | mit dem Ordner gelöscht (cascade) |
Materialtyp (good_type) |
gehört zu | nein | – | Verweis gelöst, Anforderung bleibt ohne Typ (detach) |
Technische Anforderung (technical_structure_spec_req) |
hat viele | nein | – | mitgelöscht (cascade) |
Technische Komponente (fulfillingGoods) |
hat viele | nein | – | Komponente bleibt, Verweis bleibt stehen (keep) |
Zustände
Abschnitt betitelt „Zustände“| Wert | Label in der Oberfläche | Gesetzt durch |
|---|---|---|
open |
kein Badge; Button „Spec-Matching“ sichtbar | Anlegen; Löschen der letzten erfüllenden Komponente |
fulfilled |
Badge „Zuordnung erfüllt Spezifikation“ (grün), „Zuordnung verletzt Spezifikation“ (rot) oder „Zuordnung ungeprüft (Werte fehlen)“ (gelb), darunter der Name der Komponente; bei rot/gelb Button „Zuordnung ersetzen“ | Spec-Matching |
open ──(Spec-Matching: Komponente übernehmen)──▶ fulfilled ▲ │ └──(letzte erfüllende Komponente gelöscht)─────────┘Regeln & Automatik
Abschnitt betitelt „Regeln & Automatik“- Spec-Matching (Dialog „Spec-Matching –
“): Kandidaten sind alle Varianten der Güter des Materialtyps und seiner Untertypen. Je Variante zählt Aligia erfüllte, verletzte und unbekannte Bedingungen und zeigt eine Quote in Prozent (nur über bekannte Werte). Rangfolge: erst Varianten, die alles erfüllen; dann ohne Verstoß, aber mit fehlenden Werten (weniger Unbekannte zuerst); dann Varianten mit Verstößen (höhere Quote zuerst); zuletzt Varianten ohne jeden Wert. Gleichstand: SKU aufsteigend. Farbe: grün bei vollem Treffer, rot bei einem Verstoß, sonst gelb. - Vergleichsregeln: Zahlen und Zahlbereiche müssen ganz innerhalb der Grenzen liegen (Grenzen einschließlich). Text muss nach Trimmen genau gleich sein; Text wird nie in eine Zahl umgewandelt. Fehlender oder unpassender Wert zählt als „unbekannt“, nie als Verstoß. Es gibt keine Umrechnung von Einheiten; die Einheit stammt aus der Spezifikation.
- Übernehmen („Hinzufügen“ nach der Warnung „… Dieser Vorgang ist unwiederrufbar.“): Aligia legt im selben Strukturordner eine technische Komponente mit der gewählten Variante, der eingegebenen „Benötigte Menge“, Titel, Beschreibung und allgemeinen Anforderungen der Anforderung an, setzt deren Verweis auf die Anforderung und löscht die Anforderung. Bei „Zuordnung ersetzen“ wird zusätzlich die bisherige Komponente gelöscht. Scheitert ein Schritt, nimmt Aligia die neue Komponente zurück und meldet dies.
- Ungültige gespeicherte Bedingungen (z. B. aus Altdaten) zeigt der Matching-Dialog als Hinweis „… ungültige Anforderungen“ und ignoriert sie.
- Ohne Materialtyp oder ohne Bedingungen zeigt der Dialog nur einen Hinweis; ein Matching ist dann nicht möglich.
Kennzahlen
Abschnitt betitelt „Kennzahlen“Das Verdikt (summaryToState) ist als Badge Teil der Qualitätskennzahlen, siehe Kap. 13 › Qualität. Ein Zahlenwert wird nicht ausgewiesen.
Siehe auch
Abschnitt betitelt „Siehe auch“Technische Komponente · Spezifikation · Material · Guides › Spec-Matching