Тема
Миссия, видение и ценности
Семейство 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 | Видение: смелая цель, год и описание конечного состояния. |