docs: add kustomize structure and usage

README.md

@@ -1,3 +1,24 @@
 # trade-deploy
 
-GitOps (pull) manifests for trade on k3s (Argo CD/Flux)
+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.