@deppon/deppon-skills 2.4.16 → 2.4.18

package/dist/deppon-prd-generator/template/backend-list-prd-template.md

@@ -0,0 +1,106 @@
+# [页面名称] PRD (产品需求文档)
+
+## 1. 引言
+
+### 1.1 背景
+
+> 简要说明该元素/页面的核心定位、解决的问题、用户价值（控制在50字左右）。
+
+```
+[需求背景内容]
+```
+
+### 1.2 功能清单
+
+> 以表格形式梳理出所有模块、功能点及功能描述。
+>
+> 功能清单不包含：页面顶栏、左侧菜单栏的样式、交互需求内容！
+
+| 模块             | 功能点         | 功能描述       |
+| ---------------- | -------------- | -------------- |
+| `[功能模块标题]` | `[功能点标题]` | `[功能点描述]` |
+
+## 2. 页面菜单与权限规划
+
+### 2.1 页面菜单
+
+> 参考菜单栏，描述页面菜单路径。仅描述菜单路径即可！不要做其他内容说明。
+
+**菜单路径**：[一级菜单名称] / [二级菜单名称]
+
+### 2.2 权限规划
+
+> 表格呈现权限点规划，仅定义权限点、可执行操作范围、数据范围（如：个人数据/全量数据），不定义具体角色；
+>
+> **权限点规划的基本原则：**查看类操作归集在【查看】一个权限点；编辑类操作归集在【编辑】一个权限点；导出类操作归集在【导出】一个权限点。
+
+| 权限点         | 操作范围           | 数据范围      |
+| -------------- | ------------------ | ------------- |
+| `[权限点名称]` | `[支持的操作名称]` | `[个人/全量]` |
+
+## 3. [模块名称]需求说明
+
+### 3.1 筛选查询区
+
+> 用表格呈现筛选字段、控件类型（如：文本输入/下拉选择/下拉多选/日期范围选择器等）、输入限制（明确长度/枚举值/默认值/必填性/其他条件依赖）、匹配规则（精准/模糊/范围）。
+
+支持多维度组合筛选，筛选条件变更后需点击"查询"按钮生效。
+
+| 筛选字段         | 类型         | 输入限制         | 匹配规则     |
+| :--------------- | :----------- | :--------------- | :----------- |
+| `[筛选字段名称]` | `[控件类型]` | `[输入限制内容]` | `[匹配规则]` |
+
+- **操作按钮**：
+
+  - **查询**：根据当前筛选条件刷新页面数据。
+
+  - **重置**：恢复所有筛选条件为默认值。
+
+### 3.2 数据列表
+
+> 按页面里列表形式的子模块循环撰写
+
+以列表形式，按需展示详细的数据表格。
+
+- **列表字段**：
+
+  | 列表字段     | 字段说明         | 排序 |
+  | :----------- | :--------------- | :--- |
+  | `[字段名称]` | `[字段定义描述]` | 是/否 |
+
+- **分页规则**：
+  - 每页默认显示：[X]条
+  - 可切换显示：[X/X/X]条
+  - 分页控件位置：列表底部
+
+- **批量操作**：
+  > 描述支持的批量操作，如批量删除、批量导出等
+
+  - **批量删除**：选中多条记录后点击删除，弹出二次确认
+
+- **行操作**：
+  > 描述每行支持的操作，如编辑、删除、查看详情等
+
+  - **编辑**：点击编辑按钮，跳转至编辑页面
+  - **删除**：点击删除按钮，弹出二次确认
+
+- **交互说明**：
+  > 简述数据列表的操作说明，包括导出/排序/行操作说明
+
+  - **排序**：点击表头排序图标，支持升序/降序切换
+  - **导出**：点击导出按钮，导出当前筛选条件下的全部数据（CSV格式）
+
+## 4. 交互设计
+
+### 4.1 全局交互
+
+- **加载状态**：数据请求过程中需展示 Loading 状态。
+- **空状态**：无数据时需展示统一的 Empty 状态图。
+- **响应式**：页面需适配不同分辨率屏幕，保证内容不遮挡、不错位。
+
+### 4.2 特殊交互
+
+> 描述页面中特殊的交互逻辑，如：
+> - 筛选条件联动
+> - 数据刷新机制
+> - 弹窗交互等

package/dist/deppon-prd-generator/template/data-prd-template.md

@@ -0,0 +1,190 @@
+# [页面名称] PRD (产品需求文档)
+
+## 1. 引言
+
+### 1.1 背景
+
+> 简要说明该元素/页面的核心定位、解决的问题、用户价值（控制在50字左右）。
+
+```
+[需求背景内容]
+```
+
+
+
+### 1.2 功能清单
+
+> 以表格形式梳理出所有模块、功能点及功能描述。
+>
+> 功能清单不包含：页面顶栏、左侧菜单栏的样式、交互需求内容！
+
+| 模块             | 功能点         | 功能描述       |
+| ---------------- | -------------- | -------------- |
+| `[功能模块标题]` | `[功能点标题]` | `[功能点描述]` |
+
+
+
+## 2. 页面菜单与权限规划
+
+### 2.1 页面菜单
+
+> 参考菜单栏，描述页面菜单路径。仅描述菜单路径即可！不要做其他内容说明。
+
+**菜单路径**：[一级菜单名称] / [二级菜单名称]
+
+
+
+### 2.2 权限规划
+
+> 表格呈现权限点规划，仅定义权限点、可执行操作范围、数据范围（如：个人数据/全量数据），不定义具体角色；
+>
+> **权限点规划的基本原则：**查看类操作归集在【查看】一个权限点；编辑类操作归集在【编辑】一个权限点；导出类操作归集在【导出】一个权限点。
+
+| 权限点         | 操作范围           | 数据范围      |
+| -------------- | ------------------ | ------------- |
+| `[权限点名称]` | `[支持的操作名称]` | `[个人/全量]` |
+
+
+
+## 3. [模块名称]需求说明
+
+> 按模块循环撰写
+
+
+
+### 3.1 筛选查询区
+
+> 用表格呈现筛选字段、控件类型（如：文本输入/下拉选择/下拉多选/日期范围选择器等）、输入限制（明确长度/枚举值/默认值/必填性/其他条件依赖）、匹配规则（精准/模糊/范围）。
+
+支持多维度组合筛选，筛选条件变更后需点击“查询”按钮生效。
+
+| 筛选字段         | 类型         | 输入限制         | 匹配规则     |
+| :--------------- | :----------- | :--------------- | :----------- |
+| `[筛选字段名称]` | `[控件类型]` | `[输入限制内容]` | `[匹配规则]` |
+
+- **操作按钮**：
+
+  - **查询**：根据当前筛选条件刷新页面数据。
+
+  - **重置**：恢复所有筛选条件为默认值。
+
+    
+
+### 3.2 [子模块标题]卡片说明
+
+> 按页面里卡片形式**的子模块循环撰写，请严格按照一个子模块一个说明的要求进行撰写，严禁对同类型模块进行合并描述！！！
+
+- **指标列表**：
+
+  > 用表格呈现卡片里展示业务指标的业务价值、指标定义
+
+  | 指标名称     | 业务价值         | 指标定义                            |
+  | :----------- | :--------------- | :---------------------------------- |
+  | `[指标名称]` | `[指标业务价值]` | `[指标具体的定义（取数逻辑/范围）]` |
+
+
+
+- **交互说明**：
+
+  > 简述指标卡片模块的交互说明
+
+
+
+### 3.3 [子模块名称]图表说明
+
+> 按页面里**图表形式**的每个子模块独立循环撰写，请严格按照一个子模块一个说明的要求进行撰写，不要对同类型模块进行合并描述！！！
+>
+> 请识别模块是否包含多个部分，如：即包含图表部分、又包含指标卡片部分，须对每个部分分别进行描述！！！不可遗漏某个部分。
+
+- **[图表名称]说明**：
+
+  > 描述图表模型的图表内容
+
+  - **图表描述**：以`[图标形式]`展示`[图片内容描述]`
+
+  - **图表指标列表**：
+
+    > 用表格呈现图表里展示所有业务指标的业务价值、指标定义，不要用概括性的语言。
+
+    | 指标名称     | 业务价值         | 指标定义                            |
+    | :----------- | :--------------- | :---------------------------------- |
+    | `[指标名称]` | `[指标业务价值]` | `[指标具体的定义（取数逻辑/范围）]` |
+
+  - **交互说明：**
+
+    > 简述数据列表的操作说明，包括导出/排序/行操作说明
+
+- **[指标卡片名称]说明**：
+
+  > 描述图表模块的指标卡片内容，梳理出所有指标清单，不要进行概括性总结，不要对指标有遗漏！！
+
+  - **卡片指标列表**：
+
+    | 指标名称     | 业务价值         | 指标定义                            |
+    | :----------- | :--------------- | :---------------------------------- |
+    | `[指标名称]` | `[指标业务价值]` | `[指标具体的定义（取数逻辑/范围）]` |
+
+  - **交互说明**：
+
+    > 简述数据列表的操作说明，包括导出/排序/行操作说明
+
+- **[数据列表名称]说明**：
+
+  > 描述图表模块的数据列表内容，梳理出所有列表字段清单，不要进行概括性总结，不要对字段有遗漏！！
+
+  - **列表字段**：
+
+    | 列表字段     | 字段说明         |
+    | :----------- | :--------------- |
+    | `[字段名称]` | `[字段定义描述]` |
+
+  - **交互说明**：
+
+    > 简述数据列表的操作说明，包括导出/排序/行操作说明
+
+
+
+### 3.4 [子模块名称]数据列表
+
+> 按页面里列表形式**的子模块循环撰写
+
+以列表形式，按需展示详细的数据表格。
+
+- **列表字段**：
+
+  | 列表字段     | 字段说明         |
+  | :----------- | :--------------- |
+  | `[字段名称]` | `[字段定义描述]` |
+
+  
+
+- **交互说明**：
+
+  > 简述数据列表的操作说明，包括导出/排序/行操作
+
+
+
+## 4. 指标总览
+
+> 以表格的形式，梳理出整个数据看板的全量指标清单（**包含所有子模块的所有指标, 包括卡片、图表、数据列表**），描述指标名称、指标筛选维度（日期/场景/终端/用户身份/等）、数据来源（埋点/业务数据）、指标定义（取数逻辑/范围）。
+>
+> **重点**：一定要全面梳理完整整个数据看板，数据研发需要加工的所有指标内容，该部分内容将作为数据研发的需求清单。整理出来的指标总览需要满足数据看板的全部需求！不可以有遗漏！不可以有遗漏！不可以有遗漏！重点关注：
+>
+> - 提取每个页面的每个子模块中的指标；
+> - 提取指标的范围包含：指标卡片、图表（饼图/折线图/漏斗/等）、数据列表的等
+>
+> 完成梳理后务必对比所有数据看板模块，仔细检查每个指标是否都已经囊括？如果没有囊括，请进行补充！！！确保没有遗漏！！！
+
+| 指标名称     | 筛选维度                     | 数据来源         | 指标定义           |
+| ------------ | ---------------------------- | ---------------- | ------------------ |
+| `[指标名称]` | `[筛选维度，用无序列表展示]` | `[指标数据来源]` | `[指标的具体定义]` |
+
+
+
+## 5. 交互设计
+
+### 5.1 全局交互
+
+- **加载状态**：数据请求过程中需展示 Loading 状态。
+- **空状态**：无数据时需展示统一的 Empty 状态图。
+- **响应式**：页面需适配不同分辨率屏幕，保证内容不遮挡、不错位。

package/dist/deppon-prd-generator/template/user-frontend-prd-template.md

@@ -0,0 +1,55 @@
+# [页面名称] PRD (产品需求文档)
+
+## 1. 引言
+
+### 1.1 背景
+
+> 简要说明该元素/页面的核心定位、解决的问题、用户价值（控制在50字左右）。
+
+```
+[需求背景内容]
+```
+
+### 1.2 用户角色
+
+> 简要说明不同类型的用户角色，包括但不限于：游客、个人用户、供方普通企业用户、供方会员企业用户、采方企业用户。
+
+| 用户角色 | 描述 | 使用场景 |
+|---------|------|---------|
+| `[角色1]` | `[角色描述]` | `[使用场景]` |
+| `[角色2]` | `[角色描述]` | `[使用场景]` |
+
+### 1.3 功能清单
+
+> 以表格形式梳理出所有模块、功能点及功能描述。
+
+| 模块             | 功能点         | 功能描述       |
+| ---------------- | -------------- | -------------- |
+| `[功能模块标题]` | `[功能点标题]` | `[功能点描述]` |
+
+
+## 2. [功能名称]需求说明
+
+> 按功能模块循环撰写
+
+### 2.1 [子模块名称]
+
+#### 2.1.1 功能描述
+
+> 详细描述该子模块的功能
+
+#### 2.1.2 交互流程
+
+> 描述用户操作流程，包括触发条件、操作步骤、反馈等
+
+1. **触发条件**：[用户操作，如点击按钮、进入页面等]
+2. **操作步骤**：
+   - 步骤1：[描述]
+   - 步骤2：[描述]
+3. **操作反馈**：
+   - 成功：[成功反馈，如弹窗提示、页面跳转等]
+   - 失败：[失败反馈，如错误提示等]
+
+### 2.2 [子模块名称]
+
+> 按同样格式描述其他子模块

package/dist/deppon-prd-generator/user-management/prd.md

@@ -0,0 +1,146 @@
+# 用户管理 PRD（产品需求文档）
+
+> **文档说明**：通用后台**用户管理**（列表 + 详情 + 新增/编辑 + 删除）标准需求；与同级 `prototype.html` 对齐走查。落地以实际接口与权限码为准。
+
+> **高保真原型**：同目录 `prototype.html`（Tailwind Play CDN + 原生 JS），可演示 §3 筛选与列表、§4 详情弹层、§5 新增/编辑弹层、删除确认与 Toast 模拟；数据为静态 mock。
+
+---
+
+## 1. 引言
+
+### 1.1 背景
+
+为系统管理员提供统一的用户账号管理能力：按条件检索、分页浏览、查看详情、创建与编辑用户、删除（含批量可选），保证数据可追溯、操作可审计。
+
+### 1.2 功能清单
+
+> 不包含：顶栏、侧栏菜单的样式与通用导航需求。
+
+| 模块     | 功能点   | 功能描述                                                 |
+| -------- | -------- | -------------------------------------------------------- |
+| 用户管理 | 条件查询 | 用户名、姓名、手机号、状态等；查询 / 重置              |
+| 用户管理 | 列表展示 | 分页表格；约定列可排序                                 |
+| 用户管理 | 查看详情 | 行内「查看」只读弹层                                   |
+| 用户管理 | 新增用户 | 「新增用户」打开表单弹层，校验后提交（原型为模拟成功） |
+| 用户管理 | 编辑用户 | 行内「编辑」回填表单；用户名只读（与 §5 一致）         |
+| 用户管理 | 删除用户 | 单行删除二次确认；可选批量删除                         |
+| 用户管理 | 状态控制 | 启用 / 禁用（与认证策略对齐）                          |
+
+---
+
+## 2. 页面菜单与权限规划
+
+### 2.1 页面菜单
+
+**菜单路径**：系统管理 / 用户管理
+
+### 2.2 权限规划
+
+| 权限点 | 操作范围                                         | 数据范围 |
+| ------ | ------------------------------------------------ | -------- |
+| 查看   | 列表、筛选、详情、分页、导出（若做）             | 全量     |
+| 编辑   | 新增、编辑、启用/禁用、删除、批量删除            | 全量     |
+
+---
+
+## 3. 用户列表需求说明
+
+### 3.1 筛选查询区
+
+变更筛选后点击「查询」生效；「重置」恢复默认并刷新第 1 页。
+
+| 筛选字段 | 类型     | 输入限制               | 匹配规则 |
+| :------- | :------- | :--------------------- | :------- |
+| 用户名   | 文本     | 1～64，trim            | 模糊     |
+| 姓名     | 文本     | 1～64                  | 模糊     |
+| 手机号   | 文本     | 数字，建议 11 位       | 精准     |
+| 用户状态 | 下拉     | 全部 / 启用 / 禁用     | 精准     |
+
+- **查询** / **重置**：见上文。
+- **新增用户**：需「编辑」权限；打开新增表单（弹层或路由）。
+
+### 3.2 数据列表
+
+| 列表字段     | 字段说明           | 排序 |
+| :----------- | :----------------- | :--- |
+| 用户名       | 登录账号，唯一     | 是   |
+| 姓名         | 展示名             | 否   |
+| 手机号       | 可脱敏             | 否   |
+| 部门         | 主部门             | 否   |
+| 用户状态     | 启用 / 禁用        | 是   |
+| 创建时间     | `YYYY-MM-DD HH:mm` | 是   |
+
+- **分页**：默认 10 条；可切换 10 / 20 / 50；底栏展示总数。
+- **行操作**：查看、编辑、删除（受权限）。
+- **批量删除**（可选）：多选 + 确认 + 接口。
+
+---
+
+## 4. 用户详情（只读）
+
+查看弹层展示：用户 ID、用户名、姓名、手机号、邮箱、部门、角色、状态、创建/更新时间（字段以接口为准）。
+
+---
+
+## 5. 新增 / 编辑表单
+
+| 字段     | 类型   | 必填 | 校验要点                     |
+| -------- | ------ | ---- | ---------------------------- |
+| 用户名   | 文本   | 是   | 4～64；编辑态只读            |
+| 姓名     | 文本   | 是   | 1～64                        |
+| 手机号   | 文本   | 是   | `^1[3-9]\d{9}$`              |
+| 邮箱     | 文本   | 否   | 邮箱格式                     |
+| 部门     | 选择   | 是   | 至少一项                     |
+| 角色     | 多选   | 是   | 至少一项                     |
+| 用户状态 | 单选   | 是   | 启用 / 禁用；新增默认启用   |
+
+**保存**：前端校验 → 提交接口 → 成功关闭并刷新列表。**取消**：有改动时二次确认。
+
+---
+
+## 6. 删除与审计
+
+单行删除确认文案建议含用户姓名；敏感操作建议后端审计日志。
+
+---
+
+## 7. 接口（逻辑分组）
+
+| 能力     | 说明           |
+| -------- | -------------- |
+| 分页查询 | 筛选 + 分页 + 排序 |
+| 详情     | userId         |
+| 创建     | POST body      |
+| 更新     | userId + 字段  |
+| 删除     | DELETE / 批量  |
+
+---
+
+## 8. 交互设计
+
+加载态、空态、防重复提交、列表与弹层焦点与 `aria-modal` 与组件库规范对齐。
+
+---
+
+## 9. 原型与 PRD 对应关系
+
+| PRD 章节   | prototype.html 演示点           |
+| ---------- | -------------------------------- |
+| §1         | 页头「PRD §1」标注入口           |
+| §2 / §3.1  | 列表标题行右侧「PRD §2·§3.1」+「新增用户」 |
+| §3.1       | 筛选区旁「PRD §3.1」+ 查询、重置 |
+| §3.2       | 列表标题行左侧「PRD §3.2」+ 表格、行操作；底栏「共 n 条」+ 每页条数 + 分页 |
+| §4         | 详情弹层内「PRD §4」+ 只读字段   |
+| §5         | 表单弹层内「PRD §5」+ 新增/编辑与校验 |
+| §6         | 删除弹层内「PRD §6」+ 二次确认   |
+| §8         | Toast 模拟成功/失败（无真实接口） |
+| 走查说明   | 左下角「标注说明」：琥珀色弹框为需求标注（非业务功能），见 deppon-prd-generator 技能约定 |
+
+---
+
+## 10. 修订记录
+
+| 版本 | 日期       | 说明                         |
+| ---- | ---------- | ---------------------------- |
+| v0.1 | 2026-05-13 | 用户列表 CRUD 初稿（他目录） |
+| v1.2 | 2026-05-13 | 原型：新增用户移至列表标题行；总条数移至分页栏「每页」旁 |