bauman-design-system

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Sistema 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

⚠️ 关键规则

  1. SIEMPRE responsive - Desktop-first, debe funcionar en 375px+
  2. SIEMPRE ambos modos - Light y Dark mode con
    dark:
    prefix
  3. NUNCA emojis - Solo iconos Material Symbols
  4. NUNCA colores hardcodeados - Usar CSS variables o tokens Tailwind
  5. SIEMPRE usar la paleta Gold para acciones principales y estados activos

  1. 始终支持响应式 - 桌面优先,必须适配375px及以上屏幕
  2. 始终支持双模式 - 浅色和深色模式,使用
    dark:
    前缀
  3. 禁止使用表情符号 - 仅可使用Material Symbols图标
  4. 禁止硬编码颜色 - 使用CSS变量或Tailwind令牌
  5. 始终使用金色调色板作为主要操作和激活状态的颜色

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

排版

PropiedadValor
Font FamilyManrope (Google Fonts)
Weights400, 500, 600, 700, 800
Import
https://fonts.googleapis.com/css2?family=Manrope:wght@400;500;600;700;800&display=swap
tsx
// Clase Tailwind
className = 'font-sans'; // Manrope configurado como default
属性
字体家族Manrope(Google Fonts)
字重400, 500, 600, 700, 800
引入链接
https://fonts.googleapis.com/css2?family=Manrope:wght@400;500;600;700;800&display=swap
tsx
// Tailwind类
className = 'font-sans'; // Manrope已配置为默认字体

Iconografía

图标系统

LibreríaImport
Material Symbols
https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:wght,FILL@100..700,0..1&display=swap
tsx
<span className="material-symbols-outlined">dashboard</span>

引入链接
Material Symbols
https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:wght,FILL@100..700,0..1&display=swap
tsx
<span className="material-symbols-outlined">dashboard</span>

Paleta de Colores

调色板

🥇 Gold Accent (Protagonista)

🥇 金色强调色(主色)

TokenHEXUso
gold
/
gold-DEFAULT
#bd8e3d
CTAs, estados activos, highlights
gold-light
#e6c489
Hover states, fondos suaves
gold-muted
#C5A36A
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';
令牌十六进制值使用场景
gold
/
gold-DEFAULT
#bd8e3d
主要操作按钮、激活状态、高亮元素
gold-light
#e6c489
悬停状态、柔和背景
gold-muted
#C5A36A
边框、次要元素
tsx
// 主要操作按钮(CTA)
className = 'bg-gold text-white hover:bg-gold-light';

// 侧边栏激活状态
className = 'bg-gold/10 text-gold border-l-2 border-gold';

Light Mode

浅色模式

TokenHEX / TailwindUso
background
#f8f8f7
/
bg-[#f8f8f7]
Fondo principal
surface
#ffffff
/
bg-white
Cards, modales
border
#e5e5e3
/
border-[#e5e5e3]
Bordes
text-primary
#18181B
/
text-slate-900
Texto principal
text-secondary
#52525B
/
text-slate-500
Texto secundario
text-muted
#a1a1aa
/
text-slate-400
Placeholders
令牌十六进制值 / Tailwind类使用场景
background
#f8f8f7
/
bg-[#f8f8f7]
主背景
surface
#ffffff
/
bg-white
卡片、模态框
border
#e5e5e3
/
border-[#e5e5e3]
边框
text-primary
#18181B
/
text-slate-900
主要文本
text-secondary
#52525B
/
text-slate-500
次要文本
text-muted
#a1a1aa
/
text-slate-400
占位文本

Dark Mode

深色模式

TokenHEX / TailwindUso
background
#121416
/
dark:bg-[#121416]
Fondo principal
surface
#1a1c1e
/
dark:bg-[#1a1c1e]
Cards, sidebar
border
#37322a
/
dark:border-[#37322a]
Bordes
text-primary
#fafafa
/
dark:text-slate-100
Texto principal
text-secondary
#a1a1aa
/
dark:text-slate-400
Texto secundario
charcoal
#2F3136
Superficies elevadas
令牌十六进制值 / Tailwind类使用场景
background
#121416
/
dark:bg-[#121416]
主背景
surface
#1a1c1e
/
dark:bg-[#1a1c1e]
卡片、侧边栏
border
#37322a
/
dark:border-[#37322a]
边框
text-primary
#fafafa
/
dark:text-slate-100
主要文本
text-secondary
#a1a1aa
/
dark:text-slate-400
次要文本
charcoal
#2F3136
高级表面元素

Semánticos

语义化颜色

TokenLightDark
success
#10b981
#34d399
warning
#f59e0b
#fbbf24
error
#ef4444
#f87171
info
#3b82f6
#60a5fa

令牌浅色模式深色模式
success
#10b981
#34d399
warning
#f59e0b
#fbbf24
error
#ef4444
#f87171
info
#3b82f6
#60a5fa

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: 1280px

Layout por Breakpoint

各断点布局

ElementoMobileTabletDesktop
SidebarDrawer (Sheet)Colapsado 64pxExpandido 260px
HeaderHamburgerFullFull
Grid cols123-4

元素移动端平板端桌面端
侧边栏抽屉组件 (Sheet)折叠为64px展开为260px
头部汉堡菜单完整显示完整显示
网格列数123-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

参考原型

PantallaArchivo
Login Light
docs/mockup-ui/siba_login_-_light_mode_1/screen.png
Login Dark
docs/mockup-ui/siba_login_-_light_mode_2/screen.png
Dashboard
docs/mockup-ui/siba_dashboard_-_desktop_expanded/screen.png

页面文件路径
登录页(浅色)
docs/mockup-ui/siba_login_-_light_mode_1/screen.png
登录页(深色)
docs/mockup-ui/siba_login_-_light_mode_2/screen.png
仪表盘
docs/mockup-ui/siba_dashboard_-_desktop_expanded/screen.png

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