smart_grid_iot/系统设计/UI/客户档案管理/DESIGN.md

---
name: Industrial Precision
colors:
  surface: '#ffffff'
  surface-dim: '#ccdbf1'
  surface-bright: '#f8f9ff'
  surface-container-lowest: '#ffffff'
  surface-container-low: '#eef4ff'
  surface-container: '#e5efff'
  surface-container-high: '#dbe9ff'
  surface-container-highest: '#d5e4fa'
  on-surface: '#0d1c2c'
  on-surface-variant: '#424655'
  inverse-surface: '#233142'
  inverse-on-surface: '#e9f1ff'
  outline: '#727787'
  outline-variant: '#c2c6d8'
  surface-tint: '#0056d2'
  primary: '#0054cd'
  on-primary: '#ffffff'
  primary-container: '#136bfb'
  on-primary-container: '#fefcff'
  inverse-primary: '#b2c5ff'
  secondary: '#712ae2'
  on-secondary: '#ffffff'
  secondary-container: '#8a4cfc'
  on-secondary-container: '#fffbff'
  tertiary: '#00685f'
  on-tertiary: '#ffffff'
  tertiary-container: '#008378'
  on-tertiary-container: '#f4fffc'
  error: '#ba1a1a'
  on-error: '#ffffff'
  error-container: '#ffdad6'
  on-error-container: '#93000a'
  primary-fixed: '#dae2ff'
  primary-fixed-dim: '#b2c5ff'
  on-primary-fixed: '#001847'
  on-primary-fixed-variant: '#0040a1'
  secondary-fixed: '#eaddff'
  secondary-fixed-dim: '#d2bbff'
  on-secondary-fixed: '#25005a'
  on-secondary-fixed-variant: '#5a00c6'
  tertiary-fixed: '#89f5e7'
  tertiary-fixed-dim: '#6bd8cb'
  on-tertiary-fixed: '#00201d'
  on-tertiary-fixed-variant: '#005049'
  background: '#f8f9ff'
  on-background: '#0d1c2c'
  surface-variant: '#d5e4fa'
  bg-page: '#eef3f8'
  text-muted: '#5b6b7e'
  border-rule: '#dbe4ee'
  status-warn: '#e0852b'
  status-error: '#dc2626'
  accent-subtle: rgba(29,111,255,0.08)
typography:
  display-lg:
    fontFamily: hankenGrotesk
    fontSize: 32px
    fontWeight: '700'
    lineHeight: 40px
  headline-md:
    fontFamily: hankenGrotesk
    fontSize: 23px
    fontWeight: '700'
    lineHeight: 28px
  title-sm:
    fontFamily: hankenGrotesk
    fontSize: 17px
    fontWeight: '700'
    lineHeight: 24px
  body-md:
    fontFamily: hankenGrotesk
    fontSize: 15px
    fontWeight: '400'
    lineHeight: 24px
  label-bold:
    fontFamily: hankenGrotesk
    fontSize: 13px
    fontWeight: '700'
    lineHeight: 16px
  data-mono:
    fontFamily: jetbrainsMono
    fontSize: 12px
    fontWeight: '500'
    lineHeight: 16px
  caption-sm:
    fontFamily: hankenGrotesk
    fontSize: 12px
    fontWeight: '700'
    lineHeight: 14px
  headline-md-mobile:
    fontFamily: hankenGrotesk
    fontSize: 20px
    fontWeight: '700'
    lineHeight: 26px
rounded:
  sm: 0.25rem
  DEFAULT: 0.5rem
  md: 0.75rem
  lg: 1rem
  xl: 1.5rem
  full: 9999px
spacing:
  base: 4px
  xs: 8px
  sm: 12px
  md: 16px
  lg: 24px
  xl: 40px
  container-max: 1200px
  gutter: 16px
---

## Brand & Style

The design system is engineered for the **Xintong Smart Power Operation Management APP**, targeting power engineers and grid operators. The brand personality is **Professional, Efficient, and Industrial Tech**. It emphasizes reliability through a structured, high-density interface that transforms complex electrical data into actionable insights.

The design style is a blend of **Corporate Modern** and **Information-Dense Minimalism**. It utilizes a "Layered Surface" approach where data is organized into logical card blocks, using subtle elevations and clear semantic color-coding to denote system status. The aesthetic is clean and functional, avoiding decorative elements in favor of technical precision and rapid scanability.

- **Professionalism:** High-contrast typography and a restrained color palette.
- **Efficiency:** Condensed layouts that prioritize data visualization and task status.
- **Reliability:** Solid borders, consistent spacing, and clear state indicators.

## Colors

The color architecture is strictly functional, mapping specifically to the operation layers of the power management system. 

- **Primary (Deep Blue):** Reserved for core branding, navigation, and "Client" layer interactions.
- **Secondary (Purple):** Dedicated to "Gateway" operations and task-specific management.
- **Tertiary (Teal):** Used for "Service" layer success states and optimized performance indicators.
- **Neutral (Ink):** Used for primary text to ensure maximum legibility against light surfaces.

**Semantic Usage:**
- Use **status-warn (Amber)** for non-critical alerts or data synchronization states.
- Use **status-error (Red)** for critical power failures or permission denials.
- The **bg-page** provides a soft, low-strain canvas for long-duration monitoring, while **surface** (White) distinguishes interactive cards and data containers.

## Typography

This design system uses **Hanken Grotesk** as the primary typeface for its sharp, contemporary feel that bridges the gap between industrial and tech. **JetBrains Mono** is employed for technical data, device IDs, and numerical values to emphasize the system's engineering DNA.

- **Hierarchy:** Use `display-lg` for dashboard summaries. `title-sm` is the default for card headers.
- **Data Visualization:** All tabular data and technical strings must use `data-mono` for character alignment and clarity.
- **Mobile Adaptation:** For mobile screens, headlines should scale down to `headline-md-mobile` to maintain visual balance while preserving authority.

## Layout & Spacing

The layout utilizes a **Flexible Grid System** with a focus on logical grouping through card-based containment.

- **Grid:** A 12-column grid is used for desktop views, transitioning to a single-column stacked layout for mobile.
- **Rhythm:** An 8px-based spacing scale ensures vertical consistency. Use `lg (24px)` for outer card padding and `md (16px)` for internal element spacing.
- **Mobile Margins:** Standard mobile side margins are set to `md (16px)` to maximize screen real estate for dense data tables.
- **Sectioning:** Distinct operational modules should be separated by `xl (40px)` of vertical space to prevent cognitive overload.

## Elevation & Depth

This design system conveys hierarchy through **Tonal Layering** and **Subtle Ambient Shadows**. We avoid heavy skeuomorphism in favor of a "Flat-Plus" approach.

- **Base Layer:** The page background (`bg-page`) sits at the lowest elevation.
- **Mid Layer (Cards):** UI cards use a white surface with a subtle shadow (`0 4px 14px rgba(0,0,0,.07)`) to appear slightly lifted.
- **Interactive Layer:** On hover or active state, cards may transition to a higher elevation (`0 8px 28px rgba(0,0,0,.1)`) with a slight upward translation of -2px.
- **Overlays:** Modals and dropdowns use the highest z-index with a distinct backdrop blur to maintain focus on the task at hand.
- **Gradients:** Use soft radial gradients in the background (Blue/Purple) to create environmental depth without interfering with content legibility.

## Shapes

The shape language is **Rounded**, balancing industrial rigidity with modern software approachability.

- **Cards & Sections:** Use the standard `rounded-lg (1rem)` for primary containers.
- **Nodes & Blocks:** Architecture and data nodes use `rounded (0.5rem)` to fit more compactly within layouts.
- **Interactive Elements:** Buttons and tags use a "Pill-shape" (`rounded-xl` or 999px) to distinguish them from structural containers.
- **Borders:** Use `1px solid` with the `border-rule` color for most containers. Active states or primary focus areas may increase to `1.5px`.

## Components

**Buttons:**
- **Primary:** Solid `primary_color` with white text. Pill-shaped.
- **Secondary:** Transparent with `primary_color` border or subtle purple tint for operation tasks.
- **Danger:** Solid `status-error` for irreversible actions.

**Cards:**
- White background, `1px` border-rule, and `rounded-lg` corners. 
- Headers should have a `18px` internal padding and a bottom border to separate from the content body.

**Input Fields:**
- Soft white background with `1px` border. 
- Focused states should use a `primary_color` border with a subtle outer glow.

**Chips & Tags:**
- Used for status (e.g., "Active", "Offline").
- Backgrounds should use `8% opacity` versions of the semantic colors (Blue, Green, Red) with bolded text in the 100% opacity color.

**Data Visualization:**
- Charts should use the primary blue and secondary purple as the main data series colors.
- Use `data-mono` for all axis labels and tooltips to ensure technical accuracy.

**Status Indicators:**
- Small `7px` circular dots used within lists or architecture nodes to show real-time connectivity status.