Vorschlag zu Naming Conventions FIR/OpenApi. Bei Konsens bzw. Entscheidung kann diese Seite ggf. in den Dokumentationsbereich verschoben werden.
...
- Wir verwenden Camelcase.´
- Oder eine an den Anwendungsfall angepasste Variante (Snake-, Title-, Pascal-, Kebab-case)
- Wir vermeiden bestimmte Anti-Pattern bei der Verwendung von Abkürzungen und Akronymen sowie ausschließliche Groß-/Kleinschreibung.
Die Vermeidung der aufgeführten Anti-Pattern sorgt dafür, das eine verlustfreie Transformation von einem in das andere Format möglich ist. Das wichtige für Code Generatoren und andere Tools.
Was Wie Wo
[Entity] schema
Zur definition von Entity (Model-Klassen) verwenden wir Pascal case.
Examples: TroubleTicket, QueryServiceQualification, CustomerBill
[Entity] Attributes
Zur definition von Entity Attributes ((Model-Properties)) verwenden wir Camel case.
...
Beispiel: https://serverRoot/tmf-api/productOrdering/v4
Anti-Pattern
Die Vermeidung der aufgeführten Anti-Pattern sorgt dafür, das eine verlustfreie Transformation von einem in das andere Format möglich ist. Das wichtige für Code Generatoren und andere Tools.
Beispiele:
NumberOfVLANsOpenAPINUMBEROFVLANSnumberofvlans