prd-workflow-cli 1.4.1 → 2.0.0

package/templates//346/212/200/346/234/257/350/247/204/346/240/274.md

@@ -0,0 +1,237 @@
+# {{IT_ID}} {{IT_NAME}} - 技术规格
+
+**创建时间**: {{CREATE_TIME}}
+**关联业务需求**: {{IT_ID}}/业务需求.md
+**状态**: 待开发
+
+---
+
+## 1. 功能概述
+
+### 1.1 用户故事
+<!-- 从业务需求复制 -->
+
+### 1.2 功能目的
+<!-- 这个功能要解决什么问题 -->
+
+### 1.3 来源追溯
+- **规划需求项**: #___
+- **规划冻结**: ___
+
+---
+
+## 2. 详细应用场景
+
+### 场景 1: [具体场景名]
+
+**前置条件**: 
+<!-- 用户需要满足什么条件才能使用 -->
+
+**用户操作步骤**:
+1. 用户从 [入口] 进入
+2. 用户看到 [页面/组件]
+3. 用户点击/输入 [操作]
+4. 系统响应 [变化]
+5. 用户看到 [结果]
+
+**预期结果**: 
+<!-- 详细描述最终状态 -->
+
+**异常情况处理**:
+| 异常 | 触发条件 | 处理方式 | 用户感知 |
+|------|----------|----------|----------|
+| | | | |
+
+---
+
+### 场景 2: [具体场景名]
+
+<!-- 继续添加其他场景 -->
+
+---
+
+## 3. 页面/组件描述
+
+### 3.1 入口位置
+
+**入口路径**: 
+<!-- 例如：首页 → 工具栏 → 反馈按钮 -->
+
+**入口触发条件**: 
+<!-- 所有用户可见 / 登录后可见 / 特定角色可见 -->
+
+**入口样式**: 
+<!-- 按钮 / 链接 / 图标 / 菜单项 -->
+
+---
+
+### 3.2 主界面布局
+
+**整体布局**: 
+<!-- 用文字描述或引用 A2UI 原型 -->
+
+**主要区域**:
+1. [区域 1]: [功能]
+2. [区域 2]: [功能]
+3. [区域 3]: [功能]
+
+**主要元素**:
+| 元素名称 | 类型 | 位置 | 说明 | 交互行为 |
+|----------|------|------|------|----------|
+| | 按钮/输入框/下拉框 | | | 点击/输入/选择 |
+
+---
+
+### 3.3 状态变化
+
+**状态流转图**:
+```
+初始状态 → [操作1] → 中间状态 → [操作2] → 最终状态
+```
+
+**状态详情**:
+| 状态 | 触发条件 | 页面表现 | 可用操作 |
+|------|----------|----------|----------|
+| 初始 | 打开页面 | | |
+| 填写中 | 开始输入 | | |
+| 提交中 | 点击提交 | | |
+| 成功 | 提交成功 | | |
+| 失败 | 提交失败 | | |
+
+---
+
+## 4. 交互规则
+
+### 4.1 输入规则
+
+| 字段名称 | 类型 | 必填 | 长度限制 | 格式要求 | 默认值 |
+|----------|------|------|----------|----------|--------|
+| | 文本/数字/日期 | 是/否 | | | |
+
+### 4.2 验证规则
+
+**客户端验证**:
+- 
+
+**服务端验证**:
+- 
+
+**实时验证**:
+- [ ] 输入时验证
+- [ ] 失焦时验证
+- [ ] 提交时验证
+
+### 4.3 操作规则
+
+**主要操作**:
+| 操作 | 触发方式 | 前置条件 | 执行逻辑 | 反馈方式 |
+|------|----------|----------|----------|----------|
+| 提交 | 点击按钮 | 验证通过 | | 成功/失败提示 |
+| 取消 | 点击按钮 | 无 | | 关闭/返回 |
+| 重置 | 点击按钮 | 无 | | 清空表单 |
+
+### 4.4 边界情况
+
+| 情况 | 触发条件 | 处理方式 | 用户反馈 |
+|------|----------|----------|----------|
+| 网络异常 | 请求超时 | 显示错误提示，允许重试 | "网络错误，请重试" |
+| 权限不足 | 用户无权限 | 显示提示，禁用操作 | "您没有权限执行此操作" |
+| 数据异常 | 返回数据格式错误 | 显示通用错误 | "数据加载失败" |
+
+---
+
+## 5. 页面跳转逻辑
+
+### 5.1 跳转规则
+
+| 触发条件 | 目标页面 | 跳转方式 | 传递参数 |
+|----------|----------|----------|----------|
+| 提交成功 | 列表页 | 返回 | 无 |
+| 点击取消 | 上一页 | 返回 | 无 |
+
+### 5.2 页面间关联
+
+**前置页面**: 
+**后续页面**: 
+
+---
+
+## 6. 数据要求
+
+### 6.1 数据来源
+
+**需要的数据**:
+| 数据项 | 来源 | 说明 |
+|--------|------|------|
+| | 用户输入/接口/本地存储 | |
+
+### 6.2 数据提交
+
+**提交的数据**:
+| 数据项 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| | | | |
+
+**提交时机**: 
+<!-- 实时保存 / 点击保存 / 自动保存 -->
+
+---
+
+## 7. 验收标准映射
+
+### 7.1 功能验收对应
+
+| 业务验收标准 | 技术实现要点 | 验证方式 |
+|--------------|--------------|----------|
+| | | |
+
+### 7.2 体验验收对应
+
+| 业务验收标准 | 技术实现要点 | 验证方式 |
+|--------------|--------------|----------|
+| 用户能轻松找到入口 | 入口位置、样式 | 可用性测试 |
+| 用户能理解如何使用 | 提示文案、帮助信息 | 用户测试 |
+| 用户能获得及时反馈 | 加载提示、成功/失败提示 | 功能测试 |
+
+---
+
+## 8. 关联 RT
+
+**说明**: 本节由全栈工程师填写
+
+| RT 编号 | RT 标题 | 负责人 | 状态 | 备注 |
+|---------|---------|--------|------|------|
+| RT-___ | | | 待创建 | |
+
+**RT 创建指引**: 
+<!-- 工程师拆分 RT 的建议 -->
+
+---
+
+## 9. UI 原型
+
+**A2UI 文件**: 
+<!-- 如果有界面原型，保存到 IT/{{IT_ID}}/UI原型/ -->
+
+**预览地址**: 
+<!-- prd ui 启动后的访问地址 -->
+
+---
+
+## 10. 开发备注
+
+**技术约束**: 
+<!-- 有无特殊的技术限制 -->
+
+**依赖的技术/组件**: 
+<!-- 需要使用哪些现有组件或技术 -->
+
+**注意事项**: 
+<!-- 开发时需要特别注意的点 -->
+
+---
+
+**产品负责人**: 
+**全栈工程师**: 
+**创建日期**: 
+**最后更新**: