从提示词到动态文档：掌握 Visual Paradigm 的 AI 驱动 C4 工作流

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml

title 系统上下文图 - 电商平台

Person(customer, "客户", "浏览和购买产品的购物者")
Person(admin, "管理员", "管理产品、订单和用户")

System(ecommerce, "电商平台", "处理产品目录、购物车、订单和支付的在线零售系统")

System_Ext(payment, "支付网关", "处理信用卡支付")
System_Ext(inventory, "库存系统", "管理库存水平和履行")
System_Ext(shipment, "物流服务", "处理订单配送和追踪")

Rel(customer, ecommerce, "浏览、搜索、购买产品")
Rel(admin, ecommerce, "管理产品、订单、用户")
Rel(ecommerce, payment, "通过 HTTPS 处理支付", "HTTPS")
Rel(ecommerce, inventory, "检查/更新库存", "API")
Rel(ecommerce, shipment, "请求发货", "API")

@enduml

@startuml
title 序列图 - 带双因素认证的用户登录

actor "用户" as user
participant "Web 浏览器" as browser
participant "认证服务" as auth
participant "短信网关" as sms
database "用户数据库" as db

user -> browser: 输入凭据
activate browser
browser -> auth: 认证 (用户名，密码)
activate auth
auth -> db: 验证凭据
activate db
db --> auth: 有效
deactivate db

alt 2FA 已启用
    auth -> sms: 请求 OTP
    activate sms
    sms --> user: 发送 OTP
    deactivate sms
    user -> auth: 输入 OTP
    
    alt OTP 有效
        auth --> browser: 成功 + 令牌
        browser --> user: 重定向到仪表板
    else OTP 无效 (最多 3 次尝试)
        auth --> browser: 错误 (OTP 无效)
        browser --> user: 显示错误
        note right: 已实现重试循环
    end
else 2FA 已禁用
    auth --> browser: 成功 + 令牌
    browser --> user: 重定向到仪表板
end

deactivate auth
deactivate browser
@enduml

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml

title 容器图 - 仓库管理系统

Person(staff, "仓库员工", "拣货、打包和发货")
Person(manager, "仓库经理", "监督运营和分析")
Person(logistics, "物流团队", "管理入库/出库运输")

System_Boundary(wms, "仓库管理系统") {
    Container(webapp, "Web 应用程序", "React", "为仓库员工提供用户界面")
    Container(api, "REST API", "Spring Boot", "处理业务逻辑和编排")
    Container(storage, "存储优化服务", "Spring Boot", "管理物品放置和检索")
    Container(analytics, "分析服务", "Python", "生成报告和洞察")
    ContainerDb(db, "库存数据库", "PostgreSQL", "存储库存、订单和位置")
    ContainerDb(cache, "Redis 缓存", "Redis", "缓存频繁访问的数据")
}

System_Ext(erp, "ERP 系统", "管理财务和采购")
System_Ext(oms, "订单管理系统", "处理订单生命周期")

Rel(staff, webapp, "使用")
Rel(manager, webapp, "使用")
Rel(logistics, webapp, "使用")

Rel(webapp, api, "调用", "REST")
Rel(api, storage, "调用", "gRPC")
Rel(api, analytics, "调用", "REST")
Rel(api, db, "读取/写入", "JDBC")
Rel(api, cache, "读取/写入", "Redis 协议")

Rel(api, erp, "同步数据", "REST")
Rel(api, oms, "更新订单状态", "REST")

@enduml

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Component.puml

title 组件图 - 存储优化服务

Container_Boundary(storage, "存储优化服务") {
    Component(analysis, "存储分析引擎", "分析物品移动模式并优化放置")
    Component(size, "物品尺寸计算器", "计算物品尺寸和重量以进行放置")
    Component(frequency, "物品频率服务", "跟踪物品速度和受欢迎程度")
    Component(replenishment, "补货服务", "管理补货触发器和警报")
    
    ComponentDb(location, "位置数据库", "跟踪物品位置和存储容量")
}

System_Ext(api, "REST API (WMS)", "调用存储服务以进行操作")

Rel(api, analysis, "请求放置优化")
Rel(analysis, size, "使用")
Rel(analysis, frequency, "使用")
Rel(analysis, location, "读取/写入")
Rel(size, location, "更新")
Rel(frequency, location, "更新")
Rel(replenishment, location, "读取/写入")

@enduml

@startuml
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Deployment.puml

title 部署图 - 仓库管理系统

Deployment_Node(aws, "AWS 云") {
    Deployment_Node(vpc, "VPC") {
        Deployment_Node(public_subnet, "公共子网") {
            Deployment_Node(lb, "负载均衡器", "AWS ALB") {
                Container(webapp, "Web 应用程序", "托管在 S3 上的 React 应用")
            }
        }
        
        Deployment_Node(private_subnet, "私有子网") {
            Deployment_Node(backend_asg, "后端自动伸缩组") {
                Deployment_Node(backend_vm, "后端服务器虚拟机", "EC2 - t3.large") {
                    Container(api, "REST API", "Spring Boot 容器")
                    Container(storage, "存储优化", "Spring Boot 容器")
                }
            }
            
            Deployment_Node(db_subnet, "数据库子网") {
                Deployment_Node(db_cluster, "数据库集群", "RDS PostgreSQL - db.r5.large") {
                    ContainerDb(master, "主数据库")
                    ContainerDb(standby, "备用副本")
                }
                
                Deployment_Node(cache_cluster, "缓存集群", "ElastiCache Redis - cache.r5.large") {
                    ContainerDb(cache, "Redis 缓存")
                }
            }
        }
    }
}

Rel(webapp, lb, "提供服务")
Rel(lb, api, "路由", "HTTPS")
Rel(api, storage, "调用", "gRPC")
Rel(api, master, "读取/写入", "JDBC")
Rel(api, cache, "读取/写入", "Redis 协议")
Rel(master, standby, "复制")

@enduml

@startuml
title 优化后的用例图 - GourmetReserve 餐厅应用

left to right direction
actor "用餐者" as diner
actor "经理" as manager

rectangle "GourmetReserve 系统" {
    usecase "预订餐桌" as book
    usecase "预点餐" as preorder
    usecase "取消预订" as cancel
    usecase "管理预订" as manage
    
    usecase "用户认证" as auth
    usecase "处理支付" as payment
    usecase "应用折扣券" as discount
    usecase "处理候补名单" as waitlist
    
    ' 包含关系（强制性）
    book ..> auth : <<include>>
    preorder ..> auth : <<include>>
    cancel ..> auth : <<include>>
    manage ..> auth : <<include>>
    
    book ..> payment : <<include>>
    preorder ..> payment : <<include>>
    
    ' 扩展关系（可选/条件性）
    book <.. discount : <<extend>>n(输入促销码)
    book <.. waitlist : <<extend>>n(无可用餐桌)
}

diner --> book
diner --> preorder
diner --> cancel
manager --> manage

@enduml

!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Context.puml
Person(user, "用户", "描述")
System(system, "系统名称", "描述")
System_Ext(external, "外部系统", "描述")
Rel(user, system, "使用", "协议")

!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml
Container(container, "容器名称", "技术", "描述")
ContainerDb(db, "数据库", "PostgreSQL", "存储数据")

!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Component.puml
Component(component, "组件名称", "描述")

!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Deployment.puml
Deployment_Node(node, "节点名称", "技术")

actor "参与者名称" as actor
participant "参与者" as participant
actor -> participant: 消息
activate participant
participant --> actor: 返回
deactivate participant

actor "用户" as user
usecase "用例" as uc
user --> uc
uc ..> included : <<include>>
uc <.. extended : <<extend>>