Как я собрала техническую спецификацию для e-commerce-платформы
В этом проекте нужно было связать интерфейсы, бизнес-правила и внешние интеграции интернет-магазина в одном документе. Платформа соединяла покупателя, доставку, партнёров и внутренние системы FMCG-холдинга.
Описание обобщено и адаптировано: здесь нет доступа к внутренним материалам клиента. Числа о составе исходных материалов относятся к описанию проекта, а не к измерению эффективности ИИ.
Что было на старте
37 экранов дизайна, таблицы с более чем 200 SKU и атрибутами товаров, карты интеграций с оплатой, доставкой и CRM, а также регламенты по возвратам, срокам и бонусам. Эти материалы описывали разные части одного процесса.
Моя задача — собрать рабочую спецификацию, в которой видно, как пользовательский сценарий связан с данными, правилами и поведением системы при ошибке.
1. Собрать реестр материалов
Я просмотрела макеты, таблицы и описания интеграций и разложила их по категориям. Реестр помогал находить исходное основание требования и замечать вопросы, для которых материала ещё не было.
2. Согласовать язык требований
GPT-ассистент помогал выравнивать формулировки и находить возможные повторы. Термины были сведены в глоссарий. Устранение противоречий требует решения ответственного человека: модель может показать расхождение, но не определить за заказчика, какое правило верное.
3. Построить структуру спецификации
Я организовала разделы и шаблоны описания: каталог и карточка товара, корзина, оформление заказа, расчёты, личный кабинет и интеграции. Для каждого раздела обозначила назначение и связи с другими частями.
4. Описать сценарии и исключения
Помимо основного пути, в документ вошли скидки и промокоды, проверки при заказе, повторный заказ, отсутствие товара и сообщения об ошибках. Сценарии сопоставлялись с макетами и интерфейсами интеграций.
5. Описать обмен данными
Для внешних систем были собраны параметры, методы, статусы и примеры ошибок. Здесь важно опираться на согласованные контракты интеграции: правдоподобное описание, сгенерированное ИИ, не заменяет действительный API.
6. Связать процесс и роли команды
Вместе с командой была составлена схема заказа и доставки. Финальный документ включал оглавление, ссылки на экраны во внутреннем контуре и пояснения для менеджера, дизайнера, разработчика и QA.
Где помогал ИИ
В обработке текста: привести записи к одной форме, предложить структуру, подсветить повторения и подготовить вопросы. Ответственность за бизнес-правила, полноту сценариев и согласование оставалась у людей.
Результат
Материалы проекта были собраны в единую спецификацию. Она связывала требования, пользовательские действия и технические сценарии. Разработчикам она давала основу для реализации, а QA — для проверки обычных и нештатных ситуаций.