Skip to main content

Architecture

Documentation Map​

Architecture

System Overview​

jhf-wire is an isolated connector runtime sitting between Helpifyr Spindle and external providers.

Core pattern:

Helpifyr Spindle dispatch -> n8n workflow -> provider/runtime -> signed callback -> Helpifyr Spindle

Main Components​

  • n8n-jhf-wire
    • workflow engine for ingress, provider calls, and callbacks
  • eric-service
    • wrapper service for ELSTER-oriented processing
  • scripts/*
    • reconciliation, verification, and probe tooling
  • fabric-manifest.json and scripts/export-fabric-metadata.py
    • machine-readable bundle and status self-description

Data Flow​

Dispatch-Oriented Flows​

  1. Helpifyr Spindle sends a dispatch payload to a workflow webhook.
  2. The workflow normalizes input and calls the target provider/runtime.
  3. The workflow maps success, error, or approval-required outcomes.
  4. The workflow sends a signed callback to Helpifyr Spindle.

Bank Sync Flow​

  1. Helpifyr Spindle triggers bank sync.
  2. jhf-wire fetches user-context banking data from finAPI.
  3. Normalized bank statements are sent to Helpifyr Spindle via MCP.

Internal And External Interfaces​

  • inbound n8n webhooks for Helpifyr Spindle
  • outbound signed callback to Helpifyr Spindle
  • outbound MCP call to Helpifyr Spindle for bank imports
  • outbound REST calls to finAPI, Storecove, and the internal ERiC service

Dependencies​

  • hard: Helpifyr Spindle, finAPI, Docker runtime, Gitea
  • optional or narrower-scope: Storecove, ELSTER live credentials, future jhf-fabric consumption

Operating Assumptions​

  • Git remains authoritative over runtime JSON definitions
  • Linux runner behavior is the CI reference
  • no cross-repo mutation is required for normal repo development
  • external provider credentials may remain intentionally pending without meaning the repo is broken

Role In The Helpifyr Ecosystem​

This repository is the provider-bridge half of the bundle jhf-spindle-wire. Helpifyr Spindle is the business origin; jhf-wire is the delivery and connector execution layer.

Expected Role Relative To jhf-fabric​

  • discoverable bundle metadata source
  • machine-readable capability and connection source
  • machine-readable status export source
  • not a Fabric-controlled execution engine

License: AGPLv3 Project website: https://helpifyr.com