/* Publication: original design composition and interactions, real FastAPI operations. * Browser storage is never a source of release/workspace state. */ (() => { 'use strict'; if (window.sitePublication) return; window.sitePublication = true; const $ = (q, root = document) => root?.querySelector(q); const esc = x => String(x ?? '').replace(/[&<>"']/g, ch => ({'&':'&','<':'<','>':'>','"':'"',"'":'''}[ch])); const tabs = ['changes', 'checks', 'candidate', 'history', 'activity']; let root, data, csrf, icons = {}, busy = false, generation = 0, invoker; let state = {tab:'changes', filter:'all', query:'', type:'all', selected:''}; const icon = n => ``; const btn = (text, action, cls = '', extra = '') => ``; const chip = (text, style = '') => `${esc(text)}`; const date = value => value ? new Date(value).toLocaleString('ru-RU') : '—'; const chosen = () => data.changes.find(x => x.path === state.selected) || data.changes[0] || null; const issues = () => data.validation?.issues || []; const editUrl = c => !c || !c.after ? '' : c.type === 'Page' ? '/admin/pages/' + c.path.slice(6, -3).split('/').map(encodeURIComponent).join('/') : c.type === 'Entry' ? '/admin/content/' + c.path.slice(8, -3).split('/').map(encodeURIComponent).join('/') : c.path === 'theme.yaml' ? '/admin/theme' : ''; function notify(message) { const el = $('#publication-notice', root); if (el) el.textContent = message; } function error(detail, status) { window.siteAdminError?.(detail, status); notify([detail.message, detail.code, detail.request_id && 'ID запроса: ' + detail.request_id].filter(Boolean).join(' · ')); } async function call(operation, payload, query = '') { const originRoot=root,originGeneration=generation; const options = {headers:{Accept:'application/json'}}; if (payload !== undefined) { const form = new FormData(); form.set('csrf', csrf); form.set('payload', JSON.stringify(payload)); options.method = 'POST'; options.body = form; } let response; try { response = await fetch('/admin/publication/' + operation + query, options); } catch (_) { throw {status:0, detail:{code:'network_error', message:'Нет связи с сервером. Обновите состояние перед повтором операции.'}}; } let result; try { result = await response.json(); } catch (_) { throw {status:response.status, detail:{code:'invalid_response', message:'Сервер вернул некорректный ответ. Обновите состояние перед повтором.', request_id:response.headers.get('X-Request-ID')}}; } if(originGeneration!==generation||!originRoot?.isConnected)throw {cancelled:true}; if (!response.ok) throw {status:response.status, detail:result.error || {code:'http_error', message:'Не удалось выполнить запрос'}}; return result; } function heading() { return `
05 / RELEASE WORKFLOW · ATOMIC SITE RELEASES

Публикация сайта

Проверьте изменённые документы, соберите снимок-кандидат и переключите live. Редактируемые файлы workspace остаются отдельно от неизменяемого релиза.

${btn(icon('check')+' Проверить','validate')}${btn(icon('plus')+' Собрать кандидата','candidate','primary')}
`; } function liveBar() { const r = data.history.find(x => x.current); return `
${icon(r ? 'check' : 'clock')}
${r ? 'Активный релиз '+esc(data.current)+'' : 'Публичного релиза пока нет'}${r ? `Собран ${date(r.built_at)}${r.author ? ' · '+esc(r.author) : ''} · ${r.pages} страниц` : 'Соберите и проверьте первый снимок сайта'}
${chip(r ? 'LIVE' : 'Нет публикаций', r ? 'good' : 'warn')}${btn('История','history-tab','subtle tiny')}
`; } function pipeline() { const candidate = data.candidate, errors = data.validation?.errors; return `
01 / Workspace${chip(!data.comparison_available ? 'Нет сравнения' : data.changes.length ? 'Есть изменения' : 'Без изменений', data.changes.length ? 'purple' : 'good')}
${data.changes.length} файлов

Сохранённые документы и настройки. ${errors === undefined ? 'Строгая проверка выполняется при сборке.' : 'Ошибок последней проверки: '+errors+'.'}

02 / Candidate${chip(candidate?.fresh ? 'Ready' : candidate ? 'Устарел' : 'Не собран', candidate?.fresh ? 'good' : 'warn')}
${candidate ? esc(candidate.id) : 'Ожидает проверки'}

${candidate ? `Зафиксирован ${date(candidate.at)} · ${candidate.changes} изменений` : 'Снимок создаётся только после строгой валидации workspace.'}

03 / Live${chip(data.current ? 'Active' : 'Ожидает', data.current ? 'good' : 'warn')}
${esc(data.current || 'Нет публикаций')}

Неизменяемый build_id. Ошибочная сборка не меняет публичную версию.

`; } function tabBar() { const counts = [data.changes.length, issues().length, data.candidate ? 1 : 0, data.history.length, data.activity.length]; return `
${['Изменения','Проверки','Кандидат','История','Журнал'].map((title,i) => ``).join('')}
`; } function filteredChanges() { return data.changes.filter(x => (state.filter==='all'||state.filter===x.kind) && (state.type==='all'||state.type===x.type) && [x.title,x.path].some(s => s.toLocaleLowerCase().includes(state.query.toLocaleLowerCase()))); } function changeTable() { const rows=filteredChanges(); const options = (choices, value) => choices.map(([k,l])=>``).join(''); return `

Изменения после live

Сравнение рабочего дерева файлов с текущим опубликованным снимком

${chip(`${data.changes.length} documents`,'purple')}
${!data.comparison_available ? '
У активного релиза нет частного снимка исходников. Показан текущий workspace; изменения относительно live неизвестны.
' : ''}
${rows.map(x=>``).join('')||''}
Файл / НазваниеТипИзменениеСтатус
${esc(x.path)}${esc(x.type)}${chip(({new:'Добавлен',deleted:'Удалён',modified:'Изменён',unknown:'Неизвестно'})[x.kind],x.kind==='deleted'?'bad':x.kind==='new'?'good':'purple')}${chip(({published:'В каталоге',draft:'Черновик',archived:'Архив',deleted:'Удалён',configuration:'Настройки',invalid:'Ошибка'})[x.status]||x.status,x.status==='published'?'good':'warn')}${editUrl(x)?`${icon('arrow')} Открыть`:''}
Ничего не найденоИзмените фильтры или обновите документы в редакторах.
`; } function selectedPanel() { const c=chosen(); if(!c) return '

Инспектор документа

Изменений не найдено.
'; return `

Инспектор · ${esc(c.title)}

${esc(c.path)}

${btn(icon('eye'),'compare-doc','tiny','aria-label="Сравнить документ"')}
Сущность${esc(c.type)}
Изменение${esc(c.kind)}
Workspace${c.after?'Сохранённая версия':'Удалён'}
Live${!data.comparison_available?'Нет исходного снимка':c.before?'В снимке '+esc(data.current):'Нет в live'}
Размер${c.after?.size??c.before?.size??0} байт
Флаг status: published в файле не означает, что последние изменения уже видны посетителям.
${btn(icon('code')+' Diff','compare-doc','tiny')}${btn('История документа','doc-history','tiny')}${editUrl(c)?`Редактор ${icon('arrow')}`:''}
`; } function modelPanel() { return '

Модель публикации

Не путайте три состояния

WorkspaceТекущие редактируемые файлы
CandidateПроверенный immutable snapshot
LiveУказатель на конкретный build ID
В публикацию входят сохранённые файлы. Несохранённые правки в открытых редакторах остаются в этих вкладках.
'; } function changesTab() { return `
${changeTable()}

Как подготовить релиз

Изменения могут затрагивать ссылки, меню и обработчики форм

${icon('check')}
Workspace не равен LiveОткрытие редактора не публикует файл. Обновлённые документы подхватываются после обновления списка.
${icon('alert')}
Связанные файлы должны проходить проверку вместеПубликация записи создаёт согласованный релиз сайта.
${selectedPanel()}${modelPanel()}
`; } function checksTab() { const v=data.validation; return `

Проверка перед публикацией

Ошибки блокируют кандидата · предупреждения требуют внимания, но не блокируют

${btn(icon('check')+' Запустить validate','validate','primary')}
${v?.errors??'—'}Ошибок
${v?.warnings??'—'}Предупреждений
${v?.fresh?'Проверено':v?'Устарело':'—'}${date(v?.at)}
${!v?.fresh?'
Запустите проверку текущего workspace. Сборка дополнительно проверит реальный рендер.
':''}${issues().map(x=>`
${icon('alert')}
${esc(x.message)}${esc(x.code)} · ${esc(x.path)} · ${esc(x.hint)}
${chip(x.severity==='error'?'ERROR':'WARNING',x.severity==='error'?'bad':'warn')}${btn('К файлу','issue','tiny',`data-path="${esc(x.path)}"`)}
`).join('')||(v?`
${icon('check')}
Проблем не найденоСерверная проверка структуры, схем и ссылок пройдена.
${chip('OK','good')}
`:'
Проверка ещё не запускалась.
')}

Результат валидации

Текущая версия${esc(data.current||'Нет публикаций')}
Ошибки${v?.errors??'—'}
Предупреждения${v?.warnings??'—'}
Сохранение неполного draft допускается. Полнота опубликованных документов и строгий рендер проверяются перед созданием релиза.
${selectedPanel()}
`; } function candidateTab() { const c=data.candidate; return `

Release candidate

Фиксированный снимок состояния рабочего дерева

${btn(icon('plus')+' Сформировать кандидата','candidate','primary')}
${!c?`
Кандидат пока не созданИсправьте ошибки и соберите проверенный снимок.
${btn('Перейти к проверкам','checks-tab')}
`:`
Build ID${esc(c.id)}
Состояние${chip(c.fresh?'READY':'STALE — изменился workspace или live',c.fresh?'good':'bad')}
Основа${esc(c.base||'Первая публикация')}
Создан${date(c.at)}
Автор${esc(c.author)}
Снимок${c.pages} страниц · ${c.changes} изменений
Кандидат фиксирует данные на момент сборки. Правки после его создания требуют повторной сборки.
${btn('Просмотр сборки','preview')}${btn('Сравнить с live','candidate-diff')}${btn('Опубликовать','publish','primary',c.fresh?'':'disabled')}
`}

Журнал сборок

${data.builds.map((b,i)=>`
${esc(b.id||'Не завершена')}
${b.status==='ready'?'Кандидат собран':'Ошибка сборки'}${date(b.at)} · ${esc(b.base||'Первый релиз')}
${chip(b.status==='ready'?'Успешно':'Ошибка',b.status==='ready'?'good':'bad')}${btn('Лог','build-log','tiny',`data-index="${i}"`)}
`).join('')||'
Сборок пока нет.
'}
${modelPanel()}${selectedPanel()}
`; } function historyTab() { return `

История релизов

Каждый build ID представляет конкретный снимок сайта. Откат не трогает workspace.

${chip(`${data.history.length} builds`,'purple')}
${data.history.map(r=>`
${esc(r.id)}
${esc(r.comment||(r.candidate?'Неопубликованный кандидат':'Снимок сайта'))}${date(r.built_at)}${r.author?' · '+esc(r.author):''} · ${r.pages} страниц
${chip(r.current?'LIVE':r.candidate?'Candidate':'История',r.current?'good':'')}
${btn('Детали','release-details','tiny',`data-release="${r.id}"`)}${!r.current&&!r.candidate?btn('Откат','rollback','tiny',`data-release="${r.id}"`):''}
`).join('')||'
Релизов пока нет.
'}

Правила отката

Live${esc(data.current||'Нет публикаций')}
WorkspaceНе меняется при rollback
ФормыПриём заявок пока недоступен (HTTP 501)
Откат выбирает ранее созданный снимок. Перед подтверждением проверьте страницы и конфигурации форм релиза.
`; } function activityTab() { return `

Аудит действий

Серверные события validate / build / publish / rollback

${btn('Обновить','refresh-workspace','subtle tiny')}
${data.activity.length?`
${data.activity.map(e=>`
${esc(e.event)} ${esc(e.object||'')}${date(e.ts)} · ${esc(e.actor||'—')}${e.request_id?' · ID '+esc(e.request_id):''}
`).join('')}
`:'
Пока событий нет. Запустите проверку или сборку.
'}

Источники аудита

ИсточникСерверный audit.jsonl
ДоступДействующая сессия администратора
Показаны последние события публикации. Полный журнал хранится на сервере.
`; } function render() { if(!root?.isConnected) return; $('[data-publication-view]',root).innerHTML=heading()+liveBar()+pipeline()+tabBar()+`
${({changes:changesTab,checks:checksTab,candidate:candidateTab,history:historyTab,activity:activityTab})[state.tab]()}
`; root.setAttribute('aria-busy',String(busy)); root.querySelectorAll('[data-pub-action]').forEach(b=>{if(!b.hasAttribute('data-pub-disabled'))b.dataset.pubDisabled=String(b.disabled);b.disabled=busy||b.dataset.pubDisabled==='true';}); } function closeModal() { $('dialog[open]',root)?.close(); } function modal(title,description,body,actions='',wide=false) { closeModal(); invoker=document.activeElement; $('#publication-modal-root',root).innerHTML=`

${esc(title)}

${esc(description)}

${body}
${actions||btn('Закрыть','close-modal')}
`; const dialog=$('dialog',root); dialog.addEventListener('close',()=>{if(invoker?.isConnected) invoker.focus();else $(`[data-pub-tab="${state.tab}"]`,root)?.focus();}); dialog.addEventListener('click',e=>{if(e.target!==dialog)return;const r=dialog.getBoundingClientRect();if(e.clientXr.right||e.clientYr.bottom)dialog.close();}); dialog.showModal(); $('input,button',dialog)?.focus(); } async function refresh() { const mine=generation, next=await call('state'); if(mine!==generation||!root?.isConnected) return; data=next;render(); const pip=$('.live-pip'); if(pip){pip.classList.toggle('no-release',!data.current);pip.title=data.current?'Активный публичный релиз: '+data.current:'Публичного релиза пока нет';pip.innerHTML=data.current?'LIVE '+esc(data.current)+'':'НЕТ РЕЛИЗА';} } async function run(action,button) { if(busy) return; if(action==='close-modal'){closeModal();return;} if(action.endsWith('-tab')){state.tab=action.split('-')[0];render();return;} if(action==='publish') { const c=data.candidate;if(!c?.fresh)return; modal('Подтвердить публикацию','Атомарное переключение LIVE',`
Текущий live${esc(data.current||'Нет публикаций')}
Кандидат${esc(c.id)}
Снимок${c.pages} страниц · ${c.changes} изменений
Будет опубликован проверенный снимок. Рабочие файлы останутся прежними.
`,btn('Отмена','close-modal')+btn('Опубликовать','confirm-publish','primary',`data-release="${c.id}" data-base="${esc(data.current||'')}"`)); $('#release-comment',root)?.focus();return; } if(action==='build-log') { const b=data.builds[Number(button.dataset.index)];if(!b)return; modal('Лог сборки '+(b.id||''),`${date(b.at)} · ${b.status}`,`
${esc(b.log)}${b.request_id?'\nID запроса: '+esc(b.request_id):''}
${(b.issues||[]).map(x=>`

${esc(x.code)} · ${esc(x.path)} · ${esc(x.message)}

`).join('')}`);return; } if(action==='issue') { const path=button.dataset.path; state.selected=data.changes.find(x=>path===x.path||path.startsWith(x.path+'.'))?.path||''; state.tab='changes';state.query='';state.filter='all';state.type='all';render();return; } if(action==='confirm-publish'&&!$('#release-comment',root)?.value.trim()) {$('#release-comment',root)?.focus();notify('Добавьте комментарий к релизу');return;} busy=true;render();notify(({validate:'Проверяем сохранённые файлы…',candidate:'Собираем снимок…', 'confirm-publish':'Переключаем live…','rollback-confirm':'Выполняем откат…'})[action]||'Загружаем данные…'); const mine=generation; try { if(action==='refresh-workspace') await refresh(); else if(action==='validate') {await call('validate',{});state.tab='checks';await refresh();} else if(action==='candidate') {await call('build',{});state.tab='candidate';await refresh();} else if(action==='confirm-publish'||action==='rollback-confirm') { const payload={id:button.dataset.release,expected_live:button.dataset.base||null,comment:$('#release-comment',root)?.value||''}; await call(action==='confirm-publish'?'activate':'rollback',payload);closeModal();state.tab='history';await refresh(); } else if(action==='release-details'||action==='rollback') { const r=data.history.find(x=>x.id===button.dataset.release);if(!r)return; const detail=await call('release',undefined,'?id='+encodeURIComponent(r.id)); if(action==='rollback') { modal('Проверить откат','Просмотр последствий до подтверждения',`
Сейчас live${esc(detail.base||'Нет публикаций')}
Выбран${esc(r.id)}
Изменится${detail.changes.length} файлов в публичном снимке
Страниц${r.pages}
Формы${esc(r.forms.join(', ')||'Нет конфигураций')}
Live будет указывать на выбранный релиз. Файлы workspace не изменятся. Приём публичных форм пока возвращает HTTP 501.
${esc(detail.changes.map(c=>c.kind+' · '+c.path).join('\n')||'Нет отличающихся файлов')}
`,btn('Отмена','close-modal')+btn('Подтвердить откат','rollback-confirm','danger',`data-release="${r.id}" data-base="${esc(detail.base||'')}"`)); } else modal('Релиз '+r.id,`${date(r.built_at)}${r.author?' · '+r.author:''}`,`
Комментарий${esc(r.comment||'—')}
Статус${chip(r.current?'LIVE':r.candidate?'Кандидат':'Исторический',r.current?'good':'')}
Страниц${r.pages}
Формы${esc(r.forms.join(', ')||'Нет конфигураций')}
${esc(r.routes.join('\n'))}
`,btn('Просмотр снимка','preview','',`data-release="${r.id}"`)+(r.current||r.candidate?'':btn('Подготовить откат','rollback','danger',`data-release="${r.id}"`))+btn('Закрыть','close-modal')); } else if(action==='candidate-diff') { const x=await call('candidate-diff'); modal('Кандидат ↔ Live',`${x.id} ↔ ${x.base||'Первая публикация'}`,`
${esc(x.changes.map(c=>c.kind+' · '+c.path).join('\n')||'Изменений нет')}
${x.comparison_available?'Сравнение зафиксированных исходников кандидата с его базовым релизом.':'У базового релиза нет частного снимка исходников; сравнение неизвестно.'}
`, '', true); } else if(action==='compare-doc') { const c=chosen();if(!c)return; const x=await call('compare',undefined,'?path='+encodeURIComponent(c.path)); const serial=d=>d ? d.source??`SHA-256: ${d.hash}\nРазмер: ${d.size} байт\nИсходник недоступен для двоичного или большого файла.` : '(файл отсутствует)'; modal('Сравнение изменений',`${x.path} · Workspace ↔ Live`,`

LIVE / ${esc(x.current||'Нет публикаций')}

${esc(x.comparison_available?serial(x.before):'У релиза нет частного снимка исходников.')}

Workspace / сохранённая версия

${esc(serial(x.after))}
`,btn('Закрыть','close-modal'),true); } else if(action==='doc-history') { const c=chosen();if(!c)return; const x=await call('document-history',undefined,'?path='+encodeURIComponent(c.path)); modal('История документа',`Файл: ${x.path}`,x.versions.length?`
${x.versions.map(v=>`
${esc(v.id)}${v.size} байт
`).join('')}
`:'
Сохранённых предыдущих версий пока нет.
'); } else if(action==='preview') { const id=button.dataset.release||data.candidate?.id,r=data.history.find(x=>x.id===id);if(!r)return; const route=r.routes.includes('/')?'/':r.routes[0];if(!route)return; const preview=await call('preview',{id,route}); // Release snapshots remain passive even when the editor bridge is configured. modal('Просмотр сборки',`${id} · ${route}`,'',btn('Закрыть','close-modal'),true); $('.release-preview',root).src=preview.url; } if(mine===generation)notify(({validate:'Проверка завершена.',candidate:'Кандидат собран. Live не изменён.','confirm-publish':'Релиз опубликован.','rollback-confirm':'Live переключён. Workspace не изменён.'})[action]||'Данные загружены.'); } catch(exc) { if(mine!==generation||exc.cancelled)return; if(['candidate','confirm-publish','rollback-confirm'].includes(action)) { if(action==='candidate')state.tab='candidate'; try{await refresh();}catch(_){} } error(exc.detail||{code:'client_error',message:'Не удалось выполнить операцию.'},exc.status); } finally {if(mine===generation){busy=false;render();}} } async function initialize() { const next=$('[data-publication-root]');if(!next||next===root)return; const bootstrap=$('[data-publication-boot]',next); let boot; try {boot=JSON.parse(bootstrap.value);} catch(_) {window.siteAdminError?.({code:'invalid_bootstrap',message:'Не удалось прочитать данные публикации. Обновите страницу.'},0);return;} root=next;generation++;busy=false; csrf=boot.csrf;data=boot.state;state={tab:tabs.includes(boot.tab)?boot.tab:'changes',filter:'all',type:'all',query:'',selected:''}; const mine=generation; try { const response=await fetch('/admin/static/publication-icons.json'); if(!response.ok)throw new Error('icons'); const loaded=await response.json(); if(mine!==generation||!next.isConnected)return; icons=loaded; } catch(_) { if(mine!==generation||!next.isConnected)return; error({code:'resource_error',message:'Не удалось загрузить иконки публикации. Обновите страницу.'},0); } render(); } document.addEventListener('click',event=>{ if(!root?.contains(event.target))return; const tab=event.target.closest('[data-pub-tab]');if(tab){state.tab=tab.dataset.pubTab;render();$(`[data-pub-tab="${state.tab}"]`,root)?.focus();return;} const selected=event.target.closest('[data-pub-select]');if(selected){state.selected=selected.dataset.pubSelect;render();root.querySelectorAll('[data-pub-select]').forEach(x=>{if(x.dataset.pubSelect===state.selected)x.focus();});return;} const button=event.target.closest('[data-pub-action]');if(button)run(button.dataset.pubAction,button); }); document.addEventListener('input',event=>{ if(event.target.id!=='pub-search'||!root?.contains(event.target))return; state.query=event.target.value;const start=event.target.selectionStart,end=event.target.selectionEnd; $('[data-pub-table]',root).outerHTML=changeTable();const input=$('#pub-search',root);input.focus();input.setSelectionRange(start,end); }); document.addEventListener('change',event=>{ if(!root?.contains(event.target))return; if(event.target.id==='pub-change-kind'){state.filter=event.target.value;render();$('#pub-change-kind',root)?.focus();} if(event.target.id==='pub-change-type'){state.type=event.target.value;render();$('#pub-change-type',root)?.focus();} }); document.addEventListener('keydown',event=>{ const tab=event.target.closest?.('[data-pub-tab]');if(!tab||!root?.contains(tab))return; let i=tabs.indexOf(tab.dataset.pubTab); if(event.key==='ArrowRight')i=(i+1)%tabs.length;else if(event.key==='ArrowLeft')i=(i+tabs.length-1)%tabs.length;else if(event.key==='Home')i=0;else if(event.key==='End')i=tabs.length-1;else return; event.preventDefault();state.tab=tabs[i];render();$(`[data-pub-tab="${state.tab}"]`,root)?.focus(); }); document.addEventListener('htmx:load',initialize); initialize(); })();