From df80f0e46eff0af27584d4812c05adb4308051f9 Mon Sep 17 00:00:00 2001
From: billisdead <billisdead@tutanota.com>
Date: Tue, 16 Jun 2026 18:13:52 +0200
Subject: [PATCH] docs: document branch structure and upstream tag reference

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 ROLLBACK.md | 42 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/ROLLBACK.md b/ROLLBACK.md
index 11491bb..dbbcbf5 100644
--- a/ROLLBACK.md
+++ b/ROLLBACK.md
@@ -6,6 +6,48 @@ Ce document couvre le retour de la source ArgoCD depuis ce fork Gitea
 
 ---
 
+## Structure des branches et référence upstream
+
+```
+Tag upstream-1.0.5      → commit 5d6a9de2  (upstream exact, immuable)
+                           gitroomhq/postiz-helmchart, chart v1.0.5, jan 2025
+
+main                    → contenu fonctionnellement identique à upstream
+                           (source déployée par ArgoCD)
+
+feat/temporal-support   → 5d6a9de2 → Temporal + env → ROLLBACK.md
+                           (branche de travail pour l'upgrade v2.21.8)
+```
+
+### Inspecter le delta entre upstream et notre travail
+
+```bash
+# Tout ce qui a changé par rapport à l'upstream dans la chart
+git diff upstream-1.0.5 feat/temporal-support -- charts/
+
+# Juste les fichiers modifiés (sans le contenu)
+git diff --name-only upstream-1.0.5 feat/temporal-support
+
+# Comparer main avec upstream (doit être vide sur charts/)
+git diff upstream-1.0.5 main -- charts/
+```
+
+### Synchroniser le tag upstream si l'upstream GitHub évolue
+
+```bash
+# Ajouter le remote GitHub si absent
+git remote add upstream https://github.com/gitroomhq/postiz-helmchart
+
+# Récupérer le nouvel upstream
+git fetch upstream
+
+# Créer un nouveau tag pour la nouvelle version upstream
+git tag -a upstream-<version> upstream/main -m "Upstream gitroomhq à <version>"
+git push origin upstream-<version>
+```
+
+---
+
 ## Contexte de référence
 
 | Paramètre | Fork Gitea (actuel) | Chart officielle (cible rollback) |