feat:修复文档规范

Author: rockyshi1993

STATUS.md

@@ -26,9 +26,9 @@
 
 | 版本 | 发布状态 | 发布日期 | 需求数 | 进度 |
 |------|---------|---------|--------|------|
-| [v1.4.0](#v140) | 📋 规划中 | 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.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 完成 |
@@ -39,20 +39,23 @@
 
 ## v1.4.0
 
-**发布状态**: 📋 规划中  
-**发布日期**: 2026-01-15  
+**发布状态**: ❌ 已取消  
+**取消日期**: 2025-12-16  
 **版本类型**: 次版本（MINOR）
 
 | 需求标题 | 状态 | 优先级 | 详细 |
 |---------|------|--------|------|
-| 短ID支持（ObjectId压缩编码） | 📋 规划中 | P0 | [详细](./plans/short-id-direct-replacement.md) |
+| 短ID支持（ObjectId压缩编码） | ❌ 已取消 | P0 | [方案](./plans/requirements/req-short-id-objectid-compression-v1.4.md) \| [分析](./reports/monSQLize/analysis/objectid-compression-feasibility-analysis-v1.4.md) |
 
-**进度**: 1个需求 | 0个已完成
+**进度**: 1个需求 | 已取消
 
-**变更摘要**:
-- ObjectId压缩编码（Base62），24字符→16字符
-- 零依赖，纯JS实现
-- 100%无损转换，保留时间戳和可排序性
+**取消原因**:
+- ❌ 性能严重下降（批量查询-1500%，聚合-3000%）
+- ❌ MongoDB生态完全不兼容（所有官方工具失效）
+- ❌ 存储空间不减反增（+42%，与初衷相反）
+- ❌ 技术债务高（长期维护负担重）
+
+**详细分析**: [可行性分析报告](./reports/monSQLize/analysis/objectid-compression-feasibility-analysis-v1.4.md)
 
 ---
 

plans/README.md

@@ -9,57 +9,102 @@
 
 ```
 plans/
-├── TEMPLATE.md              # 需求文档模板
 ├── README.md                # 本文件
-├── req-xxx.md               # 新功能需求
-├── bug-xxx.md               # Bug 修复
-├── opt-xxx.md               # 性能优化
-├── ref-xxx.md               # 代码重构
-├── sec-xxx.md               # 安全加固
-├── db-xxx.md                # 数据库变更
-└── api-xxx.md               # API 开发
+├── TEMPLATE.md              # 需求文档模板
+├── requirements/            # 新功能需求
+│   └── req-xxx-v{版本}.md
+├── bugs/                    # Bug 修复
+│   └── bug-xxx-v{版本}.md
+├── optimizations/           # 性能优化
+│   └── opt-xxx-v{版本}.md
+├── refactoring/             # 代码重构
+│   └── ref-xxx-v{版本}.md
+├── security/                # 安全加固
+│   └── sec-xxx-v{版本}.md
+├── database/                # 数据库变更
+│   └── db-xxx-v{版本}.md
+├── api/                     # API 开发
+│   └── api-xxx-v{版本}.md
+└── scripts/                 # 脚本开发
+    └── script-xxx-v{版本}.md
 ```
 
+🔴 **强制规则**：
+- ❌ 禁止在 plans/ 根目录直接创建文档（除 README.md 和 TEMPLATE.md）
+- ✅ 所有文档必须按类型分类到对应子目录
+- ✅ 所有文档文件名必须包含版本号（-v{版本号}.md）
+
 ---
 
 ## 🏷️ 文件命名规范
 
-### 命名格式
+### 命名格式（强制版本号后置）
 
-`{类型前缀}-{功能描述}.md`
+🔴 **强制格式**: `{类型前缀}-{功能描述}-v{版本号}.md`
 
-### 类型前缀
+**示例**:
+```
+req-watch-feature-v1.4.md           # 新功能需求（v1.4实施）
+bug-cache-memory-leak-v1.3.md       # Bug修复（v1.3修复）
+opt-query-performance-v1.5.md       # 性能优化（v1.5实施）
+```
+
+**版本号规则**:
+- ✅ 必须添加版本号 - 所有文档都必须有版本号
+- ✅ 版本号后置 - 版本号必须在文件名末尾（-v{版本号}.md）
+- ✅ 使用实施版本 - 版本号对应该需求首次计划或实施的版本
+- ✅ 格式标准 - vX.Y 或 vX.Y.Z（如 v1.4、v1.4.1）
+- ✅ 短横线连接 - 使用 -v1.4.md 而不是 _v1.4.md
+
+**禁止格式**:
+```
+❌ req-watch-feature.md              # 缺少版本号
+❌ req-v1.4-watch-feature.md         # 版本号在中间
+❌ v1.4-req-watch-feature.md         # 版本号在开头
+❌ req-watch-feature_v1.4.md         # 使用下划线
+✅ req-watch-feature-v1.4.md         # 正确格式
+```
 
-| 前缀 | 说明 | 示例 |
-|------|------|------|
-| req- | 新功能需求 | req-watch-feature.md |
-| bug- | Bug 修复 | bug-cache-memory-leak.md |
-| opt- | 性能优化 | opt-query-performance.md |
-| ref- | 代码重构 | ref-transaction-manager.md |
-| sec- | 安全加固 | sec-sql-injection-fix.md |
-| db- | 数据库变更 | db-add-index.md |
-| api- | API 开发 | api-new-endpoints.md |
+### 类型前缀（必须使用）
 
-### 命名规则
+| 前缀 | 说明 | 保存目录 | 命名示例 |
+|------|------|---------|---------|
+| req- | 新功能需求 | plans/requirements/ | req-watch-feature-v1.4.md |
+| bug- | Bug 修复 | plans/bugs/ | bug-cache-memory-leak-v1.3.md |
+| opt- | 性能优化 | plans/optimizations/ | opt-query-performance-v1.5.md |
+| ref- | 代码重构 | plans/refactoring/ | ref-transaction-manager-v1.4.md |
+| sec- | 安全加固 | plans/security/ | sec-sql-injection-fix-v1.6.md |
+| db- | 数据库变更 | plans/database/ | db-add-index-v1.4.md |
+| api- | API 开发 | plans/api/ | api-new-endpoints-v1.5.md |
+| script- | 脚本开发 | plans/scripts/ | script-data-migration-v1.4.md |
+
+### 功能描述命名规则
 
 - ✅ 全小写英文
 - ✅ 连字符分隔
-- ✅ 20个字符以内
+- ✅ 20个字符以内（不含版本号）
 - ✅ 描述准确简洁
-- ❌ 禁止纯编号（如 req-001.md）
-- ❌ 禁止中文（如 req-监听功能.md）
+- ❌ 禁止纯编号（如 req-001-v1.4.md）
+- ❌ 禁止中文（如 req-监听功能-v1.4.md）
+- ❌ 禁止无版本号（如 req-watch-feature.md）
 
 ---
 
 ## 📝 创建需求文档
 
-### 步骤1：复制模板
+### 步骤1：确定版本号和类型
+
+- **类型**: 根据需求选择类型前缀（req-/bug-/opt-等）
+- **版本号**: 使用计划实施的版本号（如 v1.4、v1.5）
+
+### 步骤2：复制模板
 
 ```bash
-cp plans/TEMPLATE.md plans/req-your-feature.md
+# 复制到对应子目录
+cp plans/TEMPLATE.md plans/requirements/req-your-feature-v1.4.md
 ```
 
-### 步骤2：填充内容
+### 步骤3：填充内容
 
 必须填充的章节：
 - ✅ 需求概述
@@ -69,17 +114,17 @@ cp plans/TEMPLATE.md plans/req-your-feature.md
 - ✅ 影响范围
 - ✅ 验证方式
 
-### 步骤3：添加到 STATUS.md
+### 步骤4：添加到 STATUS.md
 
 在对应版本表格添加一行：
 
 ```markdown
 | 需求标题 | 状态 | 优先级 | 详细 |
 |---------|------|--------|------|
-| 监听功能 | 🚧 开发中 | P1 | [详细](plans/req-watch-feature.md) |
+| 监听功能 | 🚧 开发中 | P1 | [详细](plans/requirements/req-watch-feature-v1.4.md) |
 ```
 
-### 步骤4：更新状态
+### 步骤5：更新状态
 
 开发进度更新：
 - 💡 提议 → 📋 计划中 → 🚧 开发中 → ✅ 已完成
@@ -95,11 +140,19 @@ CHANGELOG.md（版本摘要）
      ↓
 STATUS.md（版本需求列表）
      ↓
-plans/req-xxx.md（需求详细）
+plans/{类型}/xxx-v{版本}.md（需求详细）
 ```
 
 ### 反向追溯（开发视角）
 
+```
+plans/{类型}/xxx-v{版本}.md（需求详细）
+     ↓
+STATUS.md（更新实施状态）
+     ↓
+CHANGELOG.md（记录变更摘要）
+```
+
 ```
 plans/req-xxx.md
      ↓