meta(tasks): create [sched-admin-client-openapi] in OpeItcLoc03/admin

This commit is contained in:
2026-08-18 19:00:48 +00:00
parent b56da997c4
commit c6c92b55fa

View File

@@ -1894,3 +1894,34 @@ Rollback: вернуть прежний образ стека либо реве
<!-- closed-by: OpeItcLoc03@DESKTOP-NSEF0UK / 2026-08-17T21:17:xxZ / note: репорт r7 + приёмка r6 отправлены 21:17Z, 91/92 + F1/F2 -->
---
## ⚪ [sched-admin-client-openapi] — Цель: написать admin-клиент для sched на ЛЮБОМ другом языке (не TypeScript/JavaScript) строго по OpenAPI-спеке @sched/admin-api, проверить живым smoke по методике F&F. Это живая проверка claim'а openapi-spec: «клиент на любом ЯП одной командой». Клиент пишется В РЕПО SCHED (C:\Users\vitya\projects\sched, папка examples/admin-client-<lang>/, по образцу examples/workers/), ПУШ РАЗРЕШЁН — решение vitya 2026-08-18 (явное исключение из fnf-testing-procedure «внешний агент не пушит в наш репо»).
## Acceptance criteria
1. Язык — любой, кроме TS/JS (свободный выбор: Python/Go/C#/Java/…). Путь свободный: сгенерированный (openapi-generator/swagger-codegen/lang-tool) ИЛИ рукописный — но источник истины ОДИН: openapi.json (subpath-export @sched/admin-api/openapi.json, опубликован 0.1.2 в verdaccio; в репо: packages/admin-api/openapi.json), не чтение нашего TS-исходника.
2. Покрытие: ВСЕ пути спеки (openapi.json 3.1, 15 путей: /health, /tasks (+run|pause|resume|schedule), /schedules (+/:id|pause|resume), /runs (+/:id|retry), artifacts; securityScheme Bearer).
3. Живой smoke против реального admin-api: свой стенд (verdaccio-пакеты, свой порт — конвенция .admin/.tmp/) или наш :8080 (живой, Node 24). Каждый путь дёрнут минимум раз, результат — в репорте.
4. Репорт по F&F-формату: что делал → что ожидал → что получил (вывод/стек) → ссылка на раздел доки + «гладкое». Находки/пробелы спеки-доков — в репорт, НЕ чинить (имплим мы).
5. TDD: unit-тесты клиента на контракт спеки + smoke-харнесс.
## Обязательные скилы — вызвать до начала работы
- invoke `tdd-criteria` — до написания кода
- invoke `using-tasks` — управление статусом задачи
- invoke `project-discipline` — дисциплина коммитов/пушей (в чужом репо аккуратно: только свои файлы examples/admin-client-<lang>/)
- invoke `using-context7` — актуальные доки/SDK выбранного ЯП
- invoke `using-wiki` после закрытия — заингесть .wiki/concepts/sched-admin-client-openapi.md
**TDD:** да — контракт-тесты + smoke
**Разрешения:** интерны: нет | автопуш: да
**weight:** needs-claude
**notify:** victor/sched
**Status:** ready
**Where I stopped:** (not started)
**Next action:** Выбрать язык (любой кроме TS/JS), прочитать openapi.json из @sched/admin-api (verdaccio 0.1.2), написать клиент в examples/admin-client-<lang>/ репо sched (TDD), прогнать живой smoke против admin-api (свой стенд или :8080), отправить F&F-репорт в victor/sched инбокс.
**Branch:** n/a
**Notify:** victor/sched
<!-- created-by: OpeItcLoc03@DESKTOP-NSEF0UK / from: victor/sched / 2026-08-18T19:00:48.011Z -->
---