Инструкция по использованию системы отслеживания багов
Обзор системы
Система отслеживания багов между Ubuntu (главный компьютер) и Orange PI через Git-репозиторий. Баги хранятся в файлах Markdown в папке bugs/.
НАСТРОЙКА НА ГЛАВНОМ КОМПЬЮТЕРЕ (Ubuntu)
Базовая настройка
bash
Copy
Download
cd ~/my-project
# Проверяем наличие системы
ls -la bug-tracker
Основные команды
1. Создать новый баг
bash
Copy
Download
./bug-tracker create "Краткое описание проблемы"
Пример:
bash
Copy
Download
./bug-tracker create "Ошибка сегментации при компиляции"
2. Посмотреть список всех багов
bash
Copy
Download
./bug-tracker list
Вывод:
text
Copy
Download
СПИСОК БАГОВ:
001: Ошибка сегментации при компиляции (🔴 Открыт)
002: Проблема с сетевым подключением (🔴 Открыт)
3. Просмотреть детали всех багов
bash
Copy
Download
./bug-tracker view
4. Синхронизировать с Orange PI
bash
Copy
Download
./bug-tracker sync
НАСТРОЙКА НА ORANGE PI
Базовая настройка
bash
Copy
Download
cd ~/my-project
# Создаем скрипт для получения багов
cat > get-bugs << 'EOF'
#!/bin/bash
cd ~/my-project
echo "🔄 Получение багов..."
git pull origin master
echo "✅ Готово"
EOF
chmod +x get-bugs
# Создаем скрипт для просмотра
cat > view-bugs << 'EOF'
#!/bin/bash
cd ~/my-project
for file in bugs/*.md; do
if [ -f "$file" ]; then
echo "=== $(basename "$file") ==="
cat "$file"
echo
fi
done
EOF
chmod +x view-bugs
Основные команды на Orange PI
1. Получить свежие баги с главного компьютера
bash
Copy
Download
./get-bugs
2. Просмотреть все баги
bash
Copy
Download
./view-bugs
3. Быстрая проверка (альтернатива)
bash
Copy
Download
# Простой просмотр
ls -la bugs/
cat bugs/001-*.md
ТИПОВОЙ РАБОЧИЙ ПРОЦЕСС
Сценарий 1: Обнаружение новой проблемы
bash
Copy
Download
# На главном компьютере
./bug-tracker create "Новая ошибка в модуле XYZ"
./bug-tracker sync
# На Orange PI
./get-bugs
./view-bugs
Сценарий 2: Ежедневная синхронизация
bash
Copy
Download
# На Orange PI утром
./get-bugs
./view-bugs
# После работы на Orange PI - если нужно отправить обратно
# (Ручное редактирование файлов багов)
nano bugs/001-*.md
git add bugs/
git commit -m "Обновление статуса багов"
git push origin master
Сценарий 3: Быстрая проверка
bash
Copy
Download
# На главном компьютере
./bug-tracker list
# На Orange PI
ls bugs/*.md | wc -l # Количество багов
📁 СТРУКТУРА ФАЙЛА БАГА
Каждый баг хранится в формате:
markdown
Copy
Download
# Баг #001: Описание проблемы
**Статус:** 🔴 Открыт
**Автор:** alensav
**Дата:** 23.09.2025 19:26
## Описание
Детальное описание проблемы...
## Комментарии
- 24.09.2025: Первый комментарий
- 25.09.2025: Второй комментарий
🎯 ШПАРГАЛКА КОМАНД
Главный компьютер (Ubuntu)
|
Команда |
Назначение |
|
./bug-tracker create "описание" |
Создать баг |
|
./bug-tracker list |
Список багов |
|
./bug-tracker view |
Детали багов |
|
./bug-tracker sync |
Синхронизация |
Orange PI
|
Команда |
Назначение |
|
./get-bugs |
Получить обновления |
|
./view-bugs |
Просмотреть баги |
|
git pull origin master |
Альтернативная синхронизация |
⚠️ УСТРАНЕНИЕ ПРОБЛЕМ
Если синхронизация не работает:
bash
Copy
Download
# Проверка подключения
ping 192.168.1.75
# Принудительная синхронизация
git push bug-server master --force
Если скрипты не найдены:
bash
Copy
Download
# Пересоздаем скрипт на главном компьютере
cd ~/my-project
cat > bug-tracker << 'EOF'
#!/bin/bash
echo "Скрипт временно недоступен"
EOF
chmod +x bug-tracker
Ручное управление (резервный вариант):
bash
Copy
Download
# Создать баг вручную
echo "# Баг: Описание" > bugs/новый-баг.md
git add bugs/
git commit -m "Новый баг"
git push bug-server master
💡 СОВЕТЫ ПО ИСПОЛЬЗОВАНИЮ
- Используйте четкие описания в заголовках багов
- Регулярно синхронизируйтесь перед началом работы
- Добавляйте комментарии по мере прогресса
- Закрывайте баги изменением статуса на "🟢 Решено"
- Создавайте один баг на одну проблему
✅ ПРОВЕРКА РАБОТОСПОСОБНОСТИ
Тестовый сценарий:
bash
Copy
Download
# На главном компьютере
./bug-tracker create "Тест системы багов"
./bug-tracker sync
# На Orange PI
./get-bugs
./view-bugs
Система готова к использованию! 🚀
