architect/standards/CHANGE_IMPACT.md

Стандарт: Impact Analysis при смене адресов

Версия: 1.0.0
Дата: 2026-03-15

Правило

Перед сменой любого адреса — найти все места где он используется и обновить все разом.

Адрес = путь к файлу/папке, URL, порт, имя контейнера, IP, имя сервиса.

Почему это важно

Адреса используются в разных местах которые не связаны между собой:
- /etc/systemd/system/ — вне git, не обновляется автоматически
- nginx конфиги — отдельно от кода
- docker-compose.yml — в проекте
- .env файлы — в проекте
- CLAUDE.md — документация
- скрипты — в разных папках

При переносе папки проекта git переезжает вместе с кодом, но systemd/nginx/env — нет.

Алгоритм перед любым переносом/переименованием

Шаг 1 — найти все упоминания

# Найти в systemd
grep -r "{старый_путь}" /etc/systemd/system/

# Найти в nginx
grep -r "{старый_путь}" /etc/nginx/

# Найти в воркспейсе
grep -r "{старый_путь}" /opt/claude-workspace/ \
  --include="*.yml" --include="*.yaml" \
  --include="*.sh" --include="*.env" \
  --include="*.conf" --include="*.md" \
  --exclude-dir=".git"

Шаг 2 — составить список файлов для обновления

Зафиксировать: файл → что именно менять.

Шаг 3 — обновить все файлы разом

Не переносить папку пока не обновлены все ссылки.

Шаг 4 — перенести

Только после обновления всех ссылок.

Шаг 5 — проверить

# Убедиться что старый путь больше нигде не упоминается
grep -r "{старый_путь}" /etc/systemd/system/ /etc/nginx/ /opt/claude-workspace/

Матрица: что где может ссылаться

Тип адреса Где искать
Путь к папке проекта systemd, nginx, docker-compose, .env, скрипты
Порт сервиса nginx upstream, docker-compose, .env, CLAUDE.md
Имя Docker-контейнера docker-compose depends_on, .env DATABASE_URL, скрипты
URL сервиса nginx, .env, CLAUDE.md, документация
IP адрес nginx, .env, документация

Триггеры применения

Действие Применить Impact Analysis
Переименование папки проекта ✅
Перенос папки в другое место ✅
Смена порта сервиса ✅
Переименование Docker-контейнера ✅
Смена IP сервера ✅
Смена имени домена ✅
Удаление сервиса ✅

Связанные документы

← Стандарты