From d93e9f0d607988a50afe22df9c89e005c66757f5 Mon Sep 17 00:00:00 2001
From: u1 <u1@rv32i.pl>
Date: Mon, 5 Jan 2026 23:35:34 +0000
Subject: [PATCH] docs: add kustomize structure and usage

---
 README.md | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 5f38d04..f1a7503 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,24 @@
 # trade-deploy
 
-GitOps (pull) manifests for trade on k3s (Argo CD/Flux)
\ No newline at end of file
+Repo na manifesty GitOps (pull) dla projektu `trade` na k3s.
+
+Założenie: obrazy są budowane/pushowane przez CI, a klaster (Argo CD/Flux) sam pobiera „desired state” z tego repo.
+
+## Struktura
+
+- `kustomize/base/` – wspólne zasoby (bez sekretów)
+- `kustomize/overlays/staging/` – staging (`namespace: trade-staging`)
+- `kustomize/overlays/prod/` – prod (`namespace: trade-prod`)
+
+## Szybki test (bez Argo CD)
+
+```bash
+kubectl apply -k kustomize/overlays/staging
+kubectl apply -k kustomize/overlays/prod
+```
+
+## Argo CD
+
+Przykładowa `Application` jest w `bootstrap/argocd/application-trade-staging.yaml`.
+
+Uwaga: sekretów (tokeny/hasła) nie trzymamy w tym repo.