dedinit.ru/docs/PRD.md

dedinit.ru — PRD (требования к проекту)

Цель

Личный технический блог dedinit.ru на Hugo: быстрая публикация статей (MLOps/DevOps/Linux/CI-CD, личный опыт) без поломки сайта.

Пользователи

• Автор (владелец) — публикует контент, настраивает тему.
• Читатели — русскоязычная аудитория (ru-ru), потребляют статьи.

Функциональные требования

• Генерация статического сайта Hugo Extended, тема rDedInit (форк PaperMod).
• Статьи — bundle: content/posts/<YYYYMMDD - slug>/index.md + hero.svg (viewBox 1200x400, фон #0a0c10, заголовок #58a6ff).
• date/lastmod — в прошлом (иначе Hugo не публикует); draft: false.
• Подсветка блочного кода (цель проекта).
• RSS с полным текстом (site.Params.ShowFullTextinRSS, лимит 5 постов).
• Деплой — ТОЛЬКО make deploy (SFTP paramiko на kpa39l.myjino.ru:2222; аккаунт SFTP-only, rsync/ssh-exec невозможны).
• Русскоязычный UI (задача локализации i18n в процессе).

Нефункциональные требования

• Git-история сохраняется (без потерь; git mv).
• Секреты/пароли в коммиты НЕ добавлять.
• Документация — на русском, в docs/; README — краткое введение.
• Все изменения проекта — через OpenSpec (propose → design → apply → archive).
• Не удалять/не перезаписывать данные пользователя без явного подтверждения.

Границы (что НЕ делаем)

• Не внедряем мультиязычность en/ru (пока).
• Не переводим контент постов — только UI.
• Не меняем провайдер хостинга/деплоя без запроса.

Критерии готовности

• Сайт собирается (make build) и деплоится (make deploy) без ошибок.
• UI на русском (по завершении локализации).
• Репозиторий: чистый git-статус, все коммиты в gitverse.
• Изменения проходят OpenSpec-цикл и архивируются.