"""纯领域逻辑：无 IO、无框架、可纯单测（架构文档 §3.2）。"""