Инструкция по использованию системы отслеживания багов

Обзор системы

Система отслеживания багов между 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

---

💡 СОВЕТЫ ПО ИСПОЛЬЗОВАНИЮ

1. Используйте четкие описания в заголовках багов
2. Регулярно синхронизируйтесь перед началом работы
3. Добавляйте комментарии по мере прогресса
4. Закрывайте баги изменением статуса на "🟢 Решено"
5. Создавайте один баг на одну проблему

---

✅ ПРОВЕРКА РАБОТОСПОСОБНОСТИ

Тестовый сценарий:

bash

Copy

Download

# На главном компьютере

./bug-tracker create "Тест системы багов"

./bug-tracker sync

# На Orange PI

./get-bugs

./view-bugs

Система готова к использованию! 🚀