# Том 10. Критерии приёмки демо-версии KazResource OS

## 10.1. Область применения

Настоящий том устанавливает чек-листы, метрики и процедуры приёмочного тестирования демо-версии «Digital Kazakhstan Experience / KazResource OS» на планшете.  
Приёмка проводится перед показом Министру и инвесторам. Все проверки делятся на:
- **P0 (blocker)** — без выполнения демо не может быть показано.
- **P1 (major)** — критично для убедительности, но не блокирует запуск.
- **P2 (nice)** — улучшает полировку; устраняются по возможности.

Каждый критерий содержит: `ID`, `Приоритет`, `Что проверяем`, `Метод проверки`, `Входные данные / шаги`, `Ожидаемый результат`, `Как зафиксировать`.

---

## 10.2. Общие принципы приёмки

1. **Все цифры и советы AI имеют маркер происхождения.** В UI отображается иконка `fact` / `model` / `forecast` / `ai_recommendation` / `demo`.
2. **Демо не управляет реальным оборудованием.** Любое действие, похожее на управление, помечено `read-only simulation`.
3. **Сценарий демо укладывается в 12–20 минут** и покрывает полный цикл: страна → пилотный кластер → скважина → НПС → трубопровод → НПЗ → финансовый AI → цифровой тенге.
4. **Планшетная версия стабильна** при 30–60 FPS, без вылетов, без рассинхрона аудио/видео.
5. **KUT-специфика видна и верифицируема**: 7 технологических слоёв, KUT-RGP, MONOLITHAR, ARKHETHOR, PFE/RFSC, NRM/WEU, 10 циклов.

---

## 10.3. Функциональные критерии (F)

| ID | Приоритет | Что проверяем | Метод | Входные данные / шаги | Ожидаемый результат | Фиксация |
|----|-----------|---------------|-------|------------------------|----------------------|----------|
| F-01 | P0 | Главный экран / карта страны | Ручной | Открыть приложение; выбрать «Казахстан» | Загружается 3D/2D карта с 13 областями, пилотная область (Маңғыстау) выделена | Скриншот |
| F-02 | P0 | Навигация к пилотному кластеру | Ручной | Тап по Маңғыстау → «Узен» | Камера летит к Узенскому месторождению, появляются скважины, ЦПСН, НПС | Скриншот |
| F-03 | P0 | 7D-паспорт объекта | Ручной | Тап на скважину UZ-101 | Открывается панель паспорта с 7 вкладками: 3D, 4D schedule, 5D cost, 6D energy/eco, 7D lifecycle, AI, KUT-RGP CID | Скриншот + запись |
| F-04 | P0 | Промышленная телеметрия | Ручной / Авто | Симуляция потока данных | Видны P, T, F, GOR, WC, vibration, corrosion с обновлением каждые 1–5 с | Лог WebSocket |
| F-05 | P0 | AI-совет с двумя вариантами | Ручной | Вызвать AI-Серік на скважине с отклонением (например, рост вибрации) | Появляется диалог с двумя вариантами действий, confidence score, источники данных | Скриншот |
| F-06 | P0 | Трубопровод Узень–Атырау | Ручной | Выбрать «Магистральный трубопровод» | Показана трасса 700 км, НПС Жетібай, датчики давления каждые 5–10 км | Скриншот |
| F-07 | P0 | Атырауский НПЗ | Ручной | Тап на Атырау НПЗ | Открывается 3D-модель НПЗ с установками АВТ, КК, риформинг, парк резервуаров | Скриншот |
| F-08 | P0 | Финансовый AI / распределение | Ручной | Тап «AI-Айым» → 100 тонн нефти | Появляется Sankey с распределением по статьям: налоги, пенсии, зарплата, CAPEX, резерв, дивиденды | Скриншот |
| F-09 | P0 | Цифровой тенге / кошелёк | Ручной | Тап на «Кошелёк гражданина» | Отображается баланс DT, история, банк-отправитель (Halyk/Kaspi/BCC), QR/адрес | Скриншот |
| F-10 | P0 | Инвестиционный кабинет | Ручной | Тап «Investor Journey» | Показаны сектор, регион, актив, сценарий, 3D-осмотр, data room, отчёт | Скриншот |
| F-11 | P1 | Поиск и голосовое управление | Ручной | Нажать микрофон, сказать «Покажи НПС Жетібай» | Распознан запрос, камера перемещается к объекту | Лог Whisper |
| F-12 | P1 | Переключение аватаров | Ручной | Свайп по панели дипломатов | Меняется AI-агент: Дәулет, Серік, Нұрлан, Айым, Жалғас, Айгерім, Зарина, Батыр | Скриншот |
| F-13 | P1 | Сравнение сценариев | Ручной | В инвест-кабинете выбрать «Оптимист/База/Консерватив/Стресс» | Пересчёт NPV/IRR, графики, 3D-маркеры рисков обновляются | Скриншот |
| F-14 | P1 | Экспорт инвестиционного меморандума | Ручной | Тап «Сформировать PDF» | PDF генерируется за <5 с, содержит титульник, NPV, риски, ESG, дисклеймер | Файл PDF |
| F-15 | P2 | Мультиязычность | Ручной | Переключить язык (каз/рус/англ) | Все UI-элементы, реплики AI, названия объектов переведены | Скриншот |

---

## 10.4. Критерии 3D / Unreal / визуализации (V)

| ID | Приоритет | Что проверяем | Метод | Входные данные | Ожидаемый результат | Фиксация |
|----|-----------|---------------|-------|----------------|----------------------|----------|
| V-01 | P0 | FPS на планшете | Авто / PerfOverlay | 12-минутный сценарий | Средний FPS ≥ 30 на iPad Pro M4 / Surface Pro 9 / Galaxy Tab S9 Ultra | Perf log |
| V-02 | P0 | LOD-переходы | Ручной | Камера от 50 км → 1 км → 10 м | Объекты переключаются LOD (0–4) без видимых «провалов» | Видео |
| V-03 | P0 | Cesium-геопривязка | Ручной | Сравнить координаты Узен (43.0°N, 52.5°E) | Модель совпадает с реальной точкой с погрешностью ≤ 100 м | Скриншот + координаты |
| V-04 | P0 | Персонажи-аватары | Ручной | Вызвать Дәулет, Айым, Жалғас | MetaHuman в национальной одежде, губы синхронизированы с TTS, отсутствуют артефакты | Видео |
| V-05 | P0 | 7D-визуализация | Ручной | Открыть 3D/4D/5D/6D/7D слои | Каждый слой визуально различим (цвет, таймлайн, графики, карты) | Скриншот |
| V-06 | P1 | Погодные/временные условия | Ручной | Переключить сутки/ночь, погоду | Освещение Lumen, тени, отражения изменяются корректно | Скриншот |
| V-07 | P1 | Анимация процессов | Авто | Запуск сценария «Добыча → транспорт → НПЗ» | Видны движение нефти по трубам, вращение насосов, дым/пар, уровень в резервуарах | Видео |
| V-08 | P2 | Accessibility | Ручной | Включить крупный шрифт, режим высокого контраста | UI читаем, цвета не теряют смысл | Скриншот |

---

## 10.5. Критерии AI / мультиагентной системы (AI)

| ID | Приоритет | Что проверяем | Метод | Входные данные | Ожидаемый результат | Фиксация |
|----|-----------|---------------|-------|----------------|----------------------|----------|
| AI-01 | P0 | Каждый агент в своей зоне | Ручной | Задать вопросы по геологии, финансам, логистике, безопасности | Ответ даёт только компетентный агент; при выходе за зону — мягкий hand-off | Лог диалога |
| AI-02 | P0 | Confidence score | Ручной / Авто | Запросить прогноз при отсутствии данных | AI показывает confidence (<0,7) и предлагает «нет достаточных данных» | Скриншот |
| AI-03 | P0 | Два варианта решения | Ручной | Сгенерировать AI-совет по отказу | Представлены ровно 2 варианта с плюсами/минусами, рисками, стоимостью | Скриншот |
| AI-04 | P0 | Галлюцинации / guardrails | Авто | 20 провокационных запросов (финансовые гарантии, управление оборудованием) | AI отказывается: «я не даю финансовых гарантий» / «управление оборудованием только через АСУ ТП» | Лог |
| AI-05 | P1 | RAG / источники | Ручной | Спросить о запасах Узен | AI приводит источники: KazSubsoil/PRMS, маркер `fact`/`model` | Скриншот |
| AI-06 | P1 | Персонализация голоса | Ручной | Включить голосовой ответ | TTS на казахском/русском/английском с акцентом «казахстанский дипломат» | Аудиозапись |
| AI-07 | P2 | Offline fallback | Авто | Отключить интернет | AI переходит на локальную модель/кэш RAG, UI информирует | Лог |

---

## 10.6. Критерии UX / планшета (UX)

| ID | Приоритет | Что проверяем | Метод | Входные данные | Ожидаемый результат | Фиксация |
|----|-----------|---------------|-------|----------------|----------------------|----------|
| UX-01 | P0 | Жесты | Ручной | Pinch, pan, rotate, double-tap | Камера масштабируется, панорамирует, вращается, центрируется | Видео |
| UX-02 | P0 | Touch target | Ручной | Тап на датчик диаметром 2 мм в 3D | Открывается панель, не промах | Видео |
| UX-03 | P0 | Читаемость при свете | Ручной | 4000K люкс | Контраст ≥ 4,5:1, названия объектов видны | Измерение |
| UX-04 | P1 | Время реакции UI | Авто | Тап на объект | Панель открывается ≤ 400 мс | Лог |
| UX-05 | P1 | Навигация по сценарию | Ручной | Следовать сценарию демо от начала до конца | Нет «тупиковых» экранов, кнопка «Далее/Назад» работает | Чек-лист |
| UX-06 | P2 | Портрет/ландшафт | Ручной | Повернуть планшет | UI адаптируется, 3D не растягивается | Скриншот |

---

## 10.7. Критерии данных / графа знаний / KUT-RGP (D)

| ID | Приоритет | Что проверяем | Метод | Входные данные | Ожидаемый результат | Фиксация |
|----|-----------|---------------|-------|----------------|----------------------|----------|
| D-01 | P0 | KUT-RGP паспорт | Ручной | Открыть UZ-101 | Поля: Asset, Measurement, Event, Right, Claim, Transaction; CID и ссылка на MONOLITHAR | Скриншот |
| D-02 | P0 | Маркеры происхождения | Авто | Скан всех чисел в UI | 100 % цифр имеют маркер: fact/model/forecast/ai_recommendation/demo | Отчёт |
| D-03 | P0 | Граф знаний | Ручной | Запрос: «Какие скважины питают НПС Жетібай?» | Cypher/GraphQL возвращает связанные узлы Well → Pipeline → NPS | Лог |
| D-04 | P1 | National Event Bus (NEB) | Авто | 5 мин симуляции | Kafka/Redis стрим не теряет событий, latency < 1 с | Grafana |
| D-05 | P1 | Происхождение данных | Авто | Проверить endpoint `/api/v1/data-lineage` | Для каждого тега указан источник: synthetic SCADA, historical, model | JSON |
| D-06 | P1 | TimescaleDB trend | Авто | Запрос за 24 ч | Возвращает тренд P/T/F за 10 мс | Лог |

---

## 10.8. Критерии KUT-специфики (KUT)

| ID | Приоритет | Что проверяем | Метод | Входные данные | Ожидаемый результат | Фиксация |
|----|-----------|---------------|-------|----------------|----------------------|----------|
| KUT-01 | P0 | 7 технологических слоёв | Ручной | Открыть «Архитектура KazResource OS» | Видны слои 1–7 с описанием и примерами для Узен | Скриншот |
| KUT-02 | P0 | Proof of Production (PoP) | Ручной | Запустить сценарий «Добыто 25 тонн нефти» | UI показывает 5 независимых источников, confidence C_PoP, статус `Production Accepted` | Скриншот |
| KUT-03 | P0 | Программируемый фискальный движок (PFE) | Ручной | Ввести V=1 000 000 DT | RFSC рассчитывает Tax, Labor, Pension, CAPEX, Reserve, Net; баланс ≤ V; Sankey визуализируется | Скриншот |
| KUT-04 | P0 | MONOLITHAR / CID | Ручной | Открыть любой паспорт | Показана ссылка `monolithar://cid/...` и хеш последнего блока (mock) | Скриншот |
| KUT-05 | P0 | ARKHETHOR / активы РВА-КЗ | Ручной | Перейти «Токенизированные активы» | Отображается токен `KUT-OIL-UZ`, NAV, выпуск только при росте чистых активов | Скриншот |
| KUT-06 | P0 | World Energy Unit (WEU) | Ручной | 1 тонна нефти → мировой энергетический эталон | Конверсия 1 т = 1,0 t.e. отображается с формулой | Скриншот |
| KUT-07 | P0 | 10 технологических циклов | Ручной | Открыть «Циклы C1–C10» для Узен | Все 10 циклов от C1 до C10 доступны с этапами и блокчейн-записями | Скриншот |
| KUT-08 | P1 | HMI/SCADA KUT | Ручной | Открыть SCADA-экран | Видны тренды, теги, аварийная сигнализация, P&ID библиотека, <1 с обновление | Скриншот |
| KUT-09 | P1 | Joint Engineering Center (JEC) | Ручной | Открыть «Партнёры → JEC с Газпромом» | Показана модель совместного центра, объекты, передача IP | Скриншот |
| KUT-10 | P2 | Цифровой банк KUT | Ручной | Показать международный расчёт T+0 | UI показывает 1–3 с, юридическая финальность, DT wallets | Скриншот |

---

## 10.9. Критерии безопасности и DevOps (S)

| ID | Приоритет | Что проверяем | Метод | Входные данные | Ожидаемый результат | Фиксация |
|----|-----------|---------------|-------|----------------|----------------------|----------|
| S-01 | P0 | OT read-only | Авто | Попытка записи в SCADA/тег | API отклоняет PUT/POST с кодом 403, лог в SIEM | Лог |
| S-02 | P0 | DMZ / шлюз | Авто | Скан портов на демо-стенде | Открыты только 80/443/8443 (Pixel Streaming/Web), OT-порты недоступны | Отчёт |
| S-03 | P0 | Secrets | Авто | `grep -r "password\|api_key"` | Нет хардкода секретов; используется Vault/ENV | Отчёт |
| S-04 | P1 | Zero Trust IAM | Ручной | Войти как «министр» vs «инвестор» vs «инженер» | Разные dashboards, RBAC работает | Лог |
| S-05 | P1 | Audit trail | Авто | 10 действий в приложении | Все действия записаны в audit log с timestamp, user, object | JSON |
| S-06 | P1 | Backup / отказоустойчивость | Авто | Убить основной Pixel Streaming | Hot-standby подхватывает ≤ 30 с | Лог |
| S-07 | P2 | AI guardrails | Авто | 50 adversarial prompts | 0 % запросов приводят к запрещённому выводу | Отчёт |

---

## 10.10. Чек-лист прогона демо (12–20 минут)

### Подготовка (T-10 мин до старта)
- [ ] Планшет заряжен ≥ 80 %.
- [ ] Wi-Fi/5G-контур изолирован, VPN/WireGuard активен.
- [ ] Hot-standby сервер работает, health-check зелёный.
- [ ] Резервный планшет синхронизирован.
- [ ] Гарнитура/динамики проверены, TTS слышно.
- [ ] Сценарий открыт в режиме презентера (operator view на втором экране).
- [ ] AI-агенты готовы: Дәулет, Серік, Нұрлан, Айым, Жалғас, Айгерім, Зарина, Батыр.

### Прогон по сценарию
- [ ] 00:00–01:30 — Открытие, Дәулет, карта Казахстана, выбор Маңғыстау.
- [ ] 01:30–03:00 — Узенское месторождение, 7D-паспорт, скважина UZ-101, Нұрлан + Серік.
- [ ] 03:00–04:30 — ЦПСН/НПС Жетібай, датчики, AI-совет с двумя вариантами.
- [ ] 04:30–06:30 — Магистральный трубопровод Узень–Атырау, Зарина, телеметрия, утечка/событие.
- [ ] 06:30–08:30 — Атырауский НПЗ, Айым, переработка, продукты, склад.
- [ ] 08:30–11:00 — Финансовый AI, распределение стоимости, цифровой тенге, кошельки.
- [ ] 11:00–13:00 — Инвестиционный кабинет, Жалғас, NPV/IRR, сценарии, токены РВА-КЗ.
- [ ] 13:00–15:00 — AI-агенты как казахстанские дипломаты, терминология, вопросы министра.
- [ ] 15:00–17:00 — Cybersecurity / Zero Trust, Батыр, OT/IT разделение.
- [ ] 17:00–19:00 — Экология, Айгерім, ESG, выбросы, рекультивация.
- [ ] 19:00–20:00 — Финал: экспорт модели, международные инвесторы, JEC, KUT-институт.

### Завершение
- [ ] Все события сохранены в audit log.
- [ ] Проведён post-demo debrief: что сработало, что улучшить.
- [ ] Сформирован отчёт о приёмке (PDF).

---

## 10.11. Дефект-критичность

- **Blocker (P0):** вылет приложения, FPS < 15, отсутствие AI-ответа, попытка записи в OT, утечка secrets, ошибка в финансовом распределении > 1 %.
- **Major (P1):** задержка UI > 1 с, несоответствие данных источнику, отсутствие одного из 7D-слоёв, неработающий голос.
- **Minor (P2):** опечатки, некритичные визуальные артефакты, отсутствие P2-функций.

---

## 10.12. Лист подписания

| Роль | ФИО | Дата | Результат | Замечания |
|------|-----|------|-----------|-----------|
| Product Owner | | | □ Принято □ Не принято | |
| UX Lead | | | □ Принято □ Не принято | |
| Unreal Lead | | | □ Принято □ Не принято | |
| AI Lead | | | □ Принято □ Не принято | |
| OT Security Lead | | | □ Принято □ Не принято | |
| DevOps Lead | | | □ Принято □ Не принято | |
| Заказчик / Министерство | | | □ Принято □ Не принято | |

**Примечание:** приёмка демо-версии не является приёмкой промышленной системы. Промышленное внедрение требует отдельного пилота на реальном объекте, метрологической поверки и сертификации.