Skip to content

Epic: Protocol connection management and operator console #206

@smithaldon1

Description

@smithaldon1

Purpose

Build production-oriented, read-only protocol connection management for OPC-UA, MQTT, and BACnet, and reshape the Factory Intelligence Platform Workbench into a Demo-Factory-style operator console.

This supersedes the old live OPC-UA drift demo workstream. The new direction is broader: define protocol connections, test them safely, show connection health and tag/source mappings, and route configured source readings through the FactoryEvent ingestion path.

Acceptance Criteria

  • Connection profiles can be defined for OPC-UA, MQTT, and BACnet.
  • Secret and certificate values are referenced or redacted; raw secrets are not returned to the browser.
  • Test-connection behavior is read-only and returns structured health/errors.
  • Workbench uses an operator-console layout inspired by Demo-Factory: sidebar navigation, status strip, connections, protocol diagnostics, tag/source browser, and existing Sentinel workflows.
  • Protocol adapters remain read-only by default and normalize source readings into FactoryEvents before Process Sentinel consumes them.
  • Documentation explicitly states no industrial writeback, arbitrary tag writes, product disposition, QMS/MES writeback, or production-readiness claim.

Out of Scope

  • Direct control of PLCs, DCS, SCADA, or equipment.
  • Arbitrary tag writes.
  • Product release/quarantine actions.
  • QMS/MES writeback.
  • Electronic signatures or validated production audit trails.
  • Copying Demo-Factory code wholesale instead of using it as a UI/reference model.

Implementation Order

  1. Connector architecture ADR and safety boundary.
  2. Shared connection profile schema.
  3. Connection profile API and storage.
  4. Read-only test-connection API with redacted results.
  5. Operator-console shell redesign.
  6. Connections page.
  7. OPC-UA adapter foundation.
  8. MQTT adapter foundation.
  9. BACnet adapter foundation.
  10. Protocol Diagnostics page.
  11. Tag/source browser.
  12. Connector tests and docs.

Project Notes

Use Project fields: Status=Ready, Workstream=Ingestion & Connectors, Priority=P1 High, MVP Phase=Post-MVP, Risk=High, Needs Tests=Yes, Needs Docs=Yes, Target Release=v0.2.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Epicconnection-managementConnection profile, credential reference, health, and test-connection workconnectorConnector architecture and integration workoperations-workbenchOperations Workbench web UI workoperator-consoleDemo-Factory-style Workbench shell and live operational UI workpost-demoNot required for the manufacturer demo path

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions