Demo:用 PlantUML 记录登录时序
PlantUML 适合把图和代码放在一起维护。短小的 sequence 源码可以说明认证、token 交换和失败处理。
- 参与方名称尽量和系统边界一致。
- 消息标签保持短,方便 review 和 wiki 阅读。
- 失败路径用 alt 块表达,不要只写在段落里。
@startuml
actor User
participant Web
participant Auth
database SessionDB
User -> Web: submit credentials
Web -> Auth: verify password
Auth -> SessionDB: create session
Auth --> Web: token
Web --> User: signed in
@enduml