编码规范 · Vibe-Trading Wiki

所有页面通过 useTranslation 的 t 函数输出文案，键名遵循 <page>.<key> 命名空间（如 reports.*、scheduled.*、runtime.*）。
长列表/状态页使用 setInterval 轮询后端，并用 AbortController + 递增序列号（refreshSeq / requestSeqRef）保证只有最新请求能写入 state，避免旧响应覆盖新状态。
错误与空态通过条件渲染区分 loading skeleton、error banner、empty section 三种 UI，并在 catch 中将 ApiError 消息透传给用户。
状态展示统一封装为小型 StatusPill/SummaryTile 组件，通过 tone 属性（success/danger/warning/neutral）映射到 Tailwind 语义色类。
时间与时区处理集中在辅助函数中（如 formatRunDate、formatInZone、formatCountdown、normalizeEpochMs），对外部传入的 ISO/epoch 做容错解析后再格式化。
复杂业务逻辑（排序、风险推导、连接器状态机、限额摘要）拆分为纯函数（如 compareRuns、deriveRiskState、connectorState、summarizeLimits），便于测试与复用。