odoo-forge-bundle 0.1.0

package/payload/skills/view-spec/examples/sample-maintenance-request.md

@@ -0,0 +1,304 @@
+# 视图规格：设备报修工单（maintenance.request）
+
+---
+
+## 视图组合
+
+| 视图类型 | 说明 |
+|----------|------|
+| Form | 报修详情，含工作流 + 维修用料明细 |
+| List | 工单列表，查看全部工单状态和进度 |
+| Kanban | 工单看板，按处理阶段分列拖拽 |
+| Search | 搜索 + 筛选 + 分组 |
+
+---
+
+## Form 视图
+
+```
+┌── header ────────────────────────────────────────────────────────────────┐
+│ [提交报修] [开始维修] [完成] [取消]    ○ 草稿 → ○ 已报修 → ○ 维修中 → ● 已完成  │
+├── sheet ─────────────────────────────────────────────────────────────────┤
+│  ┌── oe_title ───────────────────────────────┐  ┌── button_box ──────┐ │
+│  │  工单编号    MR/2026/0001                 │  │ [📊 3 用料]        │ │
+│  │  报修标题    空压机异响需检修（大字）        │  │ [💰 ¥2,800 费用]  │ │
+│  └───────────────────────────────────────────┘  └────────────────────┘ │
+│                                                                         │
+│  ┌── group（左）──────────────┐  ┌── group（右）───────────────────┐   │
+│  │ 报修设备    [设备名称 ▼]   │  │ 报修日期    [2026-03-15 📅]    │   │
+│  │ 故障类别    [机械故障 ▼]   │  │ 计划维修    [2026-03-17 📅]    │   │
+│  │ 报修人      [👤 张三]      │  │ 完成日期    [__________ 📅]    │   │
+│  │ 紧急程度    ★★☆            │  │ 维修负责人  [👤 _________]     │   │
+│  └────────────────────────────┘  └─────────────────────────────────┘   │
+│                                                                         │
+│  故障描述                                                               │
+│  ┌──────────────────────────────────────────────────────────────────┐  │
+│  │ （多行文本域）                                                    │  │
+│  │ _______________________________________________________________  │  │
+│  │ _______________________________________________________________  │  │
+│  └──────────────────────────────────────────────────────────────────┘  │
+│                                                                         │
+│  ┌── notebook ───────────────────────────────────────────────────────┐ │
+│  │ [维修用料] [其他信息] [备注]                                       │ │
+│  │ ≡ │ 物料名称       │ 数量    │ 单价       │ 小计                 │ │
+│  │ ──┼────────────────┼─────────┼────────────┼─────────────────────│ │
+│  │ ≡ │ [物料名 ▼]     │ [___1]  │ [__0.00]   │ ¥0.00               │ │
+│  │   [添加一行]                                                      │ │
+│  │                                              维修总费用  ¥0.00    │ │
+│  └───────────────────────────────────────────────────────────────────┘ │
+│                                                                         │
+├── chatter ──────────────────────────────────────────────────────────────┤
+│  消息 / 活动 / 关注者                                                    │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+**字段说明**
+
+| 字段 | Widget | 备注 |
+|------|--------|------|
+| 工单编号 | `char` | 序号自动生成，不可编辑 |
+| 报修标题 | `char` | 必填，oe_title 大字显示 |
+| 报修设备 | `many2one` | 关联 maintenance.equipment，必填 |
+| 故障类别 | `selection` | 可选值：机械故障 / 电气故障 / 管道泄漏 / 其他 |
+| 报修人 | `many2one_avatar` | 默认当前用户 |
+| 紧急程度 | `priority` | 0-3 星，默认 0 |
+| 报修日期 | `date` | 默认今天 |
+| 计划维修 | `date` | 选填，维修中状态才可编辑 |
+| 完成日期 | `date` | 只读，完成时自动填入 |
+| 维修负责人 | `many2one_avatar` | 关联 res.users |
+| 故障描述 | `text` | 多行文本，放在 group 下方单独一行 |
+| 明细行 > 物料名称 | `many2one` | 关联 product.product |
+| 明细行 > 数量 | `float` | 默认 1 |
+| 明细行 > 单价 | `monetary` | — |
+| 明细行 > 小计 | `monetary` | 只读，数量 × 单价 |
+| 维修总费用 | `monetary` | 只读，汇总明细行小计 |
+
+**操作按钮**
+
+| 按钮 | 显示条件 | 行为 |
+|------|----------|------|
+| [提交报修] | 草稿状态 | 状态→已报修，通知维修负责人 |
+| [开始维修] | 已报修，且当前用户是维修负责人 | 状态→维修中 |
+| [完成] | 维修中 | 状态→已完成，自动填入完成日期 |
+| [取消] | 非已完成状态 | 状态→已取消 |
+
+**状态栏**：statusbar 显示 `草稿 → 已报修 → 维修中 → 已完成`。已取消不显示在状态栏。
+
+---
+
+## List 视图
+
+```
+┌── 列头 ─────────────────────────────────────────────────────────────────┐
+│ ☐ │ 工单编号    │ 报修标题  │ 报修设备  │紧急│报修人│维修费用 │ 状态   │⇅│
+├─────────────────────────────────────────────────────────────────────────┤
+│ ☐ │ MR/2026/003│ XXXXX    │ XXXXX     │★★☆│ [👤] │ ¥2,800 │[维修中]│  │
+│ ☐ │ MR/2026/002│ XXXXX    │ XXXXX     │★☆☆│ [👤] │ ¥0     │[已报修]│  │
+│ ☐ │ MR/2026/001│ XXXXX    │ XXXXX     │★★★│ [👤] │ ¥5,100 │[已完成]│  │
+├── 合计 ─────────────────────────────────────────────────────────────────┤
+│                                                    ¥7,900              │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+**列说明**
+
+| 列 | Widget | 备注 |
+|----|--------|------|
+| 工单编号 | `char` | 默认降序 |
+| 报修标题 | `char` | — |
+| 报修设备 | `many2one` | — |
+| 紧急程度 | `priority` | 星级显示 |
+| 报修人 | `many2one_avatar` | 只显示头像 |
+| 维修费用 | `monetary` | 列底部显示合计 |
+| 状态 | `badge` | 草稿=灰，已报修=蓝，维修中=黄，已完成=绿，已取消=红 |
+
+---
+
+## Kanban 视图
+
+**卡片线框图**
+
+```
+┌──────────────────────────┐
+│ ★★☆  MR/2026/003        │
+│ 空压机异响需检修          │
+│ 设备: 3号空压机           │
+│ 报修: 2026-03-15         │
+│──────────────────────────│
+│ [👤 张三]            ⋮  │
+└──────────────────────────┘
+```
+
+**卡片字段说明**
+
+| 字段 | Widget | 位置 | 备注 |
+|------|--------|------|------|
+| 紧急程度 | `priority` | 主体（标题行左侧）| 星级 |
+| 工单编号 | `char` | 主体（标题行右侧）| — |
+| 报修标题 | `char` | 主体 | 加粗，主识别信息 |
+| 报修设备 | `many2one` | 主体 | — |
+| 报修日期 | `date` | 主体 | — |
+| 报修人 | `many2one_avatar` | footer | 显示头像 + 姓名 |
+
+**列/阶段说明**
+
+分组字段：`state`，按以下值分列：
+
+| 列名 | 含义 |
+|------|------|
+| 草稿 | 新建，未提交 |
+| 已报修 | 已提交，等待维修人员接单 |
+| 维修中 | 维修人员正在处理 |
+| 已完成 | 维修完毕 |
+
+- 卡片可拖拽在列间移动
+- 已取消不作为列显示（异常态）
+
+---
+
+## Search 视图
+
+```
+🔍 [工单编号 / 报修标题 / 设备名称                  ]            [▲]
+
+  ┌── 筛选 ──────────────┬── 分组方式 ──────────┬── 收藏夹 ──────────┐
+  │   我报修的           │  按设备              │  保存当前搜索 ▼    │
+  │   我负责的           │  按故障类别           │                    │
+  │ ──────────────────   │  按负责人            │                    │
+  │   待处理             │  按月份              │                    │
+  │   维修中             │                      │                    │
+  │   已完成             │                      │                    │
+  │ ──────────────────   │                      │                    │
+  │   本月               │                      │                    │
+  │   本季度             │                      │                    │
+  └──────────────────────┴──────────────────────┴────────────────────┘
+```
+
+**搜索字段**：输入关键词时匹配以下字段：
+- 工单编号（name）
+- 报修标题（title）
+- 设备名称（equipment_id.name）
+
+**筛选器**
+
+| 标签 | 过滤条件 | 所在组 |
+|------|---------|-------|
+| 我报修的 | 当前用户是报修人 | 组1 |
+| 我负责的 | 当前用户是维修负责人 | 组1 |
+| 待处理 | 状态=已报修 | 组2 |
+| 维修中 | 状态=维修中 | 组2 |
+| 已完成 | 状态=已完成 | 组2 |
+| 本月 | 报修日期在本月内 | 组3 |
+| 本季度 | 报修日期在本季度内 | 组3 |
+
+> 组1 内 OR；组2 内 OR；组3 内 OR；三组之间 AND。
+
+**分组依据**
+
+| 标签 | 字段 |
+|------|------|
+| 按设备 | equipment_id |
+| 按故障类别 | category |
+| 按负责人 | assigned_to |
+| 按月份 | date_reported:month |
+
+---
+
+## 菜单结构
+
+```
+设备管理
+└── 报修工单
+    ├── 我报修的       → 过滤当前用户是报修人，默认 List
+    ├── 待处理工单     → 过滤状态=已报修，默认 Kanban
+    ├── 维修排期       → 默认 Calendar（仅维修人员+管理员可见）
+    └── 全部工单       → 无过滤，默认 List（仅设备管理员可见）
+```
+
+---
+
+## Pivot 视图
+
+**默认布局：**
+- 行：报修设备（equipment_id）
+- 列：报修日期按月（date_reported:month）
+- 度量：维修总费用（total_cost, sum）
+
+**度量字段**
+
+| 度量 | 字段 | 聚合 | 说明 |
+|------|------|------|------|
+| 维修总费用 | total_cost | sum | 默认显示 |
+| 工单数 | __count | count | — |
+
+**分组维度**
+
+| 维度 | 字段 | 用法 |
+|------|------|------|
+| 设备 | equipment_id | 行分组（默认） |
+| 故障类别 | category | 行分组 |
+| 报修日期 | date_reported | 列分组（按月，默认） |
+| 维修负责人 | assigned_to | 行分组 |
+
+---
+
+## Graph 视图
+
+**默认图表：** 柱状图
+
+**字段配置**
+
+| 字段 | 角色 | 说明 |
+|------|------|------|
+| date_reported | X 轴（按月分组） | 时间维度 |
+| total_cost | Y 轴（度量，sum） | 费用汇总 |
+| category | 分组（颜色区分） | 按故障类别分色 |
+
+**推荐图表组合：**
+- 柱状图：按月统计维修费用
+- 饼图：故障类别分布占比
+- 折线图：月度维修数量趋势
+
+---
+
+## Calendar 视图
+
+**日期字段：** date_scheduled（计划维修日期）
+**卡片标题：** title（报修标题）
+**颜色分组：** assigned_to（按维修负责人分色）
+**默认模式：** week
+
+**卡片显示字段**
+
+| 字段 | 说明 |
+|------|------|
+| title | 事件标题 |
+| equipment_id | 副标题（设备名） |
+| priority | 紧急程度星级 |
+
+---
+
+## 继承视图示例：在采购订单上关联报修工单
+
+当报修产生采购需求时，在 purchase.order 上关联来源报修工单。
+
+### 继承：purchase.order Form 视图
+
+**基础视图来源：** purchase.purchase_order_form
+
+#### 变更清单
+
+| 操作 | 参考位置 | 内容 | 说明 |
+|------|----------|------|------|
+| 新增字段 | partner_id 之后 | maintenance_request_id | widget=many2one，标签"来源报修工单"，invisible="not maintenance_request_id" |
+| 新增 smart button | button_box 内 | [🔧 报修工单] | 点击跳转到关联的报修工单，invisible="not maintenance_request_id" |
+
+### 继承：purchase.order List 视图
+
+**基础视图来源：** purchase.purchase_order_list_with_onboarding
+
+#### 变更清单
+
+| 操作 | 参考位置 | 内容 | 说明 |
+|------|----------|------|------|
+| 新增列 | state 之前 | maintenance_request_id | optional="hide"（默认隐藏，用户可通过 ⇅ 开启） |

package/payload/skills/view-spec/references/analytics-templates.md

@@ -0,0 +1,161 @@
+# 分析视图规格模板（Pivot / Graph / Calendar）
+
+这几种视图结构简单，**不需要 ASCII 线框图**，用文字描述 + 字段表即可。
+
+---
+
+## Pivot 视图（透视表）
+
+### 什么时候用
+
+管理员/分析师需要多维度交叉统计时。典型场景：按设备×月份统计维修费用、按客户×产品统计销售额。
+
+### 输出格式
+
+```markdown
+### Pivot 视图
+
+**默认布局：**
+- 行：{分组字段}（如设备、客户）
+- 列：{时间字段}:month（如报修日期按月）
+- 度量：{数值字段}（如维修总费用、数量）
+
+**度量字段**
+
+| 度量 | 字段 | 聚合 | 说明 |
+|------|------|------|------|
+| 维修总费用 | total_cost | sum | 默认显示 |
+| 工单数 | __count | count | — |
+
+**分组维度**
+
+| 维度 | 字段 | 用法 |
+|------|------|------|
+| 设备 | equipment_id | 行分组 |
+| 故障类别 | category | 行分组 |
+| 报修日期 | date_reported | 列分组（按月/季/年） |
+| 维修负责人 | assigned_to | 行分组 |
+```
+
+### 关键属性
+
+| 属性 | 说明 | 示例 |
+|------|------|------|
+| `default_order` | 默认排序 | `total_cost desc` |
+| `disable_linking` | 禁止点击单元格跳转到明细 | `disable_linking="True"` |
+| `display_quantity` | 显示数量列 | `display_quantity="True"` |
+| 字段 `type="measure"` | 标记为度量 | 数值类字段 |
+| 字段 `type="row"` | 默认行分组 | 维度字段 |
+| 字段 `type="col"` | 默认列分组 | 通常是时间字段 |
+
+---
+
+## Graph 视图（图表）
+
+### 什么时候用
+
+需要可视化趋势、分布、占比时。典型场景：维修数量月度趋势折线图、故障类别分布饼图。
+
+### 图表类型
+
+| 类型 | 属性值 | 适用场景 |
+|------|--------|---------|
+| 柱状图 | `type="bar"` | 分类对比（默认） |
+| 折线图 | `type="line"` | 时间趋势 |
+| 饼图 | `type="pie"` | 占比分布 |
+
+### 输出格式
+
+```markdown
+### Graph 视图
+
+**默认图表：** 柱状图
+
+**字段配置**
+
+| 字段 | 角色 | 说明 |
+|------|------|------|
+| date_reported | X 轴（按月分组） | 时间维度 |
+| total_cost | Y 轴（度量，sum） | 费用汇总 |
+| category | 分组（颜色区分） | 按故障类别分色 |
+
+**推荐图表组合：**
+- 柱状图：按月统计维修费用（X=月份，Y=费用，分色=故障类别）
+- 饼图：故障类别占比
+- 折线图：月度维修数量趋势
+```
+
+### 关键属性
+
+| 属性 | 说明 |
+|------|------|
+| `type` | bar / line / pie |
+| `stacked` | 堆叠模式（仅 bar/line），`stacked="True"` |
+| `cumulative` | 累计模式（仅 line），`cumulative="True"` |
+| `order` | 排序，如 `order="desc"` |
+| 字段 `type="row"` | X 轴 / 分组维度 |
+| 字段 `type="measure"` | Y 轴 / 度量 |
+
+---
+
+## Calendar 视图（日历）
+
+### 什么时候用
+
+记录有日期/时间维度，需要在日历上查看排期时。典型场景：计划维修日期排期、服务预约日历。
+
+### 输出格式
+
+```markdown
+### Calendar 视图
+
+**日期字段：** date_scheduled（计划维修日期）
+**结束日期：**（无，单日事件）
+**卡片标题：** title（报修标题）
+**颜色分组：** assigned_to（按维修负责人分色）
+
+**卡片显示字段**
+
+| 字段 | 说明 |
+|------|------|
+| title | 显示为事件标题 |
+| equipment_id | 副标题 |
+| assigned_to | 颜色区分 |
+| priority | 显示在卡片上 |
+```
+
+### 关键属性
+
+| 属性 | 说明 | 示例 |
+|------|------|------|
+| `date_start` | 开始日期/时间字段 | `date_start="date_scheduled"` |
+| `date_stop` | 结束日期/时间字段（可选） | `date_stop="date_end"` |
+| `date_delay` | 持续时长（小时，替代 date_stop） | `date_delay="duration"` |
+| `color` | 颜色分组字段 | `color="assigned_to"` |
+| `mode` | 默认视图模式 | `month` / `week` / `day` |
+| `event_open_popup` | 点击事件弹窗编辑 | `event_open_popup="True"` |
+| `quick_create` | 点击空白区域快速创建 | `quick_create="True"` |
+| `all_day` | 全天事件字段 | `all_day="is_all_day"` |
+
+---
+
+## 与 Form/List/Search 的配合
+
+分析视图通常不独立存在，而是作为现有 action 的附加视图模式：
+
+```markdown
+### 菜单 Action 视图模式
+
+| 菜单项 | 视图模式 |
+|--------|---------|
+| 全部工单 | list, kanban, form, pivot, graph |
+| 维修排期 | calendar, list, form |
+```
+
+用户在页面右上角通过视图切换图标切换。不需要为 Pivot/Graph/Calendar 单独创建菜单。
+
+### 共用 Search 视图
+
+Pivot/Graph/Calendar 共用同一个 Search 视图的筛选器和分组。设计 Search 时要考虑分析视图的需求：
+- 时间筛选（本月/本季度/本年）对 Pivot/Graph 很重要
+- 分组维度要跟 Pivot 的行/列分组一致