git要求

先调用git获取修改的代码，然后更新task-logs到.task-logs文件夹，并且维护activeContext.md文件（也在.task-logs文件夹里），最后上传该任务所修改的代码到git上

# git要求

## 分开提交git

按照不同的修改内容区分，或者用暂存和未提交的区分，要读清楚修改的内容

## git提交信息

请为每次代码更新编写规范的git提交信息，包含以下内容：
1. 简洁明了的标题行（不超过50个字符），使用类型前缀（如feat:、fix:、docs:、style:、refactor:、perf:、test:、chore:）
2. 空一行后添加详细描述（每行不超过72个字符），包括：
   - 更改的具体内容和原因
   - 解决的问题或实现的功能
   - 技术实现的关键点
3. 列出所有修改的文件（使用markdown列表格式）
4. 如果有相关的issue或任务编号，请在描述中引用

提交信息应遵循Angular提交规范，使用中文编写，确保格式清晰易读，便于团队成员理解代码变更历史。

不要显示🤖 Generated with Claude Code

Co-Authored-By: Claude noreply@anthropic.com

## 样例

fix: 修复优惠券系统数据完整性问题

- 修复优惠券领取时couponSnapshot缺少couponType字段的问题
- 实现深度复制确保数据完整性，避免浅拷贝导致的数据不一致
- 完善优惠券类型智能推断逻辑，兼容缺少couponType字段的情况
- 修复支付金额浮点数精度问题，正确处理分转元的单位转换
- 添加数据完整性验证机制，防止不完整数据写入数据库

修改文件:
- cloudfunctions/mall/modules/coupons.js: 修复用户端优惠券领取逻辑
- admin-miniprogram/cloudfunctions/admin/modules/coupons.js: 修复管理后台发放逻辑
- miniprogram/utils/price-calculator.js: 完善类型推断和计算逻辑
- miniprogram/pages/payment/checkout/index.js: 修复金额转换精度问题

关联任务: #优惠券系统数据完整性修复"

# Task-Logs 标准格式模板

## 时间

调用`date`获取准确时间

## 📋 文件命名规范

### 标准命名格式
```
task-log_YYYY-MM-DD-type_中文描述.md
```

### 命名示例
```
task-log_2025-06-16-bugfix_商城搜索功能Bug修复.md
task-log_2025-06-16-feature_用户认证系统开发.md
task-log_2025-06-16-refactor_数据库架构重构.md
task-log_2025-06-16-optimization_性能优化实施.md
task-log_2025-06-16-deployment_生产环境部署.md
```

### 任务类型标识
- `bugfix` - Bug修复任务
- `feature` - 新功能开发
- `refactor` - 代码重构
- `optimization` - 性能优化
- `deployment` - 部署相关
- `testing` - 测试相关
- `documentation` - 文档更新
- `maintenance` - 维护任务

## 📝 标准格式模板

```markdown
# 任务日志: [任务名称]

## 任务概览

**任务ID**: task_YYYY-MM-DD_[type]_[description]
**任务类型**: [任务类型描述]
**开始时间**: YYYY-MM-DD HH:MM
**完成时间**: YYYY-MM-DD HH:MM
**执行状态**: [✅ 已完成并验证 / ⏳ 进行中 / ❌ 失败 / ⏸️ 暂停]
**严重程度**: [高/中/低] ([影响描述])

## 问题描述

### 错误现象
[详细描述用户遇到的具体问题]
1. **主要问题**: [核心问题描述]
2. **次要问题**: [相关问题描述]
3. **用户体验影响**: [对用户的具体影响]

### 错误影响
- [影响范围1]
- [影响范围2]
- [影响范围3]
- [对系统整体的影响]

## 根本原因分析

### 🔍 深度诊断结果

#### 1. **技术层面问题**
- **问题类型**: [具体的技术问题类型]
- **根本原因**: [深层次的技术原因]
- **触发条件**: [问题出现的具体条件]

#### 2. **架构/设计问题**
- **设计缺陷**: [架构或设计层面的问题]
- **数据流问题**: [数据处理流程的问题]
- **依赖关系**: [模块间依赖导致的问题]

### 🚨 犀利批评
**[直接、犀利的问题批评]** [详细说明问题的严重性和根本原因，不留情面地指出设计缺陷或实现问题]

## 修复方案

### 技术修复步骤

#### 1. **核心修复**
```[language]
// 文件：[文件路径] ([具体行号])

// 修复前 (错误)
[错误代码示例]

// 修复后 (正确)
[正确代码示例]
```

#### 2. **相关修复**
```[language]
// 文件：[文件路径] ([具体行号])
[相关修复代码]
```

#### 3. **配置/环境修复**
```[language]
// 配置文件修改
[配置修改内容]
```

### 返回值格式适配/数据结构调整
- [数据格式变更说明]
- [API接口调整说明]
- [兼容性处理说明]

## 修复验证

### ✅ 修复确认清单
1. **核心功能**: [具体验证项] ✅
2. **相关功能**: [具体验证项] ✅
3. **数据一致性**: [具体验证项] ✅
4. **性能影响**: [具体验证项] ✅
5. **用户体验**: [具体验证项] ✅

### 🔍 代码检查结果
- 搜索 `[问题关键词]`: 0个匹配项 ✅
- 搜索 `[修复关键词]`: X个匹配项 ✅
- 文件语法检查: 无错误 ✅

#### 功能测试结果
| 测试场景 | 修复前 | 修复后 | 状态 |
|---------|--------|--------|------|
| [测试场景1] | [结果1] | [结果2] | ✅ 修复完成 |
| [测试场景2] | [结果1] | [结果2] | ✅ 修复完成 |

## 技术细节

### 修改文件
1. **文件**: `[文件路径]`
   - **第X-Y行**: [修改内容描述]
   - **第Z行**: [修改内容描述]

2. **文件**: `[文件路径]`
   - **第X-Y行**: [修改内容描述]

### 兼容性保证
- [兼容性说明1]
- [兼容性说明2]
- [向后兼容处理]

## 预防措施

### 🛡️ 未来预防策略
1. **技术预防**: [具体的技术预防措施]
2. **流程预防**: [流程改进措施]
3. **监控预防**: [监控和告警措施]
4. **测试预防**: [测试覆盖改进]

### 📋 质量保证
- [质量保证措施1]
- [质量保证措施2]
- [长期改进建议]

## 总结

### 🎯 修复成果
- **问题解决**: [具体解决的问题]
- **代码质量**: [代码质量改进]
- **系统稳定**: [系统稳定性提升]
- **用户体验**: [用户体验改进]
- **功能验证**: [功能验证结果]

### 💡 经验教训
[深度的技术反思和经验总结，包括对问题根因的深入分析和未来避免类似问题的策略]

**重要提醒**:
1. [重要提醒1]
2. [重要提醒2]
3. [重要提醒3]

### 🚀 后续建议
[具体的后续行动建议]：
- ✅ [已完成项]
- ✅ [已完成项]
- ⏳ [待完成项]
- ⏳ [待完成项]

---

*任务完成时间: YYYY-MM-DD HH:MM*
*修复质量: [优秀/良好/一般] - [质量评价说明]*
*影响范围: [具体影响的模块或功能]*
```

## 🎯 关键要素说明

### 必须包含的核心要素

#### 1. **犀利批评部分**
- 必须包含直接、不留情面的问题批评
- 指出设计缺陷、实现问题、架构问题
- 体现技术严谨性和质量要求

#### 2. **技术深度**
- 详细的代码修改示例
- 具体的文件路径和行号
- 完整的修复验证过程

#### 3. **经验教训**
- 深度的技术反思
- 对问题根因的深入分析
- 未来预防策略

#### 4. **量化验证**
- 具体的测试结果对比
- 可验证的检查清单
- 明确的成功标准

### 格式要求

#### 1. **标题层级**
- 使用标准的Markdown标题层级
- 保持层级结构清晰
- 使用emoji图标增强可读性

#### 2. **代码块格式**
- 使用正确的语言标识
- 包含文件路径和行号注释
- 提供修复前后对比

#### 3. **表格格式**
- 使用标准的Markdown表格
- 包含状态标识（✅❌⏳）
- 提供清晰的对比数据

#### 4. **时间格式**
- 统一使用 YYYY-MM-DD HH:MM 格式
- 包含开始和完成时间
- 记录关键时间节点

## 📚 参考示例

参考已完成的任务日志：
- `task-log_2025-06-16-bugfix_商城前后端交互Bug修复.md`
- `task-log_2025-06-16-bugfix_商城搜索功能Bug修复.md`

这些示例展示了标准格式的完整应用，包括犀利批评、技术深度和经验总结。