embeddevio/awg-dash
1
0
Fork 0
Code Issues 40 Pull Requests 3 Actions Packages Projects Releases Wiki Activity

Sprint 2: каркас FastAPI (lifespan, health/ready, логирование, error model) #31

New Issue
Open
opened 2026-10-21 23:24:37 +03:00 by embeddevio · 0 comments
embeddevio commented 2026-10-21 23:24:37 +03:00
Owner
Copy Link
Copy Source

Owner: backend · Est: 3 SP · P0 · Sprint 2 · Deps: #16 · Refs #15

  • FastAPI-приложение: lifespan (старт/стоп агента и планировщика), конфиг из env, structured JSON-логи с request-id.
  • Эндпоинты /api/v1/health (liveness, без деталей) и /api/v1/ready (готовность: туннель/агент/БД) для Docker HEALTHCHECK.
  • Единый формат ошибок {code, message, details}, глобальные обработчики исключений, отдача статики UI.

AC:

  • GIVEN контейнер запущен, WHEN GET /api/v1/health, THEN 200 без авторизации; WHEN GET /api/v1/ready и агент недоступен, THEN 503 с причиной.
  • GIVEN необработанное исключение в хендлере, WHEN запрос, THEN ответ в едином формате ошибки и stacktrace только в логах.

DoD: coverage ≥70%, CI green, ревью владельца роли.

**Owner:** backend · **Est:** 3 SP · **P0** · **Sprint 2** · **Deps:** #16 · Refs #15 - FastAPI-приложение: lifespan (старт/стоп агента и планировщика), конфиг из env, structured JSON-логи с request-id. - Эндпоинты `/api/v1/health` (liveness, без деталей) и `/api/v1/ready` (готовность: туннель/агент/БД) для Docker HEALTHCHECK. - Единый формат ошибок `{code, message, details}`, глобальные обработчики исключений, отдача статики UI. AC: - GIVEN контейнер запущен, WHEN `GET /api/v1/health`, THEN 200 без авторизации; WHEN `GET /api/v1/ready` и агент недоступен, THEN 503 с причиной. - GIVEN необработанное исключение в хендлере, WHEN запрос, THEN ответ в едином формате ошибки и stacktrace только в логах. DoD: coverage ≥70%, CI green, ревью владельца роли.
embeddevio added this to the Sprint 2 — Control plane: REST API + Web UI milestone 2026-10-21 23:24:37 +03:00
embeddevio added the backendstatus/backlog labels 2026-10-21 23:24:37 +03:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
backend
Backend related work
 blocker
Blocking issue
 devops
Infra and deployment
 epic
Large feature or project
 frontend
Frontend related work
 hotfix
Urgent hotfix
 qa
Testing and QA
 release
Release request
 status/backlog
Kanban: не начато / бэклог
 status/blocked
Kanban: заблокировано, нужна эскалация
 status/in-progress
Kanban: в работе (есть ветка/PR)
 status/ready
Kanban: готово к работе, есть AC и зависимости
 status/review
Kanban: на ревью/QA
No Label backend status/backlog
Milestone
No items
No Milestone Sprint 2 — Control plane: REST API + Web UI
Projects
Clear projects
No project
Assignees
Clear assignees
embeddevio
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: embeddevio/awg-dash#31
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?