Nguyen Le PhongNguyen Le Phong

seriesNames.lean-business-analysis第 3 篇,共 4 篇

Requirements Modeling: How BA Turns Messy Conversations into Shared Pictures

A calm, practical guide to requirements modeling: scope, process, rule, data, and interface models, with examples of how diagrams and structured descriptions help teams reason together before building.

The whiteboard looked messy by lunchtime: arrows, boxes, crossed-out steps, and one lonely question mark beside "approval exception." But the room was quieter than it had been in the morning. People had stopped arguing from memory and started pointing to the same picture.

That is the quiet value of requirements modeling. A model does not have to be beautiful. It has to make a conversation easier to correct.

Source note: This series is based on a local Markdown guide about Lean Business Analysis, which synthesizes ideas from Emrah Yayici, PMI, and Business Analysis For Dummies. I am treating it as working material, not as a replacement for the original books.

Models Are Thinking Tools

Requirements often begin as sentences. Sentences are flexible, which is useful early, but they can also hide gaps. A stakeholder says "the system should notify the manager," and five people imagine five different triggers, channels, timing rules, and escalation paths.

A model turns part of that sentence into a shared structure. It may be a context diagram, process flow, decision table, data dictionary, use case, user story map, wireframe, or state diagram. The purpose is not to impress anyone with notation. The purpose is to expose ambiguity while it is still cheap.

The source material groups requirements models into five practical families: scope, process, rule, data, and interface models. That classification is useful because it reminds a BA that one diagram rarely explains everything.

Model familyQuestion it answersCommon examples
ScopeWhat is inside, outside, and connected?Context diagram, ecosystem map, feature model, use case diagram
ProcessHow does work flow across people and systems?Swimlane, process flow, use case description, user story map
RuleWhat logic decides what happens?Business rules catalog, decision table, decision tree
DataWhat information exists, moves, or changes state?ERD, DFD, data dictionary, state diagram
InterfaceHow do users or systems interact at the surface?Wireframe, report table, UI flow, display-action-response model

Scope Models Set the Edge

Scope problems are some of the most painful because they often look like commitment problems. A team thinks it agreed to "customer onboarding," then later discovers that sales, KYC, billing, support, analytics, and compliance all assumed their own version of onboarding was included.

A context diagram helps by placing the solution in the middle and drawing its external actors, systems, and data flows. An ecosystem map broadens the view to include partners, departments, regulators, channels, and other products. A business objectives model links the work back to outcomes. A feature model shows the major capability groups. A use case diagram can show who interacts with which function.

Imagine a lending product. A feature called "application review" may sound small until the context diagram shows applicant portal, credit bureau, fraud service, document storage, underwriting team, notification service, audit log, and CRM. The diagram does not solve the project, but it makes scope real enough to discuss.

Process Models Reveal Handoffs

Process models are especially useful when delay, rework, or unclear ownership is part of the problem. A swimlane diagram can show that a refund request moves from customer support to finance, then back to support, then to a manager, then to the payment gateway. Each lane shows who owns a step. Each arrow shows a handoff that can break.

For a refund flow, the process model may expose that agents cannot tell whether a refund is within policy until after they create a ticket. That creates unnecessary escalations. A better requirement may be "show policy eligibility before ticket submission," not merely "add refund status to the ticket screen."

User stories are also process models when used well. A story like "As a support agent, I want to see refund eligibility before submitting a ticket so that I can resolve simple cases without escalation" keeps the user, capability, and outcome connected. The INVEST reminder helps: independent, negotiable, valuable, estimable, small, and testable. But the acronym is not magic. The story still needs examples.

Rule Models Catch Hidden Logic

Business rules often hide inside phrases like "eligible customer," "high risk," "manager approval," or "standard discount." A rule model makes that logic explicit.

A decision table is useful when several conditions combine. For example:

Customer tierRefund ageAmountDecision
GoldUnder 30 daysUnder 100 dollarsAuto approve
GoldUnder 30 days100 dollars or moreManager review
StandardUnder 14 daysUnder 50 dollarsAuto approve
AnyBeyond policy windowAnyDeny or exception review

Once the table is visible, stakeholders can challenge it. Is Gold tier really enough for auto approval? What about fraud flags? What about partial refunds? These questions are easier to ask before the logic is buried in code.

Data Models Keep Words Honest

Many requirement disputes are actually data disputes. A "customer" may mean account holder to billing, active user to product, legal entity to compliance, and contact person to sales. A data dictionary can save days of confusion by defining terms, formats, owners, allowed values, and relationships.

Data flow diagrams help when information crosses boundaries. Entity relationship diagrams help when structure matters. State diagrams help when an object changes over time: application draft, submitted, under review, approved, rejected, expired, withdrawn. The value is not academic precision. The value is reducing mismatched assumptions.

For example, if an application can be "approved" but still missing bank details, the state model should name that clearly. Otherwise support will promise one thing, operations will expect another, and engineering will encode a state that nobody owns.

Interface Models Protect the Last Meter

Interface models connect requirements to the place where people actually act. Wireframes, report tables, UI flows, and display-action-response descriptions help the team reason about what users see, what actions are available, and what feedback the system gives.

A report table can be more useful than a polished mockup when the question is data meaning: column name, source, calculation rule, filter behavior, refresh cadence, and owner. A low-fidelity wireframe is better when layout and user decision flow matter. A UI flow is better when the risk is navigation across states.

How Much Modeling Is Enough?

Enough modeling means the team can make the next decision with fewer hidden assumptions. If a single story and three examples are enough, do that. If a rule table avoids weeks of rework, do that. If a formal ERD is necessary because five systems depend on the same entity, do that.

The healthy BA habit is not "always draw diagrams." It is: when words start wobbling, make the idea visible.

你觉得这篇文章如何?

常见问题

What is requirements modeling?
Requirements modeling is the use of structured visuals or descriptions to clarify scope, process, rules, data, interfaces, and behavior before or during solution development.
What are the main types of requirements models?
A practical grouping is scope models, process models, rule models, data models, and interface models.
Why are models useful in Business Analysis?
Models make assumptions visible, expose gaps, help stakeholders reason from the same picture, and give delivery teams clearer inputs than prose alone.
Do teams need formal modeling notation?
Only when it helps the audience and decision. Many teams get value from simple diagrams, tables, examples, and lightweight prototypes if those artifacts clarify the work.