xsl
f5c416dd9d
SAE 上这一版只做云网关适配层：/api/taobao/* 字节级透传给 1me.xajuzi.com 上 现有的 H5 后端（旷视调用、评分、报告都留在那边），Java 不再重写测肤逻辑。 - TaobaoEnvelope：客户端要求的 data.ok + data.http_status 信封（HTTP 恒 200） - TaobaoAuthController：challenge/session/me/logout（native 模式） - TaobaoSessionService：一次性 challenge + 30 天 Bearer token，按 open_id 限流 （网关后面所有请求同源 IP，按 IP 计数会变成全站共享 30 次/分钟） - TaobaoForwardController：mode=forward 时透传，保留原始 query 与 body 字节 （签名覆盖原始 body，重新序列化会让验签失败） - TaobaoSignatureVerifier：缺省 sign_method 按 md5 校验 - 打包名固定为 taobao-mvp-backend-0.0.4-forward，SAE 不需要任何环境变量 - pom 版本 0.0.4；mvn test 11/11（新增 8 个用例） - docs：更新 SAE 操作步骤，新增本次交接文档
27 lines
1.8 KiB
Markdown
27 lines
1.8 KiB
Markdown
# 巨子测肤 · H5 与淘宝小程序
|
|
|
|
本仓库包含两个入口，共用 Node 后端、Face++ 检测、评分与报告话术。
|
|
|
|
- `h5/`：现有浏览器/微信公众号 H5、管理后台，以及共享后端 `server.js`。
|
|
- `taobao/`：淘宝原生小程序。开发、联调、测试说明见 [taobao/README.md](taobao/README.md)。
|
|
- `backend-java/`：SAE + 淘宝云网关的 Java 最小连通性 MVP；操作步骤见 [docs/SAE-Java-MVP-操作步骤.md](docs/SAE-Java-MVP-操作步骤.md)。
|
|
- 当前交接：[docs/HANDOFF-2026-11-01.md](docs/HANDOFF-2026-11-01.md)。
|
|
- `rednote/`：复用 H5 的持久浏览器身份入口，独立运行和存储。说明见 [rednote/README.md](rednote/README.md)。
|
|
- `h5/js/skin-score.js`、`report-ui.js`、`report-copy.js`：业务规则的源文件。小程序内的副本由同步脚本生成并检查哈希。
|
|
- `h5/lib/taobao-*.js`：淘宝网关验签、短期上传/异步任务和独立 API 路由。
|
|
- `docs/`、`reference/`、`design/`、`feedback/`、`new_feedback/`：需求、接口资料、设计与历轮反馈；早期文档的规则可能已被后续实现替代。
|
|
- `backend/docs/`：后台需求资料；可运行的共享服务实际在 `h5/server.js`。
|
|
- `temp/`：本地测试数据、预览和截图，已忽略，不提交。
|
|
|
|
兼容边界：允许共享后端扩展，但保持 H5 的页面、微信公众号链接、微信登录、游客不留存和历史报告行为。淘宝使用独立账号来源，不把淘宝账号与微信账号自动合并。
|
|
|
|
本轮工作只在本地开发和样本验证，未部署或修改线上服务器。启动本地隔离环境：
|
|
|
|
```powershell
|
|
cd taobao
|
|
npm ci
|
|
npm run dev:backend
|
|
```
|
|
|
|
H5 本地入口为 http://127.0.0.1:18180；这个环境固定使用测试样本，不调用真实 Face++。生产 H5 的运行说明仍见 [h5/README.md](h5/README.md)。
|