@deppon/deppon-prd-mcp 0.1.1 → 2.5.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (27) hide show
  1. package/README.md +53 -26
  2. package/dist/core/canvas-handoff.d.ts +72 -0
  3. package/dist/core/canvas-handoff.js +238 -0
  4. package/dist/core/prd-generator.js +3 -9
  5. package/dist/core/project-store.d.ts +12 -0
  6. package/dist/core/project-store.js +17 -0
  7. package/dist/core/prototype-generator.d.ts +1 -1
  8. package/dist/core/prototype-generator.js +93 -89
  9. package/dist/core/prototype-layout.d.ts +13 -0
  10. package/dist/core/prototype-layout.js +219 -0
  11. package/dist/core/tldraw-wireframe.d.ts +11 -0
  12. package/dist/core/tldraw-wireframe.js +205 -0
  13. package/dist/core/types.d.ts +52 -0
  14. package/dist/core/types.js +13 -4
  15. package/dist/http/server.js +12 -1
  16. package/dist/mcp/server.js +59 -2
  17. package/package.json +6 -3
  18. package/templates/examples/README.md +8 -8
  19. package/templates/examples/app-shell-navigation/layout-spec.md +21 -21
  20. package/templates/examples/app-shell-navigation/prd.md +56 -56
  21. package/templates/examples/backend-list/prd.md +32 -32
  22. package/templates/examples/data-dashboard/prd.md +46 -46
  23. package/templates/examples/form-edit/prd.md +33 -33
  24. package/templates/examples/form-preview/prd.md +21 -21
  25. package/templates/examples/user-frontend/prd.md +19 -19
  26. package/web/app.js +80 -45
  27. package/web/index.html +2 -2
package/templates/examples/app-shell-navigation/prd.md CHANGED
@@ -16,13 +16,13 @@
16
16
 
17
17
  ### 1.2 功能清单
18
18
 
19
- | 模块 | 功能点 | 功能描述 |
20
- | -------- | -------- | -------- |
21
- | 壳层原型 | 全局布局 | 侧栏 180px / 收起 56px、顶栏 56px、主区与周边 16px 间距、底边距 24px |
22
- | 壳层原型 | 侧栏导航 | 一级展开二级；悬停二级「应用市场」类项展示三级飞层；收起仅图标 |
23
- | 壳层原型 | 顶栏页签 | 顶栏右侧占位；可选页签条与 iframe 地址同步（本示例为简化静态页签） |
19
+ | 模块 | 功能点 | 功能描述 |
20
+ | -------- | -------- | --------------------------------------------------------------------------------- |
21
+ | 壳层原型 | 全局布局 | 侧栏 180px / 收起 56px、顶栏 56px、主区与周边 16px 间距、底边距 24px |
22
+ | 壳层原型 | 侧栏导航 | 一级展开二级；悬停二级「应用市场」类项展示三级飞层；收起仅图标 |
23
+ | 壳层原型 | 顶栏页签 | 顶栏右侧占位；可选页签条与 iframe 地址同步（本示例为简化静态页签） |
24
24
  | 壳层原型 | 子页承载 | `pages/demo-home.html` / `demo-list.html` / `demo-form.html` 在主页 iframe 内打开 |
25
- | 壳层原型 | PRD 标注 | 壳层区块琥珀色标注弹框，切片本 `prd.md`（与技能技术约定一致） |
25
+ | 壳层原型 | PRD 标注 | 壳层区块琥珀色标注弹框，切片本 `prd.md`（与技能技术约定一致） |
26
26
 
27
27
  ---
28
28
 
@@ -34,17 +34,17 @@
34
34
 
35
35
  **菜单树（示例）**：
36
36
 
37
- - 工作台 → `pages/demo-home.html`
38
- - 产品管理（一级）
39
- - 折扣与价格（二级）
40
- - 产品折扣列表（三级）→ `pages/demo-list.html`
41
- - 新建折扣（演示）（三级）→ `pages/demo-form.html`
37
+ - 工作台 → `pages/demo-home.html`
38
+ - 产品管理（一级）
39
+ - 折扣与价格（二级）
40
+ - 产品折扣列表（三级）→ `pages/demo-list.html`
41
+ - 新建折扣（演示）（三级）→ `pages/demo-form.html`
42
42
 
43
43
  ### 2.2 权限规划
44
44
 
45
- | 权限点 | 操作范围 | 数据范围 |
46
- | ------ | -------- | -------- |
47
- | 查看 | 浏览壳层、打开示例子页 | 示例无鉴权 |
45
+ | 权限点 | 操作范围 | 数据范围 |
46
+ | ------ | ---------------------------------- | ------------------- |
47
+ | 查看 | 浏览壳层、打开示例子页 | 示例无鉴权 |
48
48
  | 编辑 | 真实项目中对子页编辑入口的显示控制 | 以 UUMS / RBAC 为准 |
49
49
 
50
50
  ---
@@ -53,22 +53,22 @@
53
53
 
54
54
  ### 3.1 尺寸与间距
55
55
 
56
- | 区域 | 规格 | 说明 |
57
- | ---- | ---- | ---- |
58
- | 侧栏宽度（展开） | 180px | 与视觉稿「首页栅格」侧栏一致 |
59
- | 侧栏宽度（收起） | 56px | 仅图标；悬停 Tooltip 菜单名 |
60
- | 顶栏高度 | 56px | 固定 |
61
- | 主区与侧栏间距 | 16px | `gap` 实现 |
62
- | 顶栏与主区间距 | 16px | 顶栏底到主区顶 |
63
- | 主区内模块间距 | 16px | 卡片间距 |
64
- | 页面底边距 | 24px | 主区 `padding-bottom` |
65
- | 栅格体系 | 24 栅格 | 主区内逻辑栅格，用于首页分栏比例 |
56
+ | 区域 | 规格 | 说明 |
57
+ | ---------------- | ------- | -------------------------------- |
58
+ | 侧栏宽度（展开） | 180px | 与视觉稿「首页栅格」侧栏一致 |
59
+ | 侧栏宽度（收起） | 56px | 仅图标；悬停 Tooltip 菜单名 |
60
+ | 顶栏高度 | 56px | 固定 |
61
+ | 主区与侧栏间距 | 16px | `gap` 实现 |
62
+ | 顶栏与主区间距 | 16px | 顶栏底到主区顶 |
63
+ | 主区内模块间距 | 16px | 卡片间距 |
64
+ | 页面底边距 | 24px | 主区 `padding-bottom` |
65
+ | 栅格体系 | 24 栅格 | 主区内逻辑栅格，用于首页分栏比例 |
66
66
 
67
67
  ### 3.2 主工作区栅格
68
68
 
69
- - **顶通栏**：占满主区宽；放 KPI 卡片区（演示）。
70
- - **下区左列**：约 **16/24** 栅格（2/3）；列表或主内容。
71
- - **下区右列**：约 **8/24** 栅格（1/3）；快捷说明或辅信息。
69
+ - **顶通栏**：占满主区宽；放 KPI 卡片区（演示）。
70
+ - **下区左列**：约 **16/24** 栅格（2/3）；列表或主内容。
71
+ - **下区右列**：约 **8/24** 栅格（1/3）；快捷说明或辅信息。
72
72
 
73
73
  ---
74
74
 
@@ -76,36 +76,36 @@
76
76
 
77
77
  ### 4.1 一级菜单
78
78
 
79
- | 项 | 说明 |
80
- | -- | ---- |
81
- | 行高 | 52px（与侧栏导航规范图一致） |
79
+ | 项 | 说明 |
80
+ | -------- | -------------------------------------------------------------- |
81
+ | 行高 | 52px（与侧栏导航规范图一致） |
82
82
  | 水平留白 | 左 18px、图标与文案 8px、右 18px（示意，原型用 Tailwind 近似） |
83
- | 展开指示 | 右侧 chevron；展开后背景浅蓝、图标主色 |
84
- | 选中态 | 浅蓝底 + 主色图标 |
83
+ | 展开指示 | 右侧 chevron；展开后背景浅蓝、图标主色 |
84
+ | 选中态 | 浅蓝底 + 主色图标 |
85
85
 
86
86
  ### 4.2 二级菜单
87
87
 
88
- - 点击一级展开二级；本示例**不强制手风琴**（可同时展开多组，可按产品改为互斥）。
88
+ - 点击一级展开二级；本示例**不强制手风琴**（可同时展开多组，可按产品改为互斥）。
89
89
 
90
90
  ### 4.3 三级菜单（飞层）
91
91
 
92
- - **触发**：鼠标悬停带三级的二级项，右侧浮出白卡片列表；点击三级项在 iframe 打开对应 `pages/*.html`。
93
- - **关闭**：鼠标移出飞层区域后收起；`Esc` 关闭飞层（与焦点管理以最终实现为准）。
92
+ - **触发**：鼠标悬停带三级的二级项，右侧浮出白卡片列表；点击三级项在 iframe 打开对应 `pages/*.html`。
93
+ - **关闭**：鼠标移出飞层区域后收起；`Esc` 关闭飞层（与焦点管理以最终实现为准）。
94
94
 
95
95
  ### 4.4 收起导航
96
96
 
97
- - 侧栏右缘中部 **◀/▶** 切换；收起宽度 56px。
98
- - 当前一级在收起态下以 **蓝色描边图标底** 表示 active（示意）。
97
+ - 侧栏右缘中部 **◀/▶** 切换；收起宽度 56px。
98
+ - 当前一级在收起态下以 **蓝色描边图标底** 表示 active（示意）。
99
99
 
100
100
  ---
101
101
 
102
102
  ## 5. 顶栏与页签区
103
103
 
104
- | 元素 | 行为与内容 |
105
- | ---- | ---------- |
106
- | 产品名 | 左侧品牌区展示「PRD 文档中心 / 交互原型」（简体中文） |
107
- | 页签 | 本示例为静态标签：工作台 / 列表 / 表单；点击同步切换 iframe `src` |
108
- | 右侧区 | 搜索框、通知、用户头像为占位，无真实逻辑 |
104
+ | 元素 | 行为与内容 |
105
+ | ------ | ----------------------------------------------------------------- |
106
+ | 产品名 | 左侧品牌区展示「PRD 文档中心 / 交互原型」（简体中文） |
107
+ | 页签 | 本示例为静态标签：工作台 / 列表 / 表单；点击同步切换 iframe `src` |
108
+ | 右侧区 | 搜索框、通知、用户头像为占位，无真实逻辑 |
109
109
 
110
110
  ---
111
111
 
@@ -137,28 +137,28 @@ examples/app-shell-navigation/
137
137
 
138
138
  ## 8. 无障碍与响应式
139
139
 
140
- - 侧栏折叠：`aria-expanded` 绑定在折叠按钮。
141
- - 飞层：原型使用 `role="navigation"` 与 `aria-hidden` 切换；生产应对齐组件库焦点策略。
142
- - **本期**：桌面优先；小屏策略可后续补充「抽屉侧栏」。
140
+ - 侧栏折叠：`aria-expanded` 绑定在折叠按钮。
141
+ - 飞层：原型使用 `role="navigation"` 与 `aria-hidden` 切换；生产应对齐组件库焦点策略。
142
+ - **本期**：桌面优先；小屏策略可后续补充「抽屉侧栏」。
143
143
 
144
144
  ---
145
145
 
146
146
  ## 9. 原型与 PRD 对应关系
147
147
 
148
- | PRD 章节 | prototype.html 演示点 |
149
- | -------- | ---------------------- |
150
- | §3 | 侧栏宽、顶栏高、主区 `pb-6` 与间距 |
151
- | §4.1–4.2 | 一级展开、二级列表 |
152
- | §4.3 | 「折扣与价格」下悬停二级出现三级飞层 |
153
- | §4.4 | 折叠按钮切换 180px / 56px |
154
- | §5 | 顶栏 + 页签条切换 iframe |
155
- | §6 | 各链接打开 `pages/` 下不同 HTML |
156
- | 走查说明 | 左下角「标注说明」→ 切片本文件 §9 |
148
+ | PRD 章节 | prototype.html 演示点 |
149
+ | -------- | ------------------------------------ |
150
+ | §3 | 侧栏宽、顶栏高、主区 `pb-6` 与间距 |
151
+ | §4.1–4.2 | 一级展开、二级列表 |
152
+ | §4.3 | 「折扣与价格」下悬停二级出现三级飞层 |
153
+ | §4.4 | 折叠按钮切换 180px / 56px |
154
+ | §5 | 顶栏 + 页签条切换 iframe |
155
+ | §6 | 各链接打开 `pages/` 下不同 HTML |
156
+ | 走查说明 | 左下角「标注说明」→ 切片本文件 §9 |
157
157
 
158
158
  ---
159
159
 
160
160
  ## 10. 修订记录
161
161
 
162
- | 版本 | 日期 | 说明 |
163
- | ---- | ---- | ---- |
162
+ | 版本 | 日期 | 说明 |
163
+ | ---- | ---------- | ----------------------------------- |
164
164
  | v0.1 | 2026-05-14 | 初版：栅格壳层 + iframe 多页 + 标注 |
package/templates/examples/backend-list/prd.md CHANGED
@@ -14,12 +14,12 @@
14
14
 
15
15
  ### 1.2 功能清单
16
16
 
17
- | 模块 | 功能点 | 功能描述 |
18
- | -------- | -------- | -------------------------------- |
19
- | 公告台账 | 条件查询 | 标题、类型、发布时间范围；查询/重置 |
20
- | 公告台账 | 列表展示 | 分页表格；发布时间降序默认 |
17
+ | 模块 | 功能点 | 功能描述 |
18
+ | -------- | ---------- | --------------------------------------------------------------------- |
19
+ | 公告台账 | 条件查询 | 标题、类型、发布时间范围；查询/重置 |
20
+ | 公告台账 | 列表展示 | 分页表格；发布时间降序默认 |
21
21
  | 公告台账 | 列表工具栏 | 「导出 CSV」置于列表卡片表头行右侧（与 `list-crud` 列表卡工具栏一致） |
22
- | 公告台账 | 导出 | 导出 CSV（可选，受导出权限控制） |
22
+ | 公告台账 | 导出 | 导出 CSV（可选，受导出权限控制） |
23
23
 
24
24
  ---
25
25
 
@@ -31,10 +31,10 @@
31
31
 
32
32
  ### 2.2 权限规划
33
33
 
34
- | 权限点 | 操作范围 | 数据范围 |
35
- | ------ | ---------------------------- | -------- |
36
- | 查看 | 列表、筛选、分页 | 全量 |
37
- | 导出 | 导出当前筛选结果 | 全量 |
34
+ | 权限点 | 操作范围 | 数据范围 |
35
+ | ------ | ---------------- | -------- |
36
+ | 查看 | 列表、筛选、分页 | 全量 |
37
+ | 导出 | 导出当前筛选结果 | 全量 |
38
38
 
39
39
  ---
40
40
 
@@ -44,25 +44,25 @@
44
44
 
45
45
  变更筛选后点击「查询」生效；「重置」恢复默认并回到第 1 页。
46
46
 
47
- | 筛选字段 | 类型 | 输入限制 | 匹配规则 |
48
- | :------- | :------- | :-------------- | :------- |
49
- | 标题 | 文本 | 1～128，trim | 模糊 |
47
+ | 筛选字段 | 类型 | 输入限制 | 匹配规则 |
48
+ | :------- | :------- | :----------------- | :------- |
49
+ | 标题 | 文本 | 1 ～ 128，trim | 模糊 |
50
50
  | 公告类型 | 下拉 | 全部 / 系统 / 活动 | 精准 |
51
- | 发布时间 | 日期范围 | 起止合法 | 范围 |
51
+ | 发布时间 | 日期范围 | 起止合法 | 范围 |
52
52
 
53
- - **查询** / **重置**：同上。筛选区底部不放「导出」。
53
+ - **查询** / **重置**：同上。筛选区底部不放「导出」。
54
54
 
55
55
  ### 3.2 数据列表
56
56
 
57
- | 列表字段 | 字段说明 | 排序 |
58
- | :------- | :--------- | :--- |
59
- | 标题 | 公告标题 | 否 |
60
- | 类型 | 系统/活动 | 是 |
61
- | 发布时间 | 发布时间 | 是 |
62
- | 发布人 | 操作账号 | 否 |
57
+ | 列表字段 | 字段说明 | 排序 |
58
+ | :------- | :-------- | :--- |
59
+ | 标题 | 公告标题 | 否 |
60
+ | 类型 | 系统/活动 | 是 |
61
+ | 发布时间 | 发布时间 | 是 |
62
+ | 发布人 | 操作账号 | 否 |
63
63
 
64
- - **分页**：默认 10 条；可切换 10 / 20 / 50。
65
- - **行操作**：本示例页**无**编辑/删除行操作；跳转详情若做则为另页路由（不在本模板最小范围）。
64
+ - **分页**：默认 10 条；可切换 10 / 20 / 50。
65
+ - **行操作**：本示例页**无**编辑/删除行操作；跳转详情若做则为另页路由（不在本模板最小范围）。
66
66
 
67
67
  ### 3.2.1 列表工具栏（表头操作区）
68
68
 
@@ -78,20 +78,20 @@
78
78
 
79
79
  ## 9. 原型与 PRD 对应关系
80
80
 
81
- | PRD 章节 | prototype.html 演示点 |
82
- | -------- | ---------------------- |
83
- | §1 | 页头「PRD §1」 |
84
- | §3.1 | 筛选区「PRD §3.1」+ 查询/重置 |
85
- | §3.2 | 表格区「PRD §3.2」+ 分页 |
81
+ | PRD 章节 | prototype.html 演示点 |
82
+ | -------- | -------------------------------------------- |
83
+ | §1 | 页头「PRD §1」 |
84
+ | §3.1 | 筛选区「PRD §3.1」+ 查询/重置 |
85
+ | §3.2 | 表格区「PRD §3.2」+ 分页 |
86
86
  | §3.2.1 | 列表表头右侧「导出 CSV」+「PRD §3.2·工具栏」 |
87
- | §4 | 「PRD §4」标注与导出 Toast |
88
- | 走查说明 | 左下角「标注说明」+ prd.md §9 原文联动 |
87
+ | §4 | 「PRD §4」标注与导出 Toast |
88
+ | 走查说明 | 左下角「标注说明」+ prd.md §9 原文联动 |
89
89
 
90
90
  ---
91
91
 
92
92
  ## 10. 修订记录
93
93
 
94
- | 版本 | 日期 | 说明 |
95
- | ---- | ---------- | ---- |
96
- | v0.1 | 2026-05-14 | 初版：对齐 backend-list 模板示例 |
94
+ | 版本 | 日期 | 说明 |
95
+ | ---- | ---------- | --------------------------------------- |
96
+ | v0.1 | 2026-05-14 | 初版：对齐 backend-list 模板示例 |
97
97
  | v0.2 | 2026-05-15 | 导出按钮迁至列表表头工具栏；补充 §3.2.1 |
package/templates/examples/data-dashboard/prd.md CHANGED
@@ -14,13 +14,13 @@
14
14
 
15
15
  ### 1.2 功能清单
16
16
 
17
- | 模块 | 功能点 | 功能描述 |
18
- | ------ | -------- | ------------------ |
19
- | 运营看板 | 筛选 | 日期、渠道类型 |
20
- | 运营看板 | 指标卡 | UV、转化率、消耗 |
21
- | 运营看板 | 趋势图 | 近 7 日转化趋势（示意） |
22
- | 运营看板 | 明细表 | 分渠道指标表 |
23
- | 运营看板 | 指标总览 | 全量指标清单表 |
17
+ | 模块 | 功能点 | 功能描述 |
18
+ | -------- | -------- | ----------------------- |
19
+ | 运营看板 | 筛选 | 日期、渠道类型 |
20
+ | 运营看板 | 指标卡 | UV、转化率、消耗 |
21
+ | 运营看板 | 趋势图 | 近 7 日转化趋势（示意） |
22
+ | 运营看板 | 明细表 | 分渠道指标表 |
23
+ | 运营看板 | 指标总览 | 全量指标清单表 |
24
24
 
25
25
  ---
26
26
 
@@ -32,10 +32,10 @@
32
32
 
33
33
  ### 2.2 权限规划
34
34
 
35
- | 权限点 | 操作范围 | 数据范围 |
36
- | ------ | ---------- | -------- |
37
- | 查看 | 看板全部模块 | 全量 |
38
- | 导出 | 导出明细（可选） | 全量 |
35
+ | 权限点 | 操作范围 | 数据范围 |
36
+ | ------ | ---------------- | -------- |
37
+ | 查看 | 看板全部模块 | 全量 |
38
+ | 导出 | 导出明细（可选） | 全量 |
39
39
 
40
40
  ---
41
41
 
@@ -45,39 +45,39 @@
45
45
 
46
46
  支持多维度组合筛选，变更后点击「查询」生效。
47
47
 
48
- | 筛选字段 | 类型 | 输入限制 | 匹配规则 |
49
- | :------- | :------- | :--------- | :------- |
50
- | 统计日期 | 单日选择 | 默认昨日 | 精准 |
51
- | 渠道类型 | 下拉 | 全部/付费/自然 | 精准 |
48
+ | 筛选字段 | 类型 | 输入限制 | 匹配规则 |
49
+ | :------- | :------- | :------------- | :------- |
50
+ | 统计日期 | 单日选择 | 默认昨日 | 精准 |
51
+ | 渠道类型 | 下拉 | 全部/付费/自然 | 精准 |
52
52
 
53
- - **查询** / **重置**：刷新卡片、图表与列表。
53
+ - **查询** / **重置**：刷新卡片、图表与列表。
54
54
 
55
55
  ### 3.2 核心指标卡说明
56
56
 
57
- - **指标列表**
57
+ - **指标列表**
58
58
 
59
- | 指标名称 | 业务价值 | 指标定义 |
60
- | :------- | :----------- | :----------------- |
61
- | 渠道 UV | 流量规模 | 统计日独立访客去重 |
62
- | 转化率 | 投放效率 | 订单数 / UV |
63
- | 消耗金额 | 成本控制 | 投放账户汇总消耗 |
59
+ | 指标名称 | 业务价值 | 指标定义 |
60
+ | :------- | :------- | :----------------- |
61
+ | 渠道 UV | 流量规模 | 统计日独立访客去重 |
62
+ | 转化率 | 投放效率 | 订单数 / UV |
63
+ | 消耗金额 | 成本控制 | 投放账户汇总消耗 |
64
64
 
65
- - **交互说明**：卡片数字与筛选联动；hover 显示环比（可选）。
65
+ - **交互说明**：卡片数字与筛选联动；hover 显示环比（可选）。
66
66
 
67
67
  ### 3.3 转化趋势说明
68
68
 
69
- - **图表描述**：以折线图展示近 7 日转化率（原型为占位块 + 图例）。
70
- - **图表指标列表**
69
+ - **图表描述**：以折线图展示近 7 日转化率（原型为占位块 + 图例）。
70
+ - **图表指标列表**
71
71
 
72
- | 指标名称 | 业务价值 | 指标定义 |
73
- | :------- | :------- | :----------- |
74
- | 日转化率 | 趋势监控 | 当日订单/UV |
72
+ | 指标名称 | 业务价值 | 指标定义 |
73
+ | :------- | :------- | :---------- |
74
+ | 日转化率 | 趋势监控 | 当日订单/UV |
75
75
 
76
- - **交互说明**：随筛选日期范围变化（本示例固定 7 日 mock）。
76
+ - **交互说明**：随筛选日期范围变化（本示例固定 7 日 mock）。
77
77
 
78
78
  ### 3.4 渠道明细列表
79
79
 
80
- - **列表字段**
80
+ - **列表字段**
81
81
 
82
82
  | 列表字段 | 字段说明 |
83
83
  | :------- | :--------- |
@@ -85,17 +85,17 @@
85
85
  | UV | 独立访客 |
86
86
  | 订单数 | 成交笔数 |
87
87
 
88
- - **交互说明**：支持按 UV 排序；导出见权限。
88
+ - **交互说明**：支持按 UV 排序；导出见权限。
89
89
 
90
90
  ---
91
91
 
92
92
  ## 4. 指标总览
93
93
 
94
- | 指标名称 | 筛选维度 | 数据来源 | 指标定义 |
95
- | -------- | ---------- | -------- | --------------- |
96
- | 渠道 UV | 日期、渠道类型 | 埋点+业务库 | 见 §3.2 |
97
- | 转化率 | 日期、渠道类型 | 计算指标 | 订单/UV |
98
- | 消耗金额 | 日期 | 财务接口 | 账户日汇总 |
94
+ | 指标名称 | 筛选维度 | 数据来源 | 指标定义 |
95
+ | -------- | -------------- | ----------- | ---------- |
96
+ | 渠道 UV | 日期、渠道类型 | 埋点+业务库 | 见 §3.2 |
97
+ | 转化率 | 日期、渠道类型 | 计算指标 | 订单/UV |
98
+ | 消耗金额 | 日期 | 财务接口 | 账户日汇总 |
99
99
 
100
100
  ---
101
101
 
@@ -109,19 +109,19 @@
109
109
 
110
110
  ## 9. 原型与 PRD 对应关系
111
111
 
112
- | PRD 章节 | prototype.html 演示点 |
113
- | -------- | ---------------------- |
114
- | §1 | 页头「PRD §1」 |
115
- | §3.1 | 筛选区「PRD §3.1」 |
116
- | §3.2～§3.4 | 卡片区、趋势占位、表格 |
117
- | §4 | 「PRD §4」指标总览说明 |
118
- | §5 | 全局交互说明入口 |
119
- | 走查说明 | 左下角「标注说明」 |
112
+ | PRD 章节 | prototype.html 演示点 |
113
+ | ----------- | ---------------------- |
114
+ | §1 | 页头「PRD §1」 |
115
+ | §3.1 | 筛选区「PRD §3.1」 |
116
+ | §3.2 ～§3.4 | 卡片区、趋势占位、表格 |
117
+ | §4 | 「PRD §4」指标总览说明 |
118
+ | §5 | 全局交互说明入口 |
119
+ | 走查说明 | 左下角「标注说明」 |
120
120
 
121
121
  ---
122
122
 
123
123
  ## 10. 修订记录
124
124
 
125
- | 版本 | 日期 | 说明 |
126
- | ---- | ---------- | ---- |
125
+ | 版本 | 日期 | 说明 |
126
+ | ---- | ---------- | ------------------------ |
127
127
  | v0.1 | 2026-05-14 | 初版：对齐 data 模板示例 |
package/templates/examples/form-edit/prd.md CHANGED
@@ -14,11 +14,11 @@
14
14
 
15
15
  ### 1.2 功能清单
16
16
 
17
- | 模块 | 功能点 | 功能描述 |
18
- | ------------ | -------- | ------------------------ |
19
- | 通知模板配置 | 表单编辑 | 字段录入与校验 |
20
- | 通知模板配置 | 保存提交 | 校验通过后提交接口 |
21
- | 通知模板配置 | 取消离开 | 有改动时二次确认 |
17
+ | 模块 | 功能点 | 功能描述 |
18
+ | ------------ | -------- | ------------------ |
19
+ | 通知模板配置 | 表单编辑 | 字段录入与校验 |
20
+ | 通知模板配置 | 保存提交 | 校验通过后提交接口 |
21
+ | 通知模板配置 | 取消离开 | 有改动时二次确认 |
22
22
 
23
23
  ---
24
24
 
@@ -30,10 +30,10 @@
30
30
 
31
31
  ### 2.2 权限规划
32
32
 
33
- | 权限点 | 操作范围 | 数据范围 |
34
- | ------ | ------------ | -------- |
33
+ | 权限点 | 操作范围 | 数据范围 |
34
+ | ------ | ---------------- | -------- |
35
35
  | 查看 | 进入页、查看表单 | 全量 |
36
- | 编辑 | 保存、修改字段 | 全量 |
36
+ | 编辑 | 保存、修改字段 | 全量 |
37
37
 
38
38
  ---
39
39
 
@@ -41,40 +41,40 @@
41
41
 
42
42
  ### 3.1 表单字段说明
43
43
 
44
- | 字段名称 | 字段类型 | 必填 | 默认值 | 校验规则 | 说明 |
45
- | ---------- | -------- | ---- | ------ | --------------- | -------------- |
46
- | 模板名称 | 文本 | 是 | 无 | 2～64 | 唯一展示名 |
47
- | 推送渠道 | 多选 | 是 | 站内信 | 至少选一项 | 站内信/邮件/短信 |
48
- | 标题前缀 | 文本 | 否 | 无 | 0～32 | 可选 |
49
- | 接收范围 | 下拉 | 是 | 全部用户 | 枚举 | 全部/按部门 |
44
+ | 字段名称 | 字段类型 | 必填 | 默认值 | 校验规则 | 说明 |
45
+ | -------- | -------- | ---- | -------- | ---------- | ---------------- |
46
+ | 模板名称 | 文本 | 是 | 无 | 2 ～ 64 | 唯一展示名 |
47
+ | 推送渠道 | 多选 | 是 | 站内信 | 至少选一项 | 站内信/邮件/短信 |
48
+ | 标题前缀 | 文本 | 否 | 无 | 0 ～ 32 | 可选 |
49
+ | 接收范围 | 下拉 | 是 | 全部用户 | 枚举 | 全部/按部门 |
50
50
 
51
51
  ### 3.2 字段详细说明
52
52
 
53
53
  #### 3.2.1 接收范围
54
54
 
55
- - **字段说明**：控制模板默认推送对象范围。
56
- - **输入限制**：枚举；与组织数据联动时以后端为准。
57
- - **校验规则**：必选。
58
- - **错误提示**：请选择接收范围。
55
+ - **字段说明**：控制模板默认推送对象范围。
56
+ - **输入限制**：枚举；与组织数据联动时以后端为准。
57
+ - **校验规则**：必选。
58
+ - **错误提示**：请选择接收范围。
59
59
 
60
60
  ### 3.3 字段联动逻辑
61
61
 
62
- | 触发字段 | 触发条件 | 影响字段 | 影响效果 |
63
- | -------- | ---------- | -------- | ------------ |
64
- | 接收范围 | 选择按部门 | 部门选择 | 显示且必填 |
62
+ | 触发字段 | 触发条件 | 影响字段 | 影响效果 |
63
+ | -------- | ------------ | -------- | ---------- |
64
+ | 接收范围 | 选择按部门 | 部门选择 | 显示且必填 |
65
65
  | 接收范围 | 选择全部用户 | 部门选择 | 隐藏并清空 |
66
66
 
67
67
  ### 3.4 操作按钮
68
68
 
69
69
  #### 3.4.1 保存/提交
70
70
 
71
- - **按钮位置**：表单底部右侧。
72
- - **点击逻辑**：前端校验 → 提交 → 成功 Toast → 可选留在本页。
71
+ - **按钮位置**：表单底部右侧。
72
+ - **点击逻辑**：前端校验 → 提交 → 成功 Toast → 可选留在本页。
73
73
 
74
74
  #### 3.4.2 取消
75
75
 
76
- - **按钮位置**：保存旁。
77
- - **点击逻辑**：有改动时确认离开；无改动直接返回列表（原型用 Toast 模拟）。
76
+ - **按钮位置**：保存旁。
77
+ - **点击逻辑**：有改动时确认离开；无改动直接返回列表（原型用 Toast 模拟）。
78
78
 
79
79
  ---
80
80
 
@@ -92,17 +92,17 @@
92
92
 
93
93
  ## 9. 原型与 PRD 对应关系
94
94
 
95
- | PRD 章节 | prototype.html 演示点 |
96
- | -------- | ---------------------- |
97
- | §1 | 页头「PRD §1」 |
98
- | §3.1～§3.4 | 表单卡片分区标注 + 保存/取消 |
99
- | §4 | 校验与 Toast 行为 |
100
- | 走查说明 | 左下角「标注说明」 |
95
+ | PRD 章节 | prototype.html 演示点 |
96
+ | ----------- | ---------------------------- |
97
+ | §1 | 页头「PRD §1」 |
98
+ | §3.1 ～§3.4 | 表单卡片分区标注 + 保存/取消 |
99
+ | §4 | 校验与 Toast 行为 |
100
+ | 走查说明 | 左下角「标注说明」 |
101
101
 
102
102
  ---
103
103
 
104
104
  ## 10. 修订记录
105
105
 
106
- | 版本 | 日期 | 说明 |
107
- | ---- | ---------- | ---- |
106
+ | 版本 | 日期 | 说明 |
107
+ | ---- | ---------- | ------------------------------------- |
108
108
  | v0.1 | 2026-05-14 | 初版：对齐 backend-form-edit 模板示例 |
package/templates/examples/form-preview/prd.md CHANGED
@@ -14,8 +14,8 @@
14
14
 
15
15
  ### 1.2 功能清单
16
16
 
17
- | 模块 | 功能点 | 功能描述 |
18
- | -------- | -------- | ------------------ |
17
+ | 模块 | 功能点 | 功能描述 |
18
+ | -------- | -------- | ---------------- |
19
19
  | 工单详情 | 信息展示 | 字段只读展示 |
20
20
  | 工单详情 | 编辑跳转 | 有编辑权限时展示 |
21
21
  | 工单详情 | 返回 | 返回上一页或列表 |
@@ -41,22 +41,22 @@
41
41
 
42
42
  ### 3.1 信息展示区域
43
43
 
44
- | 字段名称 | 展示格式 | 说明 |
45
- | -------- | ---------- | ---------- |
46
- | 工单号 | 等宽文本 | 主键展示 |
47
- | 状态 | 状态标签色 | 待处理/处理中/已关闭 |
48
- | 优先级 | 文本 | P1～P3 |
49
- | 创建时间 | YYYY-MM-DD HH:mm | — |
50
- | 问题描述 | 多行文本 | 保留换行 |
44
+ | 字段名称 | 展示格式 | 说明 |
45
+ | -------- | ---------------- | -------------------- |
46
+ | 工单号 | 等宽文本 | 主键展示 |
47
+ | 状态 | 状态标签色 | 待处理/处理中/已关闭 |
48
+ | 优先级 | 文本 | P1 ～ P3 |
49
+ | 创建时间 | YYYY-MM-DD HH:mm | — |
50
+ | 问题描述 | 多行文本 | 保留换行 |
51
51
 
52
52
  ### 3.2 字段详细说明
53
53
 
54
54
  #### 3.2.1 状态
55
55
 
56
- - **字段说明**：驱动 SLA 展示与按钮显隐。
57
- - **展示格式**：彩色标签。
58
- - **空值展示**：—
59
- - **特殊规则**：已关闭隐藏「编辑」。
56
+ - **字段说明**：驱动 SLA 展示与按钮显隐。
57
+ - **展示格式**：彩色标签。
58
+ - **空值展示**：—
59
+ - **特殊规则**：已关闭隐藏「编辑」。
60
60
 
61
61
  ### 3.3 操作按钮
62
62
 
@@ -90,17 +90,17 @@
90
90
  ## 9. 原型与 PRD 对应关系
91
91
 
92
92
  | PRD 章节 | prototype.html 演示点 |
93
- | -------- | ---------------------- |
94
- | §1 | 页头「PRD §1」 |
95
- | §3.1 | 详情区「PRD §3.1」 |
96
- | §3.3 | 操作栏「PRD §3.3」 |
97
- | §4 | 按钮点击 Toast 模拟 |
98
- | 走查说明 | 左下角「标注说明」 |
93
+ | -------- | --------------------- |
94
+ | §1 | 页头「PRD §1」 |
95
+ | §3.1 | 详情区「PRD §3.1」 |
96
+ | §3.3 | 操作栏「PRD §3.3」 |
97
+ | §4 | 按钮点击 Toast 模拟 |
98
+ | 走查说明 | 左下角「标注说明」 |
99
99
 
100
100
  ---
101
101
 
102
102
  ## 10. 修订记录
103
103
 
104
- | 版本 | 日期 | 说明 |
105
- | ---- | ---------- | ---- |
104
+ | 版本 | 日期 | 说明 |
105
+ | ---- | ---------- | ---------------------------------------- |
106
106
  | v0.1 | 2026-05-14 | 初版：对齐 backend-form-preview 模板示例 |