Реестр программных компонентов КТМ-ДАС (драфт)

5 ноября 2026. Черновик по имеющимся описаниям. Не утверждённая архитектура. Статусы — по описаниям на 03.11.2026, в коде не перепроверялись.

Обозначения

Статус

Значение

работает

есть в выложенной версии или на develop4

демо

работает как демонстрационный контур, не продуктовый

частично

реализовано частично

на ревью

MR или ветка на ревью

ветка

реализовано в ветке, не влито

не выложено

реализовано локально, не развёрнуто

в платформе

компонент назван в C4, отдельный статус в описаниях не указан

внешняя

внешняя система или зависимость

Источники — S1–S9, расшифровка в конце.

1. Клиентские интерфейсы

ID

Компонент

Тип

Назначение

Статус

Источник

CI-01

Портал станций /portal

веб

Три станции: сертификаты, приборы, паспорта, метки, передача, акты, блоки, агент

демо

S1, S4, S8

CI-02

Консоль сценариев /console

веб

Пошаговые сценарии DiCE и агента; ключи и подписи в браузере (WebCrypto)

демо

S1, S4

CI-03

Страницы /scan, /s/<DID>, /p/<DID>

веб

Скан метки камерой, фото или ссылкой; печатный паспорт прибора или блока

работает

S1, S4

CI-04

Frontend Контрактиума

веб

Интерфейс ЦП, договоров, поставок и вложений

работает

S4

2. Шлюзы и сервисы платформы

ID

Компонент

Тип

Назначение

Статус

Источник

CI-05

API Gateway (apigw, apigqlgw)

шлюз

REST/GraphQL-шлюз, JWT + RBAC

в платформе

S3, S4

CI-06

auth

сервис

Аутентификация, вход по УКЭП, выдача токенов

в платформе; проверка УКЭП частично

S2, S4

CI-07

organizations

сервис

Организации, роли, связи

в платформе

S3, S4

CI-08

applications

сервис

Заявки

в платформе

S4

CI-09

registrations

сервис

Регистрации

в платформе

S4

CI-10

verifications

сервис

Проверки, ProbePKI/CheckPKI; проверка УЦ и CRL — TODO

частично

S2

CI-11

contractengine

сервис

Договорный контур

в платформе

S4

CI-12

dictionaries

сервис

Справочники

в платформе

S4

CI-13

notifications

сервис

Уведомления; связка с DID/VC не подключена

в платформе

S2, S4

CI-14

payments

сервис

Платежи

в платформе

S4

CI-15

poa

сервис

Машиночитаемые доверенности (МЧД)

в платформе

S3, S4

CI-16

documents-svc

сервис

Документы Контрактиума: шаблоны ЦП, поставок, УПД; клиент реестра HLF и синхронизатор паспортов КТМ-А

работает; ledger-часть на ревью

S4, S5, S9

CI-17

storage-svc

сервис

Хранение файлов и сканов; в блокчейн идут только отпечатки

работает

S4, S9

CI-18

pki-svc

сервис

Разбор X.509, класс владельца, выпуск тестовых сертификатов; подписи не проверяет

частично

S2

CI-19

app-assets (assets-app, КТМ-А)

сервис

Договоры, цифровые паспорта, вложения, поставки, КБО; REST API; своей БД нет

работает; интеграция с реестром — ветка

S2, S4, S5

CI-20

cspgw-svc

сервис

ГОСТ-подпись транзакций HLF ключом организации (Криптосмарт)

работает

S2

CI-21

cspemul-svc

сервис

Эмулятор ГОСТ на стенде: ключи, cms/sign, cms/verify; not for production

демо

S2

CI-22

sigutils

библиотека

Подписи documents-svc: CAdES, PKCS#7, XMLDSig, ПЭП; валидаторы не проверяют подпись

частично

S2

CI-23

DAPSvc

сервис

Цифровой Паспорт Актива-сервис в схеме services_relations; в entities.md ЦПА ведёт app-assets — расхождение

требует уточнения

S2, S3

3. Реестр DID/VC

ID

Компонент

Тип

Назначение

Статус

Источник

CI-24

did-svc

сервис

DID-документы, подписанные операции, владелец, история и verify, outbox; REST :8080, gRPC :9090

работает

S1, S2

CI-25

vc-svc

сервис

VC-JWT, verify, отзыв, скан, кастоди, мандаты агентов, справочник типов; REST :8081

работает

S1, S2, S4

CI-26

identity-сервис

сервис

Персоны и did:i:*; выпуск PersonCredential

работает

S2

CI-27

Кастоди /custody/*

модуль vc-svc

Подпись ключом организации по токену станции или BIMAR

демо; ключи в Secret, ротации нет

S1, S4

4. Блокчейн-слой

ID

Компонент

Тип

Назначение

Статус

Источник

CI-28

blockchain-svc

сервис

Доступ к HLF: InvokeSmartContract / QuerySmartContract, клиент, кошелёк

работает

S4, S9

CI-29

blockchain-hlf

адаптер

blockchain-svc + PostgreSQL + NATS в тестовой сети

на ревью

S4

CI-30

Сеть HLF

сеть

peer0-gazprom, peer0-tmk, orderer, канал org

внешняя, тестовая

S4, S9

CI-31

docs-chaincode

чейнкод

Документы KCONT-2249, коллекция docsGazpromTmk

на ревью

S4

CI-32

did-registry

чейнкод

DID/VC в world state; ветка ledger-hlf, в канал не установлен

не выложено

S1, S9

CI-33

Блокчейн-вьюер

API + скрипт

GET/POST /api/v1/ledger/* в documents-svc и ledger-demo.sh; UI нет, доступ через port-forward

на ревью

S1, S4

CI-34

NATS

шина

Обмен платформенных сервисов

работает

S4

CI-35

PostgreSQL

БД

Общая БД did/vc и платформы на стенде

работает

S1, S2

5. Инструменты и CLI

ID

Компонент

Тип

Назначение

Статус

Источник

CI-36

didsign

CLI

keygen, подпись операций DID, VC и отзыва

работает

S1, S2

CI-37

agentmanifest

CLI

Сборка манифеста агента и manifestDigest

работает

S2

CI-38

agentmcp

MCP-сервер

Подключение модели-агента: init, call

работает

S1, S8

CI-39

stand5-flow.mjs

скрипт

Сквозной прогон стенда 5: 10 проверок

работает

S8

CI-40

ledger-demo.sh

CLI

Проверка записи напрямую через peer chaincode query, в обход Контрактиума

на ревью

S4

6. Инфраструктура и доставка

ID

Компонент

Тип

Назначение

Статус

Источник

CI-41

ZeptoClaw

агентный фреймворк

Контейнер zeptoclaw-agent-a, gateway 3000/8080/9090, approval-гейт

работает

S7

CI-42

YandexGPT_to_OpenAI (y2o)

прокси

Трансляция OpenAI-формата в Yandex API, порт 8520

работает

S7

CI-43

Docker

среда

Контейнеры ZeptoClaw, y2o, did/vc, PostgreSQL

работает

S1, S7

CI-44

Namespace develop-contracteum4

среда

Стенд develop4: сервисы did и vc, общая PostgreSQL

работает

S1, S4

CI-45

ArgoCD + GitLab registry

доставка

GitOps: образы gitlab.procsy.ru:5050/contracteum/network, тег в develop4-values.yaml

работает

S1

7. Внешние системы

ID

Компонент

Тип

Назначение

Статус

Источник

CI-46

BIMAR

внешняя

Система изготовителя app.bimarkit.com; обмен по VC API с токеном станции

внешняя

S1, S4

CI-47

SCADA DEMO API

внешняя

API демо-стенда АСУТП ПроКСи (scada.procsy.ru:8000/api/v1)

внешняя

S6

CI-48

Yandex Cloud API

внешняя

llm.api.cloud.yandex.net; Api-Key и folder_id

внешняя

S7

CI-49

Внешние PKI/УЦ

внешняя

Проверка цепочки X.509, CRL/OCSP; не подключена

не подключено

S2

CI-50

W3C DID registry

внешняя

Регистрация метода did:ru; не подана

не подключено

S1, S2

CI-51

Email-шлюз

внешняя

Отправка уведомлений

внешняя

S3

Открытые расхождения

  1. DAPSvc и app-assets: в services_relations.md узел DAPSvc подписан «PKISvc», в entities.md ЦПА ведёт assets-app. Нужно уточнить, один это компонент или разные.

  2. Договоры: в did-registry-hlf.md (Р5) указано расхождение — contracts-svc у аналитика или documents-svc по вики и коду.

  3. Интеграция app-assets с реестром собрана в ветках dev4-demo-integration и KCONT-2291, в develop не влита.

  4. did-registry и запись DID/VC в HLF не выложены; blockchain-hlf и блокчейн-вьюер ждут ревью MR !1756.

  5. Идентичность ЦП (did:i:*) и приборов BIMAR (did:ru:device) не объединена.

Источники

ID

Документ

S1

09-exchange/DID-VC-итоги-2026-11-03/README.md

S2

02-arch/tobe/services-and-dto/did-vc/docs/entities.md

S3

02-arch/tobe/services-and-dto/did-vc/docs/services_relations.md

S4

02-arch/tobe/software-components/did-vc/c4-stand5.html

S5

02-arch/tobe/services-and-dto/openapi(ЦП).yaml

S6

03-epics/depsi/openapi.yaml

S7

02-arch/tobe/infrastructure/zeptoclaw-runbook.md, 251006_zeptoclaw+yGPT.md

S8

02-arch/tobe/services-and-dto/did-vc/docs/stand5/README.md

S9

02-arch/tobe/software-components/did-vc/did-registry-hlf.md

Журнал изменений

Дата

Перечень изменений

Автор

2026-11-05

Создан драфт реестра программных компонентов.

Дис