Job YAML schema

Машинный чертёж: schemas/job.schema.json (JSON Schema 2020-12). Документ человекочитаемого формата остаётся каноничным в docs/reference/job-format-v1.md.

Согласованность с валидацией

API POST /api/v1/jobs/validate и CLI iobackupctl job validate используют Go-валидацию (job.Validate, job.ValidateStrict, preflight.Run) — это источник истины для полей, которые JSON Schema пока описывает частично.
JSON Schema служит для статического линтинга в CI/редакторах; при расхождении приоритет у Go-валидации до полного покрытия схемы.

Coverage status

JSON Schema сейчас — skeleton. Он покрывает базовую структуру и ряд foundation-полей, но не гарантирует полную эквивалентность Go-валидации.

covered: metadata.job_id, metadata.labels, spec.operation, spec.tasks[].task_id, базовая структура source/destination, destination.write_policy.
documented but Go-validation-first: spec.resources, spec.concurrency, spec.conditions, spec.logging, spec.data, spec.notifications.webhooks[].policy — схема допускает широкий формат, точные правила задаёт job.Validate/ValidateStrict.
reserved/future: source.type=filesystem_incremental, spec.operation.strategy != full, spec.repository content-addressed модели, hooks/encryption/immutability enforcement — см. docs/internal/roadmap/status-matrix.md.
planned for 0.18.1: full schema validation CI (строгие enums/oneOf, запрет system fields на уровне схемы, генерация/проверка ссылок).

Full schema validation CI is planned for 0.18.1.

Ключевые узлы

Узел	Описание
`metadata.job_id`	Уникальный идентификатор job (slug).
`metadata.job_uid`	Не задавать в submit — только read-only в ответах API.
`metadata.labels`	Рекомендуемое место для tenant/project/env до появления first-class полей.
`spec.operation`	`{type, strategy}` — в v1 исполняется только `backup` + `full` по сути.
`spec.repository`	`single_artifact` / `iobackup` исполняется; прочие комбинации — reserved.
`spec.resources` / `spec.concurrency` / `spec.conditions`	Foundation — см. `docs/reference/job-format-v1.md`.
`spec.policies`	`retention`, `verify`, `encryption`, `validation`, `immutability`, …
`spec.logging` / `spec.data`	Classification / redaction hints (0.17-fix.50).
`spec.notifications.webhooks[].payload`	Поля `format`/`template` — reserved/future.
`spec.tasks[]`	`task_id`, `required`, `resources`, `source`/`destination`, `hooks` (feature gate).
`policies.retention`	Поддерживает `dry_run`, `keep_days`/`keep_last`, см. `docs/features/retention/retention-behavior.md`.
`policies.verify`	`after_run`, `limit_per_task`.
`notifications.webhooks`	Проверка конфликтующих секретов в auth-блоке (`job/validate_secrets.go`).

Примеры

Рабочие: examples/*.yaml (без metadata.job_uid).
Зарезервированное / неисполняемое: examples/future/* — не использовать для job submit без правок; ожидайте коды SOURCE_UNSUPPORTED / HOOKS_UNSUPPORTED / …

Регенерация примеров: любой YAML из examples/*.yaml (кроме future/) должен проходить iobackupctl job validate при подготовке CI в будущем.