---
doc_id: MAP-CK8S-DOMAIN-PACKAGE-PLATFORM
type: issue-map
title: kodex — карта Issue домена пакетной платформы
status: active
owner_role: KM
created_at: 2026-04-25
updated_at: 2026-05-14
---

# Карта Issue — пакетная платформа

## TL;DR

Долгоживущая карта домена `package-platform`.

## Матрица

| Issue/PR | Документы | Волна | Статус | Примечание |
|---|---|---|---|---|
| #642 | `docs/domains/package-platform/product/requirements.md`, `docs/domains/package-platform/architecture/design.md`, `docs/domains/package-platform/architecture/data_model.md`, `docs/domains/package-platform/architecture/api_contract.md`, `docs/domains/package-platform/delivery/package_hub.md`, `docs/catalogs/package-store/`, `docs/catalogs/plugins/`, `docs/catalogs/guidance-packages/` | PKG-1 | готово | Стартовый доменный пакет документации: границы, сущности, сценарии, события, риски и план поставки. |
| #646 | `proto/kodex/packages/**`, `specs/asyncapi/package-hub.v1.yaml`, `libs/go/platformevents/packagehub/**`, `libs/go/accesscatalog/**`, `docs/domains/package-platform/architecture/api_contract.md` | PKG-2 | готово | Контракты `package-hub`, события и действия доступа. |
| #650 | `services/internal/package-hub/**`, `docs/domains/package-platform/delivery/package_hub.md`, `docs/domains/package-platform/architecture/api_contract.md` | PKG-3.1 | готово | Минимальный каркас процесса `package-hub`: gRPC runtime, health, metrics и stub-операции. |
| #663 | `libs/go/grpcserver/**`, `docs/design-guidelines/common/external_dependencies_catalog.md`, `docs/domains/package-platform/delivery/package_hub.md` | runtime перед PKG-3.2 | готово | Общий gRPC runtime создаёт OpenTelemetry span для входящих RPC и извлекает W3C trace context для новых сервисов. |
| #667 | `services/internal/package-hub/cmd/cli/migrations/**`, `services/internal/package-hub/internal/domain/**`, `services/internal/package-hub/internal/repository/postgres/catalog/**`, `scripts/test-go-postgres.sh`, `docs/domains/package-platform/delivery/package_hub.md` | PKG-3.2 | готово | PostgreSQL-модель каталога пакетов: источники, пакеты, версии, снимки manifest и ценовые метаданные без gRPC business handlers. |
| #670 | `services/internal/package-hub/cmd/cli/migrations/**`, `services/internal/package-hub/internal/domain/**`, `services/internal/package-hub/internal/repository/postgres/catalog/**`, `docs/domains/package-platform/delivery/package_hub.md` | PKG-3.3 | готово | PostgreSQL-модель установок, схем секретов, проверок и command result без gRPC business handlers и outbox. |
| #673 | `services/internal/package-hub/**`, `docs/domains/package-platform/architecture/data_model.md`, `docs/domains/package-platform/delivery/package_hub.md` | PKG-3.4 | готово | Outbox, базовые repository-backed gRPC чтения и команда проверки версии пакета. |
| #678 | `services/internal/package-hub/**`, `docs/domains/package-platform/architecture/api_contract.md`, `docs/domains/package-platform/architecture/design.md`, `docs/domains/package-platform/delivery/package_hub.md` | PKG-4.1 | готово | Команды жизненного цикла источников пакетов: подключение, обновление, отключение, идемпотентность и события. |
| #680 | `proto/kodex/packages/**`, `proto/gen/go/kodex/packages/**`, `services/internal/package-hub/**`, `docs/domains/package-platform/architecture/api_contract.md`, `docs/domains/package-platform/architecture/design.md`, `docs/domains/package-platform/delivery/package_hub.md` | PKG-4.2 | готово | Синхронизация доступного каталога принимает нормализованный снимок, проверяет manifest, создаёт или обновляет packages/versions и пишет события. |
| #684 | `services/internal/package-hub/**`, `docs/domains/package-platform/architecture/api_contract.md`, `docs/domains/package-platform/architecture/design.md`, `docs/domains/package-platform/delivery/package_hub.md` | PKG-5.1 | готово | Запрос установки пакета и чтения установок: проверка доступа, идемпотентность, manifest-derived статусы и события установки. |
| #689 | `services/internal/package-hub/**`, `docs/domains/package-platform/architecture/api_contract.md`, `docs/domains/package-platform/architecture/data_model.md`, `docs/domains/package-platform/architecture/design.md`, `docs/domains/package-platform/delivery/package_hub.md` | PKG-5.2 | готово | Изменение, отключение и снятие установок: expected version, command result, outbox и gRPC handlers. |
| #692 | `services/internal/package-hub/**`, `docs/domains/package-platform/architecture/api_contract.md`, `docs/domains/package-platform/architecture/data_model.md`, `docs/domains/package-platform/architecture/design.md`, `docs/domains/package-platform/delivery/package_hub.md` | PKG-5.3a | готово | Чтение схем секретов: снимки схем из manifest при синхронизации каталога, событие `package.secret_schema.updated` и gRPC `GetPackageSecretSchema`. |
| #723 | `proto/kodex/packages/**`, `services/internal/package-hub/**`, `libs/go/secretresolver/**`, `docs/domains/package-platform/**`, `docs/platform/architecture/secret_resolution.md` | PKG-5.3b | готово | `RefreshPackageInstallationSecretStatus` получает безопасные ссылки секретов установки из `access-manager`, проверяет доступность через `secretresolver.Checker` без чтения значения и обновляет `secret_binding_status`. |
| #711 | `libs/go/secretresolver/**`, `docs/platform/architecture/secret_resolution.md`, `docs/domains/package-platform/**` | междоменный срез секретов | готово | `package-hub` может проверять доступность секрета без возврата значения через `secretresolver.Checker` и не получает сырое значение. |
| #718 | `proto/kodex/access_accounts/**`, `services/internal/access-manager/**`, `docs/domains/access-and-accounts/**`, `docs/domains/package-platform/**` | междоменный срез доступа | готово | `access-manager` добавил `ListPackageInstallationSecretRefs` для безопасной выдачи ссылок и статусов секретов установки без значений; `package-hub` использует этот контракт в PKG-5.3b. |
| #700 | `services/internal/package-hub/**`, `docs/domains/package-platform/**`, `docs/catalogs/package-store/`, `docs/catalogs/plugins/`, `docs/catalogs/guidance-packages/` | PKG-6.1 | готово | Специализация видов пакетов: `plugin`, `guidance`, `store`, `platform_content`; валидация manifest по виду и модели чтения через фильтры `package_kind`. |
| #704 | `services/internal/package-hub/**`, `docs/domains/package-platform/**`, `docs/catalogs/guidance-packages/**` | PKG-6.2 | готово | Руководящие пакеты отдаются как `package_kind=guidance` через существующие чтения каталога, установок и manifest; валидация запрещает runtime, секреты, действия доступа и API платформы. |
| #706 | `services/internal/package-hub/**`, `docs/domains/package-platform/**`, `docs/catalogs/package-store/**` | PKG-6.3a | готово | Локальные сценарии `store` и `platform_content`: существующие чтения каталога, установок и manifest; валидация manifest без runtime-запуска, provider-native синхронизации и хранения файлов в БД. |
| не назначено | `services/internal/package-hub/**`, `docs/catalogs/plugins/**`, `docs/catalogs/package-store/**` | PKG-6.3b+ | запланировано | Следующие интеграционные сценарии магазина, плагинов и пользовательского контента после согласования внешнего адаптера магазина, provider-native доступа и runtime-размещения. |
| #710 | `services/internal/package-hub/Dockerfile`, `deploy/base/package-hub/**`, `deploy/base/postgres/**`, `services.yaml`, `bootstrap/host/**`, `scripts/build-package-hub-images.sh`, `docs/domains/package-platform/delivery/package_hub.md`, `docs/domains/package-platform/operations/package_hub_runbook.md` | PKG-7 | готово | Эксплуатационный контур `package-hub`: манифесты, migration job, config, health, metrics и runbook; проверка первого кольца идёт через `bootstrap/host/smoke_backend_contour.sh`. |
| #281, #282 | `docs/platform/architecture/repository_onboarding.md`, `docs/domains/package-platform/**` | междоменное решение | модель выбрана, ждёт реализации | Bootstrap/adoption должны учитывать установки пакетов, руководящих пакетов и шаблонов репозиториев через `package-hub`; тексты пакетов и руководства не копируются в БД, а workspace собирается платформой из установленных пакетов, шаблонов и `source_ref`. |
