feat: implement admin api v1

docs/admin-api.md

@@ -198,6 +198,26 @@
 
 - загрузить sample выходного JSON.
 
+`admin-api v1` реализует именно JSON samples, потому что они нужны для REST сценария и draft generation уже на первом этапе.
+
+### `POST /api/admin/operations/{operation_id}/drafts/generate`
+
+Назначение:
+
+- построить черновую схему и mappings из сохраненных JSON samples.
+
+В `admin-api v1` endpoint возвращает:
+
+- `generated_draft`
+- сгенерированные `input_schema`
+- сгенерированные `output_schema`
+- сгенерированные `input_mapping`
+- сгенерированные `output_mapping`
+
+## 7. gRPC descriptor endpoints
+
+Следующие endpoints относятся к фазе `grpc-support` и не входят в `admin-api v1`:
+
 ### `POST /api/admin/operations/{operation_id}/descriptors/proto`
 
 Назначение:
@@ -235,40 +255,6 @@
 }
 ```
 
-## 7. Черновая генерация схем и mappings
-
-### `POST /api/admin/operations/{operation_id}/drafts/generate`
-
-Назначение:
-
-- построить черновую схему и mappings из samples и schema artifacts.
-
-Тело:
-
-```json
-{
-  "sources": [
-    "input_json_sample",
-    "output_json_sample"
-  ]
-}
-```
-
-Ответ:
-
-```json
-{
-  "generated_draft": {
-    "status": "available",
-    "input_schema_generated": true,
-    "output_schema_generated": true,
-    "input_mapping_generated": true,
-    "output_mapping_generated": true,
-    "warnings": []
-  }
-}
-```
-
 ## 8. Тестовый запуск
 
 ### `POST /api/admin/operations/{operation_id}/test-runs`
@@ -442,10 +428,12 @@ operation:
 - список и чтение operations;
 - создание новой version;
 - publish;
-- upload samples и descriptors;
+- upload JSON samples;
 - auth profiles;
 - generate draft;
 - test run;
 - YAML import/export.
 
 Этого достаточно, чтобы UI полностью управлял жизненным циклом operation без ручного редактирования кода backend.
+
+`gRPC descriptor` endpoints добавляются отдельным этапом вместе с `grpc-support`.