# xlpp

**Repository Path**: myself_56/xlpp

## Basic Information

- **Project Name**: xlpp
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-28
- **Last Updated**: 2026-11-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 性格匹配交友小程序 — 项目文档索引

## 🖥 服务器基础信息

| 项目           | 值                             |
| -------------- | ------------------------------ |
| 内网 IP        | `10.1.0.6`                     |
| 公网 IP        | `134.175.197.20`               |
| 域名           | https://www.yvlead.com         |
| Nginx 配置     | `docs/root/nginx/`             |
| Docker Compose | `docs/root/docker-compose.yml` |

## 📱 微信小程序

| 项目      | 值                                 |
| --------- | ---------------------------------- |
| AppID     | `wxb31c0f713d6d0df3`               |
| AppSecret | `146b794a852cc8ae244975fd4201b611` |

## ☁️ 腾讯云账号

| 项目          | 值                                                                                  |
| ------------- | ----------------------------------------------------------------------------------- |
| 主账号 ID     | `100051366051`                                                                      |
| 子账号        | `ad`                                                                                |
| 登录密码      | `2hE-$j:2`                                                                          |
| 快捷登录      | https://cloud.tencent.com/login/subAccount/100051366051?type=subAccount&username=ad |
| API SecretId  | `AKIDjpBPQK5dyAB0c3JQK1Zx8iCUaT9jAOPF`                                              |
| API SecretKey | `kHahgU7A2jDUNBmBOQHwPgllKiuukPr7`                                                  |

### 已接入的腾讯云服务

| 服务                | 模块                 | 用途                                                   | 启用状态    |
| ------------------- | -------------------- | ------------------------------------------------------ | ----------- |
| **人脸核身 FaceID** | `yudao-module-match` | 实名认证二要素核验（姓名+身份证号 → 公安库一致性校验） | ✅ 生产启用 |
| **IM（TIM）**       | `yudao-module-im`    | 私聊/群聊消息异步双写备份                              | ✅ 生产启用 |

---

## 📋 实名认证自动核验配置

> 更新日期：2026-09-17

### 工作流程

```
用户提交身份证（姓名 + 身份证号）
    │
    ▼
┌─ 三档模式调度 ─────────────────────────────────────┐
│                                                      │
│  mock-auto-approve=false, real-api.enabled=true      │
│  provider=tencent                                    │
│                                                      │
│  → 自动调腾讯云 FaceID IdCardVerification 二要素核验 │
│                                                      │
│  ├─ Result=0  一致       → APPROVED（自动通过）      │
│  ├─ Result=-1 不一致     → REJECTED（直接打回）      │
│  ├─ Result=-2/-3/-5     → REJECTED（非法/无记录）    │
│  └─ Result=-4/-6/-7     → PENDING（降级人工审核）    │
│     SDK 异常网络/限流 ──┘                             │
│                                                      │
│  PENDING 记录进入后台 「平台管理中心 → 实名审核」     │
│  菜单 ID=7670 / 按钮权限 ID=7672                     │
└──────────────────────────────────────────────────────┘
```

### 腾讯云 IdCardVerification 结果码

| Result | 含义                        | 处理           | 收费      |
| ------ | --------------------------- | -------------- | --------- |
| `0`    | 姓名和身份证号一致          | → APPROVED     | ✅ 收费   |
| `-1`   | 姓名和身份证号不一致        | → REJECTED     | ✅ 收费   |
| `-2`   | 非法身份证号（长度/校验位） | → REJECTED     | ❌ 不收费 |
| `-3`   | 非法姓名（长度/格式）       | → REJECTED     | ❌ 不收费 |
| `-4`   | 证件库服务异常              | → PENDING 降级 | ❌ 不收费 |
| `-5`   | 证件库中无此身份证记录      | → REJECTED     | ❌ 不收费 |
| `-6`   | 权威比对系统升级中          | → PENDING 降级 | ❌ 不收费 |
| `-7`   | 认证次数超过当日限制        | → PENDING 降级 | ❌ 不收费 |

### 涉及代码文件

| 文件                                                                    | 说明                                              |
| ----------------------------------------------------------------------- | ------------------------------------------------- |
| `yudao-module-match/pom.xml`                                            | +`tencentcloud-sdk-java-faceid:3.1.1518`          |
| `yudao-module-match/.../verification/TencentFaceIdClient.java`          | **新增** — FaceID SDK 懒加载 Client 封装          |
| `yudao-module-match/.../verification/MatchVerificationServiceImpl.java` | `realVerify` 骨架占位 → tencent provider 完整实现 |
| `yudao-module-match/.../config/MatchProperties.java`                    | RealApi.provider 注释更新                         |
| `yudao-server/src/main/resources/application-prod.yaml`                 | 生产配置（SecretId/SecretKey/超时）               |

### 生产配置摘要

```yaml
yudao:
  match:
    verification:
      mock-auto-approve: false
      real-api:
        enabled: true
        provider: tencent
        app-key: ${TENCENT_FACEID_SECRET_ID} # 建议环境变量注入
        app-secret: ${TENCENT_FACEID_SECRET_KEY}
        connect-timeout-millis: 3000
        read-timeout-millis: 5000
        fallback-to-manual: true # API 异常降级 PENDING 人工兜底
```

### 上线前确认清单

- [ ] 腾讯云人脸核身服务已在 [控制台](https://console.cloud.tencent.com/faceid) 开通
- [ ] 子账号 `ad` 已授权 `faceid:IdCardVerification` 权限
- [ ] 账户余额充足（IdCardVerification 按次计费）
- [ ] SecretKey 已迁移至 Nacos / 环境变量（禁止明文进 Git）
- [ ] 开发环境 `application.yaml` 保持 `mock-auto-approve: true` + `real-api.enabled: false`

---

## 🗂 文档目录

| 文件                                                                           | 说明                                   |
| ------------------------------------------------------------------------------ | -------------------------------------- |
| [性格匹配交友小程序-功能完成度报告.md](./性格匹配交友小程序-功能完成度报告.md) | 功能清单与实现进度                     |
| [开发环境到生产环境配置迁移清单.md](./开发环境到生产环境配置迁移清单.md)       | 上线前配置差异核对                     |
| [yudao-ui-uniapp-界面联调文档.md](./yudao-ui-uniapp-界面联调文档.md)           | 前后端接口联调说明                     |
| [不可删.txt](./不可删.txt)                                                     | 服务器与小程序凭据原文（勿删）         |
| [docs/root/](./root/)                                                          | Docker Compose + Nginx 配置 + SSL 证书 |

---

> ⚠️ **安全提示**：本文档包含生产环境敏感凭据，严禁提交到公开 Git 仓库，建议加入 `.gitignore` 或通过私有仓库 + 环境变量/密钥管理服务替代。

xshell

134.175.197.20
密钥
leadminiserver.pem.zip
无密码