微信公众号登录服务系统

# 检查 Node.js 版本
node --version  # 应显示 v18.18.0 或更高

# 检查 npm 版本
npm --version   # 应显示 8.0 或更高

# 安装 pnpm (如果未安装)
npm install -g pnpm

# 验证 pnpm 安装
pnpm --version  # 应显示 8.0 或更高

# 清理缓存 (可选，解决依赖冲突)
pnpm cache clean

# 安装项目依赖
pnpm install

# 验证安装完成
pnpm list --depth=0

# === 必填配置 ===
ADMIN_USERNAME=admin
ADMIN_PASSWORD=123456
JWT_SECRET=your_32_character_secret_key_here_123456
NEXT_PUBLIC_BASE_URL=http://localhost:3000

# === 可选配置（开发环境） ===
# 验证码有效期 (秒)
CODE_EXPIRE_TIME=60

# 开发模式 (启用详细日志)
NODE_ENV=development

# === 必填配置 ===
ADMIN_USERNAME=admin
ADMIN_PASSWORD=your_secure_password_here
JWT_SECRET=your_jwt_secret_key_32_characters_minimum_length
NEXT_PUBLIC_BASE_URL=http://localhost:3000

# === 微信API配置 (仅需要API密钥) ===
WECHAT_API_SECRET=your_api_secret_key

# === 可选配置 ===
CODE_EXPIRE_TIME=60
NODE_ENV=development

# === 数据存储 (开发环境可不配置) ===
# KV_URL=your_kv_database_url
# KV_REST_API_TOKEN=your_kv_token

# 1. 进入项目目录
cd wechat-oauth-login

# 2. 安装依赖 (首次运行)
pnpm install

# 3. 配置环境变量
cp .env.example .env.local
# 编辑 .env.local 文件

# 4. 启动开发服务器
pnpm dev

# 服务器启动成功后会显示:
# ▲ Next.js 14.x.x
# - Local:        http://localhost:3000
# - ready started server on 0.0.0.0:3000

# 使用不同端口启动
pnpm dev -- -p 3001

# 启动并自动打开浏览器
pnpm dev -- --open

# 启动时显示更详细的日志
pnpm dev -- --debug

# 安装Vercel CLI
npm i -g vercel

# 部署
vercel --prod

FROM node:20-alpine
WORKDIR /app
COPY . .
RUN npm install -g pnpm && pnpm install && pnpm build
EXPOSE 3000
CMD ["pnpm", "start"]

curl https://your-domain.com/api/health

# 1. 健康检查 - 验证服务正常运行
curl http://localhost:3000/api/health

# 期望返回:
# {"status":"ok","timestamp":"2025-08-27T10:12:53.000Z","environment":"development"}

# 2. 登录页面访问
open http://localhost:3000/login
# 或在浏览器中访问 http://localhost:3000/login

# 3. 管理后台访问
open http://localhost:3000/admin  
# 使用 .env.local 中配置的 ADMIN_USERNAME 和 ADMIN_PASSWORD 登录

# 1. 生成验证码 API 测试
curl -X POST http://localhost:3000/api/auth/code \
  -H "Content-Type: application/json"

# 2. 管理员登录测试
curl -X POST http://localhost:3000/api/admin/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"your_password"}'

# 3. 环境变量检查 (调试用)
curl http://localhost:3000/api/debug/env

// 在浏览器控制台中检查认证状态
console.log('当前存储的Token:', localStorage.getItem('auth_token'));

// 检查页面加载状态
console.log('页面路径:', window.location.pathname);
console.log('环境变量:', process.env.NODE_ENV);

# 启动开发服务器时观察日志
pnpm dev

# 查看以下关键日志:
# - "健康检查通过"
# - "用户认证成功" 
# - "管理员登录成功"
# - "验证码生成: XXXXXX"
# - "微信消息处理完成"

# 查看本地数据存储文件
cat .kv-data.json | jq .

# 检查用户数据
grep -E "user:|wechat:" .kv-data.json

# 检查管理员数据
grep "admin:" .kv-data.json

# 解决方案1: 使用其他端口
pnpm dev -- -p 3001

# 解决方案2: 杀死占用端口的进程 (macOS/Linux)
lsof -ti:3000 | xargs kill -9

# 解决方案3: Windows 下杀死进程
netstat -ano | findstr :3000
taskkill /pid <PID> /f

# 检查环境变量文件
ls -la .env*

# 确保 .env.local 存在且包含必要配置
cat .env.local | grep JWT_SECRET

# 如果不存在，复制示例文件
cp .env.example .env.local

# 清理依赖和缓存
rm -rf node_modules package-lock.json pnpm-lock.yaml
pnpm cache clean

# 重新安装
pnpm install

# 如果依然失败，尝试使用 npm
npm install

# 清理 Next.js 缓存
rm -rf .next

# 重新启动开发服务器
pnpm dev

# 如果需要测试微信功能，需要:
# 1. 注册腾讯元器新建智能体并设置为工作流模式
# 2. 工作流新建http节点
# 3. http节点设置相关参数，api地址为：/api/wechat/message/ 参数详见welogin/src/app/api/CLAUDE.md
# 4. 在腾讯元器智能体授权微信公众号 webhook URL

# 启动开发服务器
pnpm dev

# 类型检查
pnpm type-check

# 代码检查
pnpm lint

# API端点测试
curl -X POST http://localhost:3000/api/auth/code

# 管理员登录测试
curl -X POST http://localhost:3000/api/admin/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"your_password"}'

# 开发环境
tail -f logs/application.log

# 生产环境  
# 查看云函数平台日志系统