EventHub/EventHubBack
3
1
Fork 0
Code Issues 2 Pull Requests Actions Packages Projects Releases Wiki Activity

P1: Расширение встроенного баг-трекера (авто-тикеты) #35

New Issue
Closed
opened 2026-07-17 00:40:20 +03:00 by cursor-ai · 2 comments
cursor-ai commented 2026-07-17 00:40:20 +03:00
Owner
Copy Link
Copy Source

Проблема

В спеке с v0.0.1 заложен автоматический баг-трекер (ticket), но end-to-end он не был доведён: logic_ticket:report_error не вызывался из handlers, error_hash не считался, WS ticket_created не слался, фронт не репортил ошибки.

Влияние

Ошибки 500/DB и краши Admin SPA не попадали в inbox; ручной клиентский репорт не был контрактно зафиксирован.

Ожидаемый результат

Единый путь регистрации тикетов (backend / frontend / manual) с дедупом по error_hash, авто-репортом 500, capture ошибок Admin SPA, triage в Control Center. Ручной репорт — только клиентский сценарий end-user приложений через POST /v1/tickets (не меню админов).

Критерии приёмки

  • report_error + hash/dedupe/source + WS ticket_created
  • POST /v1/tickets через report_error (frontend/manual)
  • авто-репорт при HTTP >=500 (анти-рекурсия, rate-limit)
  • FrontAdmin: auto-capture + фильтр source в списке
  • миграция ticket.source + индекс error_hash
  • спека Back/FrontAdmin обновлена
  • ручной UI репорта в end-user клиенте (когда появится клиентское приложение)
  • при необходимости request_id в ответах 500

Файлы (подсказка)

  • EventHubBack/src/logic/logic_ticket.erl
  • EventHubBack/src/handlers/handler_utils.erl
  • EventHubBack/src/handlers/handler_tickets.erl
  • EventHubFrontAdmin/src/lib/errorReporter.ts
  • EventHubSpec/EventHubBackSpec.md §2.8

Приоритет

P1

## Проблема В спеке с v0.0.1 заложен автоматический баг-трекер (`ticket`), но end-to-end он не был доведён: `logic_ticket:report_error` не вызывался из handlers, `error_hash` не считался, WS `ticket_created` не слался, фронт не репортил ошибки. ## Влияние Ошибки 500/DB и краши Admin SPA не попадали в inbox; ручной клиентский репорт не был контрактно зафиксирован. ## Ожидаемый результат Единый путь регистрации тикетов (`backend` / `frontend` / `manual`) с дедупом по `error_hash`, авто-репортом 500, capture ошибок Admin SPA, triage в Control Center. Ручной репорт — только клиентский сценарий end-user приложений через `POST /v1/tickets` (не меню админов). ## Критерии приёмки - [x] `report_error` + hash/dedupe/source + WS `ticket_created` - [x] `POST /v1/tickets` через `report_error` (frontend/manual) - [x] авто-репорт при HTTP >=500 (анти-рекурсия, rate-limit) - [x] FrontAdmin: auto-capture + фильтр `source` в списке - [x] миграция `ticket.source` + индекс `error_hash` - [x] спека Back/FrontAdmin обновлена - [ ] ручной UI репорта в end-user клиенте (когда появится клиентское приложение) - [ ] при необходимости `request_id` в ответах 500 ## Файлы (подсказка) - `EventHubBack/src/logic/logic_ticket.erl` - `EventHubBack/src/handlers/handler_utils.erl` - `EventHubBack/src/handlers/handler_tickets.erl` - `EventHubFrontAdmin/src/lib/errorReporter.ts` - `EventHubSpec/EventHubBackSpec.md` §2.8 ## Приоритет P1
cursor-ai added the Story label 2026-07-17 00:40:20 +03:00
cursor-ai self-assigned this 2026-07-17 00:40:20 +03:00
cursor-ai commented 2026-07-17 00:40:20 +03:00
Author
Owner
Copy Link
Copy Source

Результаты работы (реализация в Cursor)

Сделано

  1. Единый logic_ticket:report_error/3,4: source (backend/frontend/manual), error_hash (sha256), дедуп open/in_progress, bump count, после close/resolved — новый тикет (регрессия), rate-limit новых тикетов, WS ticket_created.
  2. POST /v1/tickets идёт через report_error (не прямой create_ticket).
  3. Авто-500: handler_utils:send_error при status >= 500 асинхронно регистрирует тикет; пути /tickets пропускаются; исправлен баг анти-рекурсии (флаг не ставился до вызова report_error в spawn).
  4. Миграция 20260716230000_ticket_source_and_hash_index (поле source + индекс error_hash; no-op если таблицы ticket нет).
  5. FrontAdmin: global capture (onerror / unhandledrejection / ErrorBoundary), фильтр/колонка source; пункт «Сообщить о проблеме» у админов убран (это клиентский сценарий).
  6. Спека: EventHubBackSpec.md §2.8 + API; EventHubFrontAdminSpec.md §4.7.

Тесты

Набор Результат
CT API (rebar3 ct) 36/36 passed
EUnit: migration / logic_ticket / auto_report OK
FrontAdmin Playwright mock 25/25 (вкл. ticket-auto-report)
Полный EUnit ~237 failures — вынесено в EventHub/EventHubBack#36

Коммиты

  • EventHubBack a696d25
  • EventHubFrontAdmin b39a676
  • EventHubSpec c0121c1

Осталось / follow-up

  • Ручной UI баг-репорта в end-user клиенте (source=manual).
  • Опционально request_id в ответах 500.
  • Стабилизация полного eunit: EventHub/EventHubBack#36
## Результаты работы (реализация в Cursor) ### Сделано 1. **Единый `logic_ticket:report_error/3,4`**: `source` (`backend`/`frontend`/`manual`), `error_hash` (sha256), дедуп open/in_progress, bump `count`, после close/resolved — новый тикет (регрессия), rate-limit новых тикетов, WS `ticket_created`. 2. **`POST /v1/tickets`** идёт через `report_error` (не прямой `create_ticket`). 3. **Авто-500**: `handler_utils:send_error` при status >= 500 асинхронно регистрирует тикет; пути `/tickets` пропускаются; исправлен баг анти-рекурсии (флаг не ставился до вызова `report_error` в spawn). 4. **Миграция** `20260716230000_ticket_source_and_hash_index` (поле `source` + индекс `error_hash`; no-op если таблицы `ticket` нет). 5. **FrontAdmin**: global capture (`onerror` / `unhandledrejection` / ErrorBoundary), фильтр/колонка `source`; пункт «Сообщить о проблеме» у админов убран (это клиентский сценарий). 6. **Спека**: `EventHubBackSpec.md` §2.8 + API; `EventHubFrontAdminSpec.md` §4.7. ### Тесты | Набор | Результат | |--------|-----------| | CT API (`rebar3 ct`) | 36/36 passed | | EUnit: migration / logic_ticket / auto_report | OK | | FrontAdmin Playwright mock | 25/25 (вкл. ticket-auto-report) | | Полный EUnit | ~237 failures — вынесено в EventHub/EventHubBack#36 | ### Коммиты - EventHubBack `a696d25` - EventHubFrontAdmin `b39a676` - EventHubSpec `c0121c1` ### Осталось / follow-up - Ручной UI баг-репорта в end-user клиенте (`source=manual`). - Опционально `request_id` в ответах 500. - Стабилизация полного eunit: EventHub/EventHubBack#36
cursor-ai commented 2026-07-17 13:06:20 +03:00
Author
Owner
Copy Link
Copy Source

Готово — закрываю

Доработка автотикетов реализована и проверена на стендах.

Сделано

Backend (a696d25, далее 9d2780f на stage/IFT):

  • logic_ticket:report_error — source (backend / frontend / manual), error_hash, dedupe, rate-limit
  • POST /v1/tickets через report_error (frontend/manual)
  • авто-репорт при HTTP ≥500 (handler_utils:send_error, без рекурсии на /tickets)
  • миграция ticket.source + индекс error_hash
  • WS ticket_created для admin inbox
  • unit: handler_ticket_auto_report_tests, logic_ticket_tests; API: user_tickets_tests

FrontAdmin:

  • errorReporter + global handlers (window.onerror, unhandledrejection)
  • ReportBugDialog → POST /v1/tickets (manual)
  • фильтр source в списке тикетов

Спека: EventHubBackSpec.md §2.8, EventHubFrontAdminSpec.md

Тесты

Стенд Результат
IFT e2e 36/36
Stage e2e 36/36
Stage smoke frontend/manual/backend auto + dedupe — ок

Не в scope этой задачи (оставляем открытыми идеи на будущее)

  • Ручной репорт в end-user приложении (пока нет отдельного клиентского SPA)
  • request_id в теле ответа 500 — при необходимости отдельная задача

Fixes EventHub/EventHubBack#35

## Готово — закрываю Доработка автотикетов реализована и проверена на стендах. ### Сделано **Backend (`a696d25`, далее `9d2780f` на stage/IFT):** - `logic_ticket:report_error` — `source` (`backend` / `frontend` / `manual`), `error_hash`, dedupe, rate-limit - `POST /v1/tickets` через `report_error` (frontend/manual) - авто-репорт при HTTP ≥500 (`handler_utils:send_error`, без рекурсии на `/tickets`) - миграция `ticket.source` + индекс `error_hash` - WS `ticket_created` для admin inbox - unit: `handler_ticket_auto_report_tests`, `logic_ticket_tests`; API: `user_tickets_tests` **FrontAdmin:** - `errorReporter` + global handlers (`window.onerror`, `unhandledrejection`) - `ReportBugDialog` → `POST /v1/tickets` (`manual`) - фильтр `source` в списке тикетов **Спека:** `EventHubBackSpec.md` §2.8, `EventHubFrontAdminSpec.md` ### Тесты | Стенд | Результат | |-------|-----------| | IFT e2e | 36/36 | | Stage e2e | 36/36 | | Stage smoke | frontend/manual/backend auto + dedupe — ок | ### Не в scope этой задачи (оставляем открытыми идеи на будущее) - Ручной репорт в **end-user** приложении (пока нет отдельного клиентского SPA) - `request_id` в теле ответа 500 — при необходимости отдельная задача Fixes EventHub/EventHubBack#35
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
Bug
Дефект или ошибка
 Bug
Дефект или ошибка
 Bug
Дефект или ошибка
 Epic
Крупная инициатива / эпик
 Epic
Крупная инициатива / эпик
 Epic
Крупная инициатива / эпик
 Future
Отложенная работа
 Future
Отложенная работа
 Future
Отложенная работа
 Story
Пользовательская история
 Story
Пользовательская история
 Story
Пользовательская история
 Task
Техническая задача
 Task
Техническая задача
 Task
Техническая задача
No Label Story
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
aleksey ci-builder cursor-ai deep-seek
No Assignees cursor-ai
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: EventHub/EventHubBack#35
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?