rootandClaude Opus 5.5
b61335eaf6
- server 的 src/modules/*/__tests__ 挪到 test/<模块>/;e2e 去掉 eN- 前缀, w5a2 / v2 / search2 / *-dh1 / *-md1 / *-md2、web 的 agui3 / search2、domain 的 id2 / id3 改为按行为命名 - vitest 分三组:unit、pg(真实 PG + 假引擎,文件并行,最多 6 个)、serial(真实引擎 / worker / e2e,串行); pg 组用例超时放宽到 60s(迁移类用例并行时排队等 schema 锁)。server 测试 615s → 约 350s - CLAUDE.md 补测试约定;待办补 harness 去重与 continuous-series 偶发超时(疑似 Slot 评估竞争) - ADR-004 补充:维持 Deno,记录实际只用到 --allow-run 白名单 Co-Authored-By: Claude Opus 5.5 <[email protected]>
设计系统
控制台(apps/web)沿用 /opt/uhd_web 的设计系统:token 定义在 app.css,shadcn 组件在 apps/web/app/components/ui/,控制台共享件在 apps/web/app/components/console/。
| 文档 | 内容 |
|---|---|
| design-tokens.md | 颜色 token 分层、命名与使用规则,字号/圆角/时长/缓动阶梯 |
| interface-materials.md | 材质:pg-chrome 贴边、pg-slab 内容卡、pg-float 悬浮层 |
| ui-controls.md | 按钮、选中态、状态反馈、动效与圆角角色 |
硬规则
- 新增语义先加 token 再用。 需要新的颜色、字号、圆角、时长或缓动时,先在
app.css定义语义 token(日夜两套值都给),跑deno task gen:tokens,再在组件里引用。 - 禁止原色与十六进制。 组件里不写
#xxxxxx、text-[#..]、bg-red-500这类 Tailwind 调色板色、white/10之类的黑白透明度,也不写text-[13px]、duration-300、ease-[cubic..]、裸rounded。状态只用success/warning/destructive,并且配文字,不只靠颜色。 - 材质按层级只有三种,不在玻璃上叠玻璃:已在卡片里的空态用
<EmptyState plain>。 - 确需例外(第三方库的颜色参数等),在该行或上一行写
token-allow: 原因。
以上规则由 deno task check:tokens(apps/web/scripts/check-design-tokens.sh + 生成物校验)在 deno task ci 中守住。
控制台共享件
PageHeader:页面标题 + 一句说明 + 右侧操作区。EmptyState:空态/建设中占位;plain用于卡片内部。StatusBadge:success | warning | destructive | neutral四种语气,必须带文字。nav.ts:12 个工作区的导航表,标题与说明同时供占位页使用。