tdd

Test-Driven Development (TDD)

Final Verification: Always use: go test -v ./backend/api/handler/... | grep FAIL

Debugging & Handling Verbose Output: Avoid go test -v ./... directly in the terminal due to excessive output. Recommended Alternatives:

• Specific Tests: go test -v ./... -run ^TestSpecificFunction$ (Fastest for pinpointing).

Project Startup and Logging Rules

Service Startup:

• Use bash ./run.sh to start the mcp-handle-status service
• This script automatically loads .env, ensures PATH, kills port 3000 processes, and starts the Go backend in background
• Logs are output to backend.log

Log Monitoring:

• Use tail -f backend.log to monitor real-time logs
• Use tail -n 50 backend.log to view recent log entries
• Use grep "ERROR\|WARN\|Failed" backend.log to filter error messages Service Management:
• Use pkill -f mcp-handle-status to stop the service
• Check service status with ps aux | grep mcp-handle-status | grep -v grep
• API status endpoint: curl "http://localhost:3003/api/status"

数据库重置和缓存管理

数据库重置规则:

• 重要： 删除数据库前必须先备份：cp data/mcp-handle-status.db data/mcp-handle-status.db.backup.$(date +%Y%m%d_%H%M%S)
• 仅删除数据库文件 rm -f data/mcp-handle-status.db 是不够的
• 必须同时清理Redis缓存： redis-cli flushdb 或 redis-cli flushall
• 原因：用户列表查询有缓存机制，如果缓存中存在用户数据，系统不会创建新的root用户

完整的数据库重置流程:

# 1. 停止服务
pkill -f mcp-handle-status

# 2. 备份现有数据库
cp data/mcp-handle-status.db data/mcp-handle-status.db.backup.$(date +%Y%m%d_%H%M%S)

# 3. 删除数据库文件
rm -f data/mcp-handle-status.db

# 4. 清理Redis缓存
redis-cli flushdb

# 5. 重新启动服务
bash ./run.sh

验证root用户创建:

• 查看日志：grep "no user exists\|create a root user" backend.log
• 检查数据库：sqlite3 data/mcp-handle-status.db "SELECT id, username, LENGTH(token) as token_length FROM users;"

前端API调用规范

API路径构建:

• 当使用 frontend/src/utils/api.ts 中导出的 api 实例进行API调用时 (例如 api.get, api.post 等)，请勿在请求路径中再次添加 /api 前缀。
• 这是因为 api 实例的 baseURL 已经被配置为 /api，重复添加会导致 /api/api/ 这样的错误路径。
• 正确示例: api.get('/user/self') 或 api.post('/user', data)。
• 错误示例: api.get('/api/user/self')。