Сайт сдан, доступы переданы, обучение прошло. Через месяц клиент пишет: "нужно поправить текст в блоке под калькулятором, где это в админке?" И если ответ знает только разработчик, проект передан наполовину. Карта проекта существует, чтобы такого вопроса не возникало.
Карта проекта
Определение
Карта проекта – документ, который связывает то, что видно на сайте, с тем, где это лежит в CMS: раздел, инфоблок, конкретное поле и результат его изменения. По ней клиент правит сайт сам, не обращаясь к разработчику.
3 мин 58 Обновлено 19 октября
Как это работает
Карта проекта отвечает на один вопрос, заданный в обе стороны: "этот блок на странице – откуда он берётся" и "если я поменяю это поле – что изменится на сайте". Минимальная рабочая строка карты состоит из четырёх колонок.
| Что на сайте | Где в админке | Поле или свойство | Что изменится |
|---|---|---|---|
| Блок характеристик в карточке товара | Каталог – раздел – элемент | Свойства товара: размеры, тип привода, гарантия | Строки в таблице характеристик и значения в фильтре каталога |
| Акция на главной странице | Инфоблок акций | Название, картинка анонса, текст анонса, дата окончания | Карточка в блоке акций и страница самой акции |
| Отзыв на странице отзывов | Инфоблок отзывов | Имя, текст, фото, активность | Карточка в ленте отзывов и в блоке отзывов на главной |
| Заголовок вкладки браузера и сниппет в поиске | Элемент – вкладка SEO (поисковая оптимизация) (галочка "Изменить для этого элемента") | Заголовок и описание страницы | Заголовок во вкладке браузера и вид страницы в поисковой выдаче; в тексте самой страницы не появляется |
Что входит в карту помимо таблицы
- Схема разделов сайта и соответствие им инфоблоков. Видно, что каталог, блог и отзывы – это разные хранилища, и понятно, куда идти за нужной страницей.
- Правила заполнения. Какие поля обязательные, в каком размере и формате грузить картинки, какой длины писать заголовки и описания – всё, что иначе выясняется методом проб на живом сайте.
- Что не редактируется из админки. Отдельный список блоков, зашитых в шаблон. Это экономит больше всего времени: человек не ищет полчаса поле, которого не существует.
- Служебная часть. Где формы, куда приходят заявки, где стоят счётчики аналитики, кто получает уведомления.
Формат вторичен: это может быть таблица, документ со скриншотами или схема в Figma. Важно, чтобы карта открывалась без специальных программ и чтобы в ней был поиск по названию блока – именно так ей пользуются на практике.
Чем карта проекта отличается от карты сайта
Слова похожи, документы разные, и путаница между ними встречается постоянно.
| Документ | Для кого | Что содержит | Где живёт |
|---|---|---|---|
| Карта проекта | Клиент и его контент-менеджер | Связь интерфейса с инфоблоками, полями и свойствами | Отдельный документ вне сайта |
| sitemap.xml | Поисковые роботы | Список адресов страниц и дат их обновления | Файл в корне сайта |
| Карта сайта для посетителей | Посетитель | Ссылки на разделы одной страницей | Обычная страница сайта |
| Структура сайта | Команда проекта на этапе проектирования | Иерархия разделов и логика страниц | Прототип, до разработки |
Зачем это нужно
Карта проекта – это то, что превращает сайт из услуги в актив компании. Что она даёт заказчику:
- Независимость от одного человека. Ни от разработчика, ни от сотрудника, который вёл сайт и уволился. Документ живёт дольше, чем любой из них.
- Быстрый ввод новых людей. Новому контент-менеджеру не нужно неделю выяснять, где что лежит, – он открывает карту и работает.
- Экономию на мелких правках. Правки уровня "поменять текст, картинку, цену" делаются внутри компании и не превращаются в задачи подрядчику.
- Основу для обучения и инструкции. Инструкция контент-менеджера пишется поверх карты: карта отвечает "где", инструкция – "как".
- Проверку качества самой разработки. Когда карта собирается параллельно с работой, сразу видно, что поле названо непонятно, что один и тот же текст редактируется в двух местах или что важный блок вообще не вынесен в админку.
Последний пункт – причина, по которой карту нужно вести во время разработки, а не писать после сдачи. Написанная задним числом карта составляется по памяти, и в неё не попадают именно те мелочи, из-за которых потом звонят.
Пример
В кейсе "Колибри" карту проекта я собирала параллельно с разработкой на dev-сервере: какие разделы существуют, из каких инфоблоков они собираются, какое поле за что отвечает и что изменится на сайте, если это поле поправить.
Этот документ стал основой обучения. Поверх него собрана визуальная инструкция в Figma: как добавить товар, завести акцию, опубликовать новость или статью, изменить контент на главной и работать с заявками. Вместо большого текстового регламента – схема со скриншотами и пояснениями, где видно, какой раздел админки открыть, какое поле изменить и как это отразится на сайте.
Логика простая: сначала карта отвечает на вопрос "где это лежит", затем инструкция показывает "что нажимать". В сумме клиент получает не только готовый сайт, но и систему, которой он может управлять сам – включая наполнение каталога и правку SEO-метаданных без обращения к разработчику.
Частые вопросы
Что такое карта проекта сайта?
Это документ, связывающий интерфейс сайта с данными CMS: какой блок на странице из какого инфоблока и поля собирается и что изменится, если это поле поправить. По сути – карта местности для того, кто будет вести сайт после запуска.
Чем карта проекта отличается от sitemap.xml?
sitemap.xml – служебный файл со списком адресов страниц, он предназначен для поисковых роботов и лежит в корне сайта. Карта проекта предназначена для людей и описывает не адреса, а устройство: где в админке редактируется каждый блок. Это разные документы для разных задач.
Кто составляет карту проекта?
Разработчик или руководитель проекта – тот, кто заводил инфоблоки и знает, какое поле куда выводится. Клиент карту принимает и проверяет на понятность: если по ней невозможно найти нужный блок без подсказки, документ ещё не готов.
Когда собирать карту проекта – во время разработки или после сдачи?
Во время. Собранная параллельно карта фиксирует решения сразу и заодно вскрывает проблемы: непонятно названные поля, блоки, забытые в шаблоне, дублирование одного текста в двух местах. Написанная задним числом карта пишется по памяти и теряет мелочи.
В каком формате делают карту проекта?
Формат не принципиален: таблица, документ со скриншотами, схема в Figma. Важнее два свойства – она открывается без специальных программ и по ней можно быстро найти нужный блок. На практике удобнее всего связка "таблица соответствий плюс скриншоты админки".
Что обязательно должно быть в карте проекта?
Соответствие разделов сайта инфоблокам, разбор ключевых страниц по полям и свойствам, правила заполнения (обязательные поля, форматы картинок, длины текстов), список блоков, которые из админки не редактируются, и служебная часть: куда приходят заявки и где стоят счётчики.
Можно ли обойтись без карты проекта?
Можно, если сайт маленький и вести его будет тот же человек, который его делал. Как только появляется отдельный контент-менеджер, второй подрядчик или просто пауза в несколько месяцев, отсутствие карты превращается в постоянные вопросы разработчику и в оплату его времени за правку текста.
Связанные термины
Материалы по теме
Что почитать дальше по этой теме