feat(sae): add Java MVP backend and Taobao connectivity page

Spring Boot 3.5.6 / Java 17 JAR with cloud gateway envelope and ping/whoami/echo; Taobao gateway signature verification matching the Node implementation; /pages/mvp page, splash dev entry and local transport contract test; SAE + 聚石塔 runbook and portable JDK/Maven setup; Windows 11 wmic shim for Taobao DevTools.
2026-10-31 18:35:04 +08:00
parent 459e21dad4
commit ac0b7ca42b
25 changed files with 1334 additions and 2 deletions
@@ -0,0 +1,56 @@
+# taobao-mvp-backend
+
+淘宝小程序 + 淘宝云网关 + SAE 的最小 Java 后端验证工程。
+
+## 快速启动
+
+```powershell
+Set-ExecutionPolicy -Scope Process Bypass
+. D:\juzi\tools\env-java.ps1
+cd D:\juzi\backend-java
+mvn -DskipTests package
+java -jar target\taobao-mvp-backend-0.0.1-SNAPSHOT.jar
+```
+
+启动后：
+
+- 健康检查：<http://127.0.0.1:8080/actuator/health>
+- 云网关测试接口：`POST http://127.0.0.1:8080/api/taobao/ping`
+
+## 接口
+
+| 方法 | 路径 | 作用 |
+|---|---|---|
+| GET | `/actuator/health` | SAE 健康检查 |
+| GET/POST | `/api/taobao/ping` | 返回统一 envelope，验证连通性 |
+| POST | `/api/taobao/whoami` | 返回网关注入的 query 参数（open_id/app_key/env/sign 等） |
+| POST | `/api/taobao/echo` | 原样回显 JSON body，验证 POST/Content-Type |
+
+统一响应：
+
+```json
+{"success":true,"data":{"ok":true}}
+```
+
+失败：
+
+```json
+{"success":false,"errorCode":"SIGN_INVALID","errorMessage":"..."}
+```
+
+## 环境变量（SAE）
+
+| 变量 | 本地 | 云端 |
+|---|---|---|
+| `TAOBAO_APP_KEY` | 可空 | 淘宝开放平台 AppKey |
+| `TAOBAO_APP_SECRET` | 可空 | AppSecret，只放服务端 |
+| `TAOBAO_VERIFY_SIGN` | `false` | `true` |
+
+云端必须用 `TAOBAO_VERIFY_SIGN=true`，否则任何知道地址的人都能直接调用接口。
+
+## 说明
+
+- 本工程只实现连通性 MVP：`ping/whoami/echo`。
+- 真实的 `challenge/session/photo/skin-analyze/analysis/reports` 尚未迁移；现有 Node 实现见 `../h5/lib/taobao-routes.js`，可作为 Java 迁移的接口契约参考。
+- SAE 部署时选 **JAR 包部署 + 标准 Java 应用运行环境 + Open JDK 17**，不要选 WAR/Tomcat/EDAS-Container。
+- 端口 `8080`，健康检查 `/actuator/health`，至少 2 实例。