>_ Analyst Engineering

Systems Analyst

Systems Analyst

A systems analyst sees how the pieces connect, mapping end-to-end flows and documenting the integrations between services. This pillar covers that work in practice: drawing system context and sequence diagrams, choosing between synchronous and asynchronous integration, designing reconciliation between systems, and understanding ISO 20022 architecture and payment message flows end to end. Written for analysts who own the big picture, with patterns from real integration delivery.

Requirements to UAT

The system-facing parts: reading the diagram you were handed against the contract and the code, and connecting an assistant to Jira, Confluence, Xray, and Datadog.

The AI Analyst

The integration parts: connecting an assistant to Jira and Confluence over the Model Context Protocol, and the guardrails that scope what it can reach.

Stripe PaymentIntents API Review: 22 of 24 on the Scorecard, and the 12 Findings Your Integration Must Own

Stripe's PaymentIntents API scored on a 12-check contract review: 22 of 24, plus the idempotency, webhook, versioning, and lifecycle findings your team must own.

Diagrams as Code with AI: The Analyst's System for Mermaid, BPMN, and Sequence Diagrams

How analysts use AI to draw and maintain Mermaid, BPMN, and sequence diagrams: the context pack, the house style file, the review loop, and the git workflow.

Analyzing Diagrams With AI: Turning an Architecture Picture Into Requirements and Gaps

How to read a diagram you were handed with AI: extract actors, flows and rules, find the missing branches, and reconcile the picture against the contract and the code.

BPMN with AI: Generating Valid BPMN 2.0 XML That Opens in Camunda and bpmn.io

How analysts use AI to produce real BPMN 2.0 XML, not flowchart approximations: the element subset that matters, the prompt, validation, and maintenance.

Turn a Bruno or Postman Run Into a Live Sequence Diagram

Generate a Mermaid sequence diagram from a Bruno or Postman collection run. The trace script, the newman JSON export, the prompt, and the CI wiring.

Automating Kafka Validation in Postman: Collections, Scripts, and a CI Gate

Turn manual Kafka checks into an automated Postman collection: produce and consume over REST Proxy, poll with backoff, assert schema and ordering, and run it in CI.

MCP and API Tokens for Jira, Confluence, Xray, and Datadog: The Analyst's Write Path

Wire an assistant to Jira, Confluence, Xray, and Datadog with scoped API tokens and MCP: read safely, publish idempotently, and keep every write reviewable in git.

Mermaid for Analysts: The Six Diagram Types You Actually Need

A practitioner reference for Mermaid: sequence, flowchart, state, ER, C4 context, and gantt diagrams, with copy-paste syntax and where each one renders.

RAG for Analysts: How to Specify and Test a Retrieval System

What retrieval-augmented generation is, the eight stages where it fails, the requirements an analyst must write for each, and a golden-set harness that proves it works.

Draw Sequence Diagrams from Splunk and Datadog Logs: The Flow as It Actually Ran

Turn correlated Splunk or Datadog logs into an accurate Mermaid sequence diagram with AI. The queries, the export shape, the prompt, and the verification step.

Test Strategy to Execution: The Pipeline That Runs Your Tests and Proves the Coverage

Write a test strategy that makes decisions, turn conditions into an executable suite, run it in CI with Xray and Datadog, and generate the coverage proof automatically.

The AI Analyst Operating System: Eleven Parts, One Working Week

How the whole AI analyst stack fits into a real week, the 90-day build order, what to measure, how to lead adoption on your team, and what to put on your CV.

Context Engineering for Analysts: The Project Pack That Makes AI Accurate

Stop pasting documents into every prompt. Build a project context pack once: glossary, contracts, data dictionary, rules, examples, and the retrieval that finds them.

AI Guardrails for Analysts: What Never Goes Into a Prompt

The rules of engagement for AI in a regulated delivery team: what data never leaves, how to mask it, tool tiers by blast radius, and the audit trail you keep.

AI in the Codebase: How Analysts Read a Repository They Did Not Write

Point AI at the repo and answer questions no document can: where a rule really lives, what a status actually means, what a pull request changes for the business.

Bulk Payments in ISO 20022: Batching, BatchBooking, and What Arrives

How pain.001 batching works: the three-level structure, BatchBooking, how a batch becomes entries on a statement, and what happens when one payment in a file fails.

The ISO 20022 Agent Chain: Who Routes What, and Which Agent Field to Trust

DbtrAgt, CdtrAgt, IntrmyAgt1, InstgAgt, InstdAgt: the agent fields in a pacs.008, what each one means at each hop, and which ones change in transit.

Cover Payments in ISO 20022: pacs.009 COV, Serial vs Cover, and the Trap

How the cover method works: pacs.008 to the beneficiary bank, pacs.009 COV to the correspondents, and why the two must carry identical underlying details.

ISO 20022 Purpose Codes: Purp, CtgyPurp, and What They Drive Downstream

Purpose code vs category purpose in ISO 20022: who reads each, the codes that change routing and treatment, and why a wrong SALA costs a payroll run.

ISO 20022 Remittance Information: Structured, Unstructured, and RF References

How remittance information works in ISO 20022: the 140-character unstructured field, the structured block, ISO 11649 RF references, and remittance location.

Sanctions Screening on ISO 20022: What Structured Data Changed

Which ISO 20022 fields sanctions screening reads, why structured addresses cut false positives, and the screening defects an analyst finds in every migration.

MCP for Analysts: Connecting AI to Jira and Confluence, Read-Only First

What the Model Context Protocol is, how to connect an assistant to Jira and Confluence safely, and the six read-only questions that pay for the setup in a week.

Which Payment Rail? Choosing Between Instant, RTGS, SEPA, and Correspondent

The decision an analyst actually has to make: which payment rail fits a flow, judged on speed, finality, cost, reach, data, and what happens when it fails.

RTGS on ISO 20022: T2, CHAPS, and Fedwire Compared

What changes when high-value payments settle in central bank money: T2's liquidity model, CHAPS enhanced data, Fedwire's cutover, and the analyst implications.

SEPA Credit Transfer: The Rulebook Layer Above ISO 20022

How the SEPA Credit Transfer scheme constrains ISO 20022: SLEV charges, IBAN-only, the 140-character limit, the Latin character set, and the return flows.

SEPA Instant: The Ten Second Rule and What It Breaks

How SCT Inst changes payment design: a ten second end-to-end limit, 24/7/365 availability, irrevocability, and the screening and liquidity problems that follow.

Verification of Payee: The Check That Runs Before the Payment

How Verification of Payee works: the name and IBAN check, the four possible outcomes, what the payer sees, and the design decisions that make or break it.

API Design Review: The Analyst's Checklist Before the Contract Is Frozen

How analysts review an API design before build: domain naming, state changes, money and dates, error model, pagination, idempotency, and a worked review.

API Glossary for Analysts: The Terms You Hear in Every Integration Meeting

A plain-language API glossary for analysts: endpoint, payload, headers, tokens, idempotency, webhooks, pagination, and more, each with a real-world example.

API Proof of Concept: How Analysts Build POCs and Demos That Settle Decisions

How an analyst builds an API proof of concept: the decision it must settle, a two-day spike, mocks from OpenAPI, webhook proof, a scripted demo, and evidence.

API Security Testing for Analysts: The OWASP API Top 10 as Test Cases

The OWASP API Security Top 10 (2023) as test cases analysts can run in Bruno or Postman: object and field authorization, auth, limits, business flows, and more.

API Versioning and Breaking Changes: How Analysts Assess Impact Before a Release

What counts as a breaking API change, versioning strategies, Deprecation and Sunset headers, detecting breaks with oasdiff, and consumer impact assessment.

Your First API Collection in Bruno and Postman: Requests, Environments, and Variables

Build a first API collection in Bruno and Postman: environments, variable precedence, inherited auth, secrets in .env or a vault, and requests imported from cURL.

GraphQL for Analysts: How to Read, Query, and Test a GraphQL API

GraphQL for analysts: queries, variables, mutations, errors returned with HTTP 200, cursor pagination, and hands-on testing of the GitHub GraphQL API in Bruno.

How to Analyze an API: The Analyst's Method Before Anyone Writes Integration Code

A method for analyzing an API before integration: capability mapping, field-level data mapping, failure behavior, limits, versioning, and a fit-gap worksheet.

How to Document an API: What Analysts Write So Developers Integrate Without a Call

How to document an API as an analyst: the seven sections consumers need, an OpenAPI endpoint example, an error catalogue, flow guides, and docs you can test.

Webhooks Explained for Analysts: How to Specify, Test, and Debug Them

How webhooks work and what analysts must specify: events, signatures, retries, duplicates, and ordering, plus testing with webhook.site and the Stripe CLI.

What Is an API? How APIs Actually Work, Explained for Analysts

What an API is and how one works, for analysts: request and response, methods, headers, auth, status codes, and a real GitHub API call you can send today.

AI Agents for Analysts: When an Agent Beats a Prompt

When an AI agent beats a single prompt for analyst work, what tools it needs, where the guardrails go, and the three agent flows worth building first.

Automating the Analyst Workflow: What to Script First

Which analyst tasks to automate first, ranked by payback: environment checks, test data setup, reconciliation, contract validation, ticket evidence.

The Analyst's Second Brain: Notes That Answer Questions Months Later

How to build a second brain as a technical analyst: a plain-Markdown knowledge base, organized by system and decision, that answers questions months later.

The Go/No-Go Call: Making a Release Decision Defensible

A go decision is made under uncertainty. The analyst's job is to make it explicit, not make it disappear. The readiness dimensions and the evidence.

API Keys, PATs, and OAuth Tokens: The Analyst's Guide to Credentials

The difference between an API key, a personal access token, and an OAuth token, how to scope and rotate them, and where they belong across an analyst toolchain.

Bruno vs Postman for Analysts: Git-Native Collections vs the Full Platform

Bruno stores API collections as plain files in your repo; Postman stores them in a cloud workspace. The trade-offs, with a pacs.008 test suite in both.

The ISO 20022 Truncation Ledger: What Rich Data Actually Loses in Transit

ISO 20022 carries rich structured data, and every non-native hop quietly degrades it. The field-by-field loss ledger, and how to specify what you accept losing.

The ISO 20022 Blast Radius: The Systems Nobody Scoped

Migration programmes scope the payment rail and forget everything reading it: screening, monitoring, the warehouse, reports. The downstream impact register.

Which ISO 20022 Identifier Do You Trace On? MsgId, InstrId, EndToEndId, TxId, and UETR

Five identifiers travel with every payment and only one survives the whole chain. Which to trace on, reconcile on, deduplicate on, and never use as a key.

Reading an ISO 20022 Usage Guideline: The Four Layers That Decide Your Field Rules

A field can be optional in ISO 20022, mandatory in CBPR+, forbidden by your correspondent, and absent from your database. How to build the net rule matrix.

The ISO 20022 XML Traps: Why a Schema-Valid Message Still Gets Rejected

Namespaces, element order, the business header, empty vs absent, amount precision, and code choices. The XML layer that fails messages your test tool accepts.

Non-Functional Requirements: The Categories, With Measurable Examples

What non-functional requirements are, the categories that matter, and how to write NFRs that are testable: measurable targets instead of adjectives. With examples.

Slowly Changing Dimensions: Type 1 vs Type 2, and When History Matters

What slowly changing dimensions are, how SCD Type 1 and Type 2 differ, how a Type 2 table works with valid_from and valid_to, and how to query it correctly.

ISO 20022 Payment Status Codes: What ACSP, ACCP, and RJCT Really Mean

The ISO 20022 payment transaction statuses explained: RCVD, ACTC, ACCP, ACSP, ACSC, PDNG, RJCT, and more, with the lifecycle order and what each guarantees.

ISO 20022 Structured Addresses: The November 2026 Deadline, Explained

CBPR+ ends fully unstructured addresses in November 2026. What structured and hybrid addresses are, the elements that matter, and how to migrate without rejections.

MT to ISO 20022: The Message Mapping Every Payments Analyst Needs

Which ISO 20022 message replaces each SWIFT MT: MT103 to pacs.008, MT202 to pacs.009, MT940 to camt.053, and the traps in the mapping. A reference table.

Payment Returns, Reversals, and Recalls: pacs.004, pacs.007, and camt.056

When money must come back, ISO 20022 gives three distinct mechanisms: returns, reversals, and recalls. Who initiates each, which message carries it, and how to model them.

Airflow vs Dagster: Orchestrating Tasks vs Orchestrating Assets

Airflow schedules tasks; Dagster declares the data assets those tasks produce. What the task vs asset split means for lineage, testing, and debugging pipelines.

Data Engineer vs Analytics Engineer: Who Does What in the Data Team

Data engineers build the pipelines and platforms that move data; analytics engineers model it in the warehouse so it means something. The split, explained.

Data Lineage: Trace Every Number Back to Its Source

Data lineage maps how each field flows from source through transformations to the report that shows it, enabling impact analysis, trust, and audit. With a diagram.

What Is a Data Mesh? Domain Ownership of Data, Explained

A data mesh decentralizes data: domains own and publish their data as products, on a self-serve platform, under federated governance. Explained with a diagram.

Reading a dbt DAG: The Map of How Your Data Is Built

A dbt DAG is the dependency graph of your transformations, built from ref() calls. How to read one, the staging to marts convention, and why tests live on nodes.

dbt vs SQLMesh: Two Ways to Build the Same Warehouse

dbt and SQLMesh both turn SQL into tested, versioned transformation pipelines. Where they differ: SQL parsing, environments, incremental state, and lineage.

Developer Analyst vs Backend Developer: Same Tools, Different Accountability

Both write code against the same systems. The backend developer owns the production system; the developer analyst uses code to verify and automate analysis.

Fivetran vs Airbyte: Managed Connectors vs Open-Source Control

Fivetran and Airbyte both move source data into your warehouse. They differ on openness, hosting, pricing, and who fixes the connector when the API changes.

Kimball vs Inmon: Bottom-Up Marts vs the Top-Down Warehouse

Kimball builds dimensional marts first and integrates through conformed dimensions; Inmon builds a normalized enterprise warehouse first. The classic debate, mapped.

Lakehouse vs Data Warehouse: Open Tables on a Lake vs the Managed Database

A warehouse is a managed analytical database; a lakehouse adds warehouse guarantees to open files on object storage. The real differences, with a diagram.

Looker vs Tableau: Governed Metrics vs Visual Exploration

Looker is a code-defined semantic layer that governs metrics; Tableau is the strongest visual exploration tool. What each optimizes for and when each fits.

Medallion Architecture: Bronze, Silver, and Gold, Explained

The medallion architecture organizes a lakehouse into bronze (raw), silver (cleaned), and gold (business-ready) layers. What each layer owns, with a diagram.

Medallion Architecture vs Data Vault: Layers vs a Modeling Method

Medallion and Data Vault answer different questions: medallion says how many quality layers, Data Vault says how to model history inside them. With diagrams.

Snowflake vs BigQuery: The Warehouse You Size vs the One You Don't

Snowflake and BigQuery are both elastic cloud warehouses. They differ on compute models, pricing units, cloud lock-in, and the knobs your team must operate.

Star Schema vs Snowflake Schema: Which Shape Fits Your Warehouse

Star and snowflake schemas differ in one thing: whether dimensions are denormalized. What each looks like, when each fits, and how to read one. With diagrams.

Systems Analyst vs Solutions Architect: Mapping the System vs Owning the Design

A systems analyst maps how systems connect and behave; a solutions architect decides how they should, and answers for it. The line, the overlap, and the jump.

The Technical Analyst Skill Matrix: 25 Skills, Five Hats, Three Levels

A self-assessment matrix of 25 skills across the five technical analyst hats, with three levels per skill and where to build each one. Original to this site.

Technical BA vs Software Engineer: Code as a Tool vs Code as the Product

Both are technical; the deliverables differ. A technical BA ships verified understanding and specs; an engineer ships production code. Which seat fits you.

Batch vs Event-Driven: Why Timing Shapes Everything

Batch and event-driven processing differ in timing, and that difference shapes latency, failure modes, and customer experience. When to use each, with banking examples.

Contract Testing: Catch Breaking Changes Before They Ship

What contract testing is, how it differs from integration testing, and how consumer-driven contracts catch breaking API and event changes before they reach production.

Dead-Letter Queues: Where Failed Messages Go

What a dead-letter queue is, why event-driven systems need one, and how an analyst specifies DLQ behavior: retries, routing, monitoring, and recovery. With examples.

Event-Driven Requirements: Specifying Systems That Talk in Events

How to write requirements for event-driven systems: event schemas, ordering, idempotency, retries, and consistency. A practitioner guide with a Kafka example.

Fit-Gap Analysis: What the System Does vs What the Business Needs

How to run a fit-gap analysis: compare requirements against system capability, classify each as fit, gap, or partial, and turn gaps into decisions. With a payments example.

How a Technical BA Investigates a Failed Payment

A walkthrough of how a technical business analyst actually investigates a failed payment: the questions, the tools, and following one transaction from the complaint to the cause.

Idempotency Testing: Proving Duplicate Requests Are Safe

How to test idempotency in APIs and event consumers: idempotency keys, duplicate requests, redelivered events, and the race conditions that cause double processing.

Integration Patterns Every Systems Analyst Should Know

The integration patterns that wire systems together: request-response, messaging, publish-subscribe, request-reply, batch file transfer, and webhooks. With payments examples.

ISO 20022 Architecture: The Data Model Behind Modern Payments

What ISO 20022 actually is as an architecture: the business model, message definitions, structured data, and usage guidelines that shape modern payment systems.

How to Test Kafka: Validating Events You Cannot See

A practitioner guide to testing Kafka: consuming events in a test, asserting schema and key, verifying ordering, duplicates, and the consumer side effects that matter.

How to Write pacs.008 Test Cases for an ISO 20022 Migration

A field-by-field guide to writing pacs.008 test cases: mandatory fields, structured data, validation, reason codes, and the pacs.002 responses that prove each case.

Payment Message Flows: pain, pacs, and camt End to End

How payment messages flow end to end in ISO 20022: pain.001 initiation, pacs.008 interbank, pacs.002 and pain.002 status, and camt reporting. A systems analyst map.

Payment Testing: How to Test a Payment Flow End to End

A practitioner guide to payment testing: following one transaction through ingestion, events, settlement, and status, plus the rejection and stuck-payment cases that matter.

The Production Support Skills Nobody Teaches Analysts

The production support skills that make a technical analyst invaluable: triage, tracing transactions, reading logs, calm under pressure, and turning incidents into requirements.

What I Learned Reading Logs During a Major Incident

Field notes from a major payments incident: how reading logs under pressure works, what the trail revealed, and the lessons about observability that became requirements.

Reading Production Logs: Trace One Transaction's Trail

How an analyst reads production logs to understand and debug a system: correlation ids, log levels, searching by transaction, and following one request across services.

Reconciliation Design: Proving Two Systems Agree

How to design reconciliation between systems: matching keys, break detection, tolerance, timing, and exception handling. The control that proves the money is right.

Regression Testing in Payments: Protecting What Already Works

How to do regression testing in payment systems: what to retest, building a regression suite, risk-based selection, and automating the checks that protect live behavior.

Scripting Checks in Python: Automate What You Repeat

How an analyst uses Python to automate repetitive checks: calling APIs, comparing files, querying data, and chaining requests. Small scripts, large leverage.

Sequence Diagrams for Business Analysts: Draw the Flow, Find the Gaps

How business analysts use sequence diagrams to map a flow across services, expose integration gaps, and write better requirements. With a payments example.

State Machines for Payments: Every Status, Every Transition

How to model a payment as a state machine: define the states, the allowed transitions, the triggers, and the illegal moves. The tool that makes status behavior precise.

Synchronous vs Asynchronous: The Choice That Defines a System

Synchronous and asynchronous communication differ in whether the caller waits, and that choice shapes coupling, latency, resilience, and the customer experience.

System Context Diagrams: Draw the Boundary Before the Internals

What a system context diagram is, how to draw one, and why starting at the boundary stops you scoping the wrong thing. With a payments example and the C4 model.

What Is a Developer Analyst? The Analyst Who Ships Code

A developer analyst reads and writes enough code to verify, automate, and prototype, without becoming a full-time engineer. Here is what the role does in payments.

What Is a Systems Analyst? Designing How Systems Talk to Each Other

A systems analyst maps how services, messages, and data flow across a system so the pieces work as a whole. Here is what the role does in banking and payments.

What Is a Technical Business Analyst? The Five-Hat Discipline, Explained

A technical business analyst analyzes, codes, tests, and supports. Here is what the role actually does day to day in banking and payments, and how to become one.

PAIN vs pacs in ISO 20022: The Difference Every Payments Analyst Should Know

PAIN vs pacs explained: why pain.001 is not pacs.008, how pain.002 and pacs.002 mirror it, where camt fits, and how ISO 20022 splits customer and bank.

You Don't Understand the System Until You Test It

Why testing a payment flow end to end teaches you the system and the UX better than any diagram: microservices, Kafka, the database, logs, and pain.002.

Free account

Practice on the Labs, keep your progress

A free account, no password: an email link signs you in. It saves your steps and self-assessments on the Labs, shows your missions on a dashboard, unlocks the solutions, and, if you tick the box, sends you new missions and articles when they ship.

Your email is used to sign you in. Nothing else, unless you ask. Privacy.