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

Backend: REST API статуса туннеля awg0 #10

New Issue
Open
opened 2026-10-18 22:18:01 +03:00 by embeddevio · 0 comments
embeddevio commented 2026-10-18 22:18:01 +03:00
Owner
Copy Link
Copy Source

Владелец: backend-engineer | Оценка: 5 SP | Приоритет: P1

Часть эпика #9 (панель состояния VPN-туннеля).

Scope

Реализовать GET /api/v1/tunnel/status, читающий состояние интерфейса awg0 и внешний IP; контракт — OpenAPI spec в репозитории.

Acceptance criteria

  • GIVEN интерфейс awg0 поднят, WHEN выполняется GET /api/v1/tunnel/status, THEN возвращается 200 и JSON {status:"up", peer_endpoint, external_ip, last_handshake_at, error:null}.
  • GIVEN awg0 отсутствует или down, WHEN выполняется тот же запрос, THEN возвращается 200 c status:"down" и непустым error, без 5xx.
  • GIVEN внешний IP недоступен, WHEN запрос обрабатывается, THEN отдаётся last-known IP или null с указанием причины, таймаут запроса < 3s.

Definition of Done

  • OpenAPI spec обновлён и валиден.
  • Unit-тесты на парсинг wg show/аналога и на оба статуса; покрытие нового кода ≥70%.
  • CI зелёный.
Владелец: backend-engineer | Оценка: 5 SP | Приоритет: P1 Часть эпика #9 (панель состояния VPN-туннеля). ## Scope Реализовать `GET /api/v1/tunnel/status`, читающий состояние интерфейса awg0 и внешний IP; контракт — OpenAPI spec в репозитории. ## Acceptance criteria - GIVEN интерфейс awg0 поднят, WHEN выполняется `GET /api/v1/tunnel/status`, THEN возвращается 200 и JSON `{status:"up", peer_endpoint, external_ip, last_handshake_at, error:null}`. - GIVEN awg0 отсутствует или down, WHEN выполняется тот же запрос, THEN возвращается 200 c `status:"down"` и непустым `error`, без 5xx. - GIVEN внешний IP недоступен, WHEN запрос обрабатывается, THEN отдаётся last-known IP или `null` с указанием причины, таймаут запроса < 3s. ## Definition of Done - OpenAPI spec обновлён и валиден. - Unit-тесты на парсинг `wg show`/аналога и на оба статуса; покрытие нового кода ≥70%. - CI зелёный.
embeddevio added the backend label 2026-10-18 22:18:01 +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
Milestone
No items
No Milestone
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#10
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?