# Журнал авторского надзора — AR-1 Инструмент для дизайнеров студии AR-1 (architecture & design), заменяющий ручное заполнение Word-отчётов об авторском надзоре на стройке. Дизайнер заполняет веб-форму (в т.ч. голосом), данные синхронизируются в Google Таблицу, менеджер видит сводную панель по всем объектам и может скачать готовый брендированный PDF-отчёт для заказчика. ## Файлы проекта - **`forma-zhurnala.html`** — форма для дизайнеров. Полностью самодостаточный HTML-файл (без зависимостей, без npm/build-шага) — открывается двойным кликом или хостится как есть. - **`panel-menedzhera.html`** — панель для владельца/менеджера: сводные данные по всем дизайнерам/объектам, фильтры, скачивание сводного PDF-отчёта. - **`index.html`** — лендинг со ссылками на обе страницы (для хостинга/превью). - **`AppsScript_Code.gs`** — бэкенд. Вставляется в Google Apps Script, привязанный к Google Таблице (она же база данных). Разворачивается как Web App (`Deploy → Web app → Execute as: Me, Access: Anyone`), выданный URL вставляется в `CONFIG.API_URL` в обоих HTML-файлах. ## Архитектура ``` forma-zhurnala.html ─┐ ├──► Google Apps Script (Web App) ──► Google Sheets panel-menedzhera.html ─┘ (AppsScript_Code.gs) (Entries, Positions) ``` Никакого отдельного сервера/хостинга под бэкенд не нужно — Apps Script уже исполняется на серверах Google. Хостинг нужен только для двух статичных HTML. ### Данные (два листа в одной Google Таблице) - **Entries** — записи журнала: дата, тип мероприятия, место, участники, что обсуждали, результат + метаданные (studio, designer, project, client). - **Positions** — живой трекер позиций/закупок (не пересоздаётся каждый отчёт, статус меняется по ходу проекта): категория, позиция, статус (Согласовано / Требует согласования / К обязательному заказу), стоимость, примечания. ### API (`AppsScript_Code.gs`) - `GET ?resource=entries` — записи (можно фильтровать по `project`, `designer`, `dateFrom`, `dateTo`) - `GET ?resource=positions&project=...` — позиции по объекту - `GET ?resource=suggestions` — уникальные ранее введённые значения (`projects`, `places`, `participants`, `studios`, `designers`, `clients`) для автодополнения полей в форме - `POST` с `{action: 'create'|'update'|'delete', recordType: 'entry'|'position', ...}` — запись/обновление/удаление в соответствующий лист Все POST-запросы уходят с `Content-Type: text/plain` (не `application/json`) намеренно — это обходит CORS preflight, который Apps Script не умеет обрабатывать. ## Как формируется отчёт (PDF) **Важно: раньше генерировался `.docx` через встроенную библиотеку docx.js — отказались от этого подхода.** Причина: один и тот же файл по-разному (и криво) рендерился в Word/LibreOffice/Google Docs — то ячейки таблиц сжимались до одной буквы в строке, то поле подписи разрывалось между страницами. Все эти баги — следствие того, что разные программы по-разному интерпретируют DOCX. Сейчас вместо этого: кнопка «Скачать отчёт (PDF)» открывает новую вкладку с HTML-версией отчёта, настроенной под печать (`@page`, `break-inside: avoid` на все таблицы/блоки), и сразу вызывает `window.print()` — пользователь жмёт «Сохранить как PDF» в системном диалоге печати браузера. Это даёт пиксель-в-пиксель одинаковый результат везде, без зависимости от сторонних библиотек и без сетевых запросов. Функции генерации: `buildPrintHtml()` в `forma-zhurnala.html` (из `state.entries`/`state.positions`), `buildPrintHtml()` в `panel-menedzhera.html` (из отфильтрованных `filtered`/`filteredPositions`, с доп. колонкой «Объект» в таблицах позиций, если выбрано «Все объекты»). ## Брендинг Цвета — точные значения из логотипа AR-1 (пиксель-сэмплинг через PIL): - Красный акцент: `#DD0031` - Серый (вторичный текст): `#8E9090` Логотип встроен как `data:image/png;base64,...` (константа `LOGO_DATA_URI` в `