@chongyan/autospec 1.0.1 → 1.0.2

package/knowledge/09-templates/04-product-design.md

@@ -0,0 +1,237 @@
+# 产品设计：{产品/功能名}
+
+> **版本**: v1.0
+> **模板来源**: 产品设计最佳实践、用户体验设计原则、精益创业方法论
+> **适用范围**: 产品需求文档、功能设计、用户体验设计
+> **生成模式**: 用户研究 → 需求定义 → 功能设计 → 体验设计
+
+---
+
+## 1. 产品概述
+
+### 1.1 基本信息
+
+| 字段 | 值 |
+|------|-----|
+| 产品名称 | |
+| 产品类型 | ToB/ToC/内部工具 |
+| 产品阶段 | 概念/MVP/成长/成熟 |
+| 目标用户 | |
+| 核心价值 | |
+
+### 1.2 产品愿景
+
+> 用一句话描述产品的长期目标和价值主张
+
+### 1.3 产品目标
+
+| 目标类型 | 目标描述 | 衡量指标 | 目标值 | 时间 |
+|---------|---------|---------|-------|------|
+| 业务目标 | | DAU/收入/转化率 | | |
+| 用户目标 | | NPS/满意度 | | |
+| 技术目标 | | 性能/可用性 | | |
+
+---
+
+## 2. 用户研究
+
+### 2.1 用户画像
+
+| 画像名称 | 描述 | 需求痛点 | 使用场景 |
+|---------|------|---------|---------|
+| | | | |
+
+### 2.2 用户旅程
+
+```mermaid
+journey
+    title 用户完成 {任务} 的旅程
+    section 认知
+      发现产品：5: 用户通过搜索发现
+      了解功能：4: 浏览产品介绍
+    section 使用
+      注册账号：3: 填写表单
+      核心操作：5: 完成主要任务
+    section 反馈
+      评价分享：4: 给予反馈
+```
+
+### 2.3 竞品分析
+
+| 竞品名称 | 优势 | 劣势 | 差异化机会 |
+|---------|------|------|-----------|
+| | | | |
+
+---
+
+## 3. 需求定义
+
+### 3.1 需求列表
+
+| 需求 ID | 需求名称 | 需求类型 | 优先级 | 用户故事 |
+|--------|---------|---------|--------|---------|
+| REQ-01 | | 功能/非功能 | P0/P1/P2 | 作为...我希望...以便... |
+
+### 3.2 需求优先级
+
+**MoSCoW 优先级**：
+- **Must have** (必须有):
+- **Should have** (应该有):
+- **Could have** (可以有):
+- **Won't have** (暂不需要):
+
+### 3.3 需求依赖
+
+| 需求 | 前置依赖 | 后置依赖 | 风险 |
+|------|---------|---------|------|
+| | | | |
+
+---
+
+## 4. 功能设计
+
+### 4.1 功能架构
+
+```mermaid
+graph TB
+    subgraph "核心功能"
+        A1[功能 A]
+        A2[功能 B]
+    end
+
+    subgraph "支撑功能"
+        B1[功能 C]
+        B2[功能 D]
+    end
+
+    A1 --> B1
+    A2 --> B2
+```
+
+### 4.2 功能详情
+
+#### 功能 {名称}
+
+| 属性 | 值 |
+|------|-----|
+| 功能 ID | |
+| 功能名称 | |
+| 功能描述 | |
+| 优先级 | P0/P1/P2 |
+| 工作量估算 | |
+
+**功能流程**：
+```mermaid
+flowchart TD
+    A[开始] --> B{条件判断}
+    B -->|是 | C[操作 A]
+    B -->|否 | D[操作 B]
+    C --> E[结束]
+    D --> E
+```
+
+**界面原型**：
+```
++---------------------------+
+|       页面标题            |
++---------------------------+
+|  [搜索框]    [搜索按钮]   |
++---------------------------+
+|  列表项 1                 |
+|  列表项 2                 |
+|  列表项 3                 |
++---------------------------+
+|  < 上一页  1  2  3  下一页 > |
++---------------------------+
+```
+
+### 4.3 功能交互
+
+| 操作 | 输入 | 处理 | 输出 |
+|------|------|------|------|
+| 点击搜索 | 关键词 | 模糊匹配 | 搜索结果列表 |
+
+---
+
+## 5. 体验设计
+
+### 5.1 设计原则
+
+- [ ] 简洁易用
+- [ ] 一致性
+- [ ] 反馈及时
+- [ ] 容错设计
+- [ ] 无障碍
+
+### 5.2 交互规范
+
+| 交互类型 | 规范描述 | 示例 |
+|---------|---------|------|
+| 加载状态 | 超过 1 秒显示 loading | |
+| 错误提示 | 顶部 Toast，3 秒消失 | |
+| 成功反馈 | 绿色对勾动画 | |
+
+### 5.3 视觉规范
+
+| 元素 | 规范 | 值 |
+|------|------|-----|
+| 主色调 | Brand Color | #0066FF |
+| 字体 | Font Family | -apple-system, BlinkMacSystemFont |
+| 字号 | Base Font Size | 14px |
+
+---
+
+## 6. 数据设计
+
+### 6.1 数据指标
+
+| 指标名称 | 定义 | 计算方式 | 目标值 |
+|---------|------|---------|-------|
+| 日活跃用户 | 每日登录用户数 | COUNT(DISTINCT user_id) | |
+| 功能使用率 | 使用功能的用户占比 | UV_feature / UV_total | |
+
+### 6.2 埋点设计
+
+| 事件名称 | 触发时机 | 事件参数 | 用途 |
+|---------|---------|---------|------|
+| feature_click | 点击功能按钮 | feature_id, user_id | 功能使用分析 |
+
+---
+
+## 7. 发布计划
+
+### 7.1 版本规划
+
+| 版本 | 时间 | 包含功能 | 目标 |
+|------|------|---------|------|
+| v1.0 | | MVP 功能 | 验证核心价值 |
+| v1.1 | | 优化体验 | 提升留存 |
+| v2.0 | | 新功能 | 扩展场景 |
+
+### 7.2 发布策略
+
+- [ ] 灰度发布
+- [ ] A/B 测试
+- [ ] 功能开关
+- [ ] 回滚方案
+
+---
+
+## 8. 附录
+
+### 8.1 术语表
+
+| 术语 | 定义 |
+|------|------|
+| | |
+
+### 8.2 参考资料
+
+- [竞品分析](url)
+- [用户研究报告](url)
+
+---
+
+**维护者**: 产品团队
+**进化分区**: 受控区
+**关联文档**: `knowledge/09-templates/01-architecture-design.md`, `knowledge/09-templates/05-business-glossary.md`

package/knowledge/09-templates/05-domain-business.md

@@ -0,0 +1,388 @@
+# 领域与业务知识：{领域/项目名}
+
+> **版本**: v1.0
+> **模板来源**: 领域驱动设计 (DDD)、业务规则方法论 (BRM)、BPMN 2.0 流程建模
+> **适用范围**: 领域建模、业务术语标准化、业务规则定义、业务流程建模
+> **生成模式**: 术语收集 → 规则定义 → 流程建模 → 领域建模 → 持续维护
+
+---
+
+## 文件位置
+
+`.autospec/environment/04-business-knowledge/{name}.md` 或 `.autospec/environment/03-design-knowledge/05-domain/{name}.md`
+
+---
+
+## 1. 业务术语表（统一语言）
+
+### 1.1 术语概述
+
+| 字段 | 值 |
+|------|-----|
+| 术语表名称 | |
+| 所属领域 | |
+| 维护团队 | |
+| 最后更新 | |
+
+### 1.2 术语管理原则
+
+- [ ] 一词一义：每个术语只有一个明确的定义
+- [ ] 团队共识：术语定义需经团队讨论确认
+- [ ] 文档化：所有术语必须有书面定义
+- [ ] 持续维护：定期审查和更新术语
+
+### 1.3 术语分类
+
+| 分类 | 说明 | 示例 |
+|------|------|------|
+| 核心业务术语 | 描述业务核心概念的术语 | 订单、用户、账户 |
+| 技术术语 | 技术实现相关的术语 | 微服务、API、缓存 |
+| 运营术语 | 运营和指标相关的术语 | DAU、转化率、留存率 |
+| 领域模型术语 | DDD 领域驱动设计术语 | 聚合、聚合根、实体、值对象 |
+
+### 1.4 领域模型术语（DDD）
+
+| 术语 | 缩写 | 定义 | 适用上下文 | 来源 |
+|-----|------|------|-----------|------|
+| 聚合 Aggregate | AGG | 一致性边界内的对象集合，包含实体和值对象 | 设计阶段 | DDD |
+| 聚合根 Aggregate Root | AR | 聚合的唯一入口实体，负责维护聚合内部一致性 | 设计阶段 | DDD |
+| 实体 Entity | E | 有唯一标识的领域对象，具有生命周期和可变状态 | 设计阶段 | DDD |
+| 值对象 Value Object | VO | 无唯一标识、不可变的对象，通过属性值判断相等性 | 设计阶段 | DDD |
+| 领域事件 Domain Event | DE | 领域中发生的业务事实，用于聚合间通信 | 设计阶段 | DDD |
+| 领域服务 Domain Service | DS | 不属于任何实体或值对象的无状态领域操作 | 设计阶段 | DDD |
+| 仓储 Repository | R | 聚合的持久化抽象，提供集合语义的查询和保存 | 设计阶段 | DDD |
+| 限界上下文 Bounded Context | BC | 语言一致性边界，边界内术语含义统一 | 战略设计 | DDD |
+| 防腐层 Anticorruption Layer | ACL | 隔离外部模型的适配层，保护内部模型纯净 | 上下文集成 | DDD |
+
+### 1.5 术语列表
+
+| 术语 ID | 术语名称 | 英文名称 | 分类 | 状态 | 简要定义 |
+|--------|---------|---------|------|------|---------|
+| TERM-001 | | | | 已发布 | |
+| TERM-002 | | | | 已发布 | |
+
+### 1.6 术语关系图
+
+```mermaid
+graph TD
+    A[核心术语 A] -->|包含| B[子术语 B]
+    A -->|包含| C[子术语 C]
+    B -->|关联| D[相关术语 D]
+```
+
+---
+
+## 2. 业务规则
+
+### 2.1 规则概述
+
+| 字段 | 值 |
+|------|-----|
+| 规则集名称 | |
+| 所属领域 | |
+| 维护团队 | |
+| 最后更新 | |
+
+### 2.2 规则管理原则
+
+- [ ] 原子性：每条规则独立完整
+- [ ] 一致性：规则之间无冲突
+- [ ] 可追溯：每条规则有明确来源
+- [ ] 可验证：规则可测试可验证
+
+### 2.3 规则分类
+
+| 分类 | 说明 | 示例 |
+|------|------|------|
+| 数据校验规则 | 数据有效性约束 | 格式、范围、必填 |
+| 业务逻辑规则 | 业务流程约束 | 状态流转、条件判断 |
+| 安全合规规则 | 安全与合规约束 | 权限、审计、脱敏 |
+| 领域模型规则 | DDD 相关规则 | 聚合边界、领域事件幂等 |
+
+### 2.4 领域模型规则（DDD）
+
+| 规则 ID | 规则名称 | 规则描述 | 适用场景 | 来源 |
+|--------|---------|---------|---------|------|
+| DDD-01 | 聚合边界一致性 | 聚合内部必须保证强一致性，单个聚合=单个事务 | 聚合设计 | DDD |
+| DDD-02 | 聚合根唯一入口 | 外部只能通过聚合根访问聚合内部 | 代码实现 | DDD |
+| DDD-03 | 跨聚合 ID 引用 | 聚合之间只能通过 ID 引用，不能直接持有对象引用 | 代码实现 | DDD |
+| DDD-04 | 领域事件幂等 | 事件处理必须幂等，同一事件多次处理结果相同 | 事件处理 | DDD |
+| DDD-05 | 统一语言一致性 | 代码命名必须与业务术语一致 | 全流程 | DDD |
+
+### 2.5 规则列表
+
+| 规则 ID | 规则名称 | 类型 | 优先级 | 状态 | 简要描述 |
+|--------|---------|------|--------|------|---------|
+| RULE-001 | | 约束 | P0 | 已发布 | |
+| RULE-002 | | 计算 | P1 | 已发布 | |
+
+### 2.6 决策表
+
+| 条件 1 | 条件 2 | 条件 3 | 动作/结论 |
+|-------|-------|-------|----------|
+| Y | Y | - | 动作 A |
+| Y | N | Y | 动作 B |
+| N | - | - | 动作 C |
+
+---
+
+## 3. 业务流程
+
+### 3.1 流程概述
+
+| 字段 | 值 |
+|------|-----|
+| 流程名称 | |
+| 流程 ID | FLOW-{编号} |
+| 所属领域 | |
+| 流程所有者 | |
+| 最后更新 | |
+
+### 3.2 流程图
+
+```mermaid
+flowchart TD
+    Start([开始]) --> A[活动 A]
+    A --> B{决策点}
+    B -->|条件 1| C[活动 C]
+    B -->|条件 2| D[活动 D]
+    C --> E[活动 E]
+    D --> E
+    E --> End([结束])
+```
+
+### 3.3 状态流转图
+
+```mermaid
+stateDiagram-v2
+    [*] --> INIT: 创建
+    INIT --> PROCESSING: 处理
+    PROCESSING --> SUCCESS: 成功
+    PROCESSING --> FAILED: 失败
+    SUCCESS --> [*]
+    FAILED --> [*]
+```
+
+### 3.4 流程步骤
+
+| 步骤 ID | 步骤名称 | 执行角色 | 输入 | 输出 | 系统/工具 | SLA |
+|--------|---------|---------|------|------|----------|-----|
+| STEP-01 | | | | | | |
+| STEP-02 | | | | | | |
+
+---
+
+## 4. 领域模型
+
+### 4.1 领域概述
+
+| 字段 | 值 |
+|------|-----|
+| 领域名称 | |
+| 所属子系统 | |
+| 领域专家 | |
+| 最后更新 | |
+
+### 4.2 领域边界
+
+**领域职责**：
+> 描述领域的核心职责和边界
+
+**领域范围**：
+- 包含的概念
+- 不包含的概念
+
+### 4.3 类图
+
+```mermaid
+classDiagram
+    class EntityA {
+        +String id
+        +String name
+        +getValue()
+    }
+
+    class EntityB {
+        +String id
+        +String description
+        +process()
+    }
+
+    class ValueObject {
+        +String type
+        +int amount
+    }
+
+    EntityA "1" --> "0..*" EntityB : contains
+    EntityB --> ValueObject : uses
+```
+
+### 4.4 实体列表
+
+| 实体名称 | 类型 | 说明 | 标识属性 |
+|---------|------|------|---------|
+| | 聚合根/实体/值对象 | | id |
+
+---
+
+## 5. 实体详情
+
+### 5.1 实体模板
+
+#### {实体名称}
+
+| 属性 | 值 |
+|------|-----|
+| 实体名称 | |
+| 实体类型 | 聚合根/实体/值对象 |
+| 标识属性 | |
+| 生命周期 | 短/中/长 |
+
+**属性定义**：
+
+| 属性名 | 类型 | 必填 | 说明 | 约束 |
+|-------|------|------|------|------|
+| id | string | 是 | 唯一标识 | uuid |
+| name | string | 是 | 名称 | max 100 |
+| status | enum | 是 | 状态 | ACTIVE/INACTIVE |
+
+**方法定义**：
+
+| 方法名 | 参数 | 返回值 | 说明 |
+|-------|------|--------|------|
+| methodA | param: string | boolean | 方法说明 |
+
+**业务规则**：
+| 规则 ID | 规则描述 |
+|--------|---------|
+| RULE-001 | |
+
+**不变量**：
+- 条件 1 必须始终成立
+- 条件 2 必须始终成立
+
+---
+
+## 6. 领域关系
+
+### 6.1 关系类型
+
+| 关系 | 源实体 | 目标实体 | 类型 | 说明 |
+|------|-------|---------|------|------|
+| 关联 | EntityA | EntityB | 1:N | EntityA 包含多个 EntityB |
+| 依赖 | EntityB | ValueObject | 使用 | EntityB 使用值对象 |
+
+### 6.2 关系图
+
+```mermaid
+graph TD
+    A[EntityA] -->|1:N 包含| B[EntityB]
+    B -->|使用| C[ValueObject]
+```
+
+---
+
+## 7. 领域事件
+
+### 7.1 事件列表
+
+| 事件名称 | 触发时机 | 事件数据 | 订阅者 |
+|---------|---------|---------|--------|
+| EntityCreated | 实体创建时 | entityId, createdAt | 服务 A, 服务 B |
+| EntityUpdated | 实体更新时 | entityId, changes | 服务 C |
+
+### 7.2 事件流程图
+
+```mermaid
+sequenceDiagram
+    Entity->>EventBus: 发布 EntityCreated
+    EventBus->>ServiceA: 通知
+    EventBus->>ServiceB: 通知
+```
+
+---
+
+## 8. 领域服务
+
+### 8.1 服务列表
+
+| 服务名称 | 职责 | 依赖实体 |
+|---------|------|---------|
+| DomainService | 处理跨实体的业务逻辑 | EntityA, EntityB |
+
+### 8.2 服务接口
+
+```
+interface DomainService {
+  methodA(entity: EntityA): Result
+  methodB(param: string): void
+}
+```
+
+---
+
+## 9. 工厂设计
+
+### 9.1 工厂方法
+
+```
+class EntityFactory {
+  static createEntityA(params: CreateParams): EntityA {
+    // 创建逻辑
+  }
+}
+```
+
+---
+
+## 10. 模型验证与演进
+
+### 10.1 验证规则
+
+| 规则 | 验证方式 | 错误信息 |
+|------|---------|---------|
+| 必填字段验证 | | 字段不能为空 |
+| 格式验证 | 正则表达式 | 格式不正确 |
+| 业务规则验证 | | 违反业务规则 |
+
+### 10.2 版本历史
+
+| 版本 | 日期 | 变更内容 |
+|------|------|---------|
+| v1.0 | | 初始版本 |
+
+---
+
+## 11. 自检清单
+
+### 11.1 术语表检查
+
+- [ ] 术语分类完整
+- [ ] 每个术语有明确定义
+- [ ] 术语之间关系清晰
+- [ ] 命名规范一致
+
+### 11.2 规则检查
+
+- [ ] 规则之间无冲突
+- [ ] 每条规则可测试可验证
+- [ ] 规则来源可追溯
+- [ ] 决策表覆盖所有场景
+
+### 11.3 流程检查
+
+- [ ] 有明确的开始和结束节点
+- [ ] 覆盖所有业务场景（正常 + 异常）
+- [ ] 每个判断节点有明确的分支条件
+
+### 11.4 领域模型检查
+
+- [ ] 类图可正常渲染
+- [ ] 实体属性定义完整
+- [ ] 关系类型明确
+
+---
+
+**维护者**: 产品团队 + 技术团队
+**进化分区**: 自由区
+**关联文档**: `knowledge/06-environment/00-template-registry.md`, `knowledge/09-templates/03-database-design.md`