infrastructure/PRD.md

PRD — Infrastructure

Цель

Каталог /opt/infrastructure — единая точка управления домашней инфраструктурой: конфиги, плейбуки, спеки (openspec), запись операционного опыта (инциденты, разборы) для повторяемости.

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

• Владелец инфраструктуры (техноблогер): управляет серверами, бэкапами, сетью; ведёт техблог.

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

• Документировать инфраструктуру: сервисы (/opt/), монтирования, бэкапы.
• Фиксировать опыт инцидентов: диагностика, команды, выводы (WALKTHROUGH).
• Поддерживать спеки openspec для изменений (s3, tunnel-proxy и т.д.).
• Содержать точные порты/маппинги и корректные технические детали (важно для пользователя).

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

• Всё в /opt/infrastructure (правило единого каталога; данные не в $HOME).
• Данные пользователя не удалять (любые операции — только с подтверждением).
• Документация на русском, точная, без «приблизительно».

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

• Не дублируем конфиги сервисов, живущих в /opt/ — только ссылки/описания.
• Не храним секреты в открытом виде (только пути к файлам секретов).

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

• STATUS.md актуален после каждой сессии.
• Каждый инцидент закончен записью в WALKTHROUGH.md с командами и выводами.
• TODO.md — журнал задач с датами и ссылками на сессии.