Skip to content

Миссия, видение и ценности ​

Семейство north.

norm_north_get ​

Миссия, видение и ценности компании — её истинный север, нулевой шаг стратегии. Север один на компанию, вход пустой. Ответ — север целиком: миссия, видение (цель, год, описание), ценности с признаками соблюдения и нарушения, complete — заполнен ли он (есть миссия, цель видения и хотя бы одна ценность), revision — номер записи, кто и когда записал. Не заданное поле — null, не заданные ценности — пустой список. Используйте север как релевантный контекст: отмечайте, где решения и выводы опираются на миссию, видение и ценности и где расходятся с ними; там, где он нерелевантен, не притягивайте. Читать вправе любой участник компании; тем, кому закрыто чтение данных компании, реализация отказывает unauthorized_scope. Доменные состояния: no_data — север ещё не записан; not_ready — хранение севера у компании не настроено.

Доступ: чтение · Списковый: нет · Версии контракта: 1

Аргументы

Аргументов нет.

Данные ответа (data)

ПолеПри успехеТипЗачем
northдаCompanyNorthСевер компании целиком.
errorнетDomainErrorПочему севера нет: он ещё не записан или хранение не настроено.
Пример: успешный ответ
json
{
  "source_refs": [
    {
      "source": "company-data",
      "ref": "north",
      "label": "Миссия, видение и ценности"
    }
  ],
  "freshness": {
    "as_of": "2026-10-29T10:15:00.000Z",
    "ttl_sec": 300,
    "stale": false
  },
  "data": {
    "north": {
      "mission": "Помогаем людям строить дома, в которых хочется жить, — без обмана в сроках и смете.",
      "vision": {
        "goal": "Каждый третий частный дом в регионе построен по нашей технологии.",
        "horizon_year": 2035,
        "description": "Заказчик выбирает нас потому, что знает: смета не вырастет, а дом сдадут в срок. Мастера держатся за компанию, потому что здесь растут, а не выгорают."
      },
      "values": [
        {
          "name": "Честная смета",
          "meaning": "Цена, которую назвали, — цена, которую заплатят.",
          "adhered": "Риски роста цены называют до подписания, а не после.",
          "violated": "Допработы всплывают в акте без согласования с заказчиком."
        },
        {
          "name": "Слово держим",
          "meaning": "Срок, названный вслух, — обязательство.",
          "adhered": "Перенос срока согласуют заранее и с причиной.",
          "violated": "Срок сдвигают молча, заказчик узнаёт последним."
        },
        {
          "name": "Учимся на ошибках",
          "meaning": null,
          "adhered": "Ошибку разбирают на встрече без поиска виноватого.",
          "violated": null
        }
      ],
      "complete": true,
      "revision": 3,
      "updated_at": "2026-10-28T16:42:10.000+03:00",
      "updated_by": {
        "id": "01K8X0A2C4E6G8J0L2N4Q6S8U0",
        "name": "Татьяна Тихомирова"
      }
    }
  }
}
Пример: случай «incomplete»
json
{
  "source_refs": [
    {
      "source": "company-data",
      "ref": "north",
      "label": "Миссия, видение и ценности"
    }
  ],
  "freshness": {
    "as_of": "2026-10-29T10:15:00.000Z",
    "ttl_sec": 300,
    "stale": false
  },
  "data": {
    "north": {
      "mission": "Помогаем людям строить дома, в которых хочется жить.",
      "vision": {
        "goal": null,
        "horizon_year": null,
        "description": null
      },
      "values": [],
      "complete": false,
      "revision": 1,
      "updated_at": "2026-10-27T11:05:00.000+03:00",
      "updated_by": {
        "id": "01K8X0A2C4E6G8J0L2N4Q6S8U0",
        "name": null
      }
    }
  }
}
Пример: случай «domain_error»
json
{
  "source_refs": [
    {
      "source": "company-data",
      "ref": "north"
    }
  ],
  "freshness": {
    "as_of": "2026-10-29T10:15:00.000Z",
    "ttl_sec": 0,
    "stale": false
  },
  "data": {
    "error": {
      "code": "no_data",
      "message": "Миссия, видение и ценности компании ещё не записаны.",
      "retryable": false
    }
  }
}

norm_north_upsert ​

Записать миссию, видение и ценности компании. Новая запись заменяет прежний север целиком: что не передано значением, стирается — не заданное поле передавайте null, не заданные ценности — пустым списком. Пробелы по краям сервер обрезает, пустую строку пишет как null. Имя ценности после обрезки пустое или повторяется без учёта регистра — сервер отклоняет вызов как invalid_input. Север длиннее 30 000 знаков в JSON сервер тоже отклоняет как invalid_input; длина — число знаков JSON входа north после обрезки: буквы не экранируются, буква кириллицы — один знак. complete, revision, updated_at и updated_by ставит сервер: во входе их нет. Ответ — revision, номер записанной ревизии, и created: true, если до записи севера у компании не было. Писать вправе только владелец и администратор компании, остальным реализация отвечает unauthorized_scope. Доменные состояния: not_ready — хранение севера не настроено; temporary и rate_limited — повторите позже.

Доступ: запись · Списковый: нет · Версии контракта: 1

Аргументы

ПолеОбязательноТипЗачем
northдаCompanyNorthInputМиссия, видение и ценности для записи; заменяют прежний север целиком.

Данные ответа (data)

ПолеПри успехеТипЗачем
createdдаbooleanЗаписан ли север впервые; false — заменён прежний.
revisionдаintegerНомер ревизии, которую записал этот вызов.
errorнетDomainErrorПочему север не записан и можно ли повторить.
Пример: успешный ответ
json
{
  "source_refs": [
    {
      "source": "company-data",
      "ref": "north",
      "label": "Миссия, видение и ценности"
    }
  ],
  "freshness": {
    "as_of": "2026-10-29T10:15:00.000Z",
    "ttl_sec": 0,
    "stale": false
  },
  "data": {
    "revision": 4,
    "created": false
  }
}
Пример: случай «domain_error»
json
{
  "source_refs": [
    {
      "source": "company-data",
      "ref": "north"
    }
  ],
  "freshness": {
    "as_of": "2026-10-29T10:15:00.000Z",
    "ttl_sec": 0,
    "stale": false
  },
  "data": {
    "error": {
      "code": "not_ready",
      "message": "Хранение миссии, видения и ценностей у компании не настроено.",
      "retryable": false
    }
  }
}

Объекты семейства ​

Объекты, из которых состоят аргументы и ответы инструментов этого семейства.

CompanyNorth ​

Миссия, видение и ценности. Истинный север компании — нулевой шаг стратегии: миссия, видение и ценности, признак заполненности, номер ревизии, кто и когда записал. Один на компанию. Стратегия опирается на него, агенты сверяют с ним выводы как с релевантным контекстом. В JSON поля миссии, видения и ценностей вместе не длиннее 30 000 знаков.

ПолеОбязательноТипЗачем
completeдаbooleanЗаполнен ли север: есть миссия, цель видения и хотя бы одна ценность. Вычисляет сервер.
missionдаstring | nullМиссия: зачем компания существует — не продукт, а смысл её работы; null — не задана.
revisionдаintegerНомер записи севера: 1 у первой, дальше растёт на каждую запись.
updated_atдаstring (date-time)Когда север записан последний раз.
updated_byдаCompanyNorthAuthorКто записал север последний раз.
valuesдасписок CompanyNorthValueЦенности: принципы, по которым компания принимает решения; пустой список — не заданы.
visionдаCompanyNorthVisionВидение: смелая цель, год и описание конечного состояния.

CompanyNorthAuthor ​

Кто записал север. Автор последней записи севера: id и имя из принципала вызова. Ставит сервер; не знает — null.

ПолеОбязательноТипЗачем
idдаstring | nullКто записал север: id из принципала вызова; null — неизвестно.
nameдаstring | nullИмя того, кто записал: показать человеку; null — неизвестно.

CompanyNorthValue ​

Ценность. Ценность компании: название, что она значит и по каким наблюдаемым признакам видно её соблюдение и нарушение. По этим признакам агенты сверяют решения с ценностями.

ПолеОбязательноТипЗачем
adheredдаstring | nullНаблюдаемые признаки соблюдения: по ним видно, что решение опирается на ценность; null — не заданы.
meaningдаstring | nullЧто ценность значит для компании; null — не задано.
nameдаstringНазвание ценности: по нему её узнают; без учёта регистра у компании одно.
violatedдаstring | nullНаблюдаемые признаки нарушения: по ним видно, что решение с ценностью расходится; null — не заданы.

CompanyNorthVision ​

Видение. Видение компании: смелая цель на 10–30 лет, год, к которому она достигнута, и яркое описание конечного состояния. Каждое поле может быть null — не задано.

ПолеОбязательноТипЗачем
descriptionдаstring | nullЯркое описание конечного состояния: какой станет компания, когда цель достигнута; null — не задано.
goalдаstring | nullСмелая цель, к которой компания идёт: одна фраза, по которой видно, достигнута она или нет; null — не задана.
horizon_yearдаinteger | nullК какому году цель достигнута; null — год не задан.

CompanyNorthInput ​

Север для записи. Миссия, видение и ценности, которые записывает владелец или администратор. Заменяют прежний север целиком. Признак заполненности, ревизию, время и автора записи ставит сервер.

ПолеОбязательноТипЗачем
missionдаstring | nullМиссия: зачем компания существует — не продукт, а смысл её работы; null — не задана.
valuesдасписок CompanyNorthValueЦенности: принципы, по которым компания принимает решения; пустой список — не заданы.
visionдаCompanyNorthVisionВидение: смелая цель, год и описание конечного состояния.