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

Sprint 1: GeoIP-модуль (RIPE Stat): загрузка, кэш, расписание, fallback #25

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

Owner: backend · Est: 5 SP · P0 · Sprint 1 · Deps: #24 · Refs #15

  • Провайдер-абстракция GeoProvider; реализация RIPE Stat API (country-resource-list, IPv4+IPv6), ~11.4k префиксов — как в PoC.
  • Кэш-снапшот на диске (/data/geoip/), версия/дата, загрузка при старте из кэша → затем обновление в фоне.
  • Расписание обновления (cron-подобное), ручной forced update, метрики (время, кол-во префиксов, источник, ошибки).
  • Fallback при недоступности источника с явным статусом «используется кэш от даты X» на UI/API.

AC:

  • GIVEN первый старт без кэша, WHEN приложение поднялось, THEN GeoIP загружен и счётчик префиксов ≥ 10 000 (метрика + лог).
  • GIVEN недоступный RIPE (мок 503), WHEN стартует приложение, THEN используется кэш и в статусе видна дата снапшота, а не тихая ошибка.
  • GIVEN наступило расписание, WHEN прошло время, THEN выполнен update и обновлён ipset без перезапуска контейнера.

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

**Owner:** backend · **Est:** 5 SP · **P0** · **Sprint 1** · **Deps:** #24 · Refs #15 - Провайдер-абстракция `GeoProvider`; реализация RIPE Stat API (`country-resource-list`, IPv4+IPv6), ~11.4k префиксов — как в PoC. - Кэш-снапшот на диске (`/data/geoip/`), версия/дата, загрузка при старте из кэша → затем обновление в фоне. - Расписание обновления (cron-подобное), ручной forced update, метрики (время, кол-во префиксов, источник, ошибки). - Fallback при недоступности источника с явным статусом «используется кэш от даты X» на UI/API. AC: - GIVEN первый старт без кэша, WHEN приложение поднялось, THEN GeoIP загружен и счётчик префиксов ≥ 10 000 (метрика + лог). - GIVEN недоступный RIPE (мок 503), WHEN стартует приложение, THEN используется кэш и в статусе видна дата снапшота, а не тихая ошибка. - GIVEN наступило расписание, WHEN прошло время, THEN выполнен update и обновлён ipset без перезапуска контейнера. DoD: coverage ≥70%, CI green, ревью владельца роли.
embeddevio added this to the Sprint 1 — Ядро шлюза: tunnel / routing / GeoIP / DNS milestone 2026-10-21 23:24:29 +03:00
embeddevio added the backendstatus/backlog labels 2026-10-21 23:24:29 +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 1 — Ядро шлюза: tunnel / routing / GeoIP / DNS
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#25
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?