Add Gitea CI/CD and Portainer stack templates

deploy/README.md

@@ -0,0 +1,62 @@
+# Portainer Deployment
+
+This directory contains Portainer stack templates for `production-orders-sync`.
+
+## Stack Templates
+
+- `portainer-one-shot.yml`: manual one-shot stack for first dry-run checks and historical backfills.
+- `portainer-stack.yml`: long-running polling stack. It runs `npm run sync`, sleeps, then repeats.
+
+Keep the first production deployment as a one-day dry run:
+
+```sh
+DRY_RUN=true
+SYNC_MODE=backfill
+SYNC_START_DATE=2026-07-02
+SYNC_END_DATE=2026-07-02
+TINY_REQUEST_DELAY_MS=5000
+```
+
+After validating Tiny payload mapping and DB output, switch the polling stack to:
+
+```sh
+DRY_RUN=false
+SYNC_MODE=recent
+RECENT_SYNC_DAYS=2
+POLL_INTERVAL_SECONDS=1800
+```
+
+## Portainer Variables
+
+Set these in the Portainer stack environment:
+
+```sh
+PRODUCTION_ORDERS_SYNC_IMAGE=gitea.blyzer.com.br/blyzer/production-order-tiny:latest
+TINY_API_TOKEN=...
+DATABASE_URL=postgres://...
+DRY_RUN=true
+SYNC_MODE=backfill
+SYNC_START_DATE=2026-07-02
+SYNC_END_DATE=2026-07-02
+TINY_REQUEST_DELAY_MS=5000
+```
+
+For polling, use `SYNC_MODE=recent` and leave `SYNC_START_DATE` / `SYNC_END_DATE` empty unless you intentionally want an explicit recent range.
+
+## Gitea Actions Secrets
+
+The workflow at `.gitea/workflows/ci-cd.yml` expects these repository secrets:
+
+```sh
+REGISTRY_URL=gitea.blyzer.com.br
+REGISTRY_USERNAME=...
+REGISTRY_PASSWORD=...
+IMAGE_REPOSITORY=blyzer/production-order-tiny
+PORTAINER_WEBHOOK_URL=https://... # optional but recommended
+```
+
+`PORTAINER_WEBHOOK_URL` should be the webhook URL generated by Portainer for this stack. If it is missing, the workflow still tests and pushes the image, but it skips the redeploy trigger.
+
+## Architecture Boundary
+
+This stack is standalone. It does not call n8n and does not add production-order sync logic to `api-tiny-n8n`.

deploy/portainer-one-shot.yml

@@ -0,0 +1,25 @@
+services:
+  production-orders-sync:
+    image: ${PRODUCTION_ORDERS_SYNC_IMAGE:-gitea.blyzer.com.br/blyzer/production-order-tiny:latest}
+    environment:
+      NODE_ENV: production
+      TINY_API_TOKEN: ${TINY_API_TOKEN:?TINY_API_TOKEN is required}
+      DATABASE_URL: ${DATABASE_URL:-}
+      TINY_API_BASE_URL: ${TINY_API_BASE_URL:-https://api.tiny.com.br/api2}
+      TINY_LIST_ENDPOINT: ${TINY_LIST_ENDPOINT:-ordens.producao.pesquisa.php}
+      TINY_DETAIL_ENDPOINT: ${TINY_DETAIL_ENDPOINT:-ordem.producao.obter.php}
+      TINY_HTTP_METHOD: ${TINY_HTTP_METHOD:-POST}
+      TINY_START_DATE_PARAM: ${TINY_START_DATE_PARAM:-dataInicial}
+      TINY_END_DATE_PARAM: ${TINY_END_DATE_PARAM:-dataFinal}
+      TINY_DATE_FORMAT: ${TINY_DATE_FORMAT:-DD/MM/YYYY}
+      TINY_FETCH_DETAILS: ${TINY_FETCH_DETAILS:-false}
+      TINY_REQUEST_DELAY_MS: ${TINY_REQUEST_DELAY_MS:-5000}
+      TINY_BLOCK_RETRY_MS: ${TINY_BLOCK_RETRY_MS:-60000}
+      TINY_MAX_RETRIES: ${TINY_MAX_RETRIES:-3}
+      SYNC_MODE: ${SYNC_MODE:-backfill}
+      SYNC_TIME_ZONE: ${SYNC_TIME_ZONE:-America/Sao_Paulo}
+      RECENT_SYNC_DAYS: ${RECENT_SYNC_DAYS:-2}
+      SYNC_START_DATE: ${SYNC_START_DATE:?SYNC_START_DATE is required for backfill}
+      SYNC_END_DATE: ${SYNC_END_DATE:-}
+      DRY_RUN: ${DRY_RUN:-true}
+    restart: "no"

deploy/portainer-stack.yml

@@ -0,0 +1,38 @@
+services:
+  production-orders-sync:
+    image: ${PRODUCTION_ORDERS_SYNC_IMAGE:-gitea.blyzer.com.br/blyzer/production-order-tiny:latest}
+    environment:
+      NODE_ENV: production
+      TINY_API_TOKEN: ${TINY_API_TOKEN:?TINY_API_TOKEN is required}
+      DATABASE_URL: ${DATABASE_URL:?DATABASE_URL is required}
+      TINY_API_BASE_URL: ${TINY_API_BASE_URL:-https://api.tiny.com.br/api2}
+      TINY_LIST_ENDPOINT: ${TINY_LIST_ENDPOINT:-ordens.producao.pesquisa.php}
+      TINY_DETAIL_ENDPOINT: ${TINY_DETAIL_ENDPOINT:-ordem.producao.obter.php}
+      TINY_HTTP_METHOD: ${TINY_HTTP_METHOD:-POST}
+      TINY_START_DATE_PARAM: ${TINY_START_DATE_PARAM:-dataInicial}
+      TINY_END_DATE_PARAM: ${TINY_END_DATE_PARAM:-dataFinal}
+      TINY_DATE_FORMAT: ${TINY_DATE_FORMAT:-DD/MM/YYYY}
+      TINY_FETCH_DETAILS: ${TINY_FETCH_DETAILS:-false}
+      TINY_REQUEST_DELAY_MS: ${TINY_REQUEST_DELAY_MS:-5000}
+      TINY_BLOCK_RETRY_MS: ${TINY_BLOCK_RETRY_MS:-60000}
+      TINY_MAX_RETRIES: ${TINY_MAX_RETRIES:-3}
+      SYNC_MODE: ${SYNC_MODE:-recent}
+      SYNC_TIME_ZONE: ${SYNC_TIME_ZONE:-America/Sao_Paulo}
+      RECENT_SYNC_DAYS: ${RECENT_SYNC_DAYS:-2}
+      SYNC_START_DATE: ${SYNC_START_DATE:-}
+      SYNC_END_DATE: ${SYNC_END_DATE:-}
+      DRY_RUN: ${DRY_RUN:-true}
+      POLL_INTERVAL_SECONDS: ${POLL_INTERVAL_SECONDS:-1800}
+    command:
+      - sh
+      - -c
+      - |
+        while true; do
+          npm run sync
+          exit_code=$$?
+          if [ "$$exit_code" -ne 0 ]; then
+            echo "[Production Orders Sync] run failed with exit code $$exit_code; sleeping before retry"
+          fi
+          sleep "$${POLL_INTERVAL_SECONDS:-1800}"
+        done
+    restart: unless-stopped