links/docs/README.md

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

Добро пожаловать в документацию проекта CatLink! Здесь вы найдете всю необходимую информацию для работы с проектом.

📖 Документы

🛠️ Для разработчиков

• MAKEFILE.md - Полное руководство по командам Make для разработки и деплоя
• DEPLOYMENT.md - Инструкции по развертыванию в продакшене
• FIXES.md - Известные проблемы и их решения

🧪 Для тестировщиков

• COVER_OVERLAY_TESTING.md - Документация по тестированию покрытия

🚀 Быстрые ссылки

Для начинающих

1. Начните с README.md в корне проекта
2. Изучите MAKEFILE.md для понимания команд
3. Следуйте инструкциям в DEPLOYMENT.md для деплоя

Для опытных разработчиков

• Используйте make help для просмотра всех команд
• Проверьте FIXES.md при возникновении проблем
• Следуйте документации в DEPLOYMENT.md для продакшена

🔧 Структура документации

docs/
├── README.md                    # Этот файл - обзор документации
├── MAKEFILE.md                  # Руководство по командам Make
├── DEPLOYMENT.md                # Инструкции по деплою
├── FIXES.md                     # Исправления и решения проблем
└── COVER_OVERLAY_TESTING.md     # Документация по тестированию

📋 Краткий справочник команд

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

make help              # Показать все команды
make install           # Первая установка
make dev-bg           # Запуск для разработки
make status           # Проверить статус
make health           # Проверить работоспособность

Управление данными

make migrate-full     # Миграции и сбор статики
make backup           # Создать бэкап БД
make restore          # Восстановить БД

Деплой

make deploy           # Деплой в продакшен
make ssl-setup        # Настройка SSL

Подробнее см. MAKEFILE.md

🆘 Получить помощь

1. Проверьте документацию - Возможно, ответ уже есть в одном из документов
2. Поищите в Issues - GitHub Issues
3. Создайте новый Issue - Если проблема не найдена

🤝 Вклад в документацию

Помогите улучшить документацию:

1. Форкните репозиторий
2. Улучшите или добавьте документацию
3. Создайте Pull Request

Рекомендации по написанию документации:

• Используйте ясный и понятный язык
• Добавляйте примеры кода
• Включайте скриншоты когда это помогает
• Обновляйте документацию при изменении функционала

---

📖 Вернуться к главному README