# Области: организация и проект

> Знание всей организации или одного проекта разработки: что куда класть, кто это видит и как модель это получает.

У каждой записи одна область: **вся организация** или **один проект разработки**.

## Что во что класть

**Организация** — то, что верно везде, в любом проекте:

- правила работы («обязательно YAGNI», «комментарии по-русски»);
- решения уровня компании, записанные как правила («в апстрим публикуем только через PR»);
- ссылки на общие ресурсы.

**Проект** — то, что верно только здесь:

- факты о конкретной кодовой базе и её окружении;
- ловушки сборки и тестов этого проекта;
- решения, принятые в этом проекте.

Сомневаетесь — кладите в проект. Записать знание в организацию значит показать его каждому прогону каждого проекта: правило, верное для одного проекта, будет мешать в остальных.

## Как это видит модель

Прогон проекта `P` в организации `O` получает:

- все активные записи организации `O`;
- все активные записи проекта `P`.

Чужие проекты не видны никогда — ни в индексе, ни по требованию.

## Как это видят люди

Участник видит записи тех областей, куда достаёт его [право чтения](/docs/knowledge/permissions): грант на проект даёт записи этого проекта и записи организации; грант на организацию — всё.

В списке область показана значком у каждой записи, а фильтры позволяют смотреть по одной области за раз.

## Кто может писать куда

| Кто | Организация | Проект |
| --- | --- | --- |
| Человек с правом изменения на организацию | да | да |
| Человек с правом изменения на проект | нет | только этот проект |
| ИИ | **нет, никогда** | только свой проект |

Общеорганизационные записи — целиком человеческая территория: это правила, по которым работает вся компания, и модель их не устанавливает.