feat:添加业务锁

Author: rockyshi1993

README.md

@@ -286,6 +286,44 @@ console.log(`总计: ${result.totals?.total}, 共 ${result.totals?.totalPages} 
 - ✅ 文档级别锁（16倍并发提升）
 - ✅ 重试、超时、监控
 
+#### **业务级分布式锁（v1.4.0 新增）** 🆕
+```javascript
+// 自动管理锁生命周期（推荐）
+await db.withLock('inventory:SKU123', async () => {
+    // 查询、计算、多表更新 - 整个流程串行执行
+    const product = await inventory.findOne({ sku: 'SKU123' });
+    const price = calculatePrice(product, user);
+    await inventory.updateOne({ sku: 'SKU123' }, { $inc: { stock: -1 } });
+    await orders.insertOne({ userId, price });
+});
+
+// 定时任务防重（多实例环境）
+const lock = await db.tryAcquireLock('cron:daily-report');
+if (lock) {
+    try {
+        await generateDailyReport();
+    } finally {
+        await lock.release();
+    }
+}
+```
+
+**特性**：
+- ✅ 基于 Redis 的分布式锁
+- ✅ 自动重试机制（可配置）
+- ✅ TTL 自动过期，防止死锁
+- ✅ 支持锁续期
+- ✅ Redis 断连降级策略
+- ✅ 内置统计监控
+
+**适用场景**：
+- ✅ 复杂订单创建（查询→计算→多表更新）
+- ✅ 定时任务防重（多实例环境）
+- ✅ 外部 API 调用后更新数据库
+- ✅ 库存扣减（复杂业务逻辑）
+
+**文档**：[完整 API 文档](./docs/business-lock.md) | [示例代码](./examples/business-lock.examples.js)
+
 #### **链式调用 API（100% 完成）**
 - ✅ sort, limit, skip, projection, hint, collation 等所有 MongoDB 游标方法
 
@@ -1253,6 +1291,7 @@ const db = new MonSQLize({
 - 📖 [完整 API 文档索引](./docs/INDEX.md)
 - 📖 [MongoDB 原生 vs monSQLize 对比](./docs/mongodb-native-vs-extensions.md)
 - 📖 [事务使用指南](./docs/transaction.md)
+- 📖 [**业务级分布式锁**](./docs/business-lock.md) 🆕 v1.4.0
 - 📖 [分布式部署指南](./docs/distributed-deployment.md)
 - 📖 [性能优化指南](./docs/transaction-optimizations.md)
 
@@ -1273,7 +1312,7 @@ const db = new MonSQLize({
 - [Schema 验证](./docs/validation.md) | [集合管理](./docs/collection-mgmt.md)
 
 **其他功能**:
-- [索引管理](./docs/indexes.md) | [聚合查询](./docs/aggregate.md)
+- [索引管理](./docs/create-index.md) | [聚合查询](./docs/aggregate.md)
 - [缓存系统](./docs/cache.md) | [链式调用](./docs/chaining-api.md)
 
 ### 示例代码

STATUS.md

@@ -1,17 +1,18 @@
 # monSQLize 需求状态追踪
 
 > **说明**: 追踪所有版本的需求状态（未来 + 历史）  
-> **最后更新**: 2025-12-15  
-> **文档版本**: 2.1（符合 AI 开发规范 v4.17）
+> **最后更新**: 2025-12-18  
+> **文档版本**: 2.2（符合 AI 开发规范 v4.23）
 
 ---
 
 ## 📑 目录导航
 
 - [发布计划](#发布计划)
-- [v1.4.0 - 📋 规划中](#v140)
+- [v1.4.0 - 📋 规划中（业务锁）](#v140-1)
 - [v1.5.0 - 📋 规划中](#v150)
 - [v1.6.0 - 📋 规划中](#v160)
+- [v1.4.0-cancelled - ❌ 已取消（短ID）](#v140)
 - [v1.2.0 - 🚧 开发中](#v120)
 - [v1.3.0 - ✅ 已完成](#v130)
 - [v1.1.0 - ✅ 已发布](#v110)
@@ -26,9 +27,10 @@
 
 | 版本 | 发布状态 | 发布日期 | 需求数 | 进度 |
 |------|---------|---------|--------|------|
+| [v1.4.0](#v140-1) | 📋 规划中 | 2026-01-15 | 1 | 0/1 未开始 |
 | [v1.5.0](#v150) | 📋 规划中 | 2026-02-28 | 1 | 0/1 未开始 |
 | [v1.6.0](#v160) | 📋 规划中 | 2026-03-31 | 1 | 0/1 未开始 |
-| [v1.4.0](#v140) | ❌ 已取消 | 2025-12-16 | 1 | 已取消 |
+| [v1.4.0-cancelled](#v140) | ❌ 已取消 | 2025-12-16 | 1 | 已取消 |
 | [v1.3.0](#v130) | ✅ 已完成 | 2025-12-12 | 1 | 1/1 完成 |
 | [v1.2.0](#v120) | 🚧 开发中 | 2025-12-15 | 3 | 3/3 进行中 |
 | [v1.1.0](#v110) | ✅ 已发布 | 2025-12-03 | 1 | 1/1 完成 |
@@ -37,7 +39,32 @@
 
 ---
 
-## v1.4.0
+## v1.4.0 {#v140-1}
+
+**发布状态**: 📋 规划中  
+**发布日期**: 2026-01-15  
+**版本类型**: 次版本（MINOR）
+
+| 需求标题 | 状态 | 优先级 | 详细 |
+|---------|------|--------|------|
+| 业务级分布式锁（withLock） | 📋 规划中 | P1 | [方案](./plans/requirements/req-business-lock-v1.4.md) |
+
+**进度**: 1个需求 | 0个已完成
+
+**变更摘要**:
+- `withLock()` API：自动管理锁的获取和释放
+- `acquireLock()` / `tryAcquireLock()`：手动锁管理
+- 复用已有 Redis 连接（分布式缓存）
+- 与 `withTransaction()` 无缝配合
+
+**设计理念**:
+- 业务锁本质是保护数据库操作，放在数据库增强层职责匹配
+- 用户不需要在框架层额外引入锁库
+- 复用 `DistributedCacheLockManager` 现有代码
+
+---
+
+## v1.4.0-cancelled {#v140}
 
 **发布状态**: ❌ 已取消  
 **取消日期**: 2025-12-16  

docs/INDEX.md

@@ -12,6 +12,7 @@
 | [connection.md](connection.md) | 连接管理和配置 |
 | [cache.md](cache.md) | 缓存系统（LRU + TTL） |
 | [transaction.md](transaction.md) | 事务管理（自动重试、缓存锁） |
+| [business-lock.md](business-lock.md) | **业务级分布式锁（v1.4.0）🆕** |
 | [transaction-optimizations.md](transaction-optimizations.md) | 事务优化策略 |
 | [distributed-deployment.md](distributed-deployment.md) | **分布式部署指南（多实例缓存一致性）⭐** |
 | [events.md](events.md) | 事件系统 |