Aatex Navigation

Навигация по ЦУП ААТех

Когда использовать

• Начало любого сценария с карточками (нужны boardId, spaceId, columnId)
• Пользователь спрашивает: «какие доски», «покажи пространства», «что на доске»
• Поиск нужной доски по названию («найди доску Закупки»)
• Проверка ограничений колонки (какие типы карточек разрешены)

Иерархия

Organization
└── Space (пространство — тема работы)
    └── Board (доска — канбан)
        └── Column (колонка — статус)
            └── Card (карточка — задача)

Инструменты

Сценарии

1. «Покажи доски»

Самый быстрый способ — list_all_boards. Он вернёт плоский список всех доступных досок с именами пространств. Не итерируй list_spaces → list_boards если пользователь не уточнил пространство.

2. «Найди доску по названию»

list_all_boards → фильтруй по title (case-insensitive contains)

Если нашёл одну — запомни её id. Если несколько — уточни у пользователя.

3. «Какие колонки на доске»

get_board_columns(boardId) → board.columns: [{id, title, isFinalColumn, attachedBoardId, allowedCardTypes?}]

Обрати внимание:

• isFinalColumn: true — финальная колонка (завершение работы, автоматизация)
• attachedBoardId — колонка каскадит карточки на dispatch-доску
• allowedCardTypes — ограничения по типам карточек в этой колонке (если задано)

4. Получить columnId для создания карточки

1. list_all_boards → найти primary доску
2. get_board_columns(boardId) → выбрать подходящую колонку
3. Запомнить columnId + проверить allowedCardTypes

Важные особенности

Primary vs Dispatch

card.boardId всегда указывает на primary. Если нужно переместить карточку на dispatch — используйте primary колонку с attachedBoardId, каскад сработает автоматически.

Доступ к доскам

• Доска с пустым userIds (не personal) — видна всем в орге
• Доска с заполненным userIds — только перечисленным + owner/admin
• Personal board (userId set) — только владельцу + owner/admin
• MCP-клиент видит ровно те же доски, что пользователь в UI

Архивация

archive_board работает только если на доске нет активных (не-архивных) карточек. Если есть — предложи пользователю:

1. Массово заархивировать карточки: bulk_move_cards в колонку + archive_card
2. Или переместить на другую доску

Типичные ошибки

Пример (типичное начало сценария)

Пользователь: «Создай карточку "Закупка подшипников" в Производстве»

1. list_all_boards
   → ищу spaceName="Производство" + boardType="primary"
   → нашёл boardId=42, spaceId=7
2. get_board_columns(42)
   → выбираю колонку "Новые" columnId="col_abc123"
3. (перехожу к create_card с найденными ID)