Files
websopy-mp/.workbuddy/memory/2026-04-13.md
赵忠林 611b488af3 refactor(api): 规范前端API接口地址并统一路径前缀
- 修正开发者、小程序和企业相关API的基础URL,避免重复添加/api前缀
- 统一调整developer、enterprise、invite等模块接口路径,保持与后端Controller一致
- 新增权限申请及消息通知相关API,并完善相关函数实现
- 规范请求参数传递,移除多余包装,改用直接传递对象方式
- 新增API Key重置、版本发布/回滚等接口支持

feat(invite): 重构邀请登录流程支持未注册快速加入

- 完整重写invite页,分离已注册用户和未注册用户的按钮显示和交互
- 实现未注册用户微信手机号授权后自动注册登录及自动加入应用
- 已注册用户直接确认加入应用,无需手机号授权弹窗
- 统一使用getPhoneNumber按钮处理两种状态并修复“授权码不能为空”报错
- 前端配合后端改造,支持已登录用户可直接通过Authorization头加入应用

fix(developer): 修复开发者中心应用加载问题

- 修复只查询创建的应用导致邀请加入的应用不显示的问题
- 同时请求创建应用和参与应用接口,合并并去重应用列表
- 新增pageJoinedApp接口调用及合并逻辑,提高应用列表完整性和体验
2026-04-13 15:30:32 +08:00

3.5 KiB
Raw Blame History

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次免费试用额度
  • 接入方式:身份证二要素核验(姓名+身份证号)最简单

待办事项

  • 配置阿里云 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.tsAPI_BASE_URL 已包含 /api 后缀,前端代码路径不应再以 /api 开头。