diff --git a/.gitea/workflows/docker-push.yaml b/.gitea/workflows/docker-push.yaml
index d354d06..15c1dd0 100644
--- a/.gitea/workflows/docker-push.yaml
+++ b/.gitea/workflows/docker-push.yaml
@@ -6,7 +6,6 @@
 name: Docker Push
 
 on:
-  # Manual trigger for testing or production
   workflow_dispatch:
     inputs:
       ref:
@@ -14,6 +13,18 @@ on:
         required: false
         type: string
         default: ''
+  push:
+    branches:
+      - main
+    paths-ignore:
+      - 'README.md'
+      - 'AGENTS.md'
+      - 'CHANGELOG.md'
+      - 'AGENT_CHANGELOG.md'
+      - 'documentation/**'
+      - 'adr/**'
+      - 'chart/**'
+      - 'features/**'
 
 # Environment variables
 env:
diff --git a/Dockerfile b/Dockerfile
index 249f273..f84aedb 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -14,6 +14,13 @@ RUN go mod download
 # Copy entire source code
 COPY . .
 
+# Generate Swagger documentation if not already present
+# (pkg/server/docs/ is gitignored ; the binary //go:embed depends on it)
+RUN if [ ! -f pkg/server/docs/swagger.json ]; then \
+      go install github.com/swaggo/swag/cmd/swag@latest && \
+      cd pkg/server && go generate ; \
+    fi
+
 # Build the server binary
 RUN go build -o app ./cmd/server