План сайта

PLAN.md создаётся в момент завершения первой сборки проекта и всегда должен описывать сайт таким, какой он есть сейчас, а не журнал всего, что с ним происходило (для этого есть вкладка «Версии» и «Журнал изменений»). Экран «План сайта» разбирает этот Markdown в настоящий интерфейс: таблица для страниц, список для модулей, чек-лист для открытых вопросов и обычный текст для бизнес-фактов, бренда и решений.

Пока ни одна сборка не завершена, читать пока нечего: экран показывает «Плана пока нет», просто объясняет, что план пишется при первой сборке проекта, и даёт ссылку назад на страницу проекта вместо пустой таблицы.

Сайт, файлы которого поступили без плана (опубликованы из другого ИИ-инструмента через коннектор, импортированы или загружены), всё равно получает план: экран создаёт его на основе брифа проекта, выбранных наборов и измеренных страниц. Баннер «Этот план создан для вас» предлагает «Сохранить этот план», что делает его настоящим планом проекта, и тогда каждый раздел можно редактировать. Ссылка «Читать полный план сайта» ведёт к документу плана на вкладке «План и бриф».

Инструменты, добавленные позже из набора (кнопка «Добавить в план»), появляются в списке модулей со статусом «Запланировано» и ссылкой «Посмотреть в наборе», даже если текст плана был написан до их добавления.

Под заголовком одна строка показывает, когда план в последний раз был обновлён: «План обновлён 2 окт., 15:04». Это время берётся из последнего замера реальных файлов сайта, который aiKit выполняет после каждого изменения (правка в чате, закрепление, добавление из набора, восстановление, ручная правка плана или публикация из другого ИИ-инструмента).

Вверху, когда план готов: общая полоса процента выполнения и под ней три плитки: Созданные страницы (из запланированных), Созданные модули (из выбранных) и Ответы на вопросы (из открытых вопросов плана). Каждая плитка — кнопка, которая прокручивает к разделу, который она считает. Ничего из этого не берётся из самого текста плана: страница считается созданной, только если aiKit нашёл её в реальных файлах сайта; модуль считается созданным только по проверенному отчёту о сборке или по модулю, найденному в файлах; а вопрос считается отвеченным, когда его строка отмечена в плане или клиент ответил на него на своей странице Вопросы.

Два обстоятельства заставляют план отставать, и экран указывает, какое именно: ИИ-проход, который переписывает план после изменения, не завершился («Письменный план не обновился после последнего изменения», с причиной), или сайт стал новее той версии, по которой измерялся план («Сайт изменился после последнего обновления этого плана»). В любом случае появляется кнопка «Обновить план». Страница не запускает её сама при открытии (открытие страницы никогда не использует ИИ); движок и так вносит каждое изменение в план в фоновом режиме, а кнопка нужна, когда это отстало. «Обновить план» вносит самое новое изменение в написанный план и заново измеряет сайт. Если и это не сработало, баннер остаётся с описанием проблемы, и вы можете нажать «Обновить план» ещё раз или отредактировать план вручную.

Карточка «Здоровье» оценивает сайт из 100 по правилам, которые aiKit проверяет в реальных файлах, а не по мнению ИИ: отсутствующий или повторяющийся заголовок страницы или описание для поиска, страница без главного заголовка или с несколькими такими заголовками, ссылка на несуществующую страницу, страница, на которую никто не ссылается и которой нет в меню, изображения без описания для программ чтения с экрана, очень короткие страницы, форма без адреса отправки и модуль, который требовал бриф, но которого нет на сайте. В каждой проблеме указано, на какой странице она и почему важна, и есть кнопка «Исправить»: она отправляет готовую инструкцию по проблеме как запрос и передаёт его ИИ, пока тот работает, кнопка показывает «Запрос на исправление», а после внесения изменения оценка измеряется заново. Фильтруйте список по важности счётчиками «Высокая», «Средняя» и «Низкая», а «Показать все» снимает фильтр.

Карта сайта показывает сайт в виде дерева: главная страница вверху, затем меню по порядку, затем страницы, ведущие с этих страниц. Страницы, на которые никто не ссылается, находятся в отдельной группе; запланированные, но ещё не созданные страницы рисуются пунктиром и помечаются «Запланировано»; созданные страницы, которых нет в плане, помечаются «Нет в плане» и имеют кнопку «Добавить в план», которая добавляет их в раздел «Страницы».

Нажмите на любую страницу (на карте сайта или в списке страниц), чтобы открыть её сведения рядом с планом. Адресная строка изменится на ?page=/about, поэтому ссылка откроет ту же страницу для любого участника команды. Сведения показывают, как страница выглядит в Google (заголовок, адрес, описание), её разделы и главные заголовки, количество слов, изображения и сколько из них без описания, её формы и какой модуль набора их обрабатывает, одобрил ли её клиент, а также последнее изменение: когда, кто попросил и что было запрошено.

История показывает версии, которые сохраняет aiKit (исходную и последние 10), от новых к старым: номер, тип изменения (Первая сборка, Чат, Закрепление, Набор, Публикация, Восстановление, Правка плана), дату, что было запрошено, кто запросил и какие страницы изменились (нажмите на страницу, чтобы открыть её сведения). Самая новая помечена как «Текущая версия»; у любой более старой есть кнопка «Восстановить эту версию», которая сначала спрашивает подтверждение и сохраняет текущее состояние перед возвратом сайта, поэтому восстановление можно отменить. Показываются первые три; «Показать все» выводит остальные.

Раздел «Деловые данные» сравнивает телефон, email, адрес и часы работы из Клиентской карты с текстом созданных страниц (сначала главная и контакты). Каждый факт показывает «На сайте» или «Не найдено на сайте» (с указанием, сколько страниц проверено, так как сайт может показывать старое значение), а ссылка «Изменить в Клиентской карте» сохраняет Клиентскую карту основным источником истины.

• Страницы — таблица: Страница, Путь, Назначение и Статус (Создана или Запланирована), с настоящей ссылкой «Открыть» на живую страницу, когда она и создана, и сайт опубликован.
• Модули и инструменты — каждый модуль из плана с плашкой «Создан» или «Запланирован» и собственной заметкой.
• Деловые данные — часы работы, адрес, услуги, цены и любые фактические сведения о бизнесе, записанные простым текстом.
• Бренд — палитра, тон и любые заметки о стиле, которые есть в плане.
• Решения — реально принятые решения, которые не нужно пересматривать при следующем изменении.
• Открытые вопросы — список дел: что ещё действительно не решено, каждый пункт показывает «Отвечено» или «Открыто».

У каждой карточки раздела есть одни и те же две кнопки. «Изменить» открывает исходный Markdown раздела в простом текстовом поле и сохраняет его напрямую в PLAN.md — это настоящая немедленная запись (через собственную конечную точку PUT проекта), но она намеренно не запускает сборку или публикацию; она меняет только текст документа плана, так же как правка любой другой заметки.

«Запросить изменение» устроено иначе намеренно: открывается небольшая форма («Что бы вы хотели изменить в разделе <section>?»), и после отправки запрос появляется на вкладке «Обратная связь» проекта с меткой «План сайта — <Section>: …», точно так же, как любой запрос с метки или быстрого редактирования, со своим статусом и ссылкой «Открыть запрос» после отправки. Используйте «Изменить», когда сами исправляете или переписываете текст плана; используйте «Запросить изменение», когда хотите, чтобы сам сайт (а значит, и план) обновился в соответствии с ним.

План состоит из двух слоёв. Измерения (страницы, заголовки, разделы, ссылки, формы, модули, состояние) снимаются кодом с реальных файлов после каждого изменения, поэтому они не расходятся с действительностью. Письменный план (цели, факты о бизнесе, бренд, решения, открытые вопросы) поддерживается в актуальном виде ИИ-проходом, который запускается после каждого изменения и переписывает только те части, которых коснулось изменение. Он никогда не добавляет журнал изменений или записи с датами; история изменений хранится в разделе «История».

Если этот ИИ-проход не удался, письменный план остаётся прежним, а не переписывается наполовину, ошибка фиксируется, и на экране вместо тихо показанного устаревшего плана появляется кнопка «Обновить план» (см. выше).

Рядом с планом находится панель с действиями (на телефоне панель превращается в кнопку «Копировать ссылку для клиента» на всю ширину сразу под полосой прогресса, а остальное скрыто под кнопкой «Другие действия (3)»). «Поделиться с клиентом» копирует ссылку только для чтения (aikit.ai/p/<project>/plan) — без служебных инструментов, без кнопок редактирования и без внутренней информации. «Открыть живой сайт» ведёт напрямую на живой сайт, а если сайт ещё не опубликован, на панели прямо написано «Пока не опубликовано». «Файлы» показывает реальное количество файлов со списком, который можно раскрыть, с путём и размером каждого файла. «Скачать план» загружает актуальный файл PLAN.md как настоящий .md-файл, байт в байт то, что читается на экране, а не сгенерированное заново резюме.

Страница клиента открывается на вкладке «План»: тот же документ плана сайта, который видит сотрудник на вкладке «План и бриф» (обзор и цели, аудитория, стратегия, карта сайта, каждый инструмент с описанием того, что он даёт для бизнеса, и его статусом, план контента, сроки, решения и открытые вопросы), но без служебных частей: без заметок, написанных при добавлении инструмента, без имён того, кто что добавил, без ссылок в Kit aiKit и без кнопки «Написать план». Вторая вкладка, «Страницы и согласования», содержит постраничный вид, описанный ниже.

На вкладке «Страницы и согласования», доступной по тому же коду доступа, который клиент уже использует для отзывов (без отдельного входа), клиент видит ту же полосу прогресса, карту сайта своих страниц, список страниц со ссылками «Смотреть», модули, факты о бизнесе, бренд, решения и открытые вопросы, а также строку «План обновлён». Они не получают «Состояние», инструкции по исправлению, «Историю», информацию о том, кто что запросил, список файлов и никаких кнопок «Редактировать» или «Запросить изменение».

Всё, что сотрудники пометили как внутреннее, удаляется на сервере до отправки страницы, во всех разделах: строка с текстом «(internal)», «[internal]» или «(staff only)», строка, начинающаяся с «Internal:» или «Staff only:», любой раздел, заголовок которого содержит Internal или Staff only, а также скрытые комментарии. Такие строки вообще не попадают в браузер клиента, даже в сетевых данных страницы.

У каждой готовой страницы есть кнопка «Утвердить». Клиент вводит своё имя (и необязательное примечание) и утверждает страницу; утверждение привязано к точному содержимому этой страницы, поэтому, если страница изменится позже, появится надпись «Изменено после вашего утверждения», и утверждение запросят снова. Утвердить может только тот, кто использует код доступа клиента. Если вы открываете ссылку клиента, будучи вошли как сотрудник, вы видите статус утверждения каждой страницы, но не видите кнопку «Утвердить», чтобы никто не мог утвердить от имени клиента. На внутреннем плане сайта для сотрудников утверждённые страницы показывают «Утверждено клиентом», а изменённые — «Изменено после утверждения».

Внизу находится кнопка «Отправить отзыв»: если сайт опубликован, она открывает живой сайт с уже включённым слоем для отзывов (с кодом доступа клиента); если сайт ещё не опубликован, она открывает страницу «Последние обновления» клиента.