Сообщить об ошибке
Все баги и проблемы отслеживаются через GitHub Issues:
github.com/ADamCarraway/journalphp/issues
Перед созданием issue
- Убедитесь, что проблема воспроизводится на актуальной версии из репозитория (
git pull). - Поищите среди существующих issues — возможно, этот баг уже известен.
- Убедитесь, что это действительно баг, а не вопрос по настройке — такие вопросы лучше задавать там же.
Что включить в отчёт
1. Описание проблемы
Что произошло? Что ожидалось? Чем фактическое поведение отличается от ожидаемого?
2. Шаги воспроизведения
Опишите последовательность действий, которая приводит к ошибке. Чем точнее — тем проще исправить.
1. Перейти на страницу /...
2. Нажать кнопку "..."
3. Заполнить поле "..." значением "..."
4. Наблюдать ошибку3. Окружение
| Параметр | Пример |
|---|---|
| Способ развёртывания | docker-compose.yml или docker-compose.prod.yml |
| Версия / коммит | git log --oneline -1 |
| Браузер | Chrome 124, Firefox 126, Safari 17 |
| Платформа ОС | macOS 14, Ubuntu 22.04 |
4. Логи
Приложите фрагмент лога, если он относится к проблеме:
- Laravel:
storage/logs/laravel.log - Контейнеры:
docker compose logs app - Horizon:
/horizon→ Failed jobs (доступ настраивается в админке → Доступы,/admin-panel/system/access) - Browser console: DevTools → Console (особенно для frontend-ошибок)
5. Скриншоты
При необходимости приложите скриншот или запись экрана — особенно для визуальных багов.
Как создать хороший заголовок
❌ Не работает
❌ Ошибка при публикации
✅ Кнопка "Опубликовать" не реагирует на клик, если пост содержит блок с опросом
Хороший заголовок — это уже половина решения проблемы.
Запросы на функции
Предложения по новому функционалу также принимаются через Issues. Пометьте label enhancement (если доступен) и объясните, зачем это нужно и как должно работать.