links/docs/COMMANDS.md

🚀 CatLink Commands Quick Reference

📋 Основные команды

Развертывание

make deploy              # Мастер-развертывание (полная настройка)
make pre-deploy-check    # Проверка готовности системы
make deploy-simple       # Простое развертывание без мастер-настройки

Разработка

make install             # Первая установка
make dev                 # Режим разработки
make build               # Сборка контейнеров
make up                  # Запуск сервисов
make down                # Остановка сервисов
make restart             # Перезапуск

База данных

make migrate             # Применить миграции
make makemigrations      # Создать миграции
make superuser           # Создать суперпользователя

Безопасность

make security-audit      # Аудит безопасности PostgreSQL
make security-setup      # Настройка безопасности БД
make update-production-security  # Безопасное обновление в продакшене

SSL/TLS

make ssl-setup          # Интерактивная настройка SSL
make ssl-renew          # Обновление сертификатов

Мониторинг и диагностика

make status             # Статус сервисов
make health             # Проверка здоровья
make logs               # Просмотр логов
make monitor            # Мониторинг ресурсов

Тестирование

make test               # Запуск тестов
make lint               # Проверка кода
make format             # Форматирование кода

Обслуживание

make backup             # Создать backup
make restore            # Восстановить из backup
make clean              # Очистка (containers, images)
make clean-all          # Полная очистка (+ volumes, data)
make reset              # Сброс к заводским настройкам

🔧 Полезные скрипты

Прямое выполнение

./scripts/master-deploy.sh          # Мастер-развертывание
./scripts/pre-deploy-check.sh       # Проверка системы
./scripts/ssl-manager.sh            # Управление SSL
./scripts/audit-db-security.sh      # Аудит безопасности БД
./scripts/health-check.sh           # Проверка здоровья
./scripts/auto-backup.sh            # Создание backup

🌐 URL-адреса (по умолчанию)

Разработка

• Frontend: http://localhost:3000
• Backend API: http://localhost:8000/api/
• Admin: http://localhost:8000/admin/

Продакшен

• Site: https://your-domain.com
• Admin: https://your-domain.com/admin/

📁 Важные файлы

Конфигурация

• .env - переменные окружения
• docker-compose.yml - основная конфигурация
• docker-compose.prod.yml - продакшен overrides
• Makefile - команды автоматизации

Безопасность

• database/postgresql.conf - конфигурация PostgreSQL
• database/pg_hba.conf - настройки аутентификации
• SECURITY.md - руководство по безопасности

Документация

• README.md - основная документация
• DEPLOYMENT.md - руководство по развертыванию
• COMMANDS.md - этот файл

Backup и логи

• backups/ - резервные копии
• logs/ - логи системы

🚨 Экстренные команды

Быстрое восстановление

# Перезапуск всех сервисов
make restart

# Пересборка и перезапуск
make build && make up

# Проверка логов при проблемах
make logs

# Полная очистка и переустановка
make clean-all && make install

Восстановление из backup

# База данных
docker exec -i links-db-1 psql -U postgres links_db < backups/database/backup_YYYYMMDD.sql

# Файлы
tar -xzf backups/files/media_YYYYMMDD.tar.gz

Диагностика проблем

# Проверка контейнеров
docker ps -a

# Проверка ресурсов
docker stats

# Проверка сетей
docker network ls

# Проверка volumes
docker volume ls

🔄 Обновление проекта

Стандартное обновление

git pull
make restart

Обновление с миграциями

git pull
make down
make build
make up
make migrate

Безопасное обновление продакшена

make update-production-security

💡 Подсказки

1. Всегда проверяйте статус перед началом работы: make status
2. Используйте pre-deploy-check перед развертыванием: make pre-deploy-check
3. Регулярно делайте backup: ./scripts/auto-backup.sh
4. Мониторьте безопасность: make security-audit
5. Проверяйте логи при проблемах: make logs

📞 Поддержка

• Issues: https://github.com/smartsoltech/links/issues
• Документация: README.md, DEPLOYMENT.md, SECURITY.md
• Команды: make help