Составлю чёткое техническое задание и спроектирую контракт API для одной функциональности или интеграции. Переведу бизнес-задачу в конкретные технические требования, чтобы команда разработки сделала именно то, что нужно бизнесу, без переделок и «сюрпризов».
Документация поможет:
— зафиксировать требования до начала разработки и согласовать их с бизнесом;
— получить точную оценку стоимости и сроков от программистов;
— одинаково понимать задачу заказчику, аналитику и разработчикам;
— сократить количество правок и уточнений во время спринтов;
— проверить готовое решение по заранее согласованным сценариям.
Что входит в фиксированную стоимость:
— один письменный бриф или интервью продолжительностью до 60 минут;
— анализ существующей документации, прототипов или базы знаний (Confluence/Notion);
— описание цели и границ решения (что входит и не входит в проект);
— описание ролей пользователей (до 3 ролей);
— до 10 функциональных требований;
— до 3 пользовательских сценариев (User Story / Use Case);
— описание до 2 основных сущностей данных и 20 полей;
— до 5 методов API (REST): эндпоинты, параметры, запросы, ответы, коды ошибок;
— основные нефункциональные требования (производительность, безопасность);
— до 8 критериев приёмки (acceptance criteria);
— один раунд правок после получения комментариев.
Ориентировочный объём документа — 8–12 страниц.
В услугу не входят:
— разработка интерфейса и макетов экранов (UI/UX-дизайн);
— проектирование полноценной архитектуры системы и микросервисов;
— детальная спецификация SOAP/GraphQL (можно добавить опцией);
— обследование исходного кода существующей системы;
— разработка программного обеспечения;
— BPMN-схемы бизнес-процессов AS IS / TO BE (можно добавить опцией);
— требования к нескольким независимым системам или более чем к одной интеграции;
— юридическая экспертиза и анализ персональных данных.
Требования, не вошедшие в согласованный объём, можно добавить отдельной опцией.
Заказчик получит:
Word (.docx), PDF, Markdown (.md), OpenAPI-спецификация (YAML / JSON), схемы и диаграммы (PNG, SVG, Draw.io)
До начала работы заказчик должен предоставить:
Описание бизнес-задачи и ожидаемого результата; пользователей системы и их сценарии; существующую документацию, прототипы, ссылки на базы знаний (Confluence/Notion); список предполагаемых интеграций и ограничения; контактного стейкхолдера для уточнения бизнес-требований. Рабочие доступы к системам не обязательны — достаточно описания логики.
