lami-shequn/CLAUDE.md

拉迷家居 — 企微群聊风控系统

项目概述

拉迷家居（全屋定制品牌）企微运营风控管理系统。通过 QiWe 开放平台 API 同步群聊消息，使用「关键词匹配 + DeepSeek AI」双重机制进行合规风险检测。

技术栈

• 前端: Angular (src/app/)
• 后端: Express + Parse Server (backend/src/)
• 数据库: PostgreSQL (via Parse Server)
• AI: DeepSeek API (deepseek-chat)
• 外部 API: QiWe 开放平台 (https://manager.qiweapi.com/qiwe)

关键路径

模块	路径
Webhook 入口	backend/src/controllers/webhook.controller.ts
消息分析引擎	backend/src/services/message-analyzer.service.ts
关键词匹配	backend/src/services/compliance-check.service.ts
AI 分析	backend/src/services/ai-analysis.service.ts
风险事件	backend/src/services/risk-event.service.ts
前端风控大屏	src/app/features/risk-control/
脚本目录	backend/scripts/
HTML 报告	backend/scripts/audit-risk-*.html
技能文档	backend/scripts/audit-risk-README.md

可用技能 (Slash Commands)

/audit-risk — 风险预警覆盖审计

对指定时间段的群聊消息进行关键词覆盖率审计和漏报检测，生成 HTML/MD 报告和管理建议。

• 技能文件: .claude/commands/audit-risk.md
• 核心脚本: backend/scripts/audit-risk-coverage.ts + audit-risk-deep-analysis.ts
• 建议频率: 每周

/backfill-nicknames — GroupMember 昵称回填

从 Message 表 senderName 跨房间回填缺失的昵称。

• 技能文件: .claude/commands/backfill-nicknames.md
• 核心脚本: backend/scripts/backfill-member-nicknames.ts

数据库核心表

表	用途
Message	群聊消息（content, senderId, senderName, roomId, timestamp）
GroupChat	群信息（roomName, communityName, ownerPhone）
GroupMember	群成员（userId, nickname, status）
Contact	内外部联系人（userId, nickname, phone, corpName）
RiskEvent	风险事件（keywords, severity, status, escalationLevel）
RiskKeyword	风险关键词库（word, category, severity, enabled）
WebhookLog	Webhook 事件日志（cmd, msgType, msgData）

常用命令

# 启动后端开发服务
cd backend && npm run dev

# 运行风险审计
cd backend && npx tsx scripts/audit-risk-coverage.ts

# 运行深度分析
cd backend && npx tsx scripts/audit-risk-deep-analysis.ts

# 昵称回填
cd backend && npx tsx scripts/backfill-member-nicknames.ts

# 启动前端
npm start