sozsoft-platform/configs/release-notes/generate-release-notes.sh

#!/bin/bash
set -e

# Sürüm notlarını git tag'lerinden üretir:
#   configs/release-notes/release-notes.json
#
# Dosya İMAJA GÖMÜLMEZ. Konteynere docker-compose-app.yml üzerinden
# `/etc/api/release-notes` altına salt okunur mount edilir; ReleaseNoteStartupService
# açılışta bu yolu okuyup `Sas_H_ReleaseNote` tablosuyla eşitler, DbMigrator gerekmez.
#
# Neden api/ altında değil: dosya api build context'i içindeyken her yeni tag
# Dockerfile'daki `COPY . .` katmanını geçersiz kılıyor ve kodda hiçbir değişiklik
# olmasa bile API imajı baştan derleniyordu. configs/ altında olduğu için artık
# API imajı bit bazında aynı kalır ve docker cache'ten yüklenir.
#
# Çıktı .gitignore'dadır: takip edilseydi deploy'daki `git pull` her seferinde
# yerel değişiklikle çakışırdı. Bu yüzden dosya BUILD makinesinde değil, DEPLOY
# sırasında sunucuda üretilir (configs/deployment/scripts/deploy/app.sh); elle de
# çalıştırılabilir.
#
# Dış bağımlılığı yoktur (jq/node gerekmez): JSON kaçışları sed ile yapılır.

cd "$(dirname "$0")"
OUTPUT="release-notes.json"

if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
  echo "> git deposu yok, ${OUTPUT} güncellenmedi." >&2
  exit 0
fi

echo "> release-notes.json oluşturuluyor..."

# origin'de olmayan yerel tag'ler sürüm sırasını bozar; temizle. `--force` şart:
# yerel bir tag origin'dekinden farklı commit'e bakıyorsa git onu "would clobber
# existing tag" diyerek reddediyor ve YENİ tag'ler de alınmamış oluyor.
git fetch --prune --prune-tags --tags --force origin >/dev/null 2>&1 || true

# Sıra tag adına göre (creatordate değil): 1.1.10 > 1.1.09.
TAGS=$(git tag --list --sort=-v:refname)

if [ -z "$TAGS" ]; then
  echo "> Tag bulunamadı, mevcut dosya korundu." >&2
  exit 0
fi

# JSON string kaçışı: önce ters bölü, sonra tırnak, sonra sekme/CR.
escape_json() {
  printf '%s' "$1" | sed -e 's/\\/\\\\/g' -e 's/"/\\"/g' -e 's/\t/\\t/g' -e 's/\r//g'
}

TMP=$(mktemp)
printf '{\n    "ReleaseNotes": [\n' > "$TMP"

FIRST_TAG=true
for TAG in $TAGS; do
  VERSION=${TAG#v}
  RELEASE_DATE=$(git log -1 --format=%ad --date=short "$TAG")
  COMMIT=$(git rev-list -n 1 "$TAG")

  if [ "$FIRST_TAG" = true ]; then FIRST_TAG=false; else printf ',\n' >> "$TMP"; fi

  printf '        {\n' >> "$TMP"
  printf '            "version": "%s",\n' "$(escape_json "$VERSION")" >> "$TMP"
  printf '            "releaseDate": "%s",\n' "$RELEASE_DATE" >> "$TMP"
  printf '            "commit": "%s",\n' "$COMMIT" >> "$TMP"
  printf '            "notes": [' >> "$TMP"

  # Annotated tag mesajı; her satır bir madde. Boş satırlar ve baştaki "-" / "*"
  # işaretleri temizlenir. Lightweight tag'de mesaj boştur → notes: [].
  FIRST_NOTE=true
  while IFS= read -r LINE; do
    [ -z "$LINE" ] && continue
    if [ "$FIRST_NOTE" = true ]; then FIRST_NOTE=false; printf '\n' >> "$TMP"; else printf ',\n' >> "$TMP"; fi
    printf '                "%s"' "$(escape_json "$LINE")" >> "$TMP"
  done < <(git tag -l --format='%(contents)' "$TAG" \
    | sed -e 's/\r//' -e 's/^[[:space:]]*[-*][[:space:]]*//' -e 's/[[:space:]]*$//' \
    | grep -v '^$' || true)

  if [ "$FIRST_NOTE" = true ]; then
    printf ']\n' >> "$TMP"
  else
    printf '\n            ]\n' >> "$TMP"
  fi
  printf '        }' >> "$TMP"
done

printf '\n    ]\n}\n' >> "$TMP"
mv "$TMP" "$OUTPUT"

echo "> ${OUTPUT}: $(grep -c '"version":' "$OUTPUT") sürüm"