#!/bin/bash
#===============================================================================
# СПРАВКА ПО СКРИПТАМ РАЗВЁРТЫВАНИЯ GIT-СЕРВЕРА
#===============================================================================
# Запуск: bash 02-k-git-server-deploy.help.sh
#===============================================================================

SCRIPT_DIR=$(cd "$(dirname "$0")" && pwd)
source "$SCRIPT_DIR/02-k-git-server-deploy.00.sh"

echo ""
echo -e "${BLUE}================================================================${NC}"
echo -e "${BLUE}  СПРАВКА ПО СКРИПТАМ РАЗВЁРТЫВАНИЯ GIT-СЕРВЕРА${NC}"
echo -e "${BLUE}================================================================${NC}"
echo ""

echo "СТРУКТУРА ФАЙЛОВ:"
echo ""
echo "  00.sh    - Конфигурация и функции (подключается автоматически)"
echo "  01.sh    - Подготовка системы"
echo "  02.sh    - Создание пользователя git"
echo "  03.sh    - Установка Gitea"
echo "  04.sh    - Systemd unit"
echo "  05.sh    - Конфигурация Gitea"
echo "  06.sh    - Запуск Gitea"
echo "  07.sh    - Nginx (HTTP only)"
echo "  08.sh    - SSL-сертификат"
echo "  09.sh    - Nginx (HTTPS)"
echo "  10.sh    - Firewall"
echo "  11.sh    - Администратор Gitea"
echo "  12.sh    - Скрипты бэкапа"
echo "  13.sh    - Настройка почты (msmtp)"
echo "  14.sh    - Настройка logrotate"
echo "  99.sh    - Финальная проверка"
echo "  all.sh   - Запуск всех шагов"
echo ""

echo "ИСПОЛЬЗОВАНИЕ:"
echo ""
echo "  Полный запуск:"
echo "    sudo bash 02-k-git-server-deploy.all.sh"
echo ""
echo "  Конкретный шаг:"
echo "    sudo bash 02-k-git-server-deploy.07.sh"
echo ""
echo "  Диапазон шагов:"
echo "    sudo bash 02-k-git-server-deploy.all.sh 7-9"
echo ""

echo "ВАЖНЫЕ МОМЕНТЫ:"
echo ""
echo "  1. Сначала отредактируйте 00.sh - укажите свои параметры:"
echo "     GIT_DOMAIN, CERT_EMAIL, GITEA_ADMIN, GITEA_ADMIN_EMAIL,"
echo "     IFACE_EXT, IFACE_INT"
echo ""
echo "  2. Порядок важен! Сертификаты (08) получаются ДО активации HTTPS (09)"
echo ""
echo "  3. При ошибках - можно перезапустить конкретный шаг"
echo ""

echo "ПОЛЕЗНЫЕ КОМАНДЫ:"
echo ""
echo "  Проверка Gitea:   systemctl status gitea"
echo "  Логи Gitea:       journalctl -u gitea -f"
echo "  Проверка Nginx:   nginx -t"
echo "  Статус firewall:  nft list ruleset"
echo "  Создать бэкап:    /usr/local/bin/gitea-backup.sh"
echo "  Статус logrotate: cat /var/lib/logrotate/status"
echo ""

echo "УСТРАНЕНИЕ ПРОБЛЕМ:"
echo ""
echo "  Gitea не запускается:"
echo "    sudo systemctl stop gitea"
echo "    sudo -u git GITEA_WORK_DIR=/var/lib/gitea /usr/local/bin/gitea web --config /etc/gitea/app.ini"
echo ""
echo "  Ошибка SSH-ключей (read-only file system):"
echo "    sudo mkdir -p /home/git/.ssh"
echo "    sudo chmod 700 /home/git/.ssh"
echo "    sudo chown git:git /home/git/.ssh"
echo ""
echo "  SSL не получается:"
echo "    Проверьте DNS: dig git.example.com"
echo "    Проверьте порт 80: curl -I http://git.example.com"
echo ""
echo "  Почта не отправляется:"
echo "    Проверьте лог: tail -f /var/log/msmtp.log"
echo "    Проверьте конфиг: cat /etc/msmtprc"
echo "    Тест: echo 'Test' | mail -s 'Test' user@example.com"
echo ""

echo "ЛОГИ:"
echo ""
echo "  Лог установки: /var/log/git-server-deploy.log"
echo ""