Skip to content
bitzorcas
中EN

Concept

Design System 1.2

BitzOrcas Design System 1.2 的冻结范围、权威顺序、稳定主题、体验 Profile 与代码实现状态。

Last updated

Design System 1.2

冻结范围

层冻结内容页面开发可以填写
Foundation / Token色彩、字体、间距、圆角、Elevation、Motion、z-index、Density无
PatternTheme、Shell、Workspace、List、Filter、Saved View选择批准的模式
RecipeList、Detail、Edit、Wizard、Dashboard、IdentitySDK、权限、字段、列、文案
Product Page不创建设计规则业务内容与编排

依赖方向固定为:

Reference -> System -> Component -> shadcn Compatibility
↓
Pattern -> Recipe -> Page
逐切片验证逐切片验证逐切片验证

Token Source

确定性生成器

CSS / TypeScript / schema

Components

Patterns

Recipes

Product Pages

Design Guardian

“Frozen”表示稳定合同不能由页面自行改写,不表示所有高级 Pattern 都已在产品中交付。下游 实现缺口应继续向合同收敛,并在符合性账本中保留明确状态。

权威顺序

发生冲突时按以下顺序处理:

  1. 主仓库 ADR 0801 与 frontend/AGENTS.md;
  2. 本章 Design System 1.2 文档;
  3. Frontend Design Guardian 与 UI Done Checklist;
  4. shadcn 组件契约;
  5. 外部设计技能、竞品、旧截图和 Axhub 参考。

旧系统和 Axhub 只用于理解业务复杂度、字段规模和用户偏好,不是视觉基线。

稳定主题

顺序ID显示名定位
0enterprise-neutral曜灰Framework / 通用 Platform fallback
1legal-navy衡蓝Legal 默认,稳健通用
2legal-amber香槟金温暖商业与高端服务
3legal-burgundy章红精品所与合伙人门户
4legal-jade青律知识、合规与东方专业
5legal-orange暖橙能源、制造与活力品牌

显示名与 theme.tokens.json 的 name 字段和 i18n 文案一致。工作台主题选择器按 workspaceBrandThemeIds 展示:衡蓝 → 香槟金 → 章红 → 青律 → 曜灰 → 暖橙。曜灰(enterprise-neutral)既是 Framework fallback,也出现在工作台选择器中供用户切换。

冻结的体验 Profile

ProfileShellWorkspaceDensity场景
platform-workbenchSideManaged TabsCompact登录后的法律业务主工作台
platform-portalTopSingle RouteCompact模块较少或搜索中心门户
identity-flowMinimalSingle RouteComfortable登录、邀请、MFA、验证码、找回密码
touch-contextResponsiveSingle RouteComfortable窄屏与触摸环境

Density 实际有四档:dense、compact、comfortable、spacious。Profile 表只标注每类场景的默认档;dense 面向高密表格批量操作,spacious 面向触摸与无障碍放大场景,用户可在偏好中切换。

Theme、Mode、Density、Shell 和 Workspace 相互独立。换主题不会换导航,换密度不会改间距 Reference,前端隐藏权限也不会替代后端 Authorization。

当前实现状态

能力设计契约当前代码
Token 分层与所有权Frozen已落地于 packages/materials,确定性生成器输出 CSS/TS/schema
六套品牌主题Frozen已生成色阶并由 AppearanceProvider 运行时注入
Light/Dark × Brand × DensityFrozen已落地四级密度、六主题与模式级联
无障碍覆写Frozen已落地 fontScale、highContrast、colorVision、reduceMotion 四组轴
Shell / WorkspaceFrozenSide/Top 与 Single Route 已落地;Managed Tabs 的恢复与脏状态矩阵尚未闭环
List / FilterFrozen共享列表与筛选基础已落地;Advanced Filter、Query Studio 和 Saved View 仍按切片推进
Identity已交付已作为 tracer-bullet 完成全链路

推荐阅读

  1. 设计语言
  2. Token 架构
  3. 色彩与法律主题
  4. 排版、空间与材质
  5. 暗色、多品牌与体验 Profile
  6. 应用壳层与工作区
  7. 列表与复杂检索
  8. 界面使用指南
  9. 实现与符合性门禁
  10. 面向后端开发者的页面开发

本章核心导航

100%

滚轮或按钮缩放 · 放大后拖动画面 · 双击切换 100% / 200%