Presentation

[mrHoft]

Leaf up team presentation

Английский текст и примечания не зачитываем)
(открыта вкладка home)

Представляю проект magic-seeds.

== Highlights of Team Contributions

Организация команды

(открыта вкладка Leaf-up)

Для организации эффективной работы команды первую очередь мы создли:

• Чат команды (в телеграм)
• Организацию в github, чтобы всё было "под рукой"
• Менеджер проектов (мы использовали github projects)
• Для крупных тем завели github discussion (к примеру, создание идеи проекта, подготовка каталога продуктов или эта презентация у нас создавались и использовались благодаря discussion)
• Приняли методические рекомендации касательно code style и работы с репозиторием
• Решили придерживаться Feature-Sliced Design,- это методология определяющая файловую структуру и правила для импортов.

Командное взаимодействие

(открыта вкладка pulls)

• Для хорошего старта, в начале мы распределили основные направления: api, интерфейс, тесты чтобы каждый занимался чем то одним но углублённо. И в последствии, благодаря ознакомлению с кодом в ходе ревью, и другие члены команды подключались к этим задачам по уже знакомым алгоритмам.

(открыта вкладка Implement remove from cart button: этот PR можно долго листать пока рассказываешь)

• Крайне эффективным оказалось внимательное ревью пулл-реквестов: так быстро исправлялись ошибки, отхождения от принятой методологии и вносились оптимизации.
• Уже через три недели с начала проекта приноровились мержить пулл-реквесты со всеми ревью и правками в течении нескольких часов после запроса на ревью в чате.

== Dynamics of Team Coordination

Использование таск-менеджера

(открыта вкладка projects в режиме спринтов)

• Github projects хорошо "заточен" на разработку: мы привязывали карточки к issue, где помимо колонок доски, хорошо отслеживался процесс работы над задачей, благодаря привязке пулл-реквестов. Некоторые из задач мы разбивали на подзадачи между членами команды.

Тыкаешь на любую карточку с сиреневой галочкой и пролистываешь, показывая детальное описание и историю изменений)

• Использовали настройки спринтов, приоритета и критерии выполнения.

Коммуникация

остаётся открыта вкладка из таск менеджера, пролистанная вниз до конца

• Для связи использовали телеграм чтобы быстро запрашивать ревью и смайлами отмечали статус проверки. Так же тут обсуждали текущие вопросы.
• Для еженедельных созвонов использовали google.meet. Так же созванивались в нём если нужно было пошарить экран и что то обсудить более детально чем в чате.

Approach to Task Allocation

(открыта вкладка, показываешь на пункты с галочками)

• Задачи принимали по выполненным критериям, код-стайлу и соответствию принятой методологии.

== Technical Framework and GitHub Practices

Аналитика GitHub

(открыта вкладка activity)

• Это аналитика GitHub. Я сразу выбрала показывать только pull-request merge, иначе там слушком много всего.

Example of a Pull Request and Associated Code Review

этот пункт пропускаем так как уже показывали как у нас оформлены PR и проходил ревью

README Documentation, Overview of Technology Stack

(открыта вкладка Guidelines, переходишь по ссылкам в ней, показываешь все страницы)

• Мы хорошо задокументировали все ключевые аспекты совместной разработки: как оформляются коммиты, как работаем с репозиторием, и даже приняли спецификацию для типизации, помимо автоматического линтинга на базе airbnb.

Использованные технологии

(открыта вкладка [README](https://github.com/Leaf-up/E-com/blob/develop/README.md, показываешь на бэджики фреймворков и библиотек, читаешь их список, приведённый там же)

• Из ui библиотек мы использовали просмотрщик из Ant design (уж больно он хорош), но и его внешний вид модифицировали override стилями.
• Остальные компоненты, включая довольно сложные реализовывали сами потому что нам и самим было интересно их сделать. Все компоненты выполнены в едином стиле.

== Total:

(открыта вкладка home)

В процессе разработки столкнулись с проблемами:

1. Пришлось потратить немало времени на изучение интерфейса commercetools чтобы понять где там находятся продукты, варианты, скидки, дисконты: api отдавал не то что ожидается, приходилось вникать в тонкости настройки.
2. Документация commercetools обширная, учитывает множество (не нужных в нашем проекте) аспектов, часть данных содержит референсы, которые пришлось "фетчить" отдельно потому что сервер не отдаёт всю необходимую информацию разом.
3. Сложно далась связь фильтров, категорий, поиска и сортировки: чтобы одно не отменяло другого пришлось реализовать апи и комплекс форм чтобы получаемый ответ соответствовал выбору пользователя.
4. Благодаря малой команде и чётко описанным правилам нам удалось избежать типичных трудностей совместной работы. Работали сплочённо, не конфликтовали, спорные вопросы не развивали а шли друг другу на встречу: это мы в последствии поделились фидбэком о том насколько было комфортно вместе работать.

(открыта вкладка about)

Отмечу некоторые из интересных фич, которые мы реализовали в ходе проекта

• Добавили поддержку тем интерфейса. По умолчанию приложение использует системную тему, а в настройках профиля можно выбрать собственную.
• Реализовали довольно крутой и универсальный компонент слайдера.
• Для страницы about сами написали markdown parser, что позволило описание проекта не хардкодить в виде разметки а держать в отдельном файле и менять его в любое время не пересобирая проект.
• Сделали множество собственных ui компонент а так же modals, popups и message component.
• Сделали интересную валидацию полей форм в виде patrial-application.

Итоги:

(открыта вкладка miro)

• Было интересно создать некий кусочек интернет магазина и добавить этот опыт в свою копилочку знаний.
• Не могу с благодарностью не отметить детальное техническое задание на этот проект, печалит лишь то что врядли когда-нибудь такое ТЗ встретится в реальном проекте.
• Лично для меня это был не первый командный проект, а вот коллега по команде наверняка вынесла для себя много полезных навыков из этой колоборации.
• И как вы могли увидеть, взаимодейтсвие у нас было налажено на высоком уровне: все ключевые аспекты были заранее документированы, стэк технологий и концепцию мы выбрали голосованием, поэтому повода для разногласий не возникало.

На этом у меня всё. Готов ответить на ваши вопросы.

[mrHoft]

Давай перепроверим "Criteria for Assessment" и можно будет удалить их из текста презентации, чтобы не отвлекали.