Cardplace.ru

Appearance

Переключение данных с локальных на боевые ​

Nuxt/Vue ​

В проектах на nuxt/vue спецификация размещается по адресу /open-api/.

Каждый метод может быть помечен одним из тегов:

  • NOT_IMPLEMENTED - метод не внедрен на бекенде, функциональность работает на локальных данных
  • IMPLEMENTED - метод внедрен на бекенде, функциональность работает на локальных данных
  • NEED_UPDATE - необходимо внести изменения в метод
  • Отсутствие одного из тегов NOT_IMPLEMENTED, IMPLEMENTED, NEED_UPDATE - метод внедрен на бекенде, функциональность работает на реальных данных

После внедрения метода backend программисту необходимо сделать 3 коммита:

  1. feat/fix: описание реализации.

  2. switch: переключение frontend на боевые данные.

    Пройти по файлам, которые относятся к добавленному api и заменить на реальные методы. Локальные методы отмечены TODO. Если была добавлена новая сущность, зайти в local-api/entity/entity.js. Найти код с нужной entity и удалить условие.

  3. api: внесение изменений в теги спецификации реализованного метода.

Переключение функциональности на реальные данные именно бекенд специалистом обуславливается тем, что ответственность за сдачу рабочей задачи лежит именно на бекенд специалисте (т.к. он последний в "цепочке" исполнителей) и это позволяет избежать лишних затрат на задачу.

Legacy ​

В legacy проектах, где шаблонизатором является php и разметка страницы хранится в компонентах bitrix верстка хранится в директории /_dev/. Логические куски верстки помечаются разработчиками frontend отдела комментариями <!-- NOT IMPLEMENTED --> или <!-- TODO: backend -->

Пример
html
<!-- NOT_IMPLEMENTED [блок "характеристики и параметры"] -->
    <section class="page-model-single__characteristics">
        <div class="base-container">
            <? require("./components/page-model-single-characteristics.php"); ?>
        </div>
    </section>
<!-- /[блок "характеристики и параметры"] -->

<!-- TODO: backend - выводить код товара -->
    <div class="product-card__code">
        Код: 00-00034165
    </div>

После внедрения верстки backend программисту необходимо убирать комментарии ToDo и изменять комментарии NOT IMPLEMENTED на IMPLEMENTED