# Git-Setup

## GitLab Host

```bash
export GITLAB_HOST=git.tech.rz.db.de
export GITLAB_TOKEN=$GITLAB_PAT
```

IMMER `GITLAB_HOST=git.tech.rz.db.de` setzen – glab nutzt sonst gitlab.com.

## Branching (mit Jira-Referenz)

- `develop` – Hauptentwicklungsbranch
- `feature/*` – Feature-Branches
- `Release_*` – Release-Tags (z.B. Release_40.04.03)
- MRs gehen nach `develop`, nicht nach `main`

## Conventional Commits

```
feat(benutzer): add user search endpoint (#123)
fix(gateway): handle timeout in service call (#124)
docs(arc42): update context diagram
ci(pipeline): update pipelinetemplates to Release_40.04.04
```

## Jira-Referenz

Der initiale Issue ist in Jira beschrieben. Branch-Name und Commits MÜSSEN die Jira-Nummer referenzieren:

```bash
# Branch-Name
feature/${JIRA_PREFIX}-1234-user-search
bugfix/${JIRA_PREFIX}-5678-fix-timeout

# Commits
feat(benutzer): add user search endpoint (${JIRA_PREFIX}-1234)
fix(gateway): handle timeout in service call (${JIRA_PREFIX}-5678)
```

### MR-Title

```
feat(benutzer): add user search endpoint (${JIRA_PREFIX}-1234)
bugfix(gateway): fix timeout in service call (${JIRA_PREFIX}-5678)
```

GitLab verlinkt automatisch auf Jira wenn die Issue-Nummer im Commit/MR steht.

## Commit-Message Prefix (Konvention)

Jede Commit-Message und jeder MR-Title beginnt mit dem Branch-Namen in eckigen Klammern:

```bash
# Commits
[feature/${JIRA_PREFIX}-1234-user-search] feat(benutzer): add user search endpoint
[bugfix/${JIRA_PREFIX}-5678-fix-timeout] fix(gateway): handle timeout in service call

# MR-Title
[feature/${JIRA_PREFIX}-1234-user-search] feat(benutzer): add user search endpoint
```

Format: `[{branch-name}] {conventional commit message}`