Всем привет. Я здесь постоянно делюсь разными нашими проектами, рассказываю о парсерах, нейросетях и всяких тонкостях в нашей работе. Но любая разработка, всегда включает в себя важный пункт – техническое задание. Многие даже понятие не имеют что это такое и как с этим работать, а также для чего это вообще нужно.
Техническое задание (ТЗ) нужно, чтобы все участники проекта одинаково понимали задачу. В нём чётко прописывают, что нужно сделать, как это должно работать и какие есть ограничения. Если ТЗ составлено неправильно или не проверено, результат может не совпасть с ожиданиями, а исправления займут лишнее время, деньги и нервы.
ТЗ помогает контролировать качество — по нему легко понять, выполнена ли работа как договорились. Оно защищает от лишних правок и недовольства клиента.
Также ТЗ упорядочивает процесс: ясно, что и когда делать, какие ресурсы нужны и к какой цели идти. Это экономит время, снижает количество ошибок и улучшает результат.
Как правильно написать ТЗ? (Прикрепляю также реальный пример, из наших разработок)
1. Введение Кратко опиши проект, его цель и решаемую проблему.
2. Функционал
3. Технические требования
4. Качество
5. Сроки
Пример реального ТЗ
Цель работы.
На основе данных заказчика, программа должна осуществлять поиск информации из сервисов сайта Froza.ru и генерировать XLSX-файлы, форматов, указанных в требованиях заказчика.
Принцип работы программы.
При запуске консольное приложение должно предложить 2 варианта работы программы:
Сбор данных с сервиса сайтов Froza.
· Получения фильтров из файла фильтров заказчика.
· Получение настроек из файла настроек заказчика.
· Получение входных данных из файла входных данных.
· Получение цен прошлых загрузок из файла БД.
Фильтры:
· Минимальный (по умолчанию 0) и максимальный (по умолчанию 2) сроки доставки.
· Минимальный и максимальный рейтинг продавца.
· Минимальный и максимальное количество в наличии.
Настройки:
· Процентная разница для вычисления рекомендуемой цены (по умолчанию 2%).
Авторизационные данные: логин\пароль, идентификатор магазина, город магазина
Формат данных в БД.
· Бренд
· Артикул
· Цена прошлой загрузки
· Признак исключения
Наша система сама подберет вам исполнителей на услуги, связанные с разработкой сайта или приложения, поисковой оптимизацией, контекстной рекламой, маркетингом, SMM и PR.
Заполнить заявку
13201 тендер
проведено за восемь лет работы нашего сайта.
Формат входных данных.
Основной входной файл (input.xlsx) должен содержать следующие обязательные колонки:
На основе авторизационных данных, собираем предложения по позициям с сервиса Froza.ru. Среди найденных предложений ищем предложения заказчика, сопоставляя их по авторизационным данным заказчика (город, идентификатор).
По ценам прошлой загрузки, полученных из БД, и найденным предложениям заказчика, вычисляем диапазон процентной наценки по сайту Froza для этого заказчика.
На основе фильтров заказчика, фильтруем предложения, полученные с сервиса Froza, отфильтрованные предложения сортируем по цене от наименьшего к большему.
Для каждой позиции есть два варианта расчета-записи.
1) Если есть цена исключения, то эту цену мы записываем в «цена для загрузки». Розница (РЦ) будет пустой. Желтый цвет заливки (желательно светлый) для «Цены для загрузки».
2) Розница (РЦ) рассчитывается в зависимости от позиции предложения заказчика. Если он находится на 1 месте, то расчет идет цена 2 конкурента -- процентная разница для вычисления рекомендуемой цен. В остальных случаях, цена 1 конкурента -- процентная разница для вычисления рекомендуемой цены. На основании ранее полученных процентных диапазонов высчитываем цену для загрузки при которой на сайте будет отображаться Розница (РЦ).
Формула: «Цена для загрузки» = «Розница (РЦ)» /(1+ «Процентная наценка Фрозы для этого диапазона Розницы (РЦ)» /100).
Если разница между ценой прошлой загрузки и текущей ценой для загрузки является положительной – то для «Цена для загрузки» используем зеленый цвет. Если же отрицательная – то красный.
Формат выходного файла (итоговая таблица)
После обработки программа должна формировать итоговый файл (Excel), в котором отображаются:
1. Бренд — из входного файла
2. Артикул — из входного файла
3. Название — из входного файла
4. Наш остаток — из входного файла
5. Цена для Загрузки
6. Розница (РЦ)
7. 5 ближайших конкурентов по самой низкой цене — список из 5 продавцов с минимальными ценами по товару
Выходной файл сохраняется в папку «Output». С шаблонами и наименования froza-parsingresult-{год-месяц-число-час-минута}.xlsx
Безопасность
1. Программа должна быть ограничена по сроку действия: через 6 месяцев после первого запуска работа должна быть заблокирована.
2. Мы высылаем программу через полгода, по запросу клиента
А как понять, что твоё ТЗ правильно составлено?
Проверь следующие моменты:
Самое основное и самое важное – согласование с заказчиком — ТЗ должно быть обсуждено и согласовано с заказчиком, чтобы убедиться, что все его пожелания учтены.
Далее проверить на четкую реализацию, того, что у вас указано в ТЗ, и что все это звучит доступно, понятно, а главное реалистично.
Вывод простой: выполнять проект без ТЗ — это как пытаться собрать IKEA-шкаф по памяти, в темноте, без инструкции и с кошкой, которая постоянно прыгает на детали. Можно. Но лучше всё-таки с ТЗ.
И помни, у тебя могу возникать ошибки, но на них мы учимся, не бойся практиковаться, и со временем, ты даже не заметишь сложностей в ТЗ, и будешь писать их идеально.