docs(integrator): v2.x.x update — workflow API + full changelog + schema extensions

This commit is contained in:
Александр Зимин
2026-05-12 00:26:37 +00:00
parent bc3373ccd8
commit d790a77313
7 changed files with 552 additions and 17 deletions
+22 -16
View File
@@ -1,28 +1,34 @@
# Pending endpoints — frontend wishlist
# Pending endpoints — frontend wishlist (ARCHIVED — все 5 shipped)
Эти 5 endpoint'ов нужны admin-UI для завершения UI-фич, заплейсхолженных в
sprint UI polish (MR !74→!93, mai-2026). Каждый блокирует конкретный
component на frontend — сегодня там показывается placeholder ("backend
changelog pending" notice / disabled button / `0` count).
> **Историческая записка.** Этот документ собирал brief из 5 endpoint'ов
> которые блокировали admin-UI fичи в sprint UI polish (MR !74→!93,
> май 2026). Все 5 теперь shipped — раздел остаётся для контекста и
> ссылок из коммитов, но для актуальной API-документации смотри:
> [read-endpoints.md](read-endpoints.md), [schema-workflow.md](schema-workflow.md),
> [events.md](events.md).
Frontend готов подключить через Orval — нужны только OpenAPI спеки.
Приоритет в порядке user-impact: 1 (highest) → 5 (nice-to-have).
## Status (2026-05-11)
## Status (2026-05-12 — final)
| # | Endpoint | Status |
|---|---|---|
| 1 | `GET /dictionaries/{name}/changelog` | ✅ shipped (MR !96) |
| 1 | `GET /dictionaries/{name}/changelog` | ✅ shipped (MR !96 + расширен MR !116 — workflow events) |
| 2 | `GET /dictionaries/{name}/snapshots` | ✅ shipped (MR !97) |
| 3 | Workflow API (4 endpoints) | ⏸ deferred — separate design + sprint |
| 3 | Workflow API (8 endpoints) | ✅ shipped (MR !113 в v2.2.0) → [schema-workflow.md](schema-workflow.md) |
| 4 | `PATCH /dictionaries/{name}/schema` | ✅ shipped (MR !98) |
| 5 | `GET /dictionaries/graph/outgoing` | ✅ shipped (MR !95) |
**4/5 endpoints landed** в session 2026-05-11 backend sprint. Workflow API (#3)
требует отдельной design discussion — state machine + RBAC pool model
parallel record-level drafts (см. `DraftController.java` для record-level
draft architecture как reference). Frontend WorkflowBanner currently рендерит
placeholder banner — кнопки скрыты пока endpoints не shipped.
**5/5 endpoints landed.** Brief полностью закрыт.
- **Changelog** в MR !116 расширен event types для draft workflow
(`SCHEMA_DRAFT_CREATED`, `REVIEW_REQUESTED`, `DECIDED`, `PUBLISHED`,
`WITHDRAWN`). Frontend History tab теперь показывает полный timeline
с промежуточными draft стадиями. Entries имеют поле `kind` для рендера
icon/color по типу события.
- **Workflow API** (#3) развернулось в 8 endpoints (4 core + 4 read-only):
create draft / submit review / decide / publish + list / active / get / pool
queue. Liquibase 0022 добавил таблицу `dictionary_schema_drafts` со
state machine guards (EXCLUDE on active, no-self-approve check).
Полная спецификация: [schema-workflow.md](schema-workflow.md).
---