Документация системы

• В страницы сайта не запекается ничего клиентского — только вечные id (§3). Смена владельца никогда не требует пересборки страниц
• Агрегатор не хранит данных товаров. Имя товара попадает к нему один раз — текстом внутри заявки (поле data.item), справочно
• Ноль ветвлений «уникум/каталог»: единичная страница (Ремонт в Калуге) = каталог из одного товара с пакетом count:1. Один формат токена, один код резолва, один формат owners-файла и прайса, один рендер витрины и кабинета

curl -X POST https://mailfly.ru/api/leads/create \
  -H 'Content-Type: application/json' \
  -d '{"token":"<offer15><region15><productId>",
       "data":{"name":"Иван","phone":"+7…","comment":"…"}}'

• offer/region — вечные id агрегатора
• productId — вечный id самого сайта (на реальном сайте — id записи его PB, на стенде — слаги вида cement-m500)

• route_leads.pb.js — POST /api/leads/create (резолв заявки, §2) + OPTIONS (CORS). Внутри — серверный OWNERS_KEY (§6)
• route_cabinet.pb.js — GET /cabinet, оболочка кабинета (§8)
• route_home.pb.js — GET /, главная стенда: все ссылки и демо-доступы
• route_docs.pb.js — эта страница

• nav-index.html — выбор сайта (стендовая страница)
• nav-stroyka/-stroymaterialy/-arenda-kvartir.html — «сайты»: тонкие файлы, только конфиг SITE {title, tagline, icon, enc:'/…enc?v=…'} + подключение скриптов
• nav-site.js — универсальный рендер витрины (один для всех сайтов): табы сети, чипсы регионов, карточки продавцов, регион в location.hash
• nav-lead.js — модалка заявки + leadsSubmit (напрямую → функция), экран результата с явным закрытием
• catalog-decrypt.js — расшифровка витрины в браузере (CATALOG_KEY зашит здесь)
• transfer.js — клиент функции-прокси (§7)
• export-sites.js — генератор выгрузки = имитация CMS всех трёх сайтов: держит «БД сайтов» (товары), берёт из агрегатора активные sales и имена клиентов, пишет 6 .enc + versions.json. Запуск: PB_URL=… PB_ADMIN_EMAIL=… PB_ADMIN_PASSWORD=… node export-sites.js, потом залить .enc в бакет и обновить ?v= в html
• transfer-function/ — исходник Я.функции (go)

• <site>.enc — витрина: {cta, products:{pid:{offer,name,price?}}, regions:[{id,name,sellers:[{name,phone?,items:[pid]}]}]}. Товар хранится один раз, регионы ссылаются по id
• <site>-owners.enc — карта {token: ownerId}. Страницы её не трогают, читает только сервер агрегатора

• CATALOG_KEY — витрины <site>.enc. Живёт в catalog-decrypt.js и export-sites.js. По определению публичен (браузер расшифровывает) — защита от простого парсинга, не от целевого
• OWNERS_KEY — owners-файлы. Живёт в route_leads.pb.js и export-sites.js. Знает только сервер — браузеру файл недоступен по содержимому
• TRANSFER_KEY — конверт функции-прокси. Живёт в nav-lead.js (клиент) и в функции

1. прямой fetch на target с таймаутом 2500 мс
2. не прошло → transferCall(FUNC_URL, key, {target, method, path, contentType, body}): конверт шифруется TRANSFER_KEY, функция расшифровывает, делает запрос к target от себя, ответ возвращает тем же шифрованным конвертом

• Бакет = домен (cdn.mailfly.ru), HTTPS-сертификат привязан к бакету напрямую (без CDN): yc storage bucket set-https
• *.html, *.js, *-owners.enc — max-age=60, must-revalidate: правки видны за минуту, owners-файл сервер и так кэширует 60 с
• <site>.enc (витрины) — max-age=31536000, immutable + версия в URL ?v=<hash>. Хэш считается от ДАННЫХ (не шифртекста), поэтому без изменений данных версия стабильна. Новая выгрузка данных → новый ?v в html сайта
• gzip: сам бакет-website не сжимает. Если понадобится — вешать Yandex CDN перед бакетом (даст gzip/brotli + edge-кэш), но у CDN-хоста есть риск вылета из белых списков операторов — проверить перед включением

1. В агрегаторе: запись в sites (name, url, ownersUrl → куда сайт будет класть owners-файл), офферы в offers, прайсы-пакеты в prices. Регионы общие
2. В CMS сайта: у товара поле «владелец» = id клиента из агрегатора (указывается при размещении). Товар заводится ОДИН раз, регионы размещения — ссылками
3. Экспорт из CMS двух файлов (формат — §5, шифрование — §6): витрина + owners-карта {offerId+regionId+productId: ownerId}. Выгрузка в бакет при каждом изменении данных
4. На страницах сайта: подключить transfer.js + nav-lead.js (или свой аналог формы), кнопка вызывает openLead(offer+region+productId, 'подпись'). Если витрина не шифруется — catalog-decrypt.js не нужен
5. Продажа мест: запись в sales (пакет из прайса, capacity=count). Всё — заявки маршрутизируются

1. Сгенерировать новые CATALOG/OWNERS/TRANSFER ключи, вынести из кода (env или PB settings), старые считать скомпрометированными
2. Свой домен агрегатора + бакеты сайтов; HTTPS к бакетам напрямую (§9)
3. Задеплоить функцию в своё облако, обновить URL в nav-lead.js
4. /api/leads/create: rate-limit + honeypot-поле против спама (сейчас нет)
5. Уведомления владельцу о новой заявке (email/telegram; хук ext_ на onRecordAfterCreateSuccess leads) — не реализовано
6. Смена паролей клиентов: сейчас тестовые (кабинет), включить сброс пароля по email
7. Партнёрка: поля partner/partnerRate в sales есть, начисления не реализованы
8. Мониторинг ответов no_active_owner / site db unavailable — сигнал рассинхрона выгрузки или падения S3
9. Продление/оплата sales — вручную или биллинг, не реализовано

1. Сохранить HTML кабинета файлом в бакет (cabinet.html)
2. Напрямую заработает сразу: PB отдаёт API с Access-Control-Allow-Origin: *
3. Для обхода блокировок — обернуть вызовы API в паттерн leadsSubmit (§7) и доработать функцию+transfer.js: проброс заголовка Authorization
4. SSE/realtime через функцию не работает — кабинет его не использует
5. Удалить SSR-роут /cabinet