# 2026-04-13 工作日志

## 完成的工作

### 1. 阿里云实人认证接入
**目的**：为 user/userVerify 页面添加阿里云身份证二要素核验

**后端改动**（JAVA/websopy-java）：
- pom.xml：添加 `com.aliyun:cloudauth20190307:2.2.4` 依赖
- application.yml：添加 `cloudauth` 配置项（accessKeyId、accessKeySecret、endpoint、regionId）
- 新增 `CloudAuthProperties.java`：配置属性类
- 新增 `IdVerificationService.java`：实人认证服务
- 新增 `IdVerificationController.java`：实人认证 API 控制器

**前端改动**（VUE/websopy-mp）：
- api/system/userVerify/index.ts：添加 `verifyIdCard()` API 调用
- user/userVerify/index.tsx：
  - 导入 verifyIdCard
  - 修改 submitSucceed 函数：个人认证时先调用实名校验，核验通过后再提交

### 2. 调研结论
- **城市服务实名校验**：已于2021年11月停止开放，不可用
- **阿里云实人认证**：推荐方案，0.2元/次，有100次免费试用额度
- **接入方式**：身份证二要素核验（姓名+身份证号）最简单

## 待办事项
- [x] 配置阿里云 AccessKey（在 application-prod.yml 中设置 cloudauth.accessKeyId 和 cloudauth.accessKeySecret）
- [ ] 在阿里云实人认证控制台开通服务并充值
- [ ] 测试验证接口是否正常工作

## 阿里云 AccessKey 配置
- 项目：websopy-java
- 文件：application-prod.yml
- accessKeyId: LTAI4GKGZ9Z2Z8JZ77c3GNZP
- 备注：与 OSS 使用同一个 AccessKey

## 3. 前端接口地址修正
**目的**：修正小程序端开发者相关 API 接口地址，与后端 Controller 路径保持一致

**问题发现**：`BaseUrl` 配置已包含 `/api` 后缀 (`https://websopy-api.websoft.top/api`)，前端代码中不应再重复添加 `/api` 前缀，否则会导致 `/api/api/` 路径错误。

**修正文件**：
- `src/api/developer/enterprise.ts`：
  - 企业信息：`/system/tenant/info`, `/system/tenant`
  - 企业成员：`/system/user/page`, `/system/user`
  - 订单：`/system/order/page`, `/system/order`
  - 账单：`/sys/recharge-order/page`
  - 企业应用：`/app/product/page`
  - 邀请：`/app/developer/invite`

- `src/api/developer/developer.ts`：
  - 项目/应用：`/app/product/*` (create, update, delete, detail, page, my/page, joined/page)
  - API Key：`/app/app-credential/*`
  - 版本发布：`/app/app-version/*`
  - 开发者信息：`/app/developer/git-account`, `/app/developer/gitea-info`
  - 通知：`/app/notification/*`
  - 权限申请：`/app/developer/permission-requests/*`

- `src/api/invite/index.ts`：
  - 所有接口移除 `/api` 前缀

**后端 Controller 对应关系**：
| 前端 API | 后端 Controller | 路径前缀 |
|---------|----------------|---------|
| enterprise.ts | TenantController | /api/system/tenant |
| enterprise.ts | UserController | /api/system/user |
| enterprise.ts | OrderController | /api/system/order |
| enterprise.ts | RechargeOrderController | /api/sys/recharge-order |
| developer.ts | AppProductController | /api/app/product |
| developer.ts | AppCredentialController | /api/app/app-credential |
| developer.ts | AppVersionController | /api/app/app-version |
| developer.ts | GitAccountController | /api/app/developer |
| developer.ts | AppNotificationController | /api/app/notification |
| developer.ts | AppPermissionRequestController | /api/app/developer/permission-requests |
| invite/index.ts | - | /api/invite/* |

**重要配置**：`config/env.ts` 中 `API_BASE_URL` 已包含 `/api` 后缀，前端代码路径不应再以 `/api` 开头。