Flynor平台文档Flynor 首页
Flynor 文档/COMPONENT · FOUNDATION
草案

Project Resource Connector

按 Project Resource Catalog 建立资源连接并统一 Driver 注册、授权、结果、错误与 doctor。Test Management 作为项目资源专门类型接入:Choerodon Tester Provider 只负责测试用例、计划、周期、执行记录和追溯的只读连接,能力通过 Resource Tool Adapter 投影;它不替代 DevOps Connector、Test Worker 或项目 Runner。当前兼容切片已包住数据库/日志、GitNexus、本地 Git、语雀读取等成熟入口。

展示名称项目资源连接器
类型connector-boundary
成熟度试点
Owner集成平台组
01

职责与边界

负责

  • 依据 Resource Binding 建立、复用和关闭外部资源连接
  • 校验连接配置并向 Secret Store 请求受控短期凭据投影
  • 执行连接级 discover、metadata、read/query/execute 原语与健康检查
  • 标准化连接错误、来源与供应商元数据
  • 装配 Knowledge、Git、Database、DevOps、Project Tool 等内部 Resource Driver
  • 在 Project Tool Driver 下注册 Test Management 等有业务语义的资源专门类型

不负责

  • 不理解用户问题或维护持续会话
  • 不决定定时、事件或手动同步策略,也不维护缓存、索引或 last-good
  • 不实现代码搜索、文档问答、影响分析等上层 Resource Tool
  • 不调用模型或编排 Worker
  • 不处理企业微信、Test MCP、Tester 编排或 Codex 协议
  • 不直接调用项目 Runner或决定测试结论
  • 不保存 Secret 正文,也不把所有资源降格为无语义通用查询
02

数据与接口

拥有的数据

  • 连接实例、连接健康、Resource Driver 注册与非秘密来源元数据

输入

Project Resource Catalog / Binding;CredentialRef;Resource Adapter Request

输出

Connector Operation Result;连接健康与来源元数据;标准错误与审计事件

协议

flynor/project-resource-connector-*/v1alpha1;flynor/project-resource-config/v1alpha1;MCP;Adapter-specific outbound protocol

依赖

project-resource-catalog;management;secret-store;protocol;devops-connector

03

运行与部署

Owner / 支持

集成平台组 · pilot · active;升级路径:集成平台组 → 运行平台组 → 平台治理组

交付策略

embedded · supported;资源连接逻辑模块与五类 Resource Driver,受支持地嵌入 Robot 与 Project Intelligence;统一 Registry、Catalog 授权、结果、错误和 doctor,不承担同步策略、缓存索引或 Agent 工具语义。

配置

目标 Schema 为 architecture/schemas/project-resource-config.schema.json 与 project-resource-adapter.schema.json;Test Management Binding 使用 tool 访问、默认拒绝写删、独立 CHOERODON_TEST_* credential namespace。当前兼容 knowledge_sources、项目目录挂载、数据库/日志配置、zcy-mcp 项目注册表和 Test MCP 工具清单。

部署

资源宿主内的独立逻辑模块;可与 Synchronizer、Resource Tool Adapter 共进程,也可按负载拆分,不要求微服务。

健康检查

连接、CredentialRef、Adapter doctor、最小只读操作和 legacy/standard 影子比对

可观测性

仅记录 projectUnitId、resourceId、driverRef、executionId/traceId、连接阶段和结果状态;不记录凭据或默认记录资源正文

升级与回滚

按项目使用 legacy/shadow/standard 单选装配;回滚保留原配置、缓存、索引和账本,不删除业务数据或重放历史写入

依据

architecture/audits/project-resource-and-test-runtime-2026-08-25.md · architecture/adrs/0006-project-resource-and-test-runtime-boundary.md · architecture/adrs/0008-project-capability-reuse-eight-layer-architecture.md · architecture/adrs/0009-test-management-runner-browser-boundaries.md · architecture/test-integration.manifest.json · architecture/schemas/test-integration.schema.json · architecture/schemas/project-resource-config.schema.json · architecture/schemas/project-resource-adapter.schema.json · architecture/schemas/project-resource-connector.schema.json · architecture/audits/project-resource-connector-governance-2026-08-26.md · apps/robot/src/flynor_robot/project_resource_connector.py · apps/robot/tests/test_project_resource_connector.py · apps/robot/src/flynor_robot/project_data_mcp.py · apps/robot/src/flynor_robot/project_intelligence_node.py · packages/integration-content/package.json · apps/robot/src/flynor_robot/knowledge.py · apps/robot/docs/CONFIGURATION.md · apps/robot/schemas/project-intelligence-node.schema.json · architecture/audits/project-resource-closure-2026-08-30.md