From 572dcf36c8992a8f4d80aa5a2cb87bd4e4c72cc2 Mon Sep 17 00:00:00 2001
From: ronenk1 <ronenk1@rnd-hub.com>
Date: Tue, 28 Jul 2026 14:34:44 +0300
Subject: [PATCH] feat: add redis to jobnik manager schema (v2)

Adds a required redis property (extending common/redis/v2 with a
keyTtlSeconds setting) to support idempotency key storage for POST
/v1/jobs retries.
---
 schemas/infra/jobnik/manager/v2.schema.json | 80 +++++++++++++++++++++
 1 file changed, 80 insertions(+)
 create mode 100644 schemas/infra/jobnik/manager/v2.schema.json

diff --git a/schemas/infra/jobnik/manager/v2.schema.json b/schemas/infra/jobnik/manager/v2.schema.json
new file mode 100644
index 00000000..54b8baf9
--- /dev/null
+++ b/schemas/infra/jobnik/manager/v2.schema.json
@@ -0,0 +1,80 @@
+{
+  "$id": "https://mapcolonies.com/infra/jobnik/manager/v2",
+  "description": "The jobnik manager service schema",
+  "title": "jobnikManagerSchemaV2",
+  "type": "object",
+  "allOf": [
+    {
+      "$ref": "https://mapcolonies.com/common/boilerplate/v2"
+    },
+    {
+      "type": "object",
+      "required": ["db", "staleTasksSweeperCron", "task", "redis"],
+      "properties": {
+        "db": {
+          "$ref": "https://mapcolonies.com/common/db/full/v2"
+        },
+        "staleTasksSweeperCron": {
+          "$ref": "#/definitions/staleTasksSweeperCron"
+        },
+        "task": {
+          "$ref": "#/definitions/task"
+        },
+        "redis": {
+          "$ref": "#/definitions/redis"
+        }
+      }
+    }
+  ],
+  "definitions": {
+    "staleTasksSweeperCron": {
+      "type": "object",
+      "properties": {
+        "enabled": {
+          "type": "boolean",
+          "description": "Flag to enable/disable the cron job",
+          "x-env-value": "STALE_TASKS_SWEEPER_CRON_ENABLED"
+        },
+        "schedule": {
+          "type": "string",
+          "description": "The cron timing spec",
+          "default": "0 0 * * *",
+          "examples": ["*/1 * * * *"],
+          "x-env-value": "STALE_TASKS_SWEEPER_CRON_SCHEDULE"
+        }
+      },
+      "required": ["enabled", "schedule"]
+    },
+    "task": {
+      "type": "object",
+      "properties": {
+        "staleTaskThresholdInMinutes": {
+          "type": "number",
+          "description": "The maximum in-progress period in minutes before a task is considered stale",
+          "default": 60,
+          "minimum": 1,
+          "x-env-value": "TASK_STALE_THRESHOLD_IN_MINUTES"
+        }
+      },
+      "required": ["staleTaskThresholdInMinutes"]
+    },
+    "redis": {
+      "allOf": [
+        {
+          "$ref": "https://mapcolonies.com/common/redis/v2"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "keyTtlSeconds": {
+              "type": "integer",
+              "description": "TTL in seconds for idempotency keys stored in redis",
+              "default": 86400,
+              "x-env-value": "REDIS_KEY_TTL_SECONDS"
+            }
+          }
+        }
+      ]
+    }
+  }
+}