Skip to main content
Back to insights

Run an Integration Architecture Review

Architecture reviews become abstract when diagrams omit operational decisions and recovery.

  • Architecture
  • Integration

Arinao Tshamano30 October 20262 min read

Architecture reviews become abstract when diagrams omit operational decisions and recovery. A review meeting is useful when it resolves decisions, not when it merely approves a diagram. Bring one normal workflow and one exception, then ask who owns meaning, access, timing, recovery and support at each handoff. Record unresolved questions as risks with owners.

What good engineering looks like

Can the team explain ownership, data meaning, timing, failure and support for the proposed handoff? Answer this for a named workflow and an accountable team. Identify the information needed at the moment of decision, the system that can settle a dispute, and the route for correcting dependent copies. The technical design should make those business rules visible to the people who operate and support the handoff.

  • Walk one normal case and one exception from trigger to outcome.

  • Review contract, identity and source-of-truth decisions.

  • Record unresolved risks, owners and a test that will close each one.

  • A named owner for a rejected, delayed or repeated item.

  • Evidence that the receiving system applied the intended business state.

A practical starting point

  1. Choose one real case and write down its trigger, expected outcome and responsible team.

  2. Walk the diagram against a real example with the teams who run it.

  3. Ask what evidence would prove that a proposed interface works under delay, rejection and correction. Leave with a small set of tests and decisions, including who may approve a change, rather than a general statement of confidence.

  4. Record what the test exposed, who will resolve each open question and how the fix will be checked.

Keep the first design small enough to review with the people who run the process. Test an exception alongside the normal case. A successful transport test shows that data moved; it does not by itself prove that the receiving team can make the right decision or recover from a partial failure.

The decision to make

A review is a decision checkpoint, not proof of production readiness. Verify behaviour with realistic tests. Decide what level of timing, traceability and recovery this workflow actually needs. Document assumptions that remain untested and revisit the choice when a partner, process or business rule changes. The point is a dependable operating decision, not simply a working interface.

Explore Algoza's related services: https://algoza.co.za/services/integration

Apply the thinking

Working through a related technology decision?

Share the operational context, current systems, constraints, and decision you need to make.

Discuss a requirement