В уроке 14 вы собрали форму обратной связи, но работала она как заглушка: пользователь нажимал «отправить», сайт показывал «спасибо», а сами сообщения никуда не уходили. Пора оживить форму, чтобы она по-настоящему принимала сообщения от посетителей сайта.
Допустим, вы напишете агенту: «запусти форму, чтобы она принимала сообщения». Он возьмется за работу и сделает — но как именно? Любую задачу можно реализовать десятком разных способов. Пользователь отправил форму с пустым именем — принять ее или попросить заполнить? Ввел в email что-то несуразное вроде «abc@» — показать ошибку или принимать как есть? Нажал «отправить» десять раз подряд — считать это спамом или сохранять все десять сообщений? Вдобавок остаются вопросы попроще: какой максимальный размер у сообщения, куда его сохранять, что показать после отправки. Агент не знает ответов на эти вопросы и будет решать все сам на ходу. Результат может оказаться рабочим, но совсем не тем, что вы имели в виду.
Короткая задача описывает, что сделать, но не объясняет, как именно это должно работать. Чтобы агент сделал так, как вы задумали, нужно заранее договориться с ним о деталях. Для этого и нужна спецификация, о которой мы поговорим в этом уроке.
Прежде чем добавлять новую функцию, ее нужно описать в отдельном документе. Что именно она должна делать, как должна работать, как вести себя в нестандартных ситуациях. Этот документ называется спецификация, или просто спек. По сути это техзадание на конкретную работу. Чтобы его написать, не нужно разбираться в коде или технологиях — достаточно на уровне понятий договориться с агентом, как все будет работать.
Спек — это не описание всего сайта. Все, что уже сделано и работает, живет в документации, которую вы собрали в прошлом уроке. Спек описывает только то, что вы собираетесь сделать. В маленьком проекте вроде нашего сайта можно обойтись одним спеком на весь сайт целиком. В большом проекте спеки пишут на каждую отдельную функцию.
Например,…
