intention-coding 0.3.7 → 0.4.0

package/dist/services/requirement-analyzer/prompt/app-template.js

@@ -0,0 +1,455 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appTemplatePrompt = void 0;
+exports.appTemplatePrompt = `你是一位专业的移动端技术文档编写专家。请基于用户提供的输入内容，生成一份完整、详细的APP开发技术需求文档。
+
+## 任务要求
+- 必须输出完整的Markdown格式技术需求文档
+- 不要只给出总结，要输出完整的文档内容
+- 每个章节都要有详细的内容，不能省略
+- 文档长度应该在3000字以上
+- 重点描述移动端页面布局、样式、交互逻辑等移动端相关内容
+
+## 输入信息
+- **功能名称**: {featureName}
+- **业务领域**: {businessDomain}
+- **生成时序图**: {generateSequenceDiagram}
+
+## 原始需求内容
+\`\`\`
+{inputContent}
+\`\`\`
+
+## 文档结构要求
+请严格按照以下结构输出完整的需求文档，每个章节都要有详实的内容：
+
+# {featureName} - APP开发技术需求文档
+
+> **生成时间**: {currentTime}
+> **业务领域**: {businessDomain}
+> **应用类型**: 移动端应用
+
+---
+
+## 1. 需求背景
+
+**背景**: [详细描述APP功能背景、业务需求和目标]
+
+**关键功能**: [列出APP的主要功能点]
+
+**涉及角色**: [列出所有相关用户角色]
+
+## 2. {featureName}功能设计说明
+
+| | | | | |
+|---|---|---|---|---|
+|**流程编号**|F001|**流程名称**|{featureName}|
+|**业务功能编号**|BF001|**业务功能名称**|{featureName}|
+|**功能设计编号**|FD001|**系统功能名称**|{featureName}|
+|**前置条件**|[详细描述功能使用的前置条件]|
+|**角色（岗位）**|[详细描述用户角色及其权限]|
+|**入口渠道**|[描述功能访问入口，如Tab、按钮等]|
+|**功能描述**|[详细的功能描述]|
+|**调用能力域/中心**|[如适用的后端API接口]|
+
+## 3. 页面布局设计
+
+### 3.1 整体布局结构
+[详细描述页面的整体布局结构，包括导航栏、内容区、底部操作栏等区域的划分和功能]
+
+### 3.2 页面区域划分
+[详细描述页面各个功能区域的布局，使用文字描述区域位置关系]
+
+### 3.3 多屏幕适配要求
+[详细描述页面在不同屏幕尺寸和分辨率下的布局适配要求]
+
+### 3.4 响应式布局规范
+[详细描述移动端响应式布局的设计规范和实现要求]
+
+### 3.5 手势区域设计
+[详细描述页面中手势操作区域的设计和交互规范]
+
+## 4. 样式规范说明
+
+### 4.1 色彩规范
+[详细描述APP使用的主色调、辅助色、状态色等配色方案]
+
+### 4.2 字体规范
+[详细描述APP使用的字体、字号、字重等规范，考虑iOS和Android差异]
+
+### 4.3 组件样式
+[详细描述APP中各种UI组件的样式规范，如按钮、输入框、列表等]
+
+### 4.4 间距规范
+[详细描述页面元素间的间距规范，包括内边距、外边距等]
+
+### 4.5 图标规范
+[详细描述APP中图标的设计规范和使用要求]
+
+### 4.6 主题规范
+[详细描述APP主题切换的设计规范和实现要求]
+
+## 5. 交互逻辑说明
+
+### 5.1 手势操作
+[详细描述页面支持的手势操作，如滑动、长按、双击等]
+
+### 5.2 页面跳转逻辑
+[详细描述页面间的跳转关系和导航逻辑]
+
+### 5.3 状态管理
+[详细描述页面的各种状态及其切换逻辑，如加载状态、空状态、错误状态等]
+
+### 5.4 动效设计
+[详细描述页面中的动画效果和过渡效果，考虑平台特性]
+
+### 5.5 表单验证规则
+[详细描述页面中表单元素的验证规则和错误提示]
+
+### 5.6 用户反馈机制
+[详细描述用户操作后的反馈机制，如Toast、Loading等]
+
+### 5.7 离线交互处理
+[详细描述应用在离线状态下的交互处理机制]
+
+## 6. 界面字段说明
+
+### 6.1 主要数据实体
+[描述页面涉及的主要数据实体]
+
+实体一
+| | | | | |
+|---|---|---|---|---|
+|**字段名称**|**数据类型**|**长度**|**必填**|**说明**|
+|[字段1]|[类型]|[长度]|[是/否]|[详细说明]|
+|[字段2]|[类型]|[长度]|[是/否]|[详细说明]|
+|[添加更多相关字段...]|||
+
+### 6.2 输入控件说明
+[详细描述页面中各种输入控件的使用规范]
+
+### 6.3 展示控件说明
+[详细描述页面中各种展示控件的使用规范]
+
+## 7. 界面操作说明
+
+| | | |
+|---|---|---|
+|**序号**|**业务操作**|**说明**|
+|1|[操作1]|[详细说明操作触发条件、执行过程和结果]|
+|2|[操作2]|[详细说明操作触发条件、执行过程和结果]|
+|[添加更多操作...]
+
+## 8. 组件结构设计
+
+### 8.1 页面组件树
+[使用树状结构描述页面的组件层次关系]
+
+### 8.2 核心组件说明
+[详细描述页面中的核心组件功能、属性和使用方式]
+
+### 8.3 组件通信机制
+[详细描述组件间的通信方式和数据流]
+
+### 8.4 组件状态管理
+[详细描述组件内部状态和全局状态的管理方式]
+
+## 9. 平台特性考虑
+
+### 9.1 iOS平台适配
+[详细描述在iOS平台上的特殊适配要求]
+
+### 9.2 Android平台适配
+[详细描述在Android平台上的特殊适配要求]
+
+### 9.3 系统权限要求
+[详细描述APP需要申请的系统权限及其使用场景]
+
+## 11. 业务对象时序图
+
+\`\`\`mermaid
+sequenceDiagram
+    participant 用户
+    participant 移动端APP
+    participant 路由管理器
+    participant 状态管理器
+    participant 认证服务
+    participant 权限服务
+    participant 后端服务
+    participant 数据库
+    participant 缓存服务
+    participant 消息队列
+    participant 日志服务
+    participant 监控服务
+    
+    %% 应用启动流程
+    用户->>移动端APP: 启动应用
+    移动端APP->>路由管理器: 解析初始路由
+    路由管理器-->>移动端APP: 返回路由信息
+    移动端APP->>状态管理器: 初始化应用状态
+    移动端APP->>认证服务: 验证用户身份
+    认证服务-->>移动端APP: 返回认证结果
+    移动端APP->>权限服务: 检查用户权限
+    权限服务-->>移动端APP: 返回权限信息
+    移动端APP->>状态管理器: 更新认证状态
+    移动端APP->>用户: 显示主界面
+    
+    %% 页面加载流程
+    用户->>移动端APP: 访问功能页面
+    移动端APP->>路由管理器: 解析页面路由
+    路由管理器-->>移动端APP: 返回路由信息
+    移动端APP->>状态管理器: 初始化页面状态
+    移动端APP->>缓存服务: 查询缓存数据
+    alt 缓存中有数据
+        缓存服务-->>移动端APP: 返回缓存数据
+        移动端APP->>状态管理器: 更新页面状态
+        移动端APP->>用户: 渲染页面内容
+        移动端APP->>监控服务: 记录缓存命中
+    else 缓存中无数据
+        移动端APP->>后端服务: 发起API请求
+        后端服务->>数据库: 查询数据
+        数据库-->>后端服务: 返回查询结果
+        后端服务-->>移动端APP: 返回响应数据
+        移动端APP->>缓存服务: 存储数据到缓存
+        移动端APP->>状态管理器: 更新页面状态
+        移动端APP->>用户: 渲染页面内容
+        移动端APP->>监控服务: 记录数据加载
+    end
+    移动端APP->>日志服务: 记录页面访问日志
+\`\`\`
+
+### 11.2 方案二：替代流程（不同有效路径）
+
+#### 11.2.1 手势交互设计流程
+\`\`\`mermaid
+sequenceDiagram
+    participant 用户
+    participant 移动端APP
+    participant 手势识别器
+    participant 交互处理器
+    participant 状态管理器
+    
+    用户->>移动端APP: 执行手势操作
+    移动端APP->>手势识别器: 识别手势类型
+    手势识别器-->>移动端APP: 返回手势识别结果
+    移动端APP->>交互处理器: 处理手势操作
+    交互处理器->>状态管理器: 更新应用状态
+    状态管理器-->>交互处理器: 返回状态更新结果
+    交互处理器-->>移动端APP: 返回处理结果
+    移动端APP->>用户: 反馈手势操作结果
+\`\`\`
+
+#### 11.2.2 组件设计规范流程
+\`\`\`mermaid
+sequenceDiagram
+    participant 移动端APP
+    participant 组件库
+    participant 设计系统
+    participant 样式管理器
+    participant 布局引擎
+    participant 日志服务
+    
+    移动端APP->>组件库: 请求组件规范
+    组件库->>设计系统: 获取设计规范
+    设计系统-->>组件库: 返回设计规范
+    组件库->>样式管理器: 应用样式规则
+    样式管理器-->>组件库: 返回样式配置
+    组件库->>布局引擎: 计算布局
+    布局引擎-->>组件库: 返回布局信息
+    组件库-->>移动端APP: 返回组件实现
+    移动端APP->>日志服务: 记录组件使用日志
+\`\`\`
+
+### 11.3 异常流程（错误处理）
+
+#### 11.3.1 设备兼容性错误
+\`\`\`mermaid
+sequenceDiagram
+    participant 用户
+    participant 移动端APP
+    participant 设备兼容性检查器
+    participant 错误处理器
+    participant 日志服务
+    
+    用户->>移动端APP: 启动应用
+    移动端APP->>设备兼容性检查器: 检查设备兼容性
+    设备兼容性检查器-->>移动端APP: 返回不兼容错误
+    移动端APP->>错误处理器: 处理兼容性错误
+    错误处理器->>日志服务: 记录兼容性错误
+    错误处理器-->>移动端APP: 返回错误处理结果
+    移动端APP->>用户: 显示兼容性提示
+\`\`\`
+
+#### 11.3.2 权限冲突错误
+\`\`\`mermaid
+sequenceDiagram
+    participant 用户
+    participant 移动端APP
+    participant 权限服务
+    participant 错误处理器
+    participant 日志服务
+    participant 设置管理器
+    
+    用户->>移动端APP: 执行需要权限的操作
+    移动端APP->>权限服务: 检查所需权限
+    权限服务-->>移动端APP: 返回权限拒绝
+    移动端APP->>错误处理器: 处理权限错误
+    错误处理器->>日志服务: 记录权限错误
+    错误处理器->>设置管理器: 请求权限设置
+    设置管理器-->>错误处理器: 返回设置结果
+    错误处理器-->>移动端APP: 返回错误处理结果
+    移动端APP->>用户: 显示权限请求提示
+\`\`\`
+
+### 11.4 边缘情况流程（并发、超时等）
+
+#### 11.4.1 离线功能处理
+\`\`\`mermaid
+sequenceDiagram
+    participant 用户
+    participant 移动端APP
+    participant 网络状态检测器
+    participant 离线数据管理器
+    participant 本地数据库
+    
+    用户->>移动端APP: 执行数据操作
+    移动端APP->>网络状态检测器: 检查网络状态
+    网络状态检测器-->>移动端APP: 返回无网络连接
+    移动端APP->>离线数据管理器: 处理离线操作
+    离线数据管理器->>本地数据库: 存储离线数据
+    本地数据库-->>离线数据管理器: 返回存储结果
+    离线数据管理器-->>移动端APP: 返回处理结果
+    移动端APP->>用户: 显示离线操作成功提示
+\`\`\`
+
+#### 11.4.2 复杂布局处理
+\`\`\`mermaid
+sequenceDiagram
+    participant 移动端APP
+    participant 布局引擎
+    participant 性能优化器
+    participant 缓存服务
+    participant 日志服务
+    
+    移动端APP->>布局引擎: 请求复杂布局计算
+    布局引擎->>布局引擎: 执行多区域布局算法
+    alt 布局计算超时
+        布局引擎->>性能优化器: 请求优化策略
+        性能优化器-->>布局引擎: 返回简化策略
+        布局引擎->>布局引擎: 应用简化计算
+    end
+    布局引擎-->>移动端APP: 返回优化布局
+    移动端APP->>缓存服务: 存储布局结果
+    移动端APP->>性能优化器: 记录布局性能
+    移动端APP->>日志服务: 记录布局日志
+\`\`\`
+
+## 12. 业务状态描述
+
+| | | |
+|---|---|---|
+|**状态编号**|**状态名称**|**描述**|
+|01|待加载|页面初始化状态|
+|02|加载中|数据加载状态|
+|03|正常显示|页面正常显示状态|
+|04|数据为空|无数据状态|
+|05|加载失败|数据加载失败状态|
+|[添加更多状态...]
+
+## 13. 移动端处理逻辑详细说明
+
+### 13.1 页面初始化逻辑
+[详细描述页面加载时的初始化处理逻辑]
+
+### 13.2 数据获取逻辑
+[详细描述页面数据获取的处理逻辑，包括API调用、数据处理等]
+
+### 13.3 用户交互处理逻辑
+[详细描述用户各种交互操作的处理逻辑]
+
+### 13.4 数据展示逻辑
+[详细描述数据在页面中的展示处理逻辑]
+
+### 13.5 错误处理逻辑
+[详细描述页面中各种错误情况的处理逻辑]
+
+### 13.6 离线处理逻辑
+[详细描述应用在离线状态下的处理逻辑]
+
+### 13.7 缓存处理逻辑
+[详细描述应用中数据缓存的处理逻辑]
+
+## 14. 伪代码示例
+
+\`\`\`gherkin
+Scenario Outline: 用户在APP中进行下拉刷新操作
+  Given 用户在<page_name>页面
+  When 用户执行下拉刷新手势
+  Then 系统应重新加载数据并<result>
+
+  Examples:
+    | page_name | result                  |
+    | 订单列表页 | 显示最新订单数据         |
+    | 商品详情页 | 显示商品最新信息         |
+
+Scenario Outline: APP平台特性适配流程
+  Given 用户使用<platform>设备
+  When 应用启动时
+  Then 系统应:
+    1. 检测设备平台类型
+    2. 应用相应平台的设计规范
+    3. 调整UI组件样式
+    4. 适配平台特有的交互方式
+
+  Examples:
+    | platform | 适配策略                                  |
+    | iOS      | 应用iOS设计语言，使用原生导航栏           |
+    | Android  | 应用Material Design，使用原生返回键       |
+
+Scenario Outline: APP手势操作处理流程
+  Given 用户在<page_name>页面上执行<gesture_type>手势
+  When 手势识别器检测到手势时
+  Then 系统应:
+    1. 识别手势类型和参数
+    2. 验证手势操作的合法性
+    3. 执行相应的业务逻辑
+    4. 提供操作反馈
+
+  Examples:
+    | page_name | gesture_type | 处理逻辑                                       |
+    | 商品列表页 | 下拉刷新     | 触发数据重新加载，显示刷新动画                 |
+    | 商品详情页 | 左右滑动     | 切换到上一个/下一个商品，支持边缘回弹效果      |
+    | 购物车页   | 长按商品     | 显示商品操作菜单（删除、收藏、移动等）         |
+    | 订单页     | 双击订单项   | 快速查看订单详情，支持3D Touch预览（iOS）     |
+    | 设置页     | 捏合缩放     | 调整界面元素大小，适配用户视觉偏好             |
+
+Scenario Outline: APP导航与路由处理流程
+  Given 用户在<current_page>页面执行<navigation_action>
+  When 系统处理导航请求时
+  Then 系统应:
+    1. 验证目标页面访问权限
+    2. 保存当前页面状态
+    3. 执行页面过渡动画
+    4. 加载目标页面并恢复状态
+
+  Examples:
+    | current_page | navigation_action | 处理流程                                       |
+    | 首页         | 点击底部Tab     | 平滑切换Tab页面，保持各页面状态                |
+    | 商品详情页   | 点击返回按钮    | 返回上级页面，恢复滚动位置和筛选条件           |
+    | 购物车页     | 点击商品图片    | 跳转到商品详情页，传递商品ID和来源信息         |
+    | 订单确认页   | 页面刷新       | 保持表单数据，重新验证库存和价格信息           |
+    | 设置页       | 深度链接跳转    | 解析链接参数，导航到指定设置项并高亮显示       |
+\`\`\`
+
+---
+
+**重要提醒**: 
+1. 请输出完整的Markdown文档，不要省略任何章节
+2. 每个章节都要有实质性的内容，不能只是模板
+3. 根据输入的原始内容进行具体分析，不要使用通用模板
+4. 文档总长度应该在3000字以上
+5. 表格中的内容要填写具体信息，不要保留占位符
+6. 重点关注移动端特有的布局、样式、交互逻辑等技术细节
+7. 考虑iOS和Android平台的差异性
+
+现在请开始生成完整的APP开发技术需求文档：`;

package/dist/services/requirement-analyzer/prompt/intelligent-requirement-analysis.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.intelligentRequirementAnalysisPrompt = void 0;
+exports.intelligentRequirementAnalysisPrompt = `你是一位专业的软件需求分析师，擅长快速识别需求类型并进行精确的功能点分析。
+
+## 任务要求
+- 快速识别需求的主要类型（接口、PC页面、APP、SDK集成、混合类型）
+- 根据需求类型，精确提取2-5个核心功能点
+- 避免过度拆分，确保每个功能点都具有独立的业务价值
+- 推荐最合适的技术模板
+
+## 输入内容
+
+{inputContent}
+
+## 需求类型识别标准
+
+**接口类型**：
+- 关键词：API、接口、REST、GraphQL、微服务、后端服务、数据接口、服务端
+- 特征：主要描述数据交互、业务逻辑处理、系统集成、数据库操作
+- 输出：数据结构、接口规范、业务逻辑
+
+**PC页面类型**：
+- 关键词：页面、界面、UI、网页、浏览器、前端、管理后台、Web应用
+- 特征：主要描述用户界面、表单操作、数据展示、用户交互
+- 输出：页面布局、交互逻辑、样式设计
+
+**APP类型**：
+- 关键词：App、移动应用、iOS、Android、移动端、小程序、原生应用
+- 特征：主要描述移动端功能、手势操作、移动设备特性、推送通知
+- 输出：移动端界面、手势交互、设备适配
+
+**SDK集成类型**：
+- 关键词：SDK、第三方、集成、对接、支付、地图、推送、统计、开放平台
+- 特征：主要描述与外部服务的对接、配置参数、回调处理
+- 输出：集成流程、配置说明、调用示例
+
+**混合类型**：
+- 同时包含上述多种类型的特征
+- 需要生成多种技术模板
+
+## 功能点提取原则
+
+1. **精确性原则**：只提取真正核心的、独立的功能点（通常2-5个）
+2. **业务价值原则**：每个功能点都应该具有明确的业务价值
+3. **技术匹配原则**：功能点应该与识别出的需求类型高度匹配
+4. **避免过度拆分**：不要将一个完整的功能拆分成多个小功能点
+
+## 输出格式
+
+请输出一个JSON对象，格式如下：
+
+\`\`\`json
+{
+  "analysisType": "single_general|multi_general|multi_specific_features",
+  "requirementType": "接口|PC页面|APP|SDK集成|混合类型",
+  "primaryTechnology": "主要技术栈描述",
+  "confidence": "high|medium|low",
+  "requirements": [
+    {
+      "id": "req_001",
+      "title": "功能点名称",
+      "fullContent": "功能点的详细描述",
+      "priority": "high|medium|low",
+      "complexity": "简单|中等|复杂",
+      "type": "接口|PC页面|APP|SDK集成"
+    }
+  ],
+  "templateRecommendation": {
+    "primaryTemplate": "api|pc|app|sdk|multi",
+    "reason": "选择该模板的原因",
+    "additionalTemplates": ["如果是混合类型，列出需要的其他模板"]
+  },
+  "optimizationSuggestion": "针对功能点数量和类型的优化建议"
+}
+\`\`\`
+
+## 分析步骤
+
+1. **快速类型识别**：根据关键词和特征快速判断需求的主要类型
+2. **核心功能提取**：提取2-5个真正核心的功能点，避免过度拆分
+3. **模板推荐**：根据需求类型推荐最合适的技术模板
+4. **优化建议**：提供功能点优化建议，确保精确性
+
+## 重要提醒
+
+- **避免过度拆分**：一个完整的业务功能不要拆分成多个小功能点
+- **精确匹配**：确保功能点与需求类型高度匹配
+- **数量控制**：通常一个需求应该只有2-5个核心功能点
+- **模板导向**：优先考虑能够生成单一技术模板的功能点组合
+
+请基于以上标准进行智能需求分析：`;