Guía de patrones de conectores
Utilice este patrón de ingeniería al agregar o revisar un nodo de conector de terceros. La guía completa, con el esqueleto de Go y la lista de verificación de PR, es tietai-hydra-platform/docs/CONNECTOR_PATTERN_GUIDE.md.
Dos patrones
| Patrón | Dónde | Utilizar cuando |
|---|---|---|
| A: node handler | pkg/node/handlers/<vendor>_node.go | El proveedor dispone de una API REST, FHIR o GraphQL multioperación. El nodo tiene su propia configuración operation Casi todos los conectores de EHR utilizan esta configuración. |
| B: driver | pkg/connector/<type>/ implementando connector.Driver (Connect, Disconnect, Test, Metadata, Read, Write) | La fuente es un conjunto uniforme de registros (S3, GCS, exportación masiva FHIR). El nodo de la canalización se genera automáticamente y se denomina <driver-type>-connector. |
Qué patrón proporciona un conector
Cada conector es un nodo, por lo que su contrato es el esquema del nodo (Schema()), que devuelve la API del catálogo:
| Campo de esquema | Requisito |
|---|---|
ID, Name, Description | El ID es el tipo de nodo: en minúsculas, separado por guiones (por ejemplo webdoc-carasent). |
Category | ehr para cada conector específico del proveedor, incluidos los nodos SAP. Los nodos de estándares genéricos (cliente FHIR, consulta FHIR, CRUD FHIR) son healthcare. |
Inputs, Outputs | Puertos tipados. Las salidas normalmente utilizan la envolvente compartida result / metadata / success. |
Config | Cada configuración, con etiqueta, descripción, grupo (basic, auth o advanced), valores predeterminados y permitidos. |
Compliance, Capabilities, UseCases, ConfigHighlights, PerformanceTier | Metadatos descriptivos que se muestran en el catálogo y que utiliza el Copilot. |
ErrorCodes | Condiciones de error conocidas. La guía solicita al menos <VENDOR>_AUTH_FAILED y <VENDOR>_REQUEST_FAILED. |
El conector también debe estar registrado en pkg/node/handlers/registry.go y listado en inferCategory() en internal/api/rest/nodecatalog_handlers.go.