@chongyan/autospec 1.0.2 → 1.0.4

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

@@ -1,237 +0,0 @@
-# 产品设计：{产品/功能名}
-
-> **版本**: 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

@@ -1,388 +0,0 @@
-# 领域与业务知识：{领域/项目名}
-
-> **版本**: 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`