docs(integrator): v2.x.x update — workflow API + full changelog + schema extensions
This commit is contained in:
@@ -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).
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user