All engagements

INTEGRATION & INTEROPERABILITY

Know what to stabilize.
Know what to change.

Integration Architecture Review

A bounded review of one healthcare integration workflow: its dependencies, failure paths, and the decisions needed before modernization. Led by Ian Booker, with prior integration engineering experience at Rush and data architecture experience at Lurie Children’s Hospital.

WHEN THIS HELPS

An unclear integration.
A decision that cannot wait.

Interfaces are difficult to change, dependencies are poorly understood, or an upcoming migration needs a defensible starting point. The review helps your team agree what to address first.

A bounded starting point

One agreed workflow and its connected systems, reviewed through stakeholder discussions and sanitized architecture and interface evidence.

What you receive

  • A current-state flow and dependency map.
  • Failure-path analysis and prioritized gaps.
  • A target design and architecture decision records.
  • A sequenced implementation plan with operating responsibilities.

The decision: what should be stabilized, redesigned, or migrated first?

ILLUSTRATIVE REVIEW EXCERPT

See the reasoning.
Inspect the output.

Fictional scenario. Not a client case study. All systems, evidence references, findings, and responsibilities below are invented to demonstrate the work product. No production outcome or measured improvement is claimed. This excerpt is not the complete contracted review.

The question

A fictional outpatient organization plans to replace its interface engine. Before choosing a migration sequence, it needs to understand how appointment updates reach its scheduling application and reporting feed.

Review boundary: One appointment-update workflow, its two consumers, and the exception process. Other interfaces, patient care decisions, and production changes are outside this example.

01 / Current-state workflow

Appointment sourceEmits update messages
Interface engineRoutes updates to two consumers
Scheduling applicationApplies appointment changes
Reporting feedReceives a separate copy
Exception handling

Engine failures enter an exception queue for operator review. In this assumed design, downstream application failures have no documented reconciliation path.

Assumed flow: source → engine → scheduling and reporting. The engine exception queue covers routing failures; application-level completion remains an open question.

02 / Findings and evidence limits

F01 / ESTABLISH COMPLETION

A handoff is not the whole outcome.

Fictional evidence E1: The sample flow diagram ends at the consumer connection and omits application processing status.

Inference: The diagram cannot establish whether an appointment change was applied. This is a documentation gap, not proof of message loss.

Verify: Trace approved synthetic updates from source through application state and reporting. Record failure and rejection behavior.

F02 / DEFINE SAFE RECOVERY

Replay needs an explicit contract.

Fictional evidence E2: A sample runbook says “resend the message” without duplicate or ordering rules.

Inference: Safe replay is not demonstrated. Do not assume either consumer handles duplicates safely.

Verify: In a non-production environment, test duplicate and out-of-order updates with each consumer owner. Document expected state and rejection handling.

F03 / ASSIGN THE EXCEPTION

Ownership stops at the engine.

Fictional evidence E3: A sample responsibility list names the engine operator but omits the application-side escalation owner.

Inference: Recovery ownership is unclear; response performance has not been measured.

Verify: Agree an escalation path and rehearse a synthetic failure with engine, application, and reporting owners.

03 / SAMPLE ARCHITECTURE DECISION · ADR-001

Establish recovery behavior before selecting the cutover sequence.

Status: Proposed within this fictional scenario; subject to evidence and stakeholder review.

Option A — Replace first
Move the workflow to the new engine immediately. This may advance the platform replacement, but leaves completion and replay assumptions unresolved.
Option B — Define and test, then sequence
Establish completion checks, recovery rules, and named ownership before planning cutover. Adds preparatory work and requires consumer-owner availability.
Option C — Replace the whole workflow
Redesign producer and consumers together. Could address broader constraints, but exceeds this review boundary and requires a separate investment decision.

Proposed choice: Option B for this example. Keep the migration decision conditional on verified consumer behavior, an agreed exception procedure, and a recoverable cutover plan.

Reconsider if: An imminent platform deadline changes the trade-off, the existing platform cannot support the required checks, or the synthetic tests reveal incompatible consumer behavior. A changed recommendation needs an explicit risk decision.

04 / Sequenced actions

  1. Establish the workflow boundary

    Proposed owner: Integration lead with application and reporting owners.

    Completion evidence: An agreed flow map identifying update types, each consumer, and the point at which processing is considered complete.

  2. Verify failure and replay behavior

    Proposed owner: Integration engineer and consumer owners.

    Completion evidence: Recorded synthetic test results for normal processing, duplicates, ordering, and rejection; unresolved cases documented.

  3. Rehearse exception handling

    Proposed owner: Operations lead and named application responders.

    Completion evidence: A practiced escalation and recovery procedure with responsibility for each handoff.

  4. Choose the migration sequence

    Proposed owner: Architecture sponsor and change owner.

    Completion evidence: A decision record with dependencies, acceptance conditions, and rollback criteria. No production change is performed by this illustrative review.

What this excerpt demonstrates: the connection between an evidence gap, a verification task, an architecture decision, and a delivery sequence. It does not demonstrate a client result.

HOW THE REVIEW WORKS

Agree the question.
Make the next step clear.

Work starts with a written scope, fee, inputs, and delivery date. The scope follows your workflow and decision; the sample above does not prescribe a universal solution.

Discuss a project or contract
  1. Frame the decision. Identify the workflow, stakeholders, constraints, and desired outcome.
  2. Review the evidence. Examine sanitized diagrams, interface descriptions, relevant procedures, and stakeholder explanations.
  3. Resolve the important unknowns. Distinguish supported findings from assumptions and agree what needs further verification.
  4. Walk through the recommendation. Review the target design, trade-offs, priorities, and operating responsibilities with the team.
Inputs and exclusions

Useful inputs: A workflow description, existing diagrams, known pain points, relevant interface documentation, and access to the people who own the connected systems.

Not included by default: Production changes, emergency incident response, a complete interface inventory, migration execution, or ongoing operations. A broader delivery need can be scoped separately.

Initial reviews use sanitized evidence. System access and implementation are agreed separately. Do not send patient information, credentials, or confidential documents through the inquiry link.

START A CONVERSATION

Bring the architecture
challenge into focus.

Share the work, the team, and the timing. Ian welcomes relevant senior architecture opportunities and focused consulting inquiries.

Please leave out patient data, credentials, and confidential documents. Supporting material can be arranged afterward.

Projects & contracts

Describe the integration, platform, or architecture challenge and the support you need.

Integration Architecture Review

Discuss a project or contract Or use the inquiry form

For consulting, scope, fee, inputs, and timing are agreed before work starts.

Architecture roles

C2C/1099 preferred. Suitable W2 roles considered.

Send the role, organization, location, engagement type, and expected rate or salary range.

Discuss an architecture role Or use the inquiry form