bauman-design-system
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseSistema de Diseño SIBA (Bauman)
SIBA(Bauman)设计系统
Referencia obligatoria al desarrollar UI para Sistema SIBA.
Estilo: Corporate Premium | Dark Mode + Light Mode | Responsive: Desktop-first
开发SIBA系统UI时的强制参考标准。
风格:企业高端风格 | 深色模式+浅色模式 | 响应式设计:桌面优先
⚠️ Reglas Críticas
⚠️ 关键规则
- SIEMPRE responsive - Desktop-first, debe funcionar en 375px+
- SIEMPRE ambos modos - Light y Dark mode con prefix
dark: - NUNCA emojis - Solo iconos Material Symbols
- NUNCA colores hardcodeados - Usar CSS variables o tokens Tailwind
- SIEMPRE usar la paleta Gold para acciones principales y estados activos
- 始终支持响应式 - 桌面优先,必须适配375px及以上屏幕
- 始终支持双模式 - 浅色和深色模式,使用前缀
dark: - 禁止使用表情符号 - 仅可使用Material Symbols图标
- 禁止硬编码颜色 - 使用CSS变量或Tailwind令牌
- 始终使用金色调色板作为主要操作和激活状态的颜色
Identidad Visual
视觉标识
Estética
美学风格
- Corporate Premium: Elegante, minimalista, sofisticado
- Influencia geométrica: Inspirado en el logo Bauman (formas cuadradas)
- Sensación de lujo: Uso estratégico del dorado sobre fondos neutros
- 企业高端风格:优雅、极简、精致
- 几何灵感:源自Bauman标志(方形元素)
- 奢华质感:在中性背景上战略性使用金色
Tipografía
排版
| Propiedad | Valor |
|---|---|
| Font Family | Manrope (Google Fonts) |
| Weights | 400, 500, 600, 700, 800 |
| Import | |
tsx
// Clase Tailwind
className = 'font-sans'; // Manrope configurado como default| 属性 | 值 |
|---|---|
| 字体家族 | Manrope(Google Fonts) |
| 字重 | 400, 500, 600, 700, 800 |
| 引入链接 | |
tsx
// Tailwind类
className = 'font-sans'; // Manrope已配置为默认字体Iconografía
图标系统
| Librería | Import |
|---|---|
| Material Symbols | |
tsx
<span className="material-symbols-outlined">dashboard</span>| 库 | 引入链接 |
|---|---|
| Material Symbols | |
tsx
<span className="material-symbols-outlined">dashboard</span>Paleta de Colores
调色板
🥇 Gold Accent (Protagonista)
🥇 金色强调色(主色)
| Token | HEX | Uso |
|---|---|---|
| | CTAs, estados activos, highlights |
| | Hover states, fondos suaves |
| | Bordes, elementos secundarios |
tsx
// Botón primario (CTA)
className = 'bg-gold text-white hover:bg-gold-light';
// Estado activo sidebar
className = 'bg-gold/10 text-gold border-l-2 border-gold';| 令牌 | 十六进制值 | 使用场景 |
|---|---|---|
| | 主要操作按钮、激活状态、高亮元素 |
| | 悬停状态、柔和背景 |
| | 边框、次要元素 |
tsx
// 主要操作按钮(CTA)
className = 'bg-gold text-white hover:bg-gold-light';
// 侧边栏激活状态
className = 'bg-gold/10 text-gold border-l-2 border-gold';Light Mode
浅色模式
| Token | HEX / Tailwind | Uso |
|---|---|---|
| background | | Fondo principal |
| surface | | Cards, modales |
| border | | Bordes |
| text-primary | | Texto principal |
| text-secondary | | Texto secundario |
| text-muted | | Placeholders |
| 令牌 | 十六进制值 / Tailwind类 | 使用场景 |
|---|---|---|
| background | | 主背景 |
| surface | | 卡片、模态框 |
| border | | 边框 |
| text-primary | | 主要文本 |
| text-secondary | | 次要文本 |
| text-muted | | 占位文本 |
Dark Mode
深色模式
| Token | HEX / Tailwind | Uso |
|---|---|---|
| background | | Fondo principal |
| surface | | Cards, sidebar |
| border | | Bordes |
| text-primary | | Texto principal |
| text-secondary | | Texto secundario |
| charcoal | | Superficies elevadas |
| 令牌 | 十六进制值 / Tailwind类 | 使用场景 |
|---|---|---|
| background | | 主背景 |
| surface | | 卡片、侧边栏 |
| border | | 边框 |
| text-primary | | 主要文本 |
| text-secondary | | 次要文本 |
| charcoal | | 高级表面元素 |
Semánticos
语义化颜色
| Token | Light | Dark |
|---|---|---|
| success | | |
| warning | | |
| error | | |
| info | | |
| 令牌 | 浅色模式 | 深色模式 |
|---|---|---|
| success | | |
| warning | | |
| error | | |
| info | | |
CSS Variables
CSS变量
css
:root {
/* Gold Accent */
--gold-primary: #bd8e3d;
--gold-light: #e6c489;
--gold-muted: #c5a36a;
/* Backgrounds */
--background: #f8f8f7;
--surface: #ffffff;
--border: #e5e5e3;
/* Text */
--foreground: #18181b;
--muted: #52525b;
}
.dark {
--background: #121416;
--surface: #1a1c1e;
--border: #37322a;
--foreground: #fafafa;
--muted: #a1a1aa;
}css
:root {
/* Gold Accent */
--gold-primary: #bd8e3d;
--gold-light: #e6c489;
--gold-muted: #c5a36a;
/* Backgrounds */
--background: #f8f8f7;
--surface: #ffffff;
--border: #e5e5e3;
/* Text */
--foreground: #18181b;
--muted: #52525b;
}
.dark {
--background: #121416;
--surface: #1a1c1e;
--border: #37322a;
--foreground: #fafafa;
--muted: #a1a1aa;
}Tailwind Config
Tailwind配置
javascript
// tailwind.config.js
export default {
darkMode: 'class',
theme: {
extend: {
colors: {
gold: {
DEFAULT: '#bd8e3d',
light: '#e6c489',
muted: '#C5A36A',
},
charcoal: '#2F3136',
luxury: '#35322c',
},
fontFamily: {
sans: ['Manrope', 'system-ui', 'sans-serif'],
},
},
},
};javascript
// tailwind.config.js
export default {
darkMode: 'class',
theme: {
extend: {
colors: {
gold: {
DEFAULT: '#bd8e3d',
light: '#e6c489',
muted: '#C5A36A',
},
charcoal: '#2F3136',
luxury: '#35322c',
},
fontFamily: {
sans: ['Manrope', 'system-ui', 'sans-serif'],
},
},
},
};Responsive Breakpoints
响应式断点
Mobile: < 768px (default)
Tablet: md: 768px
Desktop: lg: 1024px
Wide: xl: 1280px移动端: < 768px (默认)
平板端: md: 768px
桌面端: lg: 1024px
宽屏: xl: 1280pxLayout por Breakpoint
各断点布局
| Elemento | Mobile | Tablet | Desktop |
|---|---|---|---|
| Sidebar | Drawer (Sheet) | Colapsado 64px | Expandido 260px |
| Header | Hamburger | Full | Full |
| Grid cols | 1 | 2 | 3-4 |
| 元素 | 移动端 | 平板端 | 桌面端 |
|---|---|---|---|
| 侧边栏 | 抽屉组件 (Sheet) | 折叠为64px | 展开为260px |
| 头部 | 汉堡菜单 | 完整显示 | 完整显示 |
| 网格列数 | 1 | 2 | 3-4 |
Componentes Core
核心组件
Sidebar
侧边栏
tsx
// Desktop expandido: 260px
<aside className="hidden lg:flex w-[260px] bg-white dark:bg-surface-dark border-r">
// Desktop colapsado: 64px (solo iconos)
<aside className="hidden lg:flex w-16 bg-white dark:bg-surface-dark">
// Mobile: Sheet/Drawer
<Sheet>
<SheetTrigger className="lg:hidden">
<span className="material-symbols-outlined">menu</span>
</SheetTrigger>
<SheetContent side="left">...</SheetContent>
</Sheet>tsx
// 展开的桌面端: 260px
<aside className="hidden lg:flex w-[260px] bg-white dark:bg-surface-dark border-r">
// 折叠的桌面端: 64px (仅显示图标)
<aside className="hidden lg:flex w-16 bg-white dark:bg-surface-dark">
// 移动端: 抽屉组件
<Sheet>
<SheetTrigger className="lg:hidden">
<span className="material-symbols-outlined">menu</span>
</SheetTrigger>
<SheetContent side="left">...</SheetContent>
</Sheet>Navegación Sidebar
侧边栏导航
Dashboard (icon: dashboard) [SELECCIONADO]
Comercial (icon: trending_up) → Tickets, Obras
Finanzas (icon: account_balance) → Tesorería Ingresos, Tesorería Egresos
Administración (icon: corporate_fare) → Clientes, Sedes, Vehículos, Zonas
Seguridad (icon: admin_panel) → Usuarios, Roles
---
Soporte (icon: help_outline)
Configuración (icon: settings)仪表盘 (图标: dashboard) [已选中]
商务模块 (图标: trending_up) → 工单、项目
财务模块 (图标: account_balance) → 收入出纳、支出出纳
管理模块 (图标: corporate_fare) → 客户、分支机构、车辆、区域
安全模块 (icon: admin_panel) → 用户、角色
---
支持模块 (图标: help_outline)
设置模块 (图标: settings)Estado Activo Sidebar
侧边栏激活状态
tsx
// Link activo
<div className="relative flex items-center gap-3 px-3 py-3 rounded-lg bg-gold/10 text-gold">
<div className="absolute left-0 top-[20%] bottom-[20%] w-[3px] bg-gold rounded-r shadow-[0_0_10px_rgba(189,142,61,0.4)]" />
<span className="material-symbols-outlined">dashboard</span>
<span className="font-semibold">Dashboard</span>
</div>tsx
// 激活的链接
<div className="relative flex items-center gap-3 px-3 py-3 rounded-lg bg-gold/10 text-gold">
<div className="absolute left-0 top-[20%] bottom-[20%] w-[3px] bg-gold rounded-r shadow-[0_0_10px_rgba(189,142,61,0.4)]" />
<span className="material-symbols-outlined">dashboard</span>
<span className="font-semibold">Dashboard</span>
</div>Botones
按钮
tsx
// CTA Primary (Gold)
<button className="bg-gold hover:bg-gold-light text-white font-bold rounded-lg px-4 py-2 transition-all shadow-lg shadow-gold/10">
Iniciar Sesión
</button>
// Secondary
<button className="bg-white dark:bg-gold/10 border border-border-light dark:border-gold/20 text-slate-700 dark:text-gold font-bold rounded-lg px-4 py-2">
Cancelar
</button>tsx
// 主要操作按钮(金色)
<button className="bg-gold hover:bg-gold-light text-white font-bold rounded-lg px-4 py-2 transition-all shadow-lg shadow-gold/10">
登录
</button>
// 次要按钮
<button className="bg-white dark:bg-gold/10 border border-border-light dark:border-gold/20 text-slate-700 dark:text-gold font-bold rounded-lg px-4 py-2">
取消
</button>Cards
卡片
tsx
<div className="bg-white dark:bg-charcoal/30 rounded-xl border border-[#e5e5e3] dark:border-[#37322a] p-6 shadow-sm">tsx
<div className="bg-white dark:bg-charcoal/30 rounded-xl border border-[#e5e5e3] dark:border-[#37322a] p-6 shadow-sm">Empty State
空状态
tsx
<div className="flex flex-col items-center justify-center min-h-[400px] border-2 border-dashed border-slate-200 dark:border-[#37322a] rounded-xl bg-white/50 dark:bg-charcoal/20 p-12 text-center">
<div className="size-20 bg-gold/10 rounded-full flex items-center justify-center mb-6 border border-gold/20">
<span className="material-symbols-outlined text-gold text-5xl">dashboard_customize</span>
</div>
<h3 className="text-2xl font-bold text-slate-900 dark:text-white mb-3">Título</h3>
<p className="text-slate-500 dark:text-slate-400 mb-8">Descripción...</p>
</div>tsx
<div className="flex flex-col items-center justify-center min-h-[400px] border-2 border-dashed border-slate-200 dark:border-[#37322a] rounded-xl bg-white/50 dark:bg-charcoal/20 p-12 text-center">
<div className="size-20 bg-gold/10 rounded-full flex items-center justify-center mb-6 border border-gold/20">
<span className="material-symbols-outlined text-gold text-5xl">dashboard_customize</span>
</div>
<h3 className="text-2xl font-bold text-slate-900 dark:text-white mb-3">标题</h3>
<p className="text-slate-500 dark:text-slate-400 mb-8">描述...</p>
</div>Animaciones y Transiciones
动画与过渡
tsx
// Transiciones globales (150-200ms)
className = 'transition-all duration-200';
// Hover en cards
className = 'hover:shadow-lg hover:-translate-y-0.5';
// Fade in entrada
className = 'animate-fade-in'; // Definir en CSS
// Sidebar collapse
className = 'transition-[width] duration-300 ease-in-out';tsx
// 全局过渡效果 (150-200ms)
className = 'transition-all duration-200';
// 卡片悬停效果
className = 'hover:shadow-lg hover:-translate-y-0.5';
// 进入淡入效果
className = 'animate-fade-in'; // 在CSS中定义
// 侧边栏折叠过渡
className = 'transition-[width] duration-300 ease-in-out';Checklist Pre-Desarrollo
开发前检查清单
- Componente funciona en 375px (iPhone SE)
- Componente tiene clases
dark: - Usa Material Symbols, NO emojis
- Sidebar es Sheet en mobile
- CTAs usan color Gold
- Touch targets mínimo 44x44px
- Tipografía es Manrope
- 组件在375px(iPhone SE)屏幕下正常工作
- 组件包含类
dark: - 使用Material Symbols图标,未使用表情符号
- 移动端侧边栏为抽屉组件
- 主要操作按钮使用金色
- 触摸目标最小尺寸为44x44px
- 排版使用Manrope字体
Mockups de Referencia
参考原型
| Pantalla | Archivo |
|---|---|
| Login Light | |
| Login Dark | |
| Dashboard | |
| 页面 | 文件路径 |
|---|---|
| 登录页(浅色) | |
| 登录页(深色) | |
| 仪表盘 | |
Logo
标志
- Archivo:
docs/assets/logo-bauman.png - Estilo: "BAUMAN" con "BAU" negro, "MAN" gris
- Subtítulo: "SOLUCIONES CORPORATIVAS"
- Icono placeholder: Escaleras geométricas SVG en gold
- 文件路径:
docs/assets/logo-bauman.png - 风格: "BAUMAN" 中 "BAU" 为黑色,"MAN" 为灰色
- 副标题: "SOLUCIONES CORPORATIVAS"(企业解决方案)
- 占位图标: 金色几何阶梯SVG