64 lines
2.1 KiB
Markdown
64 lines
2.1 KiB
Markdown
# OneOS 设计规范 v2 · 设计决策
|
||
|
||
| 项 | 内容 |
|
||
|----|------|
|
||
| 日期 | 2026-07-22 |
|
||
| 状态 | 已落地文档包 |
|
||
| 产物 | `src/resources/design-system/`（DESIGN.md + chapters/00–09 + tokens.json + oneos-ds-tokens.css） |
|
||
|
||
## 背景
|
||
|
||
既有 v1 规范仅覆盖中后台列表页（筛选 / KPI / 表 / 分页）。产品需要基于当前平台重做设计规范，约束 Web 与 App 全部页面的显示与组件，实现全站统一。
|
||
|
||
## 决策
|
||
|
||
### App 范围
|
||
|
||
**原生 App + 微信小程序 + H5 现场端**（三端全含），与仓库中 `vehicle-inspection-app` / `miniprogram` / `web` 及 PC 中后台并列。
|
||
|
||
### 文档策略
|
||
|
||
在现有 [`src/resources/design-system/`](../../src/resources/design-system/) **扩写为 v2**，不另建 `design-system-v2` 目录。
|
||
|
||
- 根 `DESIGN.md`：总览与导航
|
||
- `chapters/00–09`：完整约束清单落地
|
||
- v1 列表强制规则并入 `04-patterns.md`，并继续指向 `vm-shared/DESIGN.md`
|
||
|
||
### 主色
|
||
|
||
沿用原型现行 **`#32a06e`**（`vehicle-management` / `field-theme`）。
|
||
`oneos-web-legacy` 的 `#10b981` 标为遗留，新页禁止。
|
||
|
||
### 暗色模式
|
||
|
||
本版明确 **仅浅色**；若未来需要，须先补映射表。
|
||
|
||
### 工程入口
|
||
|
||
- `tokens.json` schemaVersion **2**
|
||
- 新增 `oneos-ds-tokens.css` 供非列表页与共享变量引用
|
||
- 列表页仍强制 `vehicle-management/style.css` + 公共组件
|
||
|
||
## 章节结构
|
||
|
||
```text
|
||
00 总则 → 01 Foundations → 02 Layout → 03 Components
|
||
→ 04 Patterns → 05 Content → 06 A11y → 07 Platform
|
||
→ 08 Tokens 附录 → 09 迁移检查清单
|
||
```
|
||
|
||
编写优先级见 `PRIORITY.md`：Foundations / Tokens → Layout 模板 → Patterns → Components → 平台差异 → Content/A11y → 检查清单。
|
||
|
||
## 成功标准
|
||
|
||
- 任意新页可定位到唯一页面模板与 Token 来源
|
||
- Web 列表验收项不弱于 v1
|
||
- App/小程序/H5 有热区、安全区、导航对照表
|
||
- AI 提示词指向 v2 章节
|
||
|
||
## 非目标（本轮）
|
||
|
||
- 不批量改既有业务页面样式代码
|
||
- 不实现暗色主题
|
||
- 不合并改造 legacy `oneos-tokens.css` 文件内容（仅在规范中标注弃用路径）
|