docs(project): файлы проекта в docs/ (STATUS, PRD, TODO, WALKTHROUGH) + AGENTS.md

This commit is contained in:
2026-09-12 17:15:10 +00:00
parent f07bffe838
commit 8123051ca7
5 changed files with 128 additions and 0 deletions
+35
View File
@@ -0,0 +1,35 @@
# 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-цикл и архивируются.