test(web): add Vitest CI, ADRs, and PR Definition of Done

FE unit-тесты селекторов/api-client в CI; ADR по durable jobs, OpenAPI codegen и legacy Svelte; PR template WEB-19; процесс KPI cross-app sync. Co-authored-by: Cursor <[email protected]>
2026-07-31 12:27:13 +07:00
parent 8fe74c1d3b
commit 26f5172f88
8 changed files with 161 additions and 1 deletions
@@ -23,6 +23,8 @@
 | [remote-speakers.md](remote-speakers.md) | Удалённые BGP-реплики: Traefik, agent sync, compose |
 | [releasing.md](releasing.md) | Автоматические релизы, Conventional Commits, CI |
 | [ui-design-contract.md](ui-design-contract.md) | UI SoT: ReUI Frame, kit, KPI hybrid |
+| [kpi-cross-app-sync.md](kpi-cross-app-sync.md) | Синхронизация KPI/QuickActions DNA с sibling-apps |
+| [adr/](adr/) | Architecture Decision Records |
 | [openapi.yaml](openapi.yaml) | Источник правды по контракту API |
 | [OPENAPI-GITEA.md](OPENAPI-GITEA.md) | Как открыть HTML-документацию API (в т.ч. из Gitea) |
 | [evobgp-api-sketches.md](evobgp-api-sketches.md) | Ранний черновик идей API (контекст, не замена OpenAPI) |
@@ -0,0 +1,24 @@
+# ADR-001: Durable job queue via PostgreSQL job_audit
+
+## Status
+
+Accepted (2026-07)
+
+## Context
+
+`jobs.Registry` is in-process. ARCH-04 notes workers do not share memory across API replicas. Jobs were already audited to `job_audit`, but orphans after restart were not reclaimed.
+
+## Decision
+
+Keep in-process execution for latency; add durable reclaim:
+
+1. Persist lifecycle via existing `SetPersistHooks` → `job_audit`.
+2. Periodically `ReclaimStaleRunning` + `ClaimQueued` with `FOR UPDATE SKIP LOCKED`.
+3. `Registry.Adopt` injects claimed rows into the local worker pool.
+4. Claim grace (`EVOBGP_JOB_CLAIM_GRACE`, default 30s) avoids double-run of fresh local enqueues.
+
+NATS JetStream remains optional (`EVOBGP_BROKER_URL` logged only).
+
+## Consequences
+
+Two `evobgp-api` processes can reclaim orphaned work. Fresh jobs still run on the enqueueing process. Full broker-based fan-out is out of scope for this ADR.
@@ -0,0 +1,20 @@
+# ADR-002: OpenAPI → TypeScript codegen
+
+## Status
+
+Accepted (2026-07)
+
+## Context
+
+HTTP SoT is `docs/openapi.yaml`. Frontend DTOs in `apps/web/src/types/api.ts` were hand-maintained and drifted.
+
+## Decision
+
+1. Generate `apps/web/src/types/api.gen.ts` with `openapi-typescript` (`pnpm --filter @evobgp/web run openapi:gen`).
+2. Keep `api.ts` as UI-facing aliases; re-export `OpenAPISchemas` for gradual adoption.
+3. CI (`scripts/check-openapi-gen.sh`) fails when gen is stale vs OpenAPI.
+4. `packages/shared` deferred until Zod DTOs are needed cross-app.
+
+## Consequences
+
+PRs that change OpenAPI must regenerate types. Hand DTOs remain until routes migrate to `api.gen` schemas.
@@ -0,0 +1,17 @@
+# ADR-003: Removal of web-legacy-svelte
+
+## Status
+
+Accepted (2026-07)
+
+## Context
+
+`web-legacy-svelte/` (~294 files) confused agents/codegraph after the React + ReUI migration to `apps/web/`.
+
+## Decision
+
+Delete `web-legacy-svelte/` from `main`. Historical reference remains in git history. Docs and `AGENTS.md` point only to `apps/web/`.
+
+## Consequences
+
+No Svelte imports allowed. Restore from git history if a one-off migration reference is needed.
@@ -0,0 +1,19 @@
+# Cross-app KPI / Quick Actions sync
+
+EvoBGP is the **source of truth** for hybrid KPI and Quick Actions markup:
+
+- `apps/web/src/components/reui-kit/kpi-stat-grid.tsx`
+- `apps/web/src/components/reui-kit/quick-action-grid.tsx`
+
+Preview: https://reui.io/preview/base/stats-12 · https://reui.io/preview/base/card-12
+
+## Process
+
+1. Change markup/tokens only in EvoBGP first.
+2. Diff against sibling apps (`@cfdm/ui` / `@evofw/ui` / `@authportal/ui` import prefixes only):
+   - `vps-tracker/apps/web/src/components/reui-kit/kpi-stat-grid.tsx`
+   - `cloudflare-domain-manager/.../kpi-stat-grid.tsx`
+   - `EvoFirewall/.../kpi-stat-grid.tsx`
+   - `auth-portal/.../kpi-stat-grid.tsx`
+3. Port structural/class changes; keep package alias (`@evobgp/ui` → `@scope/ui`).
+4. Mention sync in the PR checklist when EvoBGP kit DNA changes.