← Все материалы

Новому участнику

Первый проект: система, два сервиса и один документ

Небольшой стартовый маршрут без переноса всей документации. Подходит, чтобы проверить подход на своей задаче.

Учебный примерФайлы к материалу ↓

01

Выберите одну понятную задачу

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

После установки и первичной настройки проверьте, что ваша роль разрешает работу с нужными объектами и инструментами. Права пользователя и доступные по лицензии модули — разные условия доступа.

02

Соберите минимальную структуру

Не пытайтесь сразу отразить все детали инфраструктуры. Проверьте, помогает ли карта ответить на выбранный вопрос.

  1. Создайте систему с названием вашего проекта.
  2. Откройте её и добавьте продукт.
  3. Добавьте два сервиса с понятными именами.
  4. Создайте связь и опишите, какие данные передаются.

03

Опишите один сервис

Откройте документацию сервиса. Запишите его назначение, вход, выход, ошибку и поведение повторного вызова. Используйте встроенный Service Doc или скачиваемую структуру. Для каждой неизвестной детали сформулируйте вопрос.

04

Дайте документ другому участнику

  1. Выдайте участнику нужные права на объекты и инструмент базы знаний.
  2. Попросите найти сервис по карте и прочитать описание.
  3. Проверьте, может ли он объяснить вход, выход и зависимость сервиса.
  4. Добавьте в документ ответы на возникшие вопросы.

Неопределённый читателем ответ — хороший повод уточнить описание. Для первой проверки не нужен полный перенос проекта.

МАТЕРИАЛЫ ДЛЯ РАБОТЫ

Продолжите на своём примере

Учебные правила и данные нужно адаптировать к вашей системе. Набор не является готовой реализацией магазина.

Скачать полный набор ↓

Инструменты из этого материала