ADR: Валидация веб-сервисов перед публикацией

Дата: 2025-12-12
Статус: APPROVED
Участники: Оператор, Claude

Контекст

При создании новых веб-сервисов ссылки отправлялись пользователю до проверки работоспособности. Это приводило к ситуациям когда:
- Порт не открыт в файрволе
- Сервис не запущен или упал с ошибкой
- URL недоступен извне

Решение

ПРАВИЛО: При создании любого нового веб-сервиса с внешним доступом — Claude ОБЯЗАН самостоятельно проверить работоспособность ПЕРЕД отправкой ссылки пользователю.

Чеклист проверки

1. [ ] Сервис запущен (ps aux | grep)
2. [ ] Порт слушается (netstat/ss)
3. [ ] Порт открыт в ufw (ufw allow PORT/tcp)
4. [ ] Страница отвечает локально (curl localhost:PORT)
5. [ ] Страница отвечает извне (curl EXTERNAL_IP:PORT)

Команды проверки

# Проверка процесса
ps aux | grep "node\|python\|nginx" | grep -v grep

# Проверка порта
netstat -tlnp | grep PORT
ss -tlnp | grep PORT

# Открыть порт
ufw allow PORT/tcp && ufw reload

# Тест локально
curl -s http://localhost:PORT | head -5

# Тест извне
curl -s http://EXTERNAL_IP:PORT | head -5

Применение

Связи

• $WORKSPACE/mcrm/CLAUDE.md — правило продублировано

Версия: 1.0.0