Skip to content

Business Scenarios Analysis Process

This skill guides the complete business scenarios analysis process, including user scenarios and system integration scenarios.

When to Use

  • Analyzing user scenarios and user stories
  • Designing system integration scenarios
  • Creating scenario documentation
  • Planning system integrations
  • Defining user experience requirements

Process Overview

Phase 1: User Scenarios Analysis

Step 1: Identify User Roles (0.5 day)

Input: User persona documents, business requirements documents

Tasks:

  1. Identify all user roles in the system
  2. Define role characteristics and responsibilities
  3. Determine role permission scopes

Role Categories:

  • System Administrator: System-level management permissions
  • Department Administrator: Department-level management permissions
  • Normal User: Basic operation permissions
  • Special Roles: Auditor, guest, etc.

Checklist:

  • [ ] All user roles identified?
  • [ ] Each role's responsibilities clear?
  • [ ] Role permission scopes defined?
  • [ ] Relationships between roles clear?

Output: User roles list

Example:

markdown
## User Roles List

### System Administrator
- **Description**: Highest privilege system manager
- **Responsibilities**: System configuration, user management, permission assignment
- **Scope**: All data and functions
- **Usage Frequency**: Daily

### Department Administrator
- **Description**: Department manager
- **Responsibilities**: Department personnel management, permission requests
- **Scope**: Department and sub-department data
- **Usage Frequency**: Daily

### Normal User
- **Description**: Regular system user
- **Responsibilities**: Daily work processing, personal information management
- **Scope**: Personal data
- **Usage Frequency**: Daily

Step 2: Identify User Scenarios (1 day)

Input: User roles list, core business process analysis

Tasks:

  1. Identify user scenarios based on business processes
  2. Organize scenarios by role
  3. Identify scenario trigger conditions and post-conditions

Scenario Categories:

  • First-time Use Scenarios: Registration, login, initialization
  • Daily Use Scenarios: Regular operations, data queries
  • Management Scenarios: Configuration, approval, monitoring
  • Exception Scenarios: Error handling, fault recovery

Checklist:

  • [ ] All business processes covered?
  • [ ] Each role has corresponding scenarios?
  • [ ] Scenario trigger conditions clear?
  • [ ] Scenario post-conditions clear?

Output: User scenarios list

Example:

markdown
## User Scenarios List

### System Administrator Scenarios
1. System Initialization Configuration
   - Trigger: First system deployment
   - Frequency: One-time
   
2. Daily User Management
   - Trigger: User lifecycle events
   - Frequency: Daily

### Normal User Scenarios
1. First Login
   - Trigger: First login after account creation
   - Frequency: One-time
   
2. Daily Workbench Usage
   - Trigger: Daily system login
   - Frequency: Daily

Step 3: Write Scenario Descriptions (1 day)

Input: User scenarios list

Tasks:

  1. Write scenario overview
  2. Define scenario participants
  3. Define pre-conditions
  4. Define post-conditions

Scenario Description Template:

markdown
#### Scenario X.X.X: [Scenario Name]

**Description**: [One sentence description]

**Participants**: [Main participants]

**Pre-conditions**:
- [Condition 1]
- [Condition 2]

**Steps**:
[Steps table]

**Post-conditions**:
- [Result 1]
- [Result 2]

**Business Rules**:
- [Rule 1]
- [Rule 2]

**Exception Handling**:
- [Exception 1]: [Handling method]
- [Exception 2]: [Handling method]

Checklist:

  • [ ] Scenario description clear?
  • [ ] Participants defined?
  • [ ] Pre-conditions complete?
  • [ ] Post-conditions complete?

Output: Scenario description document (draft)

Step 4: Define Scenario Steps (1-2 days)

Input: Scenario description document

Tasks:

  1. Detail scenario operation steps
  2. Define operator for each step
  3. Define system response for each step
  4. Define expected result for each step

Step Description Format:

StepOperationSystem ResponseExpected Result
1[User action][System behavior][Verification point]
2[User action][System behavior][Verification point]

Extension Scenarios:

  • Identify branch scenarios from main scenario
  • Define trigger conditions for extension scenarios
  • Write steps for extension scenarios

Checklist:

  • [ ] Steps complete?
  • [ ] Step sequence correct?
  • [ ] Each step verifiable?
  • [ ] Extension scenarios complete?

Output: Complete scenario steps description

Example:

markdown
| Step | Operation | System Response | Expected Result |
|------|-----------|-----------------|-----------------|
| 1 | Login with default account | Display admin console | Login successful |
| 2 | Change default password | Password change success prompt | Password updated |
| 3 | Enter system config module | Display config items list | Config page loaded |
| 4 | Configure system basic info | Save configuration | System info updated |

Step 5: Define Business Rules (0.5 day)

Input: Business rules documentation, scenario steps description

Tasks:

  1. Identify business rules involved in scenario
  2. Reference existing rules or define new ones
  3. Explain rule application in scenario

Checklist:

  • [ ] Correct rules referenced?
  • [ ] Rules match scenario?
  • [ ] Rule priorities clear?

Output: Scenario business rules list

Example:

markdown
**Business Rules**:
- BR-SYS-001: Must change default password on first login
- BR-SYS-002: System name required, 2-50 characters
- BR-SYS-003: Must create at least one department before creating users

Step 6: Identify Exception Handling (0.5 day)

Input: Scenario steps description

Tasks:

  1. Identify possible exceptions for each step
  2. Define exception handling strategies
  3. Define user prompt messages

Exception Categories:

  • Business Exceptions: Data validation failure, insufficient permissions
  • System Exceptions: Network errors, service unavailable
  • User Exceptions: Operation errors, illegal input

Checklist:

  • [ ] All exceptions identified?
  • [ ] Exception handling strategies clear?
  • [ ] User prompts friendly?

Output: Exception handling list

Example:

markdown
**Exception Handling**:
- Config save failure: Show error message, preserve current input
- Email test failure: Show error details, provide troubleshooting suggestions
- Department creation failure: Check department code uniqueness

Step 7: Scenario Review (1 day)

Input: User scenarios analysis document

Tasks:

  1. Organize review meeting
  2. Verify scenario completeness
  3. Confirm scenario priorities
  4. Modify scenario documents

Review Checklist:

  • [ ] Scenarios cover all functions?
  • [ ] Scenario steps clear?
  • [ ] Exception handling complete?
  • [ ] Business rules correct?
  • [ ] User experience good?

Output: Review records, updated scenario documents


Phase 2: System Integration Scenarios Analysis

Step 1: Identify Integration Systems (0.5 day)

Input: Existing system architecture documents, business requirements documents

Tasks:

  1. Identify internal systems to integrate
  2. Identify external services to integrate
  3. Determine integration priorities

Integration System Categories:

  • Internal Systems: HR system, ERP system, OA system, CRM system, Finance system
  • External Services: Email service, SMS service, File storage, Identity authentication

Checklist:

  • [ ] All integration systems identified?
  • [ ] Integration method clear for each system?
  • [ ] Integration priorities reasonable?

Output: Integration systems list

Example:

markdown
## Integration Systems List

| System Name | Type | Method | Priority |
|-------------|------|--------|----------|
| HR System | Internal | API + Message Queue | P0 |
| ERP System | Internal | API | P1 |
| OA System | Internal | API + SSO | P1 |
| Email Service | External | SMTP/IMAP | P0 |
| SMS Service | External | HTTP API | P1 |

Step 2: Identify Integration Scenarios (1 day)

Input: Integration systems list, core business process analysis

Tasks:

  1. Identify integration scenarios based on business processes
  2. Define scenario trigger conditions
  3. Define data flow direction

Integration Scenario Categories:

  • Data Sync Scenarios: Employee sync, department sync, master data sync
  • Authentication Integration Scenarios: Single sign-on, unified authentication
  • Business Process Integration Scenarios: Todo sync, approval integration
  • Notification Integration Scenarios: Email notification, SMS notification

Checklist:

  • [ ] All business processes covered?
  • [ ] Each integration scenario necessary?
  • [ ] Scenario trigger conditions clear?
  • [ ] Data flow direction clear?

Output: Integration scenarios list

Example:

markdown
## Integration Scenarios List

### HR System Integration
1. Employee Entry Sync
   - Trigger: HR entry approval passed
   - Data Flow: HR → System
   
2. Employee Resignation Sync
   - Trigger: HR resignation approval passed
   - Data Flow: HR → System

### OA System Integration
1. Single Sign-On (SSO)
   - Trigger: OA system redirect
   - Data Flow: OA ↔ System

Step 3: Design Integration Solution (1-2 days)

Input: Integration scenarios list

Tasks:

  1. Select integration technology solution
  2. Design interface specifications
  3. Define interaction flow

Integration Technology Options:

  • Synchronous Calls: REST API, SOAP
  • Asynchronous Messages: Message Queue (RabbitMQ, Kafka)
  • File Transfer: FTP, SFTP
  • Database Sync: CDC, ETL

Checklist:

  • [ ] Technology solution appropriate?
  • [ ] Interface specifications clear?
  • [ ] Interaction flow complete?
  • [ ] Performance requirements met?

Output: Integration solution design document

Example:

markdown
## Employee Entry Sync Solution

**Integration Method**: Message Queue (Async)

**Data Flow**:

HR System → Message Queue → System Platform → User Creation → Notification Send


**Scenario Steps**:
| Step | Actor | Action | Data |
|------|-------|--------|------|
| 1 | HR System | Entry approval passed | Employee info |
| 2 | HR System | Send entry event | EmployeeEntryEvent |
| 3 | System Platform | Consume entry event | Parse employee data |
| 4 | System Platform | Create user account | User info |
| 5 | System Platform | Send notification email | Account info |

Step 4: Define Data Mapping (0.5 day)

Input: Integration solution design document

Tasks:

  1. Define field mapping relationships
  2. Define data transformation rules
  3. Define data validation rules

Checklist:

  • [ ] Field mapping complete?
  • [ ] Transformation rules clear?
  • [ ] Validation rules defined?

Output: Data mapping table

Example:

markdown
## Data Mapping Table

| HR Field | System Field | Transformation Rule |
|----------|--------------|---------------------|
| employee_no | employee_no | Direct mapping |
| name | real_name | Direct mapping |
| email | email | Direct mapping |
| department_code | dept_id | Department code mapping |
| entry_date | entry_date | Date format conversion |

Step 5: Define Exception Handling (0.5 day)

Input: Integration solution design document

Tasks:

  1. Identify integration exception scenarios
  2. Define retry strategies
  3. Define fallback strategies
  4. Define compensation mechanisms

Exception Categories:

  • Network Exceptions: Timeout, disconnection
  • Service Exceptions: 500 errors, service unavailable
  • Data Exceptions: Format errors, missing data
  • Business Exceptions: Duplicate data, state conflicts

Checklist:

  • [ ] All exceptions identified?
  • [ ] Retry strategies reasonable?
  • [ ] Fallback strategies feasible?
  • [ ] Compensation mechanisms complete?

Output: Exception handling strategy document

Example:

markdown
## Exception Handling Strategy

| Exception Scenario | Handling Strategy | Compensation Mechanism |
|-------------------|-------------------|------------------------|
| Message consumption failure | Retry 3 times, 5 min interval | Dead letter queue, manual processing |
| Department mapping failure | Log error, assign default department | Admin manual adjustment |
| Email sending failure | Log only, no retry | Admin manual resend |

Step 6: Define Security Strategy (0.5 day)

Input: Integration solution design document

Tasks:

  1. Define transport security requirements
  2. Define authentication and authorization mechanisms
  3. Define data security measures

Security Requirements:

  • Transport Security: HTTPS, TLS
  • Authentication & Authorization: API Key, OAuth, JWT
  • Data Security: Encryption, masking, signature

Checklist:

  • [ ] Transport security adequate?
  • [ ] Authentication & authorization complete?
  • [ ] Data security sufficient?

Output: Security strategy document

Example:

markdown
## Security Strategy

### Transport Security
- All interfaces use HTTPS
- TLS 1.2+

### Authentication & Authorization
- API Key + Secret
- HMAC-SHA256 signature

### Data Security
- Sensitive data AES encryption
- Log data masking

Step 7: Scenario Review (1 day)

Input: System integration scenarios analysis document

Tasks:

  1. Organize review meeting
  2. Verify integration solution feasibility
  3. Confirm integration priorities
  4. Modify scenario documents

Review Checklist:

  • [ ] Integration solution feasible?
  • [ ] Data mapping correct?
  • [ ] Exception handling complete?
  • [ ] Security strategy adequate?
  • [ ] Performance requirements met?

Output: Review records, updated scenario documents


Quality Standards

User Scenarios Quality Standards

Check ItemStandardCheck Method
CompletenessCover all user roles and functionsChecklist
AccuracyScenario steps consistent with requirementsRequirements comparison
ClarityScenario descriptions clear and understandablePeer review
TestabilityEach scenario testableTest case review

Integration Scenarios Quality Standards

Check ItemStandardCheck Method
CompletenessCover all integration requirementsChecklist
FeasibilityTechnical solution implementableTechnical review
SecurityMeet security requirementsSecurity review
ReliabilityException handling completeFault drill

Document Templates

User Scenarios Analysis Document Template

markdown
# User Scenarios Analysis

> **Document ID**: SYS-DES-BA-XXX  
> **Version**: 1.0  
> **Created Date**: YYYY-MM-DD  
> **Author**: Architect  
> **Status**: Draft

---

## 1. Overview

### 1.1 Document Purpose
### 1.2 Input Documents
### 1.3 Scenario Categories

## 2. [Role] Scenarios

### 2.1 [Scenario Name]

**Description**:
**Participants**:
**Pre-conditions**:

**Steps**:
| Step | Operation | System Response | Expected Result |
|------|-----------|-----------------|-----------------|

**Post-conditions**:
**Business Rules**:
**Exception Handling**:

## 3. Scenario Priorities

## 4. Scenario to Function Mapping

## 5. Appendix

System Integration Scenarios Analysis Document Template

markdown
# System Integration Scenarios Analysis

> **Document ID**: SYS-DES-BA-XXX  
> **Version**: 1.0  
> **Created Date**: YYYY-MM-DD  
> **Author**: Architect  
> **Status**: Draft

---

## 1. Overview

### 1.1 Document Purpose
### 1.2 Input Documents
### 1.3 Integration Systems List

## 2. [System] Integration Scenarios

### 2.1 [Scenario Name]

**Description**:
**Integration Method**:
**Trigger Condition**:

**Data Flow**:
**Steps**:
| Step | Actor | Action | Data |
|------|-------|--------|------|

**Data Mapping**:
**Business Rules**:
**Exception Handling**:

## 3. Integration Exception Handling

## 4. Integration Security Requirements

## 5. Appendix

Best Practices

User Scenarios Best Practices

  1. User Perspective: Describe what users see and do, not system internals
  2. Keep It Simple: Each scenario focuses on one goal
  3. Use Concrete Data: Avoid vague descriptions, use specific values
  4. Consider Edge Cases: Consider both normal and exception flows
  5. Validate Feasibility: Confirm scenarios are implementable with technical team

Integration Scenarios Best Practices

  1. Clear Integration Boundaries: Clearly define system boundaries and responsibilities
  2. Design Idempotent Interfaces: Ensure repeated calls don't cause issues
  3. Consider Fallback: How system behaves when integration fails
  4. Monitor Integration: Establish integration monitoring and alerting
  5. Document Interfaces: Detailed interface specifications and examples

Common Pitfalls

User Scenarios Pitfalls

  1. Too Technical: Describe system implementation rather than user behavior
  2. Missing Exceptions: Only consider normal flow, ignore error handling
  3. Overly Complex: One scenario contains too many steps
  4. Lack Verification: No clear expected results
  5. Ignore UX: Focus only on functions, not experience

Integration Scenarios Pitfalls

  1. Underestimate Complexity: Integration more complex than expected
  2. Ignore Data Quality: Source system data quality issues
  3. Missing Timeout Handling: Long waits cause system blocking
  4. Insufficient Security: Transport and storage security
  5. Lack Monitoring: Can't及时发现 integration issues

Revision History

VersionDateAuthorChanges
1.02026-03-08ArchitectInitial version

Document Author: Architect
Document Reviewer: Technical Lead
Created Date: 2026-03-08

Released under the MIT License.