feat: 添加完整的本地开发工具集

新增 dev/ 目录，提供一键式开发环境管理：

核心功能：
- 一键启动开发环境（DB + Redis + pnpm dev）
- 独立 Docker 容器配置（避免端口冲突）
- 完整镜像构建和三容器编排测试
- 自动数据库迁移
- 一键清理所有资源
- 详细日志和状态查看工具

技术实现：
- 10 个 Shell 脚本（包含公共函数库）
- 2 个 Makefile（dev/ + 根目录转发）
- 2 个 Docker Compose 配置（dev + full）
- 独立环境变量配置（.env.dev）
- 完整使用文档（dev/README.md）

端口配置（避免冲突）：
- PostgreSQL: 5433（开发）/ 35432（完整编排）
- Redis: 6380（开发）/ 内部（完整编排）
- App: 13500（pnpm dev）/ 23000（Docker）

安全措施：
- dev/ 已添加到 .gitignore（不会提交到远程）
- 测试密码与生产环境完全隔离
- 清理操作需要用户确认

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

CLAUDE.md

@@ -44,6 +44,51 @@ docker compose pull && docker compose up -d  # 升级到最新版本
 docker compose down              # 停止并删除容器
 ```
 
+### 本地开发工具（推荐）
+
+本项目提供了完整的本地开发工具集（位于 `dev/` 目录），可以快速启动开发环境、测试部署流程和清理资源。
+
+**快速开始**：
+```bash
+cd dev
+make help      # 查看所有可用命令
+make dev       # 一键启动完整开发环境
+```
+
+**常用命令**：
+```bash
+# 环境管理
+make dev          # 启动完整开发环境 (DB + pnpm dev)
+make db           # 仅启动数据库和 Redis
+make stop         # 停止所有服务
+make status       # 查看服务状态
+
+# 镜像构建和测试
+make build        # 构建 Docker 镜像
+make compose      # 启动三容器完整编排
+
+# 数据库操作
+make migrate      # 执行数据库迁移
+make db-shell     # 进入 PostgreSQL shell
+make redis-shell  # 进入 Redis CLI
+
+# 日志查看
+make logs         # 查看所有服务日志
+make logs-app     # 查看应用日志
+
+# 清理和重置
+make clean        # 一键清理所有资源
+make reset        # 完全重置 (clean + dev)
+```
+
+**开发环境配置**：
+- PostgreSQL: `localhost:5433` (避免与本地 5432 冲突)
+- Redis: `localhost:6380` (避免与本地 6379 冲突)
+- 应用: `http://localhost:13500` (Turbopack 开发服务器)
+- 管理员 Token: `dev-admin-token`
+
+**完整文档**: 详见 `dev/README.md`
+
 ## 核心技术栈
 
 - **Next.js 15** (App Router) + **React 19** + **TypeScript**

Makefile

@@ -0,0 +1,19 @@
+# ================================
+# Claude Code Hub - 根目录快捷命令
+# ================================
+#
+# 这个 Makefile 将命令转发到 dev/Makefile
+# 可以在项目根目录直接执行 make 命令
+
+.PHONY: help dev-help dev db app build compose clean migrate db-shell redis-shell logs logs-app logs-db logs-redis reset status stop
+
+# 默认目标：显示 dev 工具帮助
+.DEFAULT_GOAL := dev-help
+
+# 显示 dev 工具帮助
+dev-help:
+	@cd dev && $(MAKE) help
+
+# 转发所有命令到 dev/Makefile
+dev db app build compose clean migrate db-shell redis-shell logs logs-app logs-db logs-redis reset status stop:
+	@cd dev && $(MAKE) $@