PlantUML中的多场景变体管理实战指南

在复杂系统开发中，同一个业务用例往往存在多种实现变体，这些变体可能对应不同平台、环境或业务规则。本文将详细介绍如何使用PlantUML高效管理用例变体。

一、变体管理基础概念

变体管理是指对同一功能点的不同实现版本进行可视化区分和对比分析的技术。在PlantUML中，我们可以通过以下方式实现：

@startuml
left to right direction

rectangle "支付系统" {
  (基础支付流程) as base
  (微信支付) as wx <<variant>> 
  (支付宝支付) as ali <<variant>>
  (银联支付) as unionpay <<variant>>
  
  base <|-- wx
  base <|-- ali
  base <|-- unionpay
}

note right of base 
  基础流程包含:
  1.金额验证
  2.订单关联
end note

note bottom of wx
  特有步骤:
  - 微信授权
  - 小程序支付
end note
@enduml

二、变体标注技术详解

1. 着色区分法

使用颜色直观展示不同变体：

@startuml
skinparam usecase {
  BackgroundColor<<Variant1>> LightGreen
  BackgroundColor<<Variant2>> Gold
}

(核心功能) as core
(移动端实现) as mobile <<Variant1>>
(PC端实现) as pc <<Variant2>>

core <|-- mobile
core <|-- pc
@enduml

2. 条件分支表达

展示环境特定的分支逻辑：

@startuml
start
if (环境类型?) then (生产环境)
  :生产环境校验流程;
  :加密通信;
else (测试环境)
  :模拟数据注入;
  :跳过安全验证;
endif
:公共处理步骤;
@enduml

3. 版本对比标注

使用表格形式对比差异：

@startuml
skinparam componentStyle uml2

component "订单服务" {
  [v1.0\n基础创建] as v1
  [v2.0\n支持预售] as v2
  [v3.0\n多仓拆单] as v3
  
  note top of v1
    | 特性 | v1.0 | v2.0 | v3.0 |
    | 预售 | ❌ | ✅ | ✅ |
    | 拆单 | ❌ | ❌ | ✅ |
  end note
}
@enduml

三、高级变体管理技巧

1. 多维度变体组合

处理平台+地域的组合变体：

@startuml
skinparam usecase {
  BackgroundColor<<CN>> #FFEEAA
  BackgroundColor<<US>> #AAEEFF
  BorderColor<<Mobile>> Green
  BorderColor<<Web>> Blue
}

(支付验证) as base
(中国区移动端) as cn_mob <<CN>> <<Mobile>>
(美国区Web端) as us_web <<US>> <<Web>>

base <|-- cn_mob
base <|-- us_web

legend right
  | 颜色 | 维度 |
  | <color:#FFEEAA>中国区 | 地域 |
  | <color:#AAEEFF>美国区 | 地域 |
  | <color:Green>移动端 | 平台 |
  | <color:Blue>Web端 | 平台 |
endlegend
@enduml

2. 废弃变体标记

使用特殊样式标记废弃版本：

@startuml
skinparam usecase {
  BackgroundColor<<Deprecated>> #CCCCCC
  FontColor<<Deprecated>> #999999
  FontStyle<<Deprecated>> strike
}

(旧版登录) as old <<Deprecated>>
(新版OAuth登录) as new

note left of old : 2024年Q1弃用
@enduml

四、实践建议

版本控制集成：将变体图与Git分支关联，保持图表与代码同步
分层展示：先展示核心流程，再通过点击展开变体细节
自动化检测：使用脚本检查变体间的冲突条件
文档生成：结合PlantUML生成变体对比文档

五、典型应用场景

1. 多租户系统变体

@startuml
skinparam usecase {
  BackgroundColor<<TenantA>> #F5A9A9
  BackgroundColor<<TenantB>> #A9BCF5
}

(报表导出) as base
(租户A定制报表) as ta <<TenantA>>
(租户B精简报表) as tb <<TenantB>>

base <|-- ta
base <|-- tb

note right of ta
  特有字段:
  - 销售渠道
  - 促销标签
end note
@enduml

2. 国际化多语言变体

@startuml
skinparam usecase {
  BackgroundColor<<EN>> #D5A6BD
  BackgroundColor<<JA>> #A6D5BD
}

(错误提示) as error
(英文提示) as en <<EN>>
(日文提示) as ja <<JA>>

error <|-- en
error <|-- ja
@enduml

通过以上技术，可以清晰表达系统不同变体间的共性和特性，帮助团队在复杂需求中保持清晰的架构视野。建议将变体图作为架构决策记录(ADR)的组成部分，确保技术决策的可追溯性。

PlantUML用例变体管理实战：多场景可视化技巧