feat: 从黄果 NET hgdjnet-server 9bfbafe 导入 HKDJ 官网后端
来源:hgdjnet-server 9bfbafe10d417deea959bd53117bc88a10e60a83 项目身份 HKDJ / JHA-216,独立官网仓库,Jenkins 守卫键 hkdjnet 测试目录 /server/hkdj_net,App/Web API 30331/30332 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,28 @@
|
||||
# 花魁 NET H5 接入
|
||||
|
||||
来源版本:黄果 NET `9bfbafe10d417deea959bd53117bc88a10e60a83`;花魁适配已推送开发分支并集成到独立test分支;本地构建、vet、配置/密钥隔离核验已通过,测试环境HTTP结果见交付记录。
|
||||
|
||||
H5 页面服务预留30334,目录 `/server/hkdj_net/h5`;H5 业务 API 为 `http://172.104.181.99:30331`。用户提供的测试页面域名为 `https://hkdjneth5.remoces.com`,域名代理待运维落地,不以域名已提供作为已部署页面的证明。
|
||||
|
||||
这里的“服务端渲染”指源黄果NET前端仓库 `ruisheng/jha-1021-91jhs/frontend/jha-1045-hgdjnet-web` 的Go页面程序读取模板并返回HTML。2026-10-10只读核验其Jenkins `Web_91YS_H5`:通过 `go build` 构建 `web_91ys_h5`,打包二进制、`static/`、`template/`,由Supervisor启动;源测试目录也存在对应静态资源和模板。因此H5需由前端交付独立Go页面程序及资源,不能套用HT的npm/dist上传脚本。
|
||||
|
||||
建议交接关系:H5测试域名的页面请求进入本项目30334页面服务;该页面服务/浏览器业务请求使用30331的App API。API服务和页面服务分别部署;源项目额外导航端口不在本次两前端入口规划内。
|
||||
|
||||
| 用途 | 方法 | 路径 |
|
||||
| --- | --- | --- |
|
||||
| 页面配置 | GET | `/api/app/config/info` |
|
||||
| 短剧首页 | GET | `/api/app/playlet/home` |
|
||||
| 短剧搜索 | GET | `/api/app/playlet/search` |
|
||||
| 应用列表 | GET | `/api/app/applist/list` |
|
||||
| 游客登录 | POST | `/api/app/auth/guest` |
|
||||
| 依赖健康检查 | POST | `/api/app/health/ping` |
|
||||
|
||||
`/api/app/*` 路径及 NET 的 JSON 返回协议保留。页面路由仍使用源项目的 `/play/...`、`/topic-detail/...`、`/tags/...` 等路径;前端不应直接替换为现有花魁短剧 H5 的路由。
|
||||
|
||||
游客、账号和 token 属于独立花魁 NET 测试库;不能向黄果或现有花魁短剧接口发送本次联调请求。支付、购买和外部发布不做测试。播放所需的花魁媒资地址、密钥和资源记录尚未接入,不能沿用黄果资源。
|
||||
|
||||
后台前端30333和H5前端30334是两个独立服务入口。H5采用独立SSR进程时,直接监听30334,不额外复制黄果导航服务;本次只准备后端与端口规划,H5前端服务尚未部署。
|
||||
|
||||
测试已通过页面配置、首页、搜索、应用列表和游客登录(HTTP200、业务200);专用游客ID10001,设备标识 `codex_hkdjnet_guest_20261010`。这些结果不代表已有可播放内容。`/enkey/`、`/newenkey/` 缺少有效播放票据时返回业务6020;鉴权后的 `/lsjenkey` 因未配置密钥返回6020。无效H5播放票据按源逻辑走占位视频路径,当前媒资域名未配置,最终返回6020;不能将该结果当作真实播放已通过。健康检查拒绝其他项目标识,合法签名下Redis/MongoDB/ES均为ok。
|
||||
|
||||
前端交接还需配置品牌、域名、SSR监听和API转发,使用花魁NET的token与播放票据;广告、应用媒资、支付、短信及真实播放资源需使用花魁自己的接入资料。准确版本及核验明细见[测试交付记录](测试交付记录-20261010.md)。
|
||||
Reference in New Issue
Block a user