feat(aia): Complete AIA V2.0 with universal streaming capabilities
Major Changes: - Add StreamingService with OpenAI Compatible format - Upgrade Chat component V2 with Ant Design X integration - Implement AIA module with 12 intelligent agents - Update API routes to unified /api/v1 prefix - Update system documentation Backend (~1300 lines): - common/streaming: OpenAI Compatible adapter - modules/aia: 12 agents, conversation service, streaming integration - Update route versions (RVW, PKB to v1) Frontend (~3500 lines): - modules/aia: AgentHub + ChatWorkspace (100% prototype restoration) - shared/Chat: AIStreamChat, ThinkingBlock, useAIStream Hook - Update API endpoints to v1 Documentation: - AIA module status guide - Universal capabilities catalog - System overview updates - All module documentation sync Tested: Stream response verified, authentication working Status: AIA V2.0 core completed (85%)
This commit is contained in:
@@ -1,65 +1,65 @@
|
||||
# Day 3 - 企业微信集成开发完成记录
|
||||
# Day 3 - 隡<EFBFBD><EFBFBD>敺桐縑<EFBFBD><EFBFBD><EFBFBD>撘<EFBFBD><EFBFBD>穃<EFBFBD><EFBFBD>鞱扇敶?
|
||||
|
||||
**开发日期**:2026-01-02
|
||||
**开发者**:AI + 用户协作
|
||||
**撘<EFBFBD><EFBFBD>烐𠯫<EFBFBD>?*嚗?026-01-02
|
||||
**撘<EFBFBD><EFBFBD>𤏸<EFBFBD>?*嚗鋫I + <20>冽<EFBFBD><E586BD>譍<EFBFBD>
|
||||
**<EFBFBD><EFBFBD>𧋦**嚗鯝1.3
|
||||
**状态**:✅ 企业微信URL验证成功,基础集成完成
|
||||
**<EFBFBD>嗆<EFBFBD>?*嚗尠<E59A97> 隡<><E99AA1>敺桐縑URL撉諹<E69289><E8ABB9>𣂼<EFBFBD>嚗<EFBFBD>抅蝖<E68A85><E89D96><EFBFBD><EFBFBD>摰峕<E691B0>
|
||||
|
||||
---
|
||||
|
||||
## 📊 开发概览
|
||||
## <EFBFBD><EFBFBD> 撘<><E69298>烐<EFBFBD>閫?
|
||||
|
||||
### <20>格<EFBFBD>
|
||||
实现企业微信集成,包括消息推送和回调处理,为 IIT Manager Agent 建立与 PI 的沟通渠道。
|
||||
摰䂿緵隡<EFBFBD><EFBFBD>敺桐縑<EFBFBD><EFBFBD><EFBFBD>嚗<EFBFBD><EFBFBD><EFBFBD>祆<EFBFBD><EFBFBD>舀綫<EFBFBD><EFBFBD><EFBFBD><EFBFBD>噼<EFBFBD>憭<EFBFBD><EFBFBD>嚗䔶蛹 IIT Manager Agent 撱箇<EFBFBD>銝?PI <20><><EFBFBD><EFBFBD>𡁏<EFBFBD><F0A1818F>瓐<EFBFBD>?
|
||||
|
||||
### <20>鞉<EFBFBD>
|
||||
- ✅ 企业微信消息推送服务(WechatService)
|
||||
- ✅ 企业微信回调处理(WechatCallbackController)
|
||||
- ✅ URL验证测试通过
|
||||
- ✅ 完善质控Worker,支持企业微信推送
|
||||
- ✅ natapp内网穿透配置成功
|
||||
- <EFBFBD>?隡<><E99AA1>敺桐縑瘨<E7B891><E798A8><EFBFBD>券<EFBFBD><E588B8><EFBFBD><EFBFBD>∴<EFBFBD>WechatService嚗?
|
||||
- <EFBFBD>?隡<><E99AA1>敺桐縑<E6A190>噼<EFBFBD>憭<EFBFBD><E686AD>嚗ÁechatCallbackController嚗?
|
||||
- <EFBFBD>?URL撉諹<EFBFBD>瘚贝<EFBFBD><EFBFBD>朞<EFBFBD>
|
||||
- <EFBFBD>?摰<><E691B0>韐冽綉Worker嚗峕𣈲<E5B395><F0A388B2><EFBFBD>銝𡁜凝靽⊥綫<E28AA5>?
|
||||
- <EFBFBD>?natapp<EFBFBD><EFBFBD><EFBFBD>蝛輸<EFBFBD>誯<EFBFBD>蝵格<EFBFBD><EFBFBD>?
|
||||
|
||||
### 餈𥕦漲
|
||||
- 模块整体完成度:**35% → 50%**
|
||||
- 企业微信集成:**0% → 80%**(URL验证完成,待端到端测试)
|
||||
- 璅∪<EFBFBD><EFBFBD>港<EFBFBD>摰峕<EFBFBD>摨佗<EFBFBD>**35% <EFBFBD>?50%**
|
||||
- 隡<EFBFBD><EFBFBD>敺桐縑<EFBFBD><EFBFBD><EFBFBD>嚗?*0% <EFBFBD>?80%**嚗㇎RL撉諹<EFBFBD>摰峕<EFBFBD>嚗<EFBFBD><EFBFBD>蝡臬<EFBFBD>蝡舀<EFBFBD>霂𤏪<EFBFBD>
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ 架构设计
|
||||
## <EFBFBD><EFBFBD>儭?<3F>嗆<EFBFBD>霈曇恣
|
||||
|
||||
### <20>詨<EFBFBD>蝏<EFBFBD>辣
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ 企业微信集成架构 │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ │
|
||||
│ REDCap DET ──→ WebhookController ──→ JobQueue │
|
||||
│ ↓ ↓ │
|
||||
│ Audit Logs iit_quality_check │
|
||||
│ Worker │
|
||||
│ ↓ │
|
||||
│ WechatService │
|
||||
│ ↓ │
|
||||
│ 企业微信 API │
|
||||
│ ↓ │
|
||||
│ PI 手机 │
|
||||
│ │
|
||||
│ 企业微信消息 ──→ WechatCallbackController ──→ AI处理 │
|
||||
│ ↓ │
|
||||
│ WechatService ──→ 主动推送回复 │
|
||||
│ │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
<EFBFBD>𢞖<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
|
||||
<EFBFBD>? 隡<EFBFBD><EFBFBD>敺桐縑<EFBFBD><EFBFBD><EFBFBD><EFBFBD>嗆<EFBFBD> <EFBFBD>?
|
||||
<EFBFBD>鎿<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
|
||||
<EFBFBD>? <EFBFBD>?
|
||||
<EFBFBD>? REDCap DET <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>? WebhookController <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>? JobQueue <EFBFBD>?
|
||||
<EFBFBD>? <EFBFBD>? <EFBFBD>? <EFBFBD>?
|
||||
<EFBFBD>? Audit Logs iit_quality_check <EFBFBD>?
|
||||
<EFBFBD>? Worker <EFBFBD>?
|
||||
<EFBFBD>? <EFBFBD>? <EFBFBD>?
|
||||
<EFBFBD>? WechatService <EFBFBD>?
|
||||
<EFBFBD>? <EFBFBD>? <EFBFBD>?
|
||||
<EFBFBD>? 隡<EFBFBD><EFBFBD>敺桐縑 API <EFBFBD>?
|
||||
<EFBFBD>? <EFBFBD>? <EFBFBD>?
|
||||
<EFBFBD>? PI <EFBFBD>𧢲㦤 <EFBFBD>?
|
||||
<EFBFBD>? <EFBFBD>?
|
||||
<EFBFBD>? 隡<><E99AA1>敺桐縑瘨<E7B891><E798A8> <20><><EFBFBD><EFBFBD><EFBFBD>? WechatCallbackController <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>? AI憭<49><E686AD> <EFBFBD>?
|
||||
<EFBFBD>? <EFBFBD>? <EFBFBD>?
|
||||
<EFBFBD>? WechatService <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>? 銝餃𢆡<E9A483>券<EFBFBD><E588B8><EFBFBD>憭? <EFBFBD>?
|
||||
<EFBFBD>? <EFBFBD>?
|
||||
<EFBFBD>婙<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>?
|
||||
```
|
||||
|
||||
### <20><><EFBFBD>舫<EFBFBD>匧<EFBFBD>
|
||||
|
||||
| 组件 | 技术方案 | 原因 |
|
||||
| 蝏<EFBFBD>辣 | <20><><EFBFBD>舀䲮獢?| <20>笔<EFBFBD> |
|
||||
|------|----------|------|
|
||||
| 消息加解密 | @wecom/crypto | 企业微信官方推荐库 |
|
||||
| XML解析 | xml2js | 成熟稳定的XML解析库 |
|
||||
| 内网穿透 | natapp | 本地开发调试 |
|
||||
| 异步处理 | setImmediate | 规避5秒超时限制 |
|
||||
| 瘨<EFBFBD><EFBFBD><EFBFBD>㰘圾撖?| @wecom/crypto | 隡<EFBFBD><EFBFBD>敺桐縑摰䀹䲮<EFBFBD>刻<EFBFBD>摨?|
|
||||
| XML閫<EFBFBD><EFBFBD> | xml2js | <EFBFBD>鞟<EFBFBD>蝔喳<EFBFBD><EFBFBD><EFBFBD>ML閫<EFBFBD><EFBFBD>摨?|
|
||||
| <EFBFBD><EFBFBD><EFBFBD>蝛輸<EFBFBD>?| natapp | <EFBFBD>砍𧑐撘<EFBFBD><EFBFBD>𤏸<EFBFBD>霂?|
|
||||
| 撘<EFBFBD>郊憭<EFBFBD><EFBFBD> | setImmediate | 閫<EFBFBD><EFBFBD>5蝘坿<EFBFBD><EFBFBD>園<EFBFBD><EFBFBD>?|
|
||||
|
||||
---
|
||||
|
||||
@@ -68,18 +68,18 @@
|
||||
### 1. WechatService.ts嚗<73><E59A97>銝𡁜凝靽⊥綫<E28AA5><E7B6AB><EFBFBD><EFBFBD>∴<EFBFBD>
|
||||
|
||||
**<EFBFBD><EFBFBD>辣頝臬<EFBFBD>**嚗䫤backend/src/modules/iit-manager/services/WechatService.ts`
|
||||
**代码行数**:314行
|
||||
**隞<EFBFBD><EFBFBD>銵峕㺭**嚗?14銵?
|
||||
|
||||
**核心功能**:
|
||||
**<EFBFBD>詨<EFBFBD><EFBFBD>蠘<EFBFBD>**嚗?
|
||||
```typescript
|
||||
class WechatService {
|
||||
// 1. Access Token 管理(缓存 + 自动刷新)
|
||||
// 1. Access Token 蝞∠<EFBFBD>嚗<EFBFBD><EFBFBD>摮?+ <20>芸𢆡<E88AB8>瑟鰵嚗?
|
||||
async getAccessToken(): Promise<string>
|
||||
|
||||
// 2. 发送文本消息
|
||||
// 2. <EFBFBD>煾<EFBFBD><EFBFBD><EFBFBD><EFBFBD>祆<EFBFBD><EFBFBD>?
|
||||
async sendTextMessage(userId: string, content: string): Promise<void>
|
||||
|
||||
// 3. 发送 Markdown 消息
|
||||
// 3. <EFBFBD>煾<EFBFBD>?Markdown 瘨<EFBFBD><EFBFBD>
|
||||
async sendMarkdownMessage(userId: string, content: string): Promise<void>
|
||||
|
||||
// 4. 摰∟恣<E2889F>亙<EFBFBD>霈啣<E99C88>
|
||||
@@ -87,13 +87,13 @@ class WechatService {
|
||||
}
|
||||
```
|
||||
|
||||
**技术亮点**:
|
||||
- ✅ Access Token 缓存机制(7200秒,提前5分钟刷新)
|
||||
- ✅ 完整的错误处理和重试机制
|
||||
- ✅ 详细的日志记录(corpId、agentId等)
|
||||
- ✅ 审计日志自动记录
|
||||
**<EFBFBD><EFBFBD><EFBFBD>臭漁<EFBFBD>?*嚗?
|
||||
- <20>?Access Token 蝻枏<EFBFBD><EFBFBD>箏<EFBFBD>嚗?200蝘𡜐<E89D98><F0A19C90>𣂼<EFBFBD>5<EFBFBD><35><EFBFBD><EFBFBD>瑟鰵嚗?
|
||||
- <20>?摰峕㟲<E5B395><E39FB2><EFBFBD>霂臬<E99C82><E887AC><EFBFBD><EFBFBD><EFBFBD>滩<EFBFBD><E6BBA9>箏<EFBFBD>
|
||||
- <20>?霂衣<E99C82><E8A1A3><EFBFBD>𠯫敹𡑒扇敶𤏪<E695B6>corpId<EFBFBD><EFBFBD>gentId蝑㚁<EFBFBD>
|
||||
- <20>?摰∟恣<E2889F>亙<EFBFBD><E4BA99>芸𢆡霈啣<E99C88>
|
||||
|
||||
**环境变量**:
|
||||
**<EFBFBD>臬<EFBFBD><EFBFBD>㗛<EFBFBD>**嚗?
|
||||
```env
|
||||
WECHAT_CORP_ID=ww6ab493470ab4f377
|
||||
WECHAT_AGENT_ID=1000002
|
||||
@@ -105,21 +105,21 @@ WECHAT_CORP_SECRET=AZIVxMtoLb0rEszXS81e4dBRl-I9kgTjygIS0cFfENU
|
||||
### 2. WechatCallbackController.ts嚗<73><E59A97>銝𡁜凝靽∪<E99DBD>靚<EFBFBD><E99D9A><EFBFBD><EFBFBD><EFBFBD>
|
||||
|
||||
**<2A><>辣頝臬<E9A09D>**嚗䫤backend/src/modules/iit-manager/controllers/WechatCallbackController.ts`
|
||||
**代码行数**:501行
|
||||
**隞<EFBFBD><EFBFBD>銵峕㺭**嚗?01銵?
|
||||
|
||||
**核心功能**:
|
||||
**<EFBFBD>詨<EFBFBD><EFBFBD>蠘<EFBFBD>**嚗?
|
||||
```typescript
|
||||
class WechatCallbackController {
|
||||
// 1. URL 验证(GET 请求)
|
||||
// 1. URL 撉諹<EFBFBD>嚗𠃑ET 霂瑟<E99C82>嚗?
|
||||
async handleVerification(request, reply): Promise<void>
|
||||
|
||||
// 2. 消息接收(POST 请求 + 异步处理)
|
||||
// 2. 瘨<EFBFBD><EFBFBD><EFBFBD>交𤣰嚗㇊OST 霂瑟<E99C82> + 撘<>郊憭<E9838A><E686AD>嚗?
|
||||
async handleCallback(request, reply): Promise<void>
|
||||
|
||||
// 3. 撘<>郊瘨<E9838A><E798A8>憭<EFBFBD><E686AD>
|
||||
private async processMessageAsync(...): Promise<void>
|
||||
|
||||
// 4. 用户消息处理(关键词匹配 + 业务逻辑)
|
||||
// 4. <EFBFBD>冽<EFBFBD>瘨<EFBFBD><EFBFBD>憭<EFBFBD><EFBFBD>嚗<EFBFBD><EFBFBD><EFBFBD>株<EFBFBD><EFBFBD>寥<EFBFBD> + 銝𡁜𦛚<F0A1819C>餉<EFBFBD>嚗?
|
||||
private async processUserMessage(message): Promise<void>
|
||||
|
||||
// 5. 蝑曉<E89D91>撉諹<E69289>
|
||||
@@ -127,14 +127,14 @@ class WechatCallbackController {
|
||||
}
|
||||
```
|
||||
|
||||
**技术亮点**:
|
||||
- ✅ **异步回复模式**:立即返回`"success"`,后台异步处理(规避5秒超时)
|
||||
- ✅ **消息解密**:使用 `@wecom/crypto` 的 `decrypt(encodingAESKey, encrypt)` 函数
|
||||
- ✅ **签名验证**:使用 `@wecom/crypto` 的 `getSignature(token, timestamp, nonce, data)` 函数
|
||||
- ✅ **意图识别**:支持"汇总"、"帮助"、"新患者"等关键词
|
||||
- ✅ **主动推送**:处理完成后主动调用 WechatService 推送回复
|
||||
**<EFBFBD><EFBFBD><EFBFBD>臭漁<EFBFBD>?*嚗?
|
||||
- <EFBFBD>?**撘<>郊<EFBFBD>𧼮<EFBFBD>璅∪<E79285>**嚗𡁶<E59A97><F0A181B6>唾<EFBFBD><E594BE>裇"success"`嚗<><E59A97><EFBFBD>啣<EFBFBD>甇亙<E79487><E4BA99><EFBFBD><EFBFBD>閫<EFBFBD><E996AB>5蝘坿<E89D98><E59DBF>塚<EFBFBD>
|
||||
- <EFBFBD>?**瘨<><E798A8>閫<EFBFBD><E996AB>**嚗帋蝙<E5B88B>?`@wecom/crypto` <EFBFBD>?`decrypt(encodingAESKey, encrypt)` <EFBFBD>賣㺭
|
||||
- <EFBFBD>?**蝑曉<E89D91>撉諹<E69289>**嚗帋蝙<E5B88B>?`@wecom/crypto` <EFBFBD>?`getSignature(token, timestamp, nonce, data)` <EFBFBD>賣㺭
|
||||
- <EFBFBD>?**<2A>誩㦛霂<E3A69B><E99C82>**嚗𡁏𣈲<F0A1818F>?瘙<><E79899>?<3F>?撣桀𨭌"<22>?<3F>唳<EFBFBD><E594B3>?蝑匧<E89D91><E58CA7>株<EFBFBD>
|
||||
- <EFBFBD>?**銝餃𢆡<E9A483>券<EFBFBD>?*嚗𡁜<E59A97><F0A1819C><EFBFBD><EFBFBD><EFBFBD>𣂼<EFBFBD>銝餃𢆡靚<F0A286A1>鍂 WechatService <EFBFBD>券<EFBFBD><EFBFBD><EFBFBD>憭?
|
||||
|
||||
**环境变量**:
|
||||
**<EFBFBD>臬<EFBFBD><EFBFBD>㗛<EFBFBD>**嚗?
|
||||
```env
|
||||
WECHAT_TOKEN=oXlRBm1YnvMy2SbDLbvAdDd5Gq3oBGq
|
||||
WECHAT_ENCODING_AES_KEY=v88eT3O9bMW897h4btr7v7qvQImlMf31edTQCmuhOhO
|
||||
@@ -142,9 +142,9 @@ WECHAT_ENCODING_AES_KEY=v88eT3O9bMW897h4btr7v7qvQImlMf31edTQCmuhOhO
|
||||
|
||||
---
|
||||
|
||||
### 3. 路由配置(routes/index.ts)
|
||||
### 3. 頝舐眏<EFBFBD>滨蔭嚗ǐoutes/index.ts嚗?
|
||||
|
||||
**新增路由**:
|
||||
**<EFBFBD>啣<EFBFBD>頝舐眏**嚗?
|
||||
```typescript
|
||||
// GET: URL撉諹<E69289>嚗<EFBFBD><E59A97>銝𡁜凝靽⊿<E99DBD>蝵桀<E89DB5>靚<EFBFBD>RL<52>嗡蝙<E597A1>剁<EFBFBD>
|
||||
fastify.get('/api/v1/iit/wechat/callback',
|
||||
@@ -159,19 +159,19 @@ fastify.post('/api/v1/iit/wechat/callback',
|
||||
|
||||
---
|
||||
|
||||
### 4. 完善质控Worker(index.ts)
|
||||
### 4. 摰<EFBFBD><EFBFBD>韐冽綉Worker嚗ǎndex.ts嚗?
|
||||
|
||||
**<EFBFBD><EFBFBD>辣頝臬<EFBFBD>**嚗䫤backend/src/modules/iit-manager/index.ts`
|
||||
**<2A>啣<EFBFBD><E595A3>蠘<EFBFBD>**嚗朞捶<E69C9E>批<EFBFBD><E689B9>𣂼<EFBFBD><F0A382BC>芸𢆡<E88AB8>券<EFBFBD><E588B8><EFBFBD>銝𡁜凝靽⊿<E99DBD>𡁶䰻
|
||||
|
||||
**代码逻辑**:
|
||||
**隞<EFBFBD><EFBFBD><EFBFBD>餉<EFBFBD>**嚗?
|
||||
```typescript
|
||||
jobQueue.process('iit_quality_check', async (job) => {
|
||||
// 1. <20>瑕<EFBFBD>憿寧𤌍<E5AFA7>滨蔭
|
||||
const project = await prisma.$queryRaw`...`;
|
||||
const piUserId = project.notification_config.wechat_user_id;
|
||||
|
||||
// 2. 执行质控检查
|
||||
// 2. <EFBFBD>扯<EFBFBD>韐冽綉璉<EFBFBD><EFBFBD>?
|
||||
const qualityCheckResult = await performSimpleQualityCheck(...);
|
||||
|
||||
// 3. <20><>遣隡<E981A3><E99AA1>敺桐縑<E6A190>𡁶䰻瘨<E4B0BB><E798A8>
|
||||
@@ -182,21 +182,21 @@ jobQueue.process('iit_quality_check', async (job) => {
|
||||
});
|
||||
```
|
||||
|
||||
**通知消息格式**:
|
||||
**<EFBFBD>𡁶䰻瘨<EFBFBD><EFBFBD><EFBFBD>澆<EFBFBD>**嚗?
|
||||
```
|
||||
<EFBFBD><EFBFBD> IIT Manager <20>唳旿敶訫<E695B6><E8A8AB>𡁶䰻
|
||||
|
||||
憿寧𤌍嚗魩est0102
|
||||
霈啣<EFBFBD>ID嚗鯴xx
|
||||
銵典<EFBFBD>嚗鯴xx
|
||||
时间:2026-01-02 23:55:00
|
||||
<EFBFBD>園𡢿嚗?026-01-02 23:55:00
|
||||
|
||||
💡 质控建议 (3项):
|
||||
1. ✅ 数据录入及时(5分钟内)
|
||||
2. ✅ 记录ID有效
|
||||
3. ✅ 表单:demographics
|
||||
<EFBFBD>働 韐冽綉撱箄悅 (3憿?嚗?
|
||||
1. <EFBFBD>?<3F>唳旿敶訫<E695B6><E8A8AB>𦠜𧒄嚗?<3F><><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
|
||||
2. <EFBFBD>?霈啣<E99C88>ID<49>㗇<EFBFBD>
|
||||
3. <EFBFBD>?銵典<E98AB5>嚗飱emographics
|
||||
|
||||
✅ 数据质量良好,无明显问题
|
||||
<EFBFBD>?<3F>唳旿韐券<E99F90><E588B8>臬末嚗峕<E59A97><E5B395>擧遬<E693A7>桅<EFBFBD>
|
||||
|
||||
<EFBFBD>俥 憒<><E68692><EFBFBD>煾䔮嚗諹窈<E8ABB9>𧼮<EFBFBD>"撣桀𨭌"<22>亦<EFBFBD><E4BAA6>游<EFBFBD><E6B8B8>蠘<EFBFBD>
|
||||
```
|
||||
@@ -205,38 +205,38 @@ jobQueue.process('iit_quality_check', async (job) => {
|
||||
|
||||
## <20>圲 撘<><E69298>𤏸<EFBFBD>蝔衤<E89D94><E8A1A4>桅<EFBFBD>閫<EFBFBD><E996AB>
|
||||
|
||||
### 问题1:环境变量名称不一致 ⚠️
|
||||
### <EFBFBD>桅<EFBFBD>1嚗𡁶㴓憓<EFBFBD><EFBFBD><EFBFBD>誩<EFBFBD>蝘唬<EFBFBD>銝<EFBFBD><EFBFBD>?<3F>𩤃<EFBFBD>
|
||||
|
||||
**现象**:
|
||||
**<EFBFBD>啗情**嚗?
|
||||
```
|
||||
hasSecret: false
|
||||
Error: 企业微信配置不完整,请检查环境变量
|
||||
Error: 隡<EFBFBD><EFBFBD>敺桐縑<EFBFBD>滨蔭銝滚<EFBFBD><EFBFBD>湛<EFBFBD>霂瑟<EFBFBD><EFBFBD>亦㴓憓<EFBFBD><EFBFBD><EFBFBD>?
|
||||
```
|
||||
|
||||
**原因**:
|
||||
**<EFBFBD>笔<EFBFBD>**嚗?
|
||||
- <20>臬<EFBFBD><E887AC>㗛<EFBFBD>嚗䫤WECHAT_CORP_SECRET`
|
||||
- 隞<><E99A9E>霂餃<E99C82>嚗䫤WECHAT_AGENT_SECRET`
|
||||
|
||||
**解决方案**:
|
||||
**閫<EFBFBD><EFBFBD><EFBFBD>寞<EFBFBD>**嚗?
|
||||
```typescript
|
||||
// 修改前
|
||||
// 靽格㺿<EFBFBD>?
|
||||
agentSecret: process.env.WECHAT_AGENT_SECRET
|
||||
|
||||
// 修改后
|
||||
// 靽格㺿<EFBFBD>?
|
||||
agentSecret: process.env.WECHAT_CORP_SECRET
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 问题2:@wecom/crypto 导入方式错误 ❌
|
||||
### <EFBFBD>桅<EFBFBD>2嚗鋣wecom/crypto 撖澆<EFBFBD><EFBFBD>孵<EFBFBD><EFBFBD>躰秤 <20>?
|
||||
|
||||
**现象**:
|
||||
**<EFBFBD>啗情**嚗?
|
||||
```
|
||||
TypeError: WXBizMsgCrypt is not a constructor
|
||||
```
|
||||
|
||||
**原因**:
|
||||
`@wecom/crypto` 不是一个类,而是导出了4个独立的函数:
|
||||
**<EFBFBD>笔<EFBFBD>**嚗?
|
||||
`@wecom/crypto` 銝齿糓銝<EFBFBD>銝芰掩嚗諹<EFBFBD>峕糓撖澆枂鈭?銝芰𡠺蝡讠<E89DA1><E8AEA0>賣㺭嚗?
|
||||
```javascript
|
||||
{
|
||||
decrypt: [Function: decrypt],
|
||||
@@ -246,33 +246,33 @@ TypeError: WXBizMsgCrypt is not a constructor
|
||||
}
|
||||
```
|
||||
|
||||
**解决方案**:
|
||||
**閫<EFBFBD><EFBFBD><EFBFBD>寞<EFBFBD>**嚗?
|
||||
```typescript
|
||||
// 修改前(错误)
|
||||
// 靽格㺿<EFBFBD>㵪<EFBFBD><EFBFBD>躰秤嚗?
|
||||
import WXBizMsgCrypt from '@wecom/crypto';
|
||||
this.wxcrypt = new WXBizMsgCrypt(token, aesKey, corpId);
|
||||
|
||||
// 修改后(正确)
|
||||
// 靽格㺿<EFBFBD>𠬍<EFBFBD>甇<EFBFBD>&嚗?
|
||||
const require = createRequire(import.meta.url);
|
||||
const { decrypt, encrypt, getSignature } = require('@wecom/crypto');
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 问题3:decrypt 函数参数错误 ❌
|
||||
### <EFBFBD>桅<EFBFBD>3嚗飱ecrypt <EFBFBD>賣㺭<EFBFBD><EFBFBD>㺭<EFBFBD>躰秤 <20>?
|
||||
|
||||
**现象**:
|
||||
**<EFBFBD>啗情**嚗?
|
||||
```
|
||||
Error: invalid encodingAESKey
|
||||
```
|
||||
|
||||
**原因**:
|
||||
通过测试脚本发现,`decrypt` 函数只需要 **2个参数**:
|
||||
**<EFBFBD>笔<EFBFBD>**嚗?
|
||||
<EFBFBD>朞<EFBFBD>瘚贝<EFBFBD><EFBFBD>𡁏𧋦<EFBFBD>𤑳緵嚗䈣decrypt` <20>賣㺭<E8B3A3>芷<EFBFBD>閬?**2銝芸<E98A9D><E88AB8>?*嚗?
|
||||
```javascript
|
||||
function decrypt(encodingAESKey, encrypt) { ... }
|
||||
```
|
||||
|
||||
**解决方案**:
|
||||
**閫<EFBFBD><EFBFBD><EFBFBD>寞<EFBFBD>**嚗?
|
||||
```typescript
|
||||
// 靽格㺿<E6A0BC>㵪<EFBFBD><E3B5AA>躰秤 - 4銝芸<E98A9D><E88AB8>堆<EFBFBD>
|
||||
const result = decrypt(this.token, this.encodingAESKey, this.corpId, echostr);
|
||||
@@ -285,51 +285,51 @@ const result = decrypt(this.encodingAESKey, echostr);
|
||||
|
||||
### <20>桅<EFBFBD>4嚗関oken摮㛖泵霂<E6B3B5><E99C82><EFBFBD>躰秤 <20>𩤃<EFBFBD>
|
||||
|
||||
**现象**:
|
||||
**<EFBFBD>啗情**嚗?
|
||||
```
|
||||
<EFBFBD>𩤃<EFBFBD> 蝑曉<E89D91>撉諹<E69289>憭梯揖
|
||||
expected: 0b7cf05d6cb23ab9ce2efca6fdc659f32051eabe
|
||||
calculated: 6f79cabd3e9eea5eb10f55abdcf087ce6393d51d
|
||||
```
|
||||
|
||||
**原因**:
|
||||
**<EFBFBD>笔<EFBFBD>**嚗?
|
||||
Token<EFBFBD><EFBFBD>洵3銝芸<EFBFBD>蝚血捆<EFBFBD>𤘪毽瘛<EFBFBD><EFBFBD>
|
||||
- `oX1R...`(数字1)
|
||||
- `oXlR...`(小写字母l)
|
||||
- `oX1R...`嚗<>㺭摮?嚗?
|
||||
- `oXlR...`嚗<><E59A97><EFBFBD>坔<EFBFBD>瘥徃嚗?
|
||||
|
||||
后端日志显示的是 `oXlR...`(小写l),而调试工具中可能输入了数字1。
|
||||
<EFBFBD>𡒊垢<EFBFBD>亙<EFBFBD><EFBFBD>曄內<EFBFBD><EFBFBD>糓 `oXlR...`嚗<><E59A97><EFBFBD>耱嚗㚁<E59A97><E39A81>諹<EFBFBD>霂訫極<E8A8AB>瑚葉<E7919A>航<EFBFBD>颲枏<E9A2B2>鈭<EFBFBD>㺭摮?<3F>?
|
||||
|
||||
**解决方案**:
|
||||
- 直接从 `.env` 文件复制粘贴,避免手动输入
|
||||
**閫<EFBFBD><EFBFBD><EFBFBD>寞<EFBFBD>**嚗?
|
||||
- <20>湔𦻖隞?`.env` <20><>辣憭滚<E686AD>蝎䁅斐嚗屸<E59A97><E5B1B8>齿<EFBFBD><E9BDBF>刻<EFBFBD><E588BB>?
|
||||
- 蝖株恕 Token 銝綽<E98A9D>`oXlRBm1YnvMy2SbDLbvAdDd5Gq3oBGq`
|
||||
|
||||
---
|
||||
|
||||
### <20>桅<EFBFBD>5嚗鍃ncodingAESKey <20>湔鰵 <20><>
|
||||
|
||||
**现象**:
|
||||
旧的 EncodingAESKey 可能格式有问题导致解密失败。
|
||||
**<EFBFBD>啗情**嚗?
|
||||
<EFBFBD>抒<EFBFBD> EncodingAESKey <EFBFBD>航<EFBFBD><EFBFBD>澆<EFBFBD><EFBFBD>厰䔮憸睃紡<EFBFBD>渲圾撖<EFBFBD>仃韐乓<EFBFBD>?
|
||||
|
||||
**解决方案**:
|
||||
**閫<EFBFBD><EFBFBD><EFBFBD>寞<EFBFBD>**嚗?
|
||||
<EFBFBD>其<EFBFBD>銝𡁜凝靽∠恣<EFBFBD><EFBFBD><EFBFBD><EFBFBD>圈<EFBFBD><EFBFBD>啁<EFBFBD><EFBFBD>琜<EFBFBD>
|
||||
```
|
||||
<EFBFBD>批<EFBFBD>潘<EFBFBD>zE4tcdBeekCHPUV015jCh9RVUydnCITINqSmCzg9xtO
|
||||
新值:v88eT3O9bMW897h4btr7v7qvQImlMf31edTQCmuhOhO(43位,格式正确)
|
||||
<EFBFBD>啣<EFBFBD>潘<EFBFBD>v88eT3O9bMW897h4btr7v7qvQImlMf31edTQCmuhOhO嚗?3雿㵪<E99BBF><E3B5AA>澆<EFBFBD>甇<EFBFBD>&嚗?
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 问题6:natapp 内网穿透配置 🌐
|
||||
### <EFBFBD>桅<EFBFBD>6嚗䭰atapp <20><><EFBFBD>蝛輸<E89D9B>誯<EFBFBD>蝵?<3F><>
|
||||
|
||||
**需求**:
|
||||
本地开发环境需要公网 HTTPS URL 用于企业微信回调。
|
||||
**<EFBFBD><EFBFBD>瘙?*嚗?
|
||||
<EFBFBD>砍𧑐撘<EFBFBD><EFBFBD>𤑳㴓憓<EFBFBD><EFBFBD>閬<EFBFBD><EFBFBD>蝵?HTTPS URL <20>其<EFBFBD>隡<EFBFBD><E99AA1>敺桐縑<E6A190>噼<EFBFBD><E599BC>?
|
||||
|
||||
**解决方案**:
|
||||
**閫<EFBFBD><EFBFBD><EFBFBD>寞<EFBFBD>**嚗?
|
||||
1. 雿輻鍂 natapp <20>滚𦛚
|
||||
2. 配置隧道:`http://iit.nat100.top` → `127.0.0.1:3001`
|
||||
2. <20>滨蔭<E6BBA8>折<EFBFBD>嚗䫤http://iit.nat100.top` <EFBFBD>?`127.0.0.1:3001`
|
||||
3. natapp <20>芸𢆡<E88AB8>𣂷<EFBFBD> HTTPS <20>舀<EFBFBD>
|
||||
|
||||
**验证**:
|
||||
**撉諹<EFBFBD>**嚗?
|
||||
```bash
|
||||
curl https://iit.nat100.top/api/v1/iit/health
|
||||
# 餈𥪜<E9A488>嚗㝯"status":"ok","module":"iit-manager",...}
|
||||
@@ -339,11 +339,11 @@ curl https://iit.nat100.top/api/v1/iit/health
|
||||
|
||||
## <20>妒 瘚贝<E7989A>撉諹<E69289>
|
||||
|
||||
### 测试1:企业微信开发者调试工具验证 ✅
|
||||
### 瘚贝<EFBFBD>1嚗帋<EFBFBD>銝𡁜凝靽∪<EFBFBD><EFBFBD>𤏸<EFBFBD><EFBFBD><EFBFBD>霂訫極<EFBFBD>琿<EFBFBD>霂?<3F>?
|
||||
|
||||
**工具**:企业微信管理后台 → 开发者工具 → 测试回调模式
|
||||
**撌亙<EFBFBD>**嚗帋<E59A97>銝𡁜凝靽∠恣<E288A0><E681A3><EFBFBD><EFBFBD>?<3F>?撘<><E69298>𤏸<EFBFBD><F0A48FB8>極<EFBFBD>?<3F>?瘚贝<E7989A><E8B49D>噼<EFBFBD>璅∪<E79285>
|
||||
|
||||
**配置**:
|
||||
**<EFBFBD>滨蔭**嚗?
|
||||
```
|
||||
URL: https://iit.nat100.top/api/v1/iit/wechat/callback
|
||||
Token: oXlRBm1YnvMy2SbDLbvAdDd5Gq3oBGq
|
||||
@@ -352,33 +352,33 @@ EchoStr: test12345678901234567890123
|
||||
ToUserName: ww6ab493470ab4f377
|
||||
```
|
||||
|
||||
**测试结果**:
|
||||
**瘚贝<EFBFBD>蝏𤘪<EFBFBD>**嚗?
|
||||
```
|
||||
✅ 返回状态:request: 成功
|
||||
✅ 返回结果:123456789012345678901 25(解密后的23位字符)
|
||||
✅ HTTP状态码:200
|
||||
<EFBFBD>?餈𥪜<E9A488><F0A5AA9C>嗆<EFBFBD><E59786><EFBFBD>request: <EFBFBD>𣂼<EFBFBD>
|
||||
<EFBFBD>?餈𥪜<E9A488>蝏𤘪<E89D8F>嚗?23456789012345678901 25嚗<EFBFBD>圾撖<EFBFBD><EFBFBD><EFBFBD>?3雿滚<E99BBF>蝚佗<E89D9A>
|
||||
<EFBFBD>?HTTP<EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD>嚗?00
|
||||
```
|
||||
|
||||
**后端日志**:
|
||||
**<EFBFBD>𡒊垢<EFBFBD>亙<EFBFBD>**嚗?
|
||||
```
|
||||
<EFBFBD>𢬢 <20>嗅<EFBFBD>隡<EFBFBD><E99AA1>敺桐縑 URL 撉諹<E69289>霂瑟<E99C82>
|
||||
nonce: "95zbplrrko5"
|
||||
echostrLength: 88
|
||||
✅ URL 验证成功
|
||||
<EFBFBD>?URL 撉諹<EFBFBD><EFBFBD>𣂼<EFBFBD>
|
||||
decryptedLength: 23
|
||||
statusCode: 200
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 测试2:natapp 隧道连通性测试 ✅
|
||||
### 瘚贝<EFBFBD>2嚗䭰atapp <20>折<EFBFBD>餈鮋<E9A488>𡁏<EFBFBD>扳<EFBFBD>霂?<3F>?
|
||||
|
||||
**测试命令**:
|
||||
**瘚贝<EFBFBD><EFBFBD>賭誘**嚗?
|
||||
```bash
|
||||
curl https://iit.nat100.top/api/v1/iit/health
|
||||
```
|
||||
|
||||
**返回结果**:
|
||||
**餈𥪜<EFBFBD>蝏𤘪<EFBFBD>**嚗?
|
||||
```json
|
||||
{
|
||||
"status": "ok",
|
||||
@@ -392,7 +392,7 @@ curl https://iit.nat100.top/api/v1/iit/health
|
||||
|
||||
## <20><> <20>滨蔭皜<E894AD><E79A9C>
|
||||
|
||||
### 后端环境变量(backend/.env)
|
||||
### <EFBFBD>𡒊垢<EFBFBD>臬<EFBFBD><EFBFBD>㗛<EFBFBD>嚗Ê̄ackend/.env嚗?
|
||||
|
||||
```env
|
||||
# ==========================================
|
||||
@@ -404,14 +404,14 @@ WECHAT_CORP_ID=ww6ab493470ab4f377
|
||||
WECHAT_AGENT_ID=1000002
|
||||
WECHAT_CORP_SECRET=AZIVxMtoLb0rEszXS81e4dBRl-I9kgTjygIS0cFfENU
|
||||
|
||||
# 企业微信回调配置(消息加解密)
|
||||
# 隡<EFBFBD><EFBFBD>敺桐縑<EFBFBD>噼<EFBFBD><EFBFBD>滨蔭嚗<EFBFBD><EFBFBD><EFBFBD>臬<EFBFBD>閫<EFBFBD><EFBFBD>嚗?
|
||||
WECHAT_TOKEN=oXlRBm1YnvMy2SbDLbvAdDd5Gq3oBGq
|
||||
WECHAT_ENCODING_AES_KEY=v88eT3O9bMW897h4btr7v7qvQImlMf31edTQCmuhOhO
|
||||
```
|
||||
|
||||
### 隡<><E99AA1>敺桐縑摨𠉛鍂<F0A0899B>滨蔭
|
||||
|
||||
**应用信息**:
|
||||
**摨𠉛鍂靽⊥<EFBFBD>**嚗?
|
||||
- 隡<><E99AA1>ID嚗䫤ww6ab493470ab4f377`
|
||||
- 摨𠉛鍂<F0A0899B>滨妍嚗䫤IIT Manager Agent`
|
||||
- AgentID嚗䫤1000002`
|
||||
@@ -423,9 +423,9 @@ Token: oXlRBm1YnvMy2SbDLbvAdDd5Gq3oBGq
|
||||
EncodingAESKey: v88eT3O9bMW897h4btr7v7qvQImlMf31edTQCmuhOhO
|
||||
```
|
||||
|
||||
**可信域名**:
|
||||
**<EFBFBD>臭縑<EFBFBD>笔<EFBFBD>**嚗?
|
||||
```
|
||||
iit.xunzhengyixue.com(SAE生产环境)
|
||||
iit.xunzhengyixue.com嚗𠄎AE<EFBFBD>煺漣<EFBFBD>臬<EFBFBD>嚗?
|
||||
```
|
||||
|
||||
### natapp <20>滨蔭
|
||||
@@ -433,8 +433,8 @@ iit.xunzhengyixue.com(SAE生产环境)
|
||||
```
|
||||
<EFBFBD>折<EFBFBD><EFBFBD>嗆<EFBFBD><EFBFBD><EFBFBD>Online
|
||||
<EFBFBD>祉<EFBFBD>URL嚗冴ttp://iit.nat100.top
|
||||
本地端口:127.0.0.1:3001
|
||||
HTTPS:自动支持
|
||||
<EFBFBD>砍𧑐蝡臬藁嚗?27.0.0.1:3001
|
||||
HTTPS嚗朞䌊<EFBFBD>冽𣈲<EFBFBD>?
|
||||
```
|
||||
|
||||
---
|
||||
@@ -443,64 +443,64 @@ HTTPS:自动支持
|
||||
|
||||
| <20><>辣 | 隞<><E99A9E>銵峕㺭 | 銝餉<E98A9D><E9A489>蠘<EFBFBD> |
|
||||
|------|---------|---------|
|
||||
| WechatService.ts | 314行 | 企业微信消息推送 |
|
||||
| WechatCallbackController.ts | 501行 | 企业微信回调处理 |
|
||||
| index.ts(质控Worker) | +80行 | 质控完成后推送通知 |
|
||||
| routes/index.ts | +48行 | 企业微信路由注册 |
|
||||
| **总计** | **~943行** | 企业微信集成核心代码 |
|
||||
| WechatService.ts | 314銵?| 隡<><E99AA1>敺桐縑瘨<E7B891><E798A8><EFBFBD>券<EFBFBD>?|
|
||||
| WechatCallbackController.ts | 501銵?| 隡<><E99AA1>敺桐縑<E6A190>噼<EFBFBD>憭<EFBFBD><E686AD> |
|
||||
| index.ts嚗<EFBFBD>捶<EFBFBD>劬orker嚗?| +80銵?| 韐冽綉摰峕<E691B0><E5B395>擧綫<E693A7><E7B6AB><EFBFBD>𡁶䰻 |
|
||||
| routes/index.ts | +48銵?| 隡<><E99AA1>敺桐縑頝舐眏瘜典<E7989C> |
|
||||
| **<EFBFBD>餉恣** | **~943銵?* | 隡<EFBFBD><EFBFBD>敺桐縑<EFBFBD><EFBFBD><EFBFBD><EFBFBD>詨<EFBFBD>隞<EFBFBD><EFBFBD> |
|
||||
|
||||
---
|
||||
|
||||
## ✅ 已完成的功能
|
||||
## <EFBFBD>?撌脣<E6928C><E884A3>鞟<EFBFBD><E99E9F>蠘<EFBFBD>
|
||||
|
||||
- [x] 企业微信 Access Token 管理(缓存+刷新)
|
||||
- [x] 隡<EFBFBD><EFBFBD>敺桐縑 Access Token 蝞∠<EFBFBD>嚗<EFBFBD><EFBFBD>摮?<3F>瑟鰵嚗?
|
||||
- [x] <20>煾<EFBFBD><E785BE><EFBFBD><EFBFBD>祆<EFBFBD><E7A586>臬<EFBFBD>隡<EFBFBD><E99AA1>敺桐縑
|
||||
- [x] 发送 Markdown 消息到企业微信
|
||||
- [x] 企业微信 URL 验证(GET请求处理)
|
||||
- [x] 企业微信消息接收(POST请求处理)
|
||||
- [x] 消息解密(使用 @wecom/crypto)
|
||||
- [x] 签名验证(使用 @wecom/crypto)
|
||||
- [x] 异步回复模式(规避5秒超时)
|
||||
- [x] <EFBFBD>煾<EFBFBD>?Markdown 瘨<EFBFBD><EFBFBD><EFBFBD>唬<EFBFBD>銝𡁜凝靽?
|
||||
- [x] 隡<EFBFBD><EFBFBD>敺桐縑 URL 撉諹<E69289>嚗𠃑ET霂瑟<E99C82>憭<EFBFBD><E686AD>嚗?
|
||||
- [x] 隡<EFBFBD><EFBFBD>敺桐縑瘨<EFBFBD><EFBFBD><EFBFBD>交𤣰嚗㇊OST霂瑟<EFBFBD>憭<EFBFBD><EFBFBD>嚗?
|
||||
- [x] 瘨<EFBFBD><EFBFBD>閫<EFBFBD><EFBFBD>嚗<EFBFBD>蝙<EFBFBD>?@wecom/crypto嚗?
|
||||
- [x] 蝑曉<EFBFBD>撉諹<EFBFBD>嚗<EFBFBD>蝙<EFBFBD>?@wecom/crypto嚗?
|
||||
- [x] 撘<EFBFBD>郊<EFBFBD>𧼮<EFBFBD>璅∪<EFBFBD>嚗<EFBFBD><EFBFBD><EFBFBD>?蝘坿<E89D98><E59DBF>塚<EFBFBD>
|
||||
- [x] <20>喲睸霂齿<E99C82><E9BDBF>曇<EFBFBD><E69B87>恬<EFBFBD>瘙<EFBFBD><E79899>颯<EFBFBD><E9A2AF>葬<EFBFBD>押<EFBFBD><E68ABC>鰵<EFBFBD><E9B0B5><EFBFBD><EFBFBD><EFBFBD>
|
||||
- [x] 韐冽綉Worker<65>券<EFBFBD><E588B8><EFBFBD>銝𡁜凝靽⊿<E99DBD>𡁶䰻
|
||||
- [x] 摰∟恣<E2889F>亙<EFBFBD>霈啣<E99C88>
|
||||
- [x] natapp 内网穿透配置
|
||||
- [x] natapp <EFBFBD><EFBFBD><EFBFBD>蝛輸<EFBFBD>誯<EFBFBD>蝵?
|
||||
|
||||
---
|
||||
|
||||
## ⏳ 待完成的功能
|
||||
## <EFBFBD>?敺<><E695BA><EFBFBD>鞟<EFBFBD><E99E9F>蠘<EFBFBD>
|
||||
|
||||
- [ ] 靽嘥<E99DBD>甇<EFBFBD><E79487><EFBFBD><EFBFBD><EFBFBD>銝𡁜凝靽∪<E99DBD>靚<EFBFBD>RL<52>滨蔭
|
||||
- [ ] 配置数据库中的 `wechat_user_id`(PI的企业微信UserID)
|
||||
- [ ] 端到端测试(REDCap → 企微推送)
|
||||
- [ ] LLM意图识别(升级关键词匹配)
|
||||
- [ ] <EFBFBD>滨蔭<EFBFBD>唳旿摨㮖葉<EFBFBD>?`wechat_user_id`嚗㇊I<EFBFBD><EFBFBD><EFBFBD>銝𡁜凝靽|serID嚗?
|
||||
- [ ] 蝡臬<EFBFBD>蝡舀<EFBFBD>霂𤏪<EFBFBD>REDCap <20>?隡<>凝<EFBFBD>券<EFBFBD><E588B8><EFBFBD>
|
||||
- [ ] LLM<EFBFBD>誩㦛霂<EFBFBD><EFBFBD>嚗<EFBFBD><EFBFBD>蝥批<EFBFBD><EFBFBD>株<EFBFBD><EFBFBD>寥<EFBFBD>嚗?
|
||||
- [ ] 撖寡<E69296><E5AFA1>蠘<EFBFBD>摰<EFBFBD><E691B0>嚗<EFBFBD>凒憭帋<E686AD><E5B88B>∪㦤<E288AA>荔<EFBFBD>
|
||||
- [ ] IP<49>賢<EFBFBD><E8B3A2>閖<EFBFBD>蝵殷<E89DB5><E6AEB7>函蔡<E587BD>訕AE<41>塚<EFBFBD>
|
||||
|
||||
---
|
||||
|
||||
## 🚀 下一步计划
|
||||
## <EFBFBD><EFBFBD> 銝衤<E98A9D>甇亥恣<E4BAA5>?
|
||||
|
||||
### Day 3 銝见<E98A9D>/<2F>帋<EFBFBD>嚗<EFBFBD>虾<EFBFBD>㚁<EFBFBD>
|
||||
|
||||
1. **保存企业微信正式配置**(5分钟)
|
||||
1. **靽嘥<EFBFBD>隡<EFBFBD><EFBFBD>敺桐縑甇<EFBFBD><EFBFBD><EFBFBD>滨蔭**嚗?<3F><><EFBFBD>嚗?
|
||||
- <20>其<EFBFBD>銝𡁜凝靽∠恣<E288A0><E681A3><EFBFBD><EFBFBD>唬<EFBFBD>摮睃<E691AE>靚<EFBFBD>RL<52>滨蔭
|
||||
- <20>暸<EFBFBD>厰<EFBFBD>閬<EFBFBD>𦻖<EFBFBD>嗥<EFBFBD>瘨<EFBFBD><E798A8>蝐餃<E89D90>
|
||||
|
||||
2. **配置项目通知**(10分钟)
|
||||
- 获取 PI 的企业微信 UserID
|
||||
- 更新数据库 `projects` 表的 `notification_config` 字段
|
||||
2. **<EFBFBD>滨蔭憿寧𤌍<EFBFBD>𡁶䰻**嚗?0<><30><EFBFBD>嚗?
|
||||
- <EFBFBD>瑕<EFBFBD> PI <EFBFBD><EFBFBD><EFBFBD>銝𡁜凝靽?UserID
|
||||
- <EFBFBD>湔鰵<EFBFBD>唳旿摨?`projects` 銵函<EFBFBD> `notification_config` 摮埈挾
|
||||
|
||||
3. **端到端测试**(30分钟)
|
||||
- 在 REDCap 中录入测试数据
|
||||
3. **蝡臬<EFBFBD>蝡舀<EFBFBD>霂?*嚗?0<><30><EFBFBD>嚗?
|
||||
- <EFBFBD>?REDCap 銝剖<EFBFBD><EFBFBD>交<EFBFBD>霂閙㺭<EFBFBD>?
|
||||
- 撉諹<E69289>隡<EFBFBD><E99AA1>敺桐縑<E6A190>嗅<EFBFBD>摰墧𧒄<E5A2A7>𡁶䰻
|
||||
- 测试对话功能(发送"帮助"、"汇总"等关键词)
|
||||
- 瘚贝<EFBFBD>撖寡<EFBFBD><EFBFBD>蠘<EFBFBD>嚗<EFBFBD><EFBFBD><EFBFBD>?撣桀𨭌"<22>?瘙<><E79899>?蝑匧<E89D91><E58CA7>株<EFBFBD>嚗?
|
||||
|
||||
### Day 4嚗<34><E59A97>蝏凋<E89D8F><E5878B>吔<EFBFBD>
|
||||
|
||||
1. **LLM<4C>誩㦛霂<E3A69B><E99C82>**
|
||||
- 接入 DeepSeek 或其他 LLM
|
||||
- 实现真正的 AI Agent 对话
|
||||
- <EFBFBD>亙<EFBFBD> DeepSeek <EFBFBD>硋<EFBFBD>隞?LLM
|
||||
- 摰䂿緵<EFBFBD><EFBFBD>迤<EFBFBD>?AI Agent 撖寡<EFBFBD>
|
||||
|
||||
2. **<EFBFBD>蠘<EFBFBD>摰<EFBFBD><EFBFBD>**
|
||||
- <20>游<EFBFBD>撖寡<E69296><E5AFA1>箸艶嚗<E889B6>㺭<EFBFBD>格䰻霂U<E99C82><EFBCB5><EFBFBD>霈∪<E99C88><E288AA>琜<EFBFBD>
|
||||
@@ -514,12 +514,12 @@ HTTPS:自动支持
|
||||
|
||||
---
|
||||
|
||||
## 📖 参考文档
|
||||
## <EFBFBD><EFBFBD> <20><><EFBFBD><EFBFBD><EFBFBD>獢?
|
||||
|
||||
- [隡<EFBFBD><EFBFBD>敺桐縑API<EFBFBD><EFBFBD>﹝](https://developer.work.weixin.qq.com/document/path/90664)
|
||||
- [隡<><E99AA1>敺桐縑瘨<E7B891><E798A8><EFBFBD>㰘圾撖<E59CBE>秩<EFBFBD>筕(https://developer.work.weixin.qq.com/document/path/90968)
|
||||
- [@wecom/crypto GitHub](https://github.com/wecomteam/crypto)
|
||||
- [最小MVP闭环开发计划](../04-开发计划/最小MVP闭环开发计划.md)
|
||||
- [<EFBFBD><EFBFBD>撠𦬅VP<EFBFBD>剔㴓撘<EFBFBD><EFBFBD>𤏸恣<EFBFBD>哋(../04-撘<><E69298>𤏸恣<F0A48FB8>?<3F><>撠𦬅VP<56>剔㴓撘<E3B493><E69298>𤏸恣<F0A48FB8>?md)
|
||||
|
||||
---
|
||||
|
||||
@@ -527,19 +527,20 @@ HTTPS:自动支持
|
||||
|
||||
Day 3 <20><><EFBFBD><EFBFBD>穃極雿𡏭蒾<F0A18FAD>園<EFBFBD><E59C92>唬<EFBFBD>憭帋葵<E5B88B><E891B5><EFBFBD>舫䔮憸矋<E686B8>雿<EFBFBD><E99BBF>蝏<EFBFBD><E89D8F><EFBFBD>笔<EFBFBD><E7AC94>𣂷<EFBFBD>隡<EFBFBD><E99AA1>敺桐縑<E6A190><E7B891><EFBFBD><EFBFBD><EFBFBD>瓲敹<E793B2><E695B9><EFBFBD>賬<EFBFBD><E8B3AC><EFBFBD>朞<EFBFBD>靚<EFBFBD><E99D9A>撌亙<E6928C><E4BA99><EFBFBD><EFBFBD>霂<EFBFBD><E99C82>霂<EFBFBD><E99C82>鈭<EFBFBD><E988AD>
|
||||
|
||||
1. ✅ **技术方案可行**:@wecom/crypto 库正常工作
|
||||
2. ✅ **架构设计合理**:异步回复模式有效规避超时问题
|
||||
3. ✅ **代码质量良好**:详细的日志和错误处理
|
||||
4. ✅ **开发流程完善**:问题排查→测试验证→文档记录
|
||||
1. <EFBFBD>?**<2A><><EFBFBD>舀䲮獢<E4B2AE>虾銵?*嚗鋣wecom/crypto 摨𤘪迤撣詨極雿?
|
||||
2. <EFBFBD>?**<2A>嗆<EFBFBD>霈曇恣<E69B87><E681A3><EFBFBD>**嚗𡁜<E59A97>甇亙<E79487>憭齿芋撘𤩺<E69298><F0A4A9BA><EFBFBD><EFBFBD><EFBFBD>輯<EFBFBD><E8BCAF>園䔮憸?
|
||||
3. <EFBFBD>?**隞<><E99A9E>韐券<E99F90><E588B8>臬末**嚗朞祕蝏<E7A595><E89D8F><EFBFBD>亙<EFBFBD><E4BA99>屸<EFBFBD>霂臬<E99C82><E887AC>?
|
||||
4. <EFBFBD>?**撘<><E69298>烐<EFBFBD>蝔见<E89D94><E8A781>?*嚗𡁻䔮憸䀹<E686B8><E480B9>乒<EFBFBD>瘚贝<E7989A>撉諹<E69289><E8ABB9>埝<EFBFBD>獢<EFBFBD>扇敶?
|
||||
|
||||
**距离完整的 MVP 闭环只差最后的端到端测试了!**
|
||||
**頝萘氖摰峕㟲<EFBFBD>?MVP <20>剔㴓<E58994>芸榆<E88AB8><E6A686><EFBFBD>𡒊<EFBFBD>蝡臬<E89DA1>蝡舀<E89DA1>霂蓥<E99C82>嚗?*
|
||||
|
||||
---
|
||||
|
||||
**记录人**:AI Assistant
|
||||
**审核人**:开发团队
|
||||
**霈啣<EFBFBD>鈭?*嚗鋫I Assistant
|
||||
**摰⊥瓲鈭?*嚗𡁜<E59A97><F0A1819C>穃𣪧<E7A983>?
|
||||
**<EFBFBD><EFBFBD>﹝<EFBFBD><EFBFBD>𧋦**嚗鯝1.0
|
||||
**最后更新**:2026-01-02 23:55:00
|
||||
**<EFBFBD><EFBFBD><EFBFBD>擧凒<EFBFBD>?*嚗?026-01-02 23:55:00
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Reference in New Issue
Block a user