Namenskonventionen der Apps

Allgemeine Namenskonventionen

Der Name der App ergibt sich aus den Konventionen von composer. Siehe https://getcomposer.org/doc/01-basic-usage.md#package-names

Alle brandbox Apps werden in den Namespace „brandbox“ gelegt: brandbox/package-name
Individuelle Apps tragen den Namen des Kunden wie folgt: brandbox/{$kunde}-package-name

Abhängigkeitsketten

Es gibt unterschiedliche strukturelle Ebenen, auf denen Apps erstellt werden können:

Framework-Level

Core-Level

Extension-Level

Das Framework (brandbox/framework) ist Grundlage für alle weiteren Apps. Apps mit dem Präfix framework, können daher direkt im Framework genutzt werden.

Beispiel: brandbox/framework-currency

Core-Apps erfüllen einen ganzheitlichen, übergeordneten Zweck und können ohne weitere Abhängigkeiten (außer dem Framework) genutzt werden. Core-Apps erhalten das Suffix core. Core-Apps sind so zu schreiben, dass sie an neuraligschen Stellen erweitert werden können (PSR-14).

Beispiel: shop-core

Extensions erfüllen einen untergeordneten Zweck und können nicht selbstständig funktionieren. Sie erweitern den Funktionsumfang auf Framework- oder Core-Level. Die Namensgebung richtet sich an der zu erweiternden App aus. Dazu wird der Name eben dieser App vorangestellt.

Beispiel: shop-paypal