系统设计:统一所有语言
基底中性,数据赋予生命。结构(背景、菜单、边框)保持平静中性,而数据则拥有色彩、形状和动画:图表、进度、人员以及带有各自颜色的项目。一个没有图表、没有实体颜色、没有主角的屏幕会显得死气沉沉。在设计仪表盘之前,请查看“生命”部分并打开06、07、08和14。同一公司中的多个系统因为共享相同的标记(tokens)、字体、圆角、状态和组件而感觉像是一个家族。不同系统之间变化的是强调色以及中性的色调。
中性不意味着灰色。 基底可以带有品牌或每个系统用途所需的色调:
- 品牌色调: 背景带有强调色的轻微色调,例如非常淡的紫色或蓝色。
- 带有色调的背景: 带有色调的背景和深色、低饱和的品牌色菜单(如海军蓝)取代纯白色。
- 暖色调或冷色调 根据行业而定。
- 深色 用于监控。
规则在于饱和度和对比度,而非颜色:中性色具有非常低的色度(OKLCH C ≤ 0.02,或画布上约0.03),始终在整个系统中保持相同的色调。它们必须让状态和强调色成为唯一真正有颜色的东西。本文档中的十六进制灰色是起点,而非强制要求:每个系统使用其色调构建自己的中性色阶梯(参见 tokens.css)。
-
可直接粘贴的标记:
tokens.css。名称使用西班牙语(fondo,superficie,tinta,texto-2,acento,verde-fondo...)。 -
示例 位于
ejemplos/:tablero-crm.html:一个CRM的完整屏幕。componentes.html:所有组件的图库,包含亮色、深色和移动端视图。recetas-tailwind.md:React + Tailwind v4中的组件,可直接复制。
打开并覆盖使用它们。
-
参考截图:
referencias/01…14-*.jpg。在设计类似内容之前,打开相应的截图。 -
按主题的完整分析,包含值和示例:
analisis/01-estructura.md…analisis/15-homogeneidad.md。阅读与当前工作相关的主题。
如果此文件夹中存在 marcas.local.md,请先阅读它:其中包含了使用该技能的公司特有的强调色、色调和规则。该文件中的内容将优先于本文档中的示例值。
新屏幕的快速配方:
- 确定屏幕类型(仪表盘、列表、详情、日历、表单、移动端),并打开其参考和
ejemplos/中的示例。 - 定义系统的强调色和中性色调(
tokens.css)。 - 构建框架:侧边栏位于画布上,包含面包屑的面板。
- 编写页头:大而轻量的显示标题、带有真实数据的副标题、一个实心按钮。
- 3到6个KPIs的行:一个主角,其余放在带有内部卡片的托盘内,每个都带有图形。
- 主体:用于进行中项目的实体卡片、用于其余内容的表格或列表、以及一个上下文侧边面板。
- 赋予生命:按实体赋予颜色、头像、具有状态的图表以及加载动画。
- 设计空状态、加载状态和错误状态(第6b节)。
- 在390px宽度和深色模式下进行测试。
- 对照参考,逐一检查第8节的清单。
基本原则:零摩擦、每屏一个主操作、无填充文本、每个带列表的按钮在点击后都应定位到对应的行。
1. 应用框架(参考02, 03, 07, 13)
- 画布为
bg-fondo(#F4F4F5)。侧边栏直接位于画布上,宽度为240–256像素。 - 内容位于
bg-panel或bg-superficie面板中,具有rounded-[var(--radius-marco)]圆角,距边框和侧边栏各8px,并带有1px边框。 - 侧边栏:
- 顶部是标志或公司选择器。可选地,使用 ⌘K 搜索。
- 带有11px
texto-3标签的分组,大写字母和tracking-wider。 - 32–36px 高的项目,带有16px灰色图标和右侧的灰色计数。
- 活动项目为
bg-superficie(或bg-tinta text-white)药丸形状:永远不要使用品牌颜色。 - 底部是用户(头像、姓名和角色)。
- 面板顶部栏: 56px高,带有
border-b。左侧是面包屑(“部分 / 页面”,父级为灰色)。右侧是 ⌘K 搜索、通知和头像。 - 页面页头:
- 20–24px 标题,500–600字重,
tracking-tight。 - 下方是带有真实状态数据的灰色副标题:“12待开票 · 3已逾期”,永远不要使用通用描述。
- 操作在右侧,同一行。
- 20–24px 标题,500–600字重,
- 固定垂直顺序: 页头 → 筛选器和视图(分段控件)→ KPIs行 → 主体。
- 带上下文的主体:
grid-cols-[1fr_360px],左侧是列表或日历,右侧是详情面板(01, 02, 07)。 - 详情卡片: 3列
[1fr_1.6fr_1fr],包含数据、带计数标签的活动以及关联的公司(03)。
1b. 生命(让其不同于整洁的电子表格的部分)
查看06(Gr8r)、07(Loops)、08(Finora)和14(Solexa)。每个仪表盘至少应包含以下5个资源:
-
按实体赋予颜色。 每个项目、客户、人或服务都有其固定颜色,来自数据调色板,并通过ID分配。它出现在:
- 其图标或头像;
- 其进度条;
- 其迷你折线图;
- 表格中的线条。 这是最能赋予生命的部分(06:每个项目和每个人都有自己的颜色)。
-
每个数字都带有一个图形。 带有渐变区域的迷你折线图、刻度条(07:彩色细线直到百分比)、分段条(06:10个块中的1个)或进度环(09, 13, 14)。孤零零的数字是死的。
-
每屏一个主角。 一张充满色彩的卡片,带有强调色渐变、白色大数字和白色折线图并带有一个标记点(08“总支出”,09“完成一半”)。
-
实体卡片,而不仅仅是表格。 对于“进行中”的项目(项目、服务、大机会),使用像06那样的网格卡片:
- 优先级药丸和标签;
- 大标题和2行描述;
- 分段条,显示“3/6已完成 · 到期12月15日”;
- 活动迷你折线图;
- “后续步骤”带有复选框和“+ 添加”。
-
人物带脸。 照片或插图头像。如果没有,则使用彩色字母组合。为参与者叠放头像。团队以卡片形式显示,带有工作负载条(06“团队”)。
-
带状态的图表。 活动的条或点为实心,其余为阴影或淡化。深色工具提示显示“值 | 占比 | vs. 其他”(08)。当前月份以“MTD”格式阴影显示(07)。
-
带有氛围的背景。 面板顶部区域使用系统色调的非常柔和的渐变(08),或者页头横幅使用照片或插图(14),或者促销或计划卡片(06和14,线条插图)。
-
有目的的运动。 加载时,数字计数到其值(约600毫秒),条从0增长,线条绘制。悬停时,卡片上移1–2px,边框突出。成功时在原位显示toast。全部使用
ease-out并尊重prefers-reduced-motion。 -
带有内部卡片的托盘(“高级”外观)。 KPI不是一个扁平盒子:它是一个带有16px圆角和4px内边距的
bg-suave托盘,其中包含:- 顶部,托盘上的标签带图标和 ⋯(07);
- 内部,一个白色卡片,12px圆角,数字及其图形;
- 底部,托盘上的页脚带图标、上下文和增量(06)。 图标也采用相同模式:一个36–40px的白色正方形,带有最小边框和阴影,位于托盘上(08)。
-
留白。 慷慨的内边距(大卡片20–24)和间距16–20。数字28–40px。高级界面需要呼吸:如果看起来拥挤,先移除内容而不是缩小。
限制: 颜色存在于数据、实体和一个主角中。框架(菜单、背景、边框、文本)保持中性。
2. 排印(分析02)
- 两个声音,而非一个:
- 显示字体 用于标题、问候语和数字:一种有特色的几何或无衬线字体,如Outfit、General Sans、Satoshi或Plus Jakarta(08使用了这类字体)。
- 文本字体 用于界面:Plus Jakarta Sans、Manrope或Inter。
- 等宽字体 具有个性(JetBrains Mono、Geist Mono)用于代码(PR-0241, FAC-01101),并且在技术或监控仪表盘中,也用于数字(14)。
- 单独使用Geist或Inter会显得“基础”。
- 大而轻量的标题: 问候语或页面标题使用36–44px大小,400字重,
tracking-tight(06“晚上好,Alex”,08)。大的不需要加粗。 - 字号比例:11 / 12 / 13 / 14 / 16 / 20 / 24 / 32 / 40。一个卡片不混合超过3种字号。
- 字重:正文和标题使用400,卡片标题和操作使用500,数字使用500–600。不使用700。
- 数据 = 上方12–13px灰色标签 + 下方14px
tinta值。 永远不要在详情卡片内的同一行写“标签:值”。 - 数字使用
tabular-nums,金额右对齐。货币符号、分币和单位 使用texto-3,比主值小一个级别:$ 24.957,81。 - 元数据在一行中,12px灰色,以“ · ”连接:“催收 · FAC-01101 · 2分钟前”。
- 大写字母仅用于菜单分组标签。表格标题、按钮和标签页使用首字母小写。
3. 颜色(分析03)
-
有三个平面(
fondo→panel→superficie),深度由色调、1px边框和最小阴影产生(参见第4节)。 -
根据每个系统定制的中性色:
- 单一阶梯: 每个系统为其中性色选择色调(来自其品牌或用途),并在整个阶梯中使用:背景、面板、边框和三个文本层级。
- 低色度: 色调应被感知为“氛围”,而非颜色。如果背景与状态药丸竞争,则说明饱和度过高。
- 不混合: 永远不要在同一系统中混合冷和暖的阶梯。
- 可以超越灰色: 带有色调的背景或深色品牌菜单也是有效的。条件是内容仍处于明亮可读的表面,状态是唯一强烈的音符。
-
文本使用
tinta/texto-2/texto-3,它们是与色调相同的中性色。禁止使用#000在#FFF上。 -
每个系统只有一个强调色,仅用于主按钮、开关、焦点、未读点和移动端的活动标签页。永远不要用于标题、卡片背景或菜单。
-
按系统设置强调色: 每个系统或公司只有一个强调色(其品牌颜色)。如果没有既定品牌,使用石墨色
#18181B。技能的其余部分对所有系统都相同。 -
状态 = 药丸: 10%背景色 + 饱和文本色 + 6px圆点。永远不要使用饱和背景加白色文本,并且永远不要只用颜色:必须带有文字。
- 绿色:已完成、已收款、在线。
- 琥珀色:待定、部分完成、即将到期。
- 红色:已逾期、失败、离线。
- 蓝色:进行中、信息性。
- 灰色:草稿、已取消、已退款。
-
正常状态不上色。 红色仅用于需要立即操作的内容。如果屏幕上有超过3个红色元素,它们应分组为一个警告。
-
数据调色板(
dato-1…6,最多6个)仅存在于图表、进度条和类型图标中。在表格中,它显示为3px的线条,从不涂满整行。 -
预测、部分或未选择的内容以阴影或30%透明度显示;实际内容实心显示。例如,当前月份显示为“MTD”样子(07, 08)。
-
每屏最多一个充满颜色的英雄卡片(08, 09)。
-
完成前,统计颜色:灰色 + 1个强调色 + 最多4个状态色 + 最多6个数据色。
4. 表面、圆角和间距(分析04)
分层圆角。 内部的每一层圆角都略小于包含它的层(内部圆角 ≈ 外部圆角 − 内边距)。不要发明其他值:
| 元素 | 圆角 |
|---|---|
| 应用框架(整个系统在一个盒子中) | 26 |
| 主面板 | 20 |
| 卡片 / 托盘 / 工作表 | 20 |
| 托盘内部的卡片 | 16 |
| 按钮 / 输入框 / 搜索框 / 方形图标 | 11–12 |
| 小按钮 / 药丸 / 标签 | 7–9,或圆形用于筛选和“+12 %” |
在移动端,卡片圆角为20–24。
间距。 比例 4 / 8 / 12 / 16 / 20 / 24 / 32 / 40,不使用10、14或18。
- 内边距:卡片16–20(如果密集或在移动端则为12),面板26–28。
- 网格间距:14。
- 大块之间:28。
- 章节之间:32–40的间距加上一个标题。永远不要使用粗线或有色背景。
边框和阴影。
- 边框始终为1px
borde。不使用2px或彩色边框,焦点除外。 - 三级阴影,始终柔和,使用墨色调(永远不是纯黑):
- 最小(
0 1px 2px /.05):用于带边框的按钮、托盘内部的卡片、菜单活动项和方形图标。这赋予了它们高级的“立体感”。 - 悬停时(
0 14px 30px -18px /.3,同时上移2px):用于可点击的卡片。 - 浮动(
0 24px 48px -16px /.22):用于菜单、工作表、模态框和toast。黑色主按钮自带阴影和顶部亮光(inset 0 1px 0 /.12)。 - 静止的内容卡片使用边框,不使用大阴影。
- 最小(
细分。 要细分卡片,使用全宽带(border-t 或 suave 背景)或托盘+白色卡片模式(参见“生命”第9点)。不推荐叠放三层带边框的盒子。行内指标使用 divide-x 分隔。
5. 组件
KPI卡片(06, 07, 13, 14 · 分析06)
- 始终包含标签 + 数字 + 上下文行。没有“关于什么”或“相对于什么”的数字是不应该出现的。
- 数字使用
tinta(24–28px, 600,tabular-nums)。颜色仅用于增量、药丸或条。 - 增量 说明其周期(“+12% vs. 上月”、“本周+3”),带有箭头 ↗/↘,其颜色取决于对业务是好是坏,而非符号:如果逾期率下降,则为绿色。
- 如果有逾期内容,页脚带有警告图标和红色文字显示数量(“2已逾期 · 需要关注”)。
- 针对目标的进度显示为分段条或环,带有“已完成X / Y · 剩余Z天”。如果剩余时间少于总时间的20%,该文本变为红色。
- 如果只有3–4个指标,它们可以共享一个微型折线图,每个指标使用自己的数据颜色。
实体卡片
- 用于进行中的事项:项目、活动、开放机会、大型服务、活跃客户。
- 尺寸:大约 1fr / 1fr / 1fr 网格,最小宽度280px。
- 布局:左上角的状态药丸 + 右上角的更多菜单 (⋯);大标题(实体名称 + 标签);2行描述;全宽进度条,带有“X / Y 项 · 到期日期”;活动迷你折线图;底部为“后续步骤”列表,带有复选框和“+ 添加”输入。
- 高级选项:卡片可以有一个顶部彩色条(2px,使用用户/实体的颜色)或一个带有渐变背景的顶部区域(用于促销卡片)。
表格和数据列表
- 表头: 灰色,12–13px,首字母小写。在密集列表中使用粘性表头。
- 行: 48–56px高。行与行之间的分隔线使用
divide-y加divide-gray-200。 - 交互: 悬停时行背景改变。点击行打开侧面板或导航到详情(不要在新页面打开)。单击图标按钮打开操作菜单。
- 内容: 第一列通常是实体名称 + 其彩色点。数字列右对齐。操作列是图标(编辑、删除、更多)。包含用于状态的彩色药丸。
- 分页: 使用“显示 20 / 50 / 100” + 页面按钮(带数字的按钮),而不是无限滚动(用于管理列表)。
筛选器和分段控件
- 分段控件 用于视图切换(“概览” / “详情” / “列表”):圆角药丸形状,
bg-superficie用于非活动项,bg-white或bg-panel用于活动项(无颜色)。 - 筛选器: 位于分段控件下方的一行。可以是:下拉选择器(带有搜索的小型组合框)、日期范围选择器(开始 / 结束)或标签筛选器(一行可点击的药丸)。
- 搜索: 位于面板右上角或筛选器行中。始终带有 ⌘K 快捷键提示。
侧面板(上下文面板)
- 位于主体右侧,360px宽。用于详情、活动日志、相关实体。
- 顶部:标题 + 关闭按钮。下部:选项卡(“详情”、“活动”、“文件”),活动选项卡带有计数。
- 内容:实体卡片、堆叠头像、迷你表格、带有时间戳的活动条目。
6. 状态和动画
6b. 空状态、加载状态和错误状态
- 空状态: 中央插图(线条艺术或图标)+ 标题“尚无数据” + 解释说明(“目前没有待处理发票”)。可选地,一个“添加第一个”按钮。
- 加载状态: 骨架屏。使用
bg-suave占位符,具有柔和脉冲动画。不应闪烁或跳跃。 - 错误状态: 红色信息框(10%红色背景 + 红色文本)位于顶部,带有关闭按钮。文本:“加载数据时出错。[重试]”。
- 部分失败: 如果某个KPI卡失败,其数字变为“---”,其颜色变为灰色,并显示一个小的重试图标。
6c. 动画原则
- 加载动画:数字计数(400–800毫秒),条增长,线条绘制。
- 悬停动画:卡片上移2px并带有增强阴影(300毫秒,
ease-out)。按钮背景变暗(不要改变边框)。 - 状态变化动画:切换滑出(200毫秒),toast淡入然后淡出(3秒后)。
- 尊重
prefers-reduced-motion:禁用所有运动(无计数,无绘制,无悬停)。仅在<html>上使用CSS,或通过useReducedMotion。
7. 深色模式(分析07)
- 颜色反转:背景变为深色(
#18181B),表面变为稍浅的深色(#27272A),文本变为浅色(#F4F4F5)。 - 保持相同的色阶层次:
fondo→panel→superficie。 - 强调色保持相同(品牌颜色)。状态色也保持不变。数据调色板也保持不变。
- 边框和阴影:边框在深色背景上变为
#3F3F46。阴影更为微妙(更深的不透明度,但保持相同的扩散和模糊)。 - 图像和图标:可能需要浅色版本。白色图标变为浅灰色或强调色。
- 在
<html>上使用class="dark"或通过系统偏好测试(prefers-color-scheme)。
8. 最终清单(在完成每个屏幕之前检查)
- 是否使用了正确的框架?(画布 + 面板 + 侧边栏)
- 标题是否大而轻量(36–44px, 400,
tracking-tight)? - 副标题是否包含真实数据(“12待开票 · 3已逾期”)?
- 是否只有一个按钮?(是的,一个实心按钮。没有第二个实心按钮。)
- KPIs行:是否有主角卡片(带颜色渐变)?
- 是否有实体卡片(用于进行中项目)而不仅仅是表格?
- 每个实体是否有颜色(头像、进度条、迷你折线图)?
- 每个数字是否都带有图形(迷你折线图、条、环、分段条)?
- 是否有空状态、加载状态和错误状态?
- 它在390px宽度上看起来好吗?
- 它在深色模式下看起来好吗?
- 颜色是否仅限于:中性色 + 1个强调色 + 最多4个状态色 + 最多6个数据色?
- 是否使用了正确的间距比例(4 / 8 / 12 / 16 / 20 / 24 / 32 / 40)?
- 是否使用了正确的圆角值(26 / 20 / 20 / 16 / 11–12 / 7–9)?
- 边框是否为1px且柔和?
- 阴影是否为三级(最小 / 悬停 / 浮动)且柔和?
- 动画是否尊重
prefers-reduced-motion? - 是否阅读了该主题在
analisis/中的相应分析文件? - 是否阅读了
marcas.local.md(如果存在)并应用了其规则?
9. 设计资产
此技能文件夹包含以下资产:
tokens.css:所有CSS变量(字体、颜色、圆角、间距)。可直接粘贴。ejemplos/:tablero-crm.html:一个完整CRM屏幕的HTML(带有CSS和JS)。在浏览器中查看。componentes.html:所有独立组件的HTML图库(卡片、表格、输入框、按钮、菜单)。recetas-tailwind.md:React + Tailwind v4代码片段,可直接复制。
referencias/:参考截图(01…14-*.jpg)。在开始设计之前打开它们。analisis/:按主题的详细分析(01-estructura.md到15-homogeneidad.md)。包含值、示例和原理。marcas.local.md(可选):特定于公司的覆盖规则。它存在于SKILL.md旁边。