OpeItcLoc03/admin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

wiki: ingest round-2 outcome — openapi-generator gotchas + sched-admin-client-openapi updated (all F-1..F-5 closed, raw_ops deleted)

Browse Source
This commit is contained in:
vitya
2026-08-18 22:49:08 +03:00
parent b019983906
commit 34e6e2c7ab
4 changed files with 77 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

32
.wiki/concepts/sched-admin-client-openapi.md
View File

@@ -6,14 +6,28 @@ related: [[openapi-generator-3-1-spec-gotchas]], [[sched-fnf-r8-verification-sta
updated: 2026-08-18
---
# sched admin-client openapi — F&F раунд
# sched admin-client openapi — F&F раунды
Живая проверка claim'а sched openapi-spec: **«клиент на любом ЯП одной
командой»**. Вердикт: **claim подтверждён с оговорками** — генерация одной
командой работает, но 3.1-спека до «любого ЯП без правок» не дотягивает
(8 операций требуют raw-обхода).
командой»**. Вердикт round 1: **claim подтверждён с оговорками** (8 операций
требуют raw-обхода). Вердикт round 2 (0.2.0/0.3.5): **claim подтверждён
полностью** — все находки F-1..F-5 закрыты, raw-обход удалён, клиент
типизированный end-to-end.
## Что делал / ожидал / получил
## Round 2 — ретест фиксов (0.2.0 / daemon 0.3.5), 2026-08-18
| | |
|---|---|
| Что | `generate.ps1` заново против `@sched/admin-api@0.2.0` (tarball spec byte-identical pinned), сьют+smoke против `@sched/daemon@0.3.5` (:8127, no auth) |
| Ожидал | все 5 находок закрыты, `raw_ops.py` не нужен |
| Получил | **все 5 закрыты**; сьют **24/24** (3 прогона), smoke **19/19** — **полностью через типизированный клиент, 0 операций на обходе**; `raw_ops.py` **удалён**; F-1/F-5 подтверждены живьём на keyed-инстансе (:8128): health 200 open, /tasks 401 без ключа, 400 на неизвестные поля schedule body/patch |
Deliverables round 2: коммит sched `d658ff0` (пример обновлён: openapi.json
0.2.0, tests/smoke typed-only, raw_ops удалён, README+generate.ps1); репорт
`sched/.agents/inbox/2026-08-18T22-55-00Z-admin-openapi-fixes-round2-retest.md`.
Механика фиксов и генераторные грабли — [[openapi-generator-3-1-spec-gotchas]].
## Round 1 — 2026-08-18 (0.1.2 / daemon 0.3.4)
| | |
|---|---|
@@ -45,12 +59,14 @@ updated: 2026-08-18
```powershell
cd sched/examples/admin-client-python
$env:JAVA_HOME = "C:\Program Files\Eclipse Adoptium\jdk-25.0.2.10-hotspot"
$env:Path = "$env:JAVA_HOME\bin;" + $env:Path # генератор спавнит java из PATH, не из JAVA_HOME
.\generate.ps1
pip install -r requirements.txt pytest
SCHED_ADMIN_URL=http://127.0.0.1:8127/api python -m pytest tests/ -v
python smoke.py --url http://127.0.0.1:8127/api
```
Стенд раунда: published `@sched/daemon` 0.3.4, `--admin-port 8127`, NO AUTH,
scratch sqlite (`/tmp/sched-acpy-stand/acpy.db`). Письменный `:8080` — под ключом
(`SCHED_ADMIN_KEY=dev-key`), `:8123` — стейл-билд (health 0.1.8, нет POST /tasks).
Стенд round 2: published `@sched/daemon` 0.3.5, `--admin-port 8127`, NO AUTH,
scratch sqlite (`/tmp/sched-acpy-stand/acpy.db`). Round 1 стоял на 0.3.4.
Письменный `:8080` — под ключом (`SCHED_ADMIN_KEY=dev-key`), `:8123` — стейл-билд
(health 0.1.8, нет POST /tasks).