编码规范 · Vibe-Trading Wiki

所有写操作通过类方法上的 _synchronized 装饰器加 threading.RLock 串行化，确保内存与 SQLite 后端并发安全。
领域实体一律用 @dataclass(frozen=True) 定义，变更通过 dataclasses.replace 生成新实例而非原地修改。
时间戳统一由模块内 _now_iso() 返回 UTC ISO-8601 字符串，避免在业务逻辑中直接调用 datetime.now()。
复杂对象（theme、columns_required 等 tuple/list 字段）在 SQLite 中以 JSON 字符串序列化，读写分别通过 _json_dumps/_json_loads 转换。
验证状态机通过 validate_validation_status_transition 在 register_artifact 与 update_artifact 两处强制校验，禁止从未验证态直接跳到 APPROVED。
查询结果统一按 created_at DESC 排序并以 limit 截断，列表/SQL 两种后端保持一致的 newest-first 语义。