jvibe 1.0.0

package/template/.claude/hooks/sync-stats.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+# ============================================================================
+# sync-stats.sh - Agent 完成后输出项目统计信息
+# ============================================================================
+# 触发事件: Stop
+# 用途: 在 Agent 完成工作后，输出项目功能统计数据供用户参考
+# ============================================================================
+
+set -euo pipefail
+
+# 项目根目录（相对于 .claude/hooks/）
+PROJECT_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
+DOCS_DIR="$PROJECT_ROOT/docs"
+FEATURE_LIST="$DOCS_DIR/功能清单.md"
+
+# 颜色定义
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m' # No Color
+
+# 检查功能清单是否存在
+if [[ ! -f "$FEATURE_LIST" ]]; then
+    exit 0
+fi
+
+echo ""
+echo -e "${BLUE}========================================${NC}"
+echo -e "${BLUE}  📊 项目统计信息${NC}"
+echo -e "${BLUE}========================================${NC}"
+
+# 统计各状态数量
+COMPLETED=$(grep -c "^## F-[0-9]* ✅" "$FEATURE_LIST" 2>/dev/null || echo "0")
+IN_PROGRESS=$(grep -c "^## F-[0-9]* 🚧" "$FEATURE_LIST" 2>/dev/null || echo "0")
+NOT_STARTED=$(grep -c "^## F-[0-9]* ❌" "$FEATURE_LIST" 2>/dev/null || echo "0")
+TOTAL=$((COMPLETED + IN_PROGRESS + NOT_STARTED))
+
+if [[ $TOTAL -eq 0 ]]; then
+    echo "  暂无功能条目"
+    echo -e "${BLUE}========================================${NC}"
+    exit 0
+fi
+
+# 计算完成率
+RATE=$((COMPLETED * 100 / TOTAL))
+
+# 输出总体统计
+echo -e "\n${CYAN}功能总览${NC}"
+echo "----------------------------------------"
+echo "  总功能数: $TOTAL"
+echo "  ✅ 已完成: $COMPLETED"
+echo "  🚧 开发中: $IN_PROGRESS"
+echo "  ❌ 未开始: $NOT_STARTED"
+echo "  📈 完成率: $RATE%"
+
+# 按模块统计（如果项目文档存在）
+PROJECT_DOC="$DOCS_DIR/项目文档.md"
+if [[ -f "$PROJECT_DOC" ]]; then
+    echo -e "\n${CYAN}模块统计${NC}"
+    echo "----------------------------------------"
+
+    # 从项目文档读取模块列表
+    # 假设模块定义在功能清单中：## F-XXX [状态] 功能名称 [模块名]
+    # 或者从功能描述中提取
+
+    # 简化版本：直接从功能清单提取所有功能的模块信息（如果有的话）
+    # 这里我们先输出一个占位符，实际实现可以更复杂
+
+    echo "  (模块统计需要在项目文档中配置)"
+fi
+
+# 显示最近更新的功能
+echo -e "\n${CYAN}最近活跃${NC}"
+echo "----------------------------------------"
+
+# 显示最近 3 个状态为 🚧 的功能
+RECENT_IN_PROGRESS=$(grep "^## F-[0-9]* 🚧" "$FEATURE_LIST" | head -n 3)
+if [[ -n "$RECENT_IN_PROGRESS" ]]; then
+    echo "$RECENT_IN_PROGRESS" | while IFS= read -r line; do
+        # 提取功能编号和名称
+        if [[ "$line" =~ ^##[[:space:]]+(F-[0-9]+)[[:space:]]+🚧[[:space:]]+(.+)$ ]]; then
+            feature_id="${BASH_REMATCH[1]}"
+            feature_name="${BASH_REMATCH[2]}"
+            echo "  🚧 $feature_id: $feature_name"
+        fi
+    done
+fi
+
+# 显示最近完成的功能（最多 3 个）
+RECENT_COMPLETED=$(grep "^## F-[0-9]* ✅" "$FEATURE_LIST" | tail -n 3)
+if [[ -n "$RECENT_COMPLETED" ]]; then
+    echo "$RECENT_COMPLETED" | while IFS= read -r line; do
+        if [[ "$line" =~ ^##[[:space:]]+(F-[0-9]+)[[:space:]]+✅[[:space:]]+(.+)$ ]]; then
+            feature_id="${BASH_REMATCH[1]}"
+            feature_name="${BASH_REMATCH[2]}"
+            echo "  ✅ $feature_id: $feature_name"
+        fi
+    done
+fi
+
+echo -e "\n${BLUE}========================================${NC}"
+
+exit 0

package/template/.claude/settings.json

@@ -0,0 +1,43 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/load-context.sh",
+            "timeout": 5000,
+            "description": "加载项目上下文，显示功能状态统计"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/sync-feature-status.sh",
+            "timeout": 10000,
+            "description": "当功能清单被修改时，自动推导功能状态"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/sync-stats.sh",
+            "timeout": 5000,
+            "description": "Agent 完成后输出项目统计信息"
+          }
+        ]
+      }
+    ]
+  }
+}

package/template/README.md

@@ -0,0 +1,144 @@
+# JVibe 项目模板
+
+> 文档驱动的 AI 辅助开发系统
+
+---
+
+## 📌 这是什么？
+
+这是由 JVibe CLI 工具初始化的项目模板，包含：
+
+- **`.claude/`** - Claude Code 配置（Agents、Commands、Hooks）
+- **`docs/core/`** - 4 个核心文档（CORE-DOCS）
+- **`docs/project/`** - 项目特定文档（PROJECT-DOCS）
+
+---
+
+## 🚀 快速开始
+
+### 1. 初始化项目文档
+
+```bash
+# 使用 JVibe Skill 初始化
+/JVibe:init
+```
+
+这会：
+- 询问项目名称、技术栈、初始模块
+- 填充 `docs/core/` 中的 4 个核心文档
+
+### 2. 查看项目状态
+
+```bash
+/JVibe:status
+```
+
+### 3. 开始开发
+
+使用自然语言描述你的需求：
+
+```
+"添加用户登录功能"
+```
+
+JVibe 会自动：
+1. 调用 `planner` agent 分析需求、创建功能条目
+2. 调用 `developer` agent 实现代码
+3. 调用 `reviewer` agent 审查代码
+4. 自动同步文档状态
+
+---
+
+## 📂 目录结构
+
+```
+your-project/
+├── .claude/                    # Claude Code 配置
+│   ├── agents/                 # 4 个 Sub-Agents
+│   │   ├── planner.md         # 需求规划
+│   │   ├── developer.md       # 代码开发
+│   │   ├── reviewer.md        # 代码审查
+│   │   └── doc-sync.md        # 文档同步
+│   ├── commands/               # 3 个 JVibe Skills
+│   │   ├── JVibe:init.md      # 初始化
+│   │   ├── JVibe:pr.md        # PR 生成
+│   │   └── JVibe:status.md    # 状态查看
+│   ├── hooks/                  # 3 个自动化 Hooks
+│   │   ├── load-context.sh
+│   │   ├── sync-feature-status.sh
+│   │   └── sync-stats.sh
+│   └── settings.json
+│
+├── docs/
+│   ├── core/                   # ⭐️ CORE-DOCS（4个固定核心文档）
+│   │   ├── 规范文档.md        # 入口和索引
+│   │   ├── 项目文档.md        # 架构与模块边界
+│   │   ├── 功能清单.md        # 功能状态唯一来源（SoT）
+│   │   └── 附加材料.md        # 规范索引
+│   │
+│   └── project/                # ⭐️ PROJECT-DOCS（按需创建）
+│       ├── README.md           # 说明文档
+│       ├── api.md.example      # API文档示例
+│       └── database.md.example # 数据库文档示例
+│
+└── .gitignore
+```
+
+---
+
+## 📚 文档体系
+
+### CORE-DOCS（核心文档）
+
+| 文档 | 职责 | 说明 |
+|------|------|------|
+| **规范文档** | 入口与索引 | 文档导航、开发流程、使用规则 |
+| **项目文档** | 架构与模块边界 | 技术栈、模块清单、功能索引 |
+| **功能清单** | 功能状态 SoT | 每个功能的描述 + TODO + 状态 |
+| **附加材料** | 规范索引 | 编码规范、技术细节、用户偏好 |
+
+### PROJECT-DOCS（项目文档）
+
+根据项目类型按需创建，例如：
+- API 文档
+- 数据库 Schema 文档
+- 部署文档
+- 组件文档
+
+⚠️ **所有 PROJECT-DOCS 必须在规范文档中注册**
+
+---
+
+## 🤖 JVibe 工作流
+
+```mermaid
+graph LR
+    A[需求分析] --> B[功能拆解]
+    B --> C[技术设计]
+    C --> D[编码实现]
+    D --> E[代码审查]
+    E --> F[文档同步]
+```
+
+### 核心原则
+
+- **Doc-driven**：文档驱动开发
+- **SoT**：功能状态只在功能清单中维护（单一事实来源）
+- **AI-native**：专为 AI 辅助开发设计的工作流
+
+---
+
+## 📋 常用命令
+
+| 命令 | 说明 |
+|------|------|
+| `/JVibe:init` | 初始化项目文档 |
+| `/JVibe:status` | 查看项目状态和进度 |
+| `/JVibe:pr` | 生成标准化 PR 描述 |
+
+---
+
+## 🔗 相关链接
+
+- [JVibe CLI 文档](https://github.com/your-org/jvibe)
+- [Claude Code 官方文档](https://docs.anthropic.com/claude-code)

package/template/docs/core//345/212/237/350/203/275/346/270/205/345/215/225.md

@@ -0,0 +1,306 @@
+# [项目名称] 功能清单
+
+## 📌 文档说明
+
+本文档是**功能状态的唯一来源（SoT）**，详细描述每个功能的：
+1. **功能描述** - 该功能是什么，解决什么问题
+2. **实现TODO** - 具体的开发任务清单
+
+**功能状态总览**: 见 [项目文档](./项目文档.md) §5 统计表（按 sprint/里程碑从本文档推导）
+
+**编号规则**: F-XXX (F = Feature，XXX = 三位数字)
+
+---
+
+## 状态说明
+
+- ✅ **已完成**: 功能开发完成、测试通过、已合并到主分支
+- 🚧 **开发中**: 正在开发中，TODO未全部完成
+- ❌ **未开始**: 已规划但尚未开始开发
+
+> ⚠️ **重要**: 功能状态只在本文档维护，项目文档的统计数据由本文档推导。
+
+---
+
+# AuthModule (认证模块)
+
+## F-001 ✅ 用户注册
+
+**描述**：允许新用户通过邮箱和密码创建账户。注册成功后，系统自动发送验证邮件，用户需点击邮件中的链接完成邮箱验证。
+
+**TODO**
+- [x] 设计数据库users表结构
+- [x] 实现 POST /api/auth/register 端点
+- [x] 实现邮件发送服务
+- [x] 实现邮箱验证端点 GET /api/auth/verify/:token
+- [x] 单元测试（邮箱格式、密码强度、加密函数）
+- [x] 集成测试（注册流程、异常情况）
+- [x] API文档更新
+- [x] 数据库Schema文档更新
+
+---
+
+## F-002 ✅ 用户登录
+
+**描述**：已注册用户通过邮箱和密码登录系统，登录成功后获得访问令牌（Access Token）和刷新令牌（Refresh Token）。支持登录失败锁定机制。
+
+**TODO**
+- [x] 实现 POST /api/auth/login 端点
+- [x] 实现登录失败计数器（Redis存储，5次失败锁定15分钟）
+- [x] 实现auth_tokens表存储refreshToken
+- [x] 单元测试（密码验证、Token生成、失败计数）
+- [x] 集成测试（登录流程、失败场景、锁定机制）
+- [x] API文档更新
+
+---
+
+## F-003 ✅ Token刷新
+
+**描述**：当accessToken过期后，客户端可使用refreshToken获取新的accessToken，无需用户重新登录。
+
+**TODO**
+- [x] 实现 POST /api/auth/refresh 端点
+- [x] 验证refreshToken有效性
+- [x] 生成新的accessToken
+- [x] 单元测试和集成测试
+- [x] API文档更新
+
+---
+
+## F-004 ✅ 密码重置
+
+**描述**：用户忘记密码时，可通过邮箱接收重置密码链接，点击链接后设置新密码。重置成功后旧token全部失效。
+
+**TODO**
+- [x] 实现 POST /api/auth/forgot-password 端点
+- [x] 实现 POST /api/auth/reset-password 端点
+- [x] 生成重置token（JWT，有效期1小时）
+- [x] 发送重置密码邮件
+- [x] 更新密码并使旧token失效
+- [x] 单元测试和集成测试
+- [x] API文档更新
+
+---
+
+## F-005 ✅ 邮箱验证
+
+**描述**：用户注册后需要验证邮箱，验证成功后才能登录系统。支持重新发送验证邮件（1分钟内限制1次）。
+
+**TODO**
+- [x] 实现 GET /api/auth/verify/:token 端点
+- [x] 实现 POST /api/auth/resend-verification 端点
+- [x] 验证token有效性（24小时有效期）
+- [x] 更新email_verified字段
+- [x] 单元测试和集成测试
+- [x] API文档更新
+
+---
+
+# UserModule (用户管理模块)
+
+## F-006 ✅ 用户信息查询
+
+**描述**：查询用户的基本信息和资料。支持查询自己的完整信息和其他用户的公开信息。
+
+**TODO**
+- [x] 实现 GET /api/users/:id 端点
+- [x] 实现 GET /api/users/me 端点
+- [x] 权限验证（需登录）
+- [x] 区分公开信息和私密信息
+- [x] 单元测试和集成测试
+- [x] API文档更新
+
+---
+
+## F-007 ✅ 用户资料编辑
+
+**描述**：用户可以编辑自己的资料，包括昵称（2-20字符）、简介（0-200字符）等信息。只能编辑自己的资料。
+
+**TODO**
+- [x] 实现 PUT /api/users/:id 端点
+- [x] 请求体验证和字段长度验证
+- [x] 权限验证（只能编辑自己）
+- [x] 单元测试和集成测试
+- [x] API文档更新
+
+---
+
+## F-008 ✅ 头像上传
+
+**描述**：用户可以上传自己的头像图片，支持JPG、PNG格式（最大5MB），自动裁剪为正方形并生成200x200缩略图。
+
+**TODO**
+- [x] 实现 POST /api/users/:id/avatar 端点
+- [x] 文件上传处理（multer）
+- [x] 图片格式验证
+- [x] 图片压缩和裁剪（sharp）
+- [x] 上传到云存储（S3/OSS）
+- [x] 更新user_profiles.avatar_url
+- [x] 单元测试和集成测试
+- [x] API文档更新
+
+---
+
+## F-009 ✅ 用户搜索
+
+**描述**：通过关键词搜索用户，支持按昵称模糊搜索和按邮箱精确搜索，返回匹配的用户列表。支持分页（默认20条/页）。
+
+**TODO**
+- [x] 实现 GET /api/users/search 端点
+- [x] 查询参数验证（q, page, limit）
+- [x] 数据库模糊查询和分页逻辑
+- [x] 权限验证（需登录）
+- [x] 单元测试和集成测试
+- [x] API文档更新
+
+---
+
+## F-010 ✅ 用户权限管理
+
+**描述**：管理员可以设置用户的角色（user/admin），支持角色变更日志记录。防止自我提权。
+
+**TODO**
+- [x] 实现 PUT /api/users/:id/role 端点
+- [x] 权限验证（需admin角色）
+- [x] 防止自我提权
+- [x] 记录角色变更日志
+- [x] 单元测试和集成测试
+- [x] API文档更新
+
+---
+
+# ChatModule (实时聊天模块)
+
+## F-011 ✅ 创建聊天室
+
+**描述**：用户可以创建聊天室，邀请其他用户加入。支持一对一聊天（direct，2人）和群聊（group，3-100人）。
+
+**TODO**
+- [x] 实现 POST /api/chat/rooms 端点
+- [x] 聊天室类型验证（direct/group）
+- [x] 成员列表验证（名称长度1-50字符）
+- [x] 创建chat_rooms和room_members记录
+- [x] 单元测试和集成测试
+- [x] API文档更新
+
+---
+
+## F-012 ✅ 发送文本消息
+
+**描述**：用户在聊天室内发送文本消息，消息实时推送给其他在线成员。
+
+**TODO**
+- [x] 实现 POST /api/chat/messages 端点
+- [x] WebSocket消息广播逻辑
+- [x] 消息内容验证和存储
+- [x] 单元测试和集成测试
+- [x] API文档更新
+
+---
+
+## F-013 ✅ 接收实时消息
+
+**描述**：用户通过WebSocket连接实时接收聊天室消息，支持断线重连和消息补发。
+
+**TODO**
+- [x] 实现WebSocket连接管理
+- [x] 实现消息推送逻辑
+- [x] 实现断线重连机制
+- [x] 实现消息补发逻辑
+- [x] 单元测试和集成测试
+
+---
+
+## F-014 ✅ 历史消息查询
+
+**描述**：查询聊天室的历史消息，支持分页加载（默认50条/页）和时间范围筛选。
+
+**TODO**
+- [x] 实现 GET /api/chat/messages/:roomId 端点
+- [x] 分页查询逻辑
+- [x] 时间范围筛选
+- [x] 权限验证（只能查询已加入的聊天室）
+- [x] 单元测试和集成测试
+- [x] API文档更新
+
+---
+
+## F-015 ✅ 在线状态显示
+
+**描述**：显示聊天室成员的在线状态（在线/离线/离开），通过WebSocket实时更新。
+
+**TODO**
+- [x] 实现在线状态管理（Redis存储）
+- [x] WebSocket在线状态广播
+- [x] 心跳检测机制
+- [x] 单元测试和集成测试
+
+---
+
+## F-016 ✅ 输入状态指示
+
+**描述**：显示其他用户正在输入的状态提示（"XXX正在输入..."），3秒无输入后自动清除。
+
+**TODO**
+- [x] WebSocket输入状态事件监听
+- [x] 输入状态广播逻辑
+- [x] 自动清除机制（3秒超时）
+- [x] 单元测试和集成测试
+
+---
+
+## F-017 ✅ 消息通知
+
+**描述**：用户离线或未打开聊天室时，收到新消息的系统通知（桌面通知/推送通知）。
+
+**TODO**
+- [x] 实现桌面通知（Web Notification API）
+- [x] 实现推送通知服务集成
+- [x] 通知开关和权限管理
+- [x] 单元测试和集成测试
+
+---
+
+## F-018 🚧 文件分享
+
+**描述**：用户可以在聊天室中分享文件（图片、文档、视频等），支持文件预览和下载。最大文件大小100MB。
+
+**TODO**
+- [x] 实现 POST /api/chat/files 端点
+- [x] 文件上传处理（multer）
+- [x] 文件类型验证和大小限制
+- [x] 上传到云存储（S3/OSS）
+- [ ] 图片预览缩略图生成
+- [ ] 文件下载权限验证
+- [ ] 单元测试和集成测试
+- [ ] API文档更新
+
+---
+
+## F-019 ❌ 消息搜索
+
+**描述**：在聊天室或全局范围内搜索历史消息，支持关键词搜索和高级筛选（发送人、时间范围、文件类型）。
+
+**TODO**
+- [ ] 实现 GET /api/chat/search 端点
+- [ ] 全文搜索索引构建（Elasticsearch）
+- [ ] 高级筛选逻辑（发送人、时间、文件类型）
+- [ ] 搜索结果高亮显示
+- [ ] 权限验证（只搜索有权限的聊天室）
+- [ ] 单元测试和集成测试
+- [ ] API文档更新
+
+---
+
+## F-020 ❌ 消息已读状态
+
+**描述**：显示消息的已读状态，支持单聊的"已读/未读"标记和群聊的"X人已读"统计。
+
+**TODO**
+- [ ] 实现消息已读记录表（message_read_status）
+- [ ] 实现 PUT /api/chat/messages/:id/read 端点
+- [ ] WebSocket已读状态广播
+- [ ] 群聊已读人数统计
+- [ ] 未读消息计数功能
+- [ ] 单元测试和集成测试
+- [ ] API文档更新