@kedge-agentic/solution-backend-nest

Solution backend 暴露 ontology-bridge endpoint 用的 NestJS 适配。

类型: NestJS 绑定 · 状态: public · v0.1.0

用途

Solution backend 从这里 import,把 ontology-bridge endpoint 暴露给 ccaas 平台。 规格: docs/architecture/ontology-bridge-protocol.md。

实现 5 个 bridge protocol 中的 4 个:

• Protocol 1 (descriptor export): exportOntology() + CLI,构建时生成 ontology descriptor
• Protocol 3 (object resolve): ObjectResolver registry + GET /objects/:type/:id + POST batch
• Protocol 4 (manifest state): ManifestStateBroadcaster per-session mutex + bufferEpoch + ring buffer + SSE 流
• Protocol 5 (auth): BridgeTokenGuard — HS256 + jti 去重

2026-06-01 cleanup C5 从 solution-backend-sdk 改名而来。 包是完全 NestJS-bound 的 (10 个 @nestjs/* import + 4 个 NestJS peerDep),-sdk 后缀把这层耦合藏起来了。

主要导出

import {
  OntologyBridgeModule,
  OntologyBridgeModuleOptions,
  ObjectResolverRegistry,
  ManifestStateProviderRegistry,
  ManifestStateBroadcaster,
  BridgeTokenGuard,
  exportOntology,
} from '@kedge-agentic/solution-backend-nest'

用法

@Module({
  imports: [
    OntologyBridgeModule.forRoot({
      tokenSecret: process.env.BRIDGE_TOKEN_SECRET,
      registrars: [LessonResolver, StudentResolver, ClassroomSessionResolver],
    }),
  ],
})
export class AppModule {}

依赖

• 运行时: @kedge-agentic/ontology, fast-json-patch, jose
• Peer: @nestjs/common, @nestjs/core, @nestjs/swagger, reflect-metadata, rxjs, zod

关联包

• @kedge-agentic/ontology — bridge 服务的 schema 规格
• 平台侧: packages/platform/src/ontology-bridge/ — 消费这些 endpoint 的 ccaas 端对手

构建 / 测试

npm run build:solution-backend-nest
npm test -w @kedge-agentic/solution-backend-nest