Scope Pack Exchange Format v1.0

Что такое Scope Pack?

Scope Pack — это завершённый состав ремонта домовладельца, запечатанный в неизменяемый версионируемый артефакт: помещения, работы, уровень качества каждой работы, ответы, которые их сформировали, и выбранная отделка — только по названию. Это единственный артефакт, который передаётся между сторонами.

Что входит в пакет

• Помещения — каждая комната с названием, типом, площадью и понятным диапазоном размера.
• Работы — каждый вид работ со своим уровнем качества, охватываемыми помещениями, суммарным количеством, выборами домовладельца и выбранной отделкой.
• Уровни качества — общий уровень работы «Хороший / Лучше / Премиум»; отделка также имеет свой уровень.
• Выборы — сводка выбранных домовладельцем вариантов в виде названия и значения.
• Отделка — выбранная категория и вариант, по названию и уровню (никогда не цена).

Версионирование и совместимость

Версия 1 зафиксирована: она никогда не изменяется задним числом, поэтому пакет v1 всегда остаётся читаемым. Обратно совместимые дополнения остаются в рамках линии v1; любое критическое изменение публикуется как новая версия наряду с v1. В каждом документе указана версия спецификации, которой он соответствует.

Пример документа

{
  "format": "briked.scope-pack",
  "specVersion": "1.0",
  "id": "01900000-0000-7000-8000-0000000000a1",
  "project": {
    "id": "01900000-0000-7000-8000-0000000000b1"
  },
  "version": 1,
  "sealedAt": "2026-06-01T10:00:00.000Z",
  "defaultTier": "better",
  "spaces": [
    {
      "id": "01900000-0000-7000-8000-0000000000c1",
      "name": {
        "en": "Kitchen",
        "ar": "مطبخ"
      },
      "type": "kitchen",
      "floorArea": {
        "value": 12,
        "unit": "m²"
      },
      "sizeBand": "typical"
    },
    {
      "id": "01900000-0000-7000-8000-0000000000c2",
      "name": {
        "en": "Main bathroom",
        "ar": "الحمام الرئيسي"
      },
      "type": "bathroom",
      "floorArea": {
        "value": 6,
        "unit": "m²"
      },
      "sizeBand": "small"
    }
  ],
  "jobs": [
    {
      "id": "01900000-0000-7000-8000-0000000000d1",
      "name": {
        "en": "Renovate kitchen",
        "ar": "تجديد المطبخ"
      },
      "type": "room",
      "tier": "best",
      "spaces": [
        {
          "id": "01900000-0000-7000-8000-0000000000c1",
          "name": {
            "en": "Kitchen",
            "ar": "مطبخ"
          }
        }
      ],
      "quantity": {
        "value": 12,
        "unit": "m²",
        "assumed": false
      },
      "selections": [
        {
          "label": {
            "en": "Cabinet style",
            "ar": "نمط الخزائن"
          },
          "value": {
            "en": "Modern",
            "ar": "عصري"
          }
        }
      ],
      "finishes": [
        {
          "category": {
            "id": "01900000-0000-7000-8000-0000000000f1",
            "name": {
              "en": "Cabinets",
              "ar": "خزائن"
            }
          },
          "choice": {
            "id": "01900000-0000-7000-8000-0000000000f2",
            "name": {
              "en": "Solid oak",
              "ar": "بلوط صلب"
            }
          },
          "tier": "premium"
        }
      ]
    },
    {
      "id": "01900000-0000-7000-8000-0000000000d2",
      "name": {
        "en": "Bathroom waterproofing",
        "ar": "عزل الحمام المائي"
      },
      "type": "trade",
      "tier": "better",
      "spaces": [
        {
          "id": "01900000-0000-7000-8000-0000000000c2",
          "name": {
            "en": "Main bathroom",
            "ar": "الحمام الرئيسي"
          }
        }
      ],
      "quantity": {
        "value": 6,
        "unit": "m²",
        "assumed": true
      },
      "selections": [],
      "finishes": []
    }
  ],
  "assumedQuantityCount": 1
}