Files
web_huakui_server/docs/测试交付记录-20261010.md
T
rootandClaude Opus 4.7 85c0071fd8 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>
2026-10-16 11:20:04 +08:00

76 lines
7.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 花魁 NET 测试交付记录
2026-10-10,北京时间17:07核验。项目为HKDJ / JHA-216,独立官网仓库 `hkdj-web-server`;GitLab路径中的jha-215不改变项目归属。仓库已可通过配置的Git VPN/SSH访问,代码已提交推送。仅完成测试后端交付,正式环境未部署。
## 准确版本与构建
| 项目 | 版本/证据 |
| --- | --- |
| 复刻来源 | 黄果NET `9bfbafe10d417deea959bd53117bc88a10e60a83` |
| 开发分支 | `feat/net-import` |
| 业务开发提交 | `7d4925970afc7ca645b0d146340ec7392d3a2e3e` |
| 部署test提交 | `eb0af077f729cd492931efaef8e7a4ff877e4124`,包含上述开发提交 |
| App Jenkins | [花魁NET #4](http://192.53.172.70:8080/job/%E8%8A%B1%E9%AD%81NET/4/),SUCCESS |
| Web Jenkins | [花魁NET #5](http://192.53.172.70:8080/job/%E8%8A%B1%E9%AD%81NET/5/),SUCCESS |
两个构建的SCM均为本仓库,参数 `BUILD_BRANCHE=origin/test`、对应 `BUILD_ITEM`、完整 `EXPECTED_COMMIT`,部署锁覆盖构建到核验。原生Go build info核验module为 `hkdj-web-server`、package分别为 `hkdj-web-server/app` / `hkdj-web-server/web`,`vcs.revision`均为上述test提交,`vcs.modified=false`。后续仅交付文档,不改变已运行版本。
## 进程、端口与健康
测试主机 `172.104.181.99`,部署根目录 `/server/hkdj_net`。
| 组件 | Supervisor / PID | 监听 | 二进制SHA256 |
| --- | --- | --- | --- |
| App/H5 API | `hkdj_net_app` / 3288320,RUNNING | 30331,归属该PID | `23107fd6188a8a4dbe8730d11ab8b8fb106d3c1720988590ab21630bf9f48581` |
| Web/后台 API | `hkdj_net_web` / 3300065,RUNNING | 30332,归属该PID | `3ec6b84e320f3d24d5dc0f4930da29fd7d5242d6849a27a3c7b40721740fe395` |
| 后台前端 | 预留 `/server/hkdj_net/houtai/dist` | 30333未监听 | 前端产物未部署 |
| H5前端 | 预留 `/server/hkdj_net/h5` | 30334未监听 | 独立H5/SSR待前端交付 |
App签名POST `/api/app/health/ping` 返回HTTP200、业务200,Redis/MongoDB/Elasticsearch均为 `ok`。Web无专用健康接口,以准确运行版本、稳定PID、二进制校验和及30332监听归属证明,另行验证业务接口。运行配置均为 `runMod=test`、Redis DB24;`/server/hkdj_net/.env` 权限600。
## test主机curl结果
请求在测试主机通过curl执行,密码、token和签名通过stdin传递;不记录凭据。成功接口均为HTTP200、业务200。
| 端 | 方法与接口 | 核验 |
| --- | --- | --- |
| App | GET `/api/app/config/info` | 配置品牌为花魁短剧web站点 |
| App | GET `/api/app/playlet/home` | 首页返回正常,独立空内容库 |
| App | GET `/api/app/playlet/search?keyword=codex` | 搜索正常,未导入内容 |
| App | GET `/api/app/applist/list` | 应用列表返回正常,未配置媒资拉取 |
| App | POST `/api/app/auth/guest` | 专用设备 `codex_hkdjnet_guest_20261010`,用户10001,返回本项目token |
| Web | POST `/api/web/login/acc` | 专用管理员登录正常 |
| Web | GET `/api/web/syscfg/get` | 配置品牌正确 |
| Web | GET `/api/web/role/getauth?id=1` | 专用角色权限查询正常 |
| Web | GET `/wbapi/hkdjnet/ipstat` | 2026-10-10起止日期统计正常 |
| Web | GET `/wbapi/hkdjnet/recharge/summary` | 同日期统计正常,无充值/支付测试 |
边界核验:外项目groupId的健康请求返回HTTP200/业务1001;旧 `/wbapi/hgdjnet/ipstat` 返回404。App `/enkey/`、`/newenkey/` 的无有效票据请求返回6020,鉴权后的 `/lsjenkey` 因未配置密钥返回6020;Web鉴权后的 `/api/web/enkey`、`/api/web/newenkey`、`/api/web/lsjenkey` 同样返回6020。无效H5票据被识别并按源逻辑转占位视频路径,因当前未配置媒资域名最终返回6020,不代表真实播放验证通过。本地票据测试另验证本项目票据可校验、其他密钥票据及缺失密钥不能校验。
## 初始化与索引回读
用户批准的清单 `deploy/test/index-plan.json`,SHA256 `3f56441d0c496a9817c5d2f269084eab8450a2d73bcaec9f45a415cbd1751541`。206条MongoDB索引请求全部按有序keys及声明unique/TTL/partial选项回读一致;206包含复用系统_id索引的请求,不等于206个新增物理索引。浏览历史TTL90天,访问日志TTL5天。
仅初始化 `hkdj_net` / `hkdj_net_log`,专用MongoDB用户角色仅这两库readWrite。管理员、角色、系统配置ID均为1,游客10001;没有迁移黄果管理员或内容数据。管理员凭据只保存在根.env的 `HKDJNET_TEST_ADMIN_*` 中,前端菜单 `role.router` 尚待前端按其版本配置。
ES仅初始化 `webhkdjnet_playlet_index_v1`,mapping及analysis回读一致。用户另行批准后,在测试部署锁内再次核对UUID `RTK05ByzST-q2pVxnAjDfQ`、创建时间1791621305061、从未启动的 `INDEX_CREATED` 状态,对primary0执行一次 `allocate_empty_primary`。最终primary active=1、文档0、状态yellow;没有修改共享集群设置或其他项目索引。单节点副本未分配,共享节点磁盘超过90%高水位的问题仍需运维处理。
## 检查、日志与回滚资料
改动相关包测试、vet、App/Web构建、Python/Shell语法及提交差异检查已通过。配置加载、健康签名、媒体密钥、H5票据、未配置广告时不走旧域名、媒资任务关闭均有针对性验证。本地测试文件和构建产物未提交;未生成或部署Swagger。
仅检查最新test SHA启动段:两库、Redis、ES和模型初始化成功,两端启动正常;未再出现旧广告备用域名、空媒资URL或旧赤果自动回流错误。App有本次游客请求缺少SDK公共字段的警告,未影响登录;其余告警对应主动测试的错误groupId、无效票据、缺失媒体密钥/域名,属于上述预期返回。
最终安装前保留并核验旧二进制回滚副本(旧SHA `f5c179a1aa27e627b2d193f794ceaec90ade91b9`):
- `/server/hkdj_net/app/.rollback/hkdj-net-app.f5c179a1aa27e627b2d193f794ceaec90ade91b9.d857e0b19c1dd1438588b4351d9d4b95271c40d6fe27fb22494b988fd0518322`
- `/server/hkdj_net/web/.rollback/hkdj-net-web.f5c179a1aa27e627b2d193f794ceaec90ade91b9.65db902ade235ae24a1c40b8c6403374230e583b2bd6cfa69ffa9d13c60a7558`
以上为二进制备份,不是数据库回滚;需要回滚时仍通过本项目部署守卫恢复并验证准确版本。旧版本存在未配置外部接入时仍发起请求的问题,不能将其视为等价于最终版本的可用状态。本次不删除初始化索引,不重复强制分配ES主分片。
## 前端交接与剩余接入
[后台Web接入](Web-后台接入.md)与[H5 App接入](App-H5接入.md)分别交付。前端需要完成花魁品牌、域名、API配置、菜单以及独立后台静态/H5 SSR产物;30333/30334仅预留,Nginx文件为模板,当前没有可登录的后台/H5页面。
支付、短信、媒资、广告、统计上报、内容回流没有复制黄果凭据,默认关闭相应外部拉取;Web `mediaJobsEnabled=false`。花魁使用嘉华媒体库,后续手动/自动媒资接口还需核对本项目产品身份、协议和资源记录,不能接入黄果独立媒体库。本次不声称真实播放、支付或前端页面已完成。