# Konwencje nazewnicze elementów aplikacji

W projektach realizowanych w Eximee Designer stosowanie spójnych konwencji nazewniczych dla elementów aplikacji jest kluczowe dla utrzymania porządku, przejrzystości i efektywnej współpracy w zespole.

Dobrze dobrane nazwy ułatwiają:

* szybkie wyszukiwanie i filtrowanie komponentów w repozytorium,
* rozpoznanie funkcji i przeznaczenia danego elementu bez konieczności jego otwierania,
* unikanie konfliktów nazw i przypadkowego nadpisywania artefaktów,
* zarządzanie dużymi zbiorami formularzy, procesów, skryptów itp., zwłaszcza w środowiskach z wieloma aplikacjami i zespołami.

Poniższa tabela prezentuje zalecane konwencje nazewnicze dla wszystkich głównych typów elementów aplikacji w Eximee. Są one zgodne z dobrymi praktykami stosowanymi w projektach produkcyjnych i umożliwiają zachowanie porządku w skalowalnych rozwiązaniach.

{% hint style="info" %}
Wszystkie nazwy dajemy w języku angielskim- w przypadku odgórnych ustaleń dotyczących nazwy formularza stosujemy język polski.
{% endhint %}

#### Tabela konwencji nazewniczych elementów aplikacji Eximee

<table><thead><tr><th width="138.272705078125">Typ elementu</th><th width="195.818115234375">Format nazwy</th><th>Przykład</th></tr></thead><tbody><tr><td><strong>Aplikacja</strong></td><td><mark style="background-color:orange;">prefix</mark>_app</td><td><code>kontoJunior_app</code>, <code>800plus_app</code></td></tr><tr><td><strong>Formularz</strong></td><td><mark style="background-color:orange;">prefixName</mark></td><td><code>kontoJuniorStart</code>, <code>kontoJuniorForm</code>, <code>kontoJuniorAcceptance</code></td></tr><tr><td><strong>Pozostałe elementy(np. skrypty)</strong></td><td><mark style="background-color:orange;">prefixName</mark></td><td><code>kontoJuniorCheckAmount</code></td></tr><tr><td><strong>Procesy</strong></td><td><mark style="background-color:orange;">prefixNameProcess</mark></td><td><code>kontoJuniorProcess</code>, <code>kontoJuniorSendNotificationProcess</code></td></tr></tbody></table>

Zasady ogólne

* <mark style="background-color:orange;">prefix</mark> - nazwa biznesowa danego projektu, umieszczana na początku każdego elementu aplikacji\
  w formacie camelCase
* <mark style="background-color:purple;">Name</mark> - nazwa danego elementu w formacie camelCase

{% hint style="warning" %}
W przypadku formularzy i aplikacji należy brać pod uwagę to, że nazwa formularza/aplikacji pojawia się potem m.in. w adresie URL.
{% endhint %}