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

## 项目概述

拉迷家居（全屋定制品牌）企微运营风控管理系统。通过 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） |

## 常用命令

```bash
# 启动后端开发服务
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
```