Skip to content

Latest commit

 

History

History
31 lines (23 loc) · 2.68 KB

DESIGN.md

File metadata and controls

31 lines (23 loc) · 2.68 KB

DESIGN.md

设计的总入口。本文只做导航;稳定原则进入 capability,跨会话设计进入 change spec,避免多份文档漂移。

设计真相源在哪

你要找的 去这里
颜色 / 圆角 / 间距 / 排版 / 基础组件 token / 布局样式写法 web/DESIGN.md(唯一真相源)。气质:浅色、克制的企业控制台,见该文 Overview
Web 组件所有权与治理执行 web/COMPONENT_GOVERNANCE.md
前端工程约定(栈/包管理/i18n/门禁) 前端工程规则
产品侧 UI / 交互规范 specs/capabilities/legacy-design-ui.md
算法服务设计原则 algorithms/DESIGN_GUIDE.md
产品与工程原则 PRODUCT.md · 能力规格
设计决策 / ADR 归档 docs/adr/
系统结构与模块边界 系统架构
OpsPilot 页面内容对话(其它 app 把当前页接到悬浮机器人) 按 对接规范 开发,不要改业务页展示、不要改 GlobalWebchat / 后端注入。参考实现:监控仪表盘 pilot · 产品说明 spec.md

OpsPilot 页面内容对话(给 Agent)

开发或评审「悬浮机器人能看见当前页」时,只读并对齐 app-integration.md。不要通读 web/DESIGN.md,也不要改监控仪表盘等业务组件。

改设计前的三条规矩

  1. token 不硬编码:前端任何颜色取自语义 token(globals.css / web/DESIGN.md);布局与间距优先 Tailwind className,不以大段行内 style 表达。
  2. 决策要留痕:跨会话设计写入 specs/changes/<feature>/spec.md;长期且难回滚的决定才写 ADR。
  3. 一致性优先:复用既有组件与规范,新范式需符合 产品原则;Web 组件放置与治理见 COMPONENT_GOVERNANCE.md。