release: align H5 demo UI and login

2026-10-21 17:34:03 +08:00
parent d51c4c6a76
commit afee993626
35 changed files with 265 additions and 32 deletions
@@ -55,6 +55,54 @@ npm --prefix h5-demo run smoke

 本次全新卷验证还确认：首次迁移与 Demo seed 成功，`seed-demo.ps1 -E2E` 第二次重跑幂等成功。当前 `danyang-demo` 数据卷使用创建时的临时凭据（PostgreSQL `demo-db`、Redis `demo-redis`）；重建 backend 时必须向 Compose 注入同一组卷凭据，并使用长度至少 32 字节的 JWT 临时密钥。该凭据仅用于本机演示，不得用于生产。

+## 部署到其他演示服务器
+
+此流程适用于隔离的演示服务器，不适用于生产。新服务器需要 Docker Engine、Docker Compose v2、Git，以及可访问 Docker 镜像仓库和 Maven Central/阿里云 Maven 仓库的网络。后端镜像在目标机从源码构建，因此首次构建会下载依赖。
+
+1. 拉取本次提交或演示标签，并在仓库根目录准备本机环境文件：
+
+   ```powershell
+   git clone http://120.27.207.134:13000/admin/danyang-match.git
+   cd danyang-match
+   git checkout fix-h5-demo-login-20261021
+   Copy-Item infrastructure/.env.example infrastructure/.env
+   ```
+
+2. 编辑 `infrastructure/.env`，为演示环境生成并填写 `DB_PASSWORD`、`REDIS_PASSWORD`、`MINIO_ACCESS_KEY`、`MINIO_SECRET_KEY`、`JWT_ACCESS_SECRET`、`JWT_REFRESH_SECRET` 和 `ENCRYPTION_KEY`。JWT 密钥至少 32 字节；`ENCRYPTION_KEY` 使用 64 位十六进制值。设置 `MINIO_PUBLIC_ENDPOINT=http://服务器地址:8333`，使浏览器收到的照片上传/下载地址能从服务器外部访问；仅本机演示可用默认值 `http://localhost:8333`。不要将 `.env` 提交到 Git。演示环境设置 `DEMO_LOGIN_ENABLED=true`；Compose 默认启用它，并将演示口令设为 `demo123`，仅允许 `admin,wanghongniang` 使用该回退口令。正式生产配置不启用此能力。
+
+3. 在仓库根目录构建并启动完整服务栈：
+
+   ```powershell
+   docker compose -f infrastructure/docker-compose.yml up -d --build
+   docker compose -f infrastructure/docker-compose.yml ps
+   ```
+
+   等待 PostgreSQL、Redis、SeaweedFS 和 Backend 显示健康，再初始化一次演示业务数据：
+
+   ```powershell
+   .\scripts\seed-demo.ps1
+   ```
+
+   初始化脚本写入用户档案、预置运营账号及 V1.1 首页/内容/服务数据，可重复运行；不要删除已有数据库卷。仅首次部署的空白数据库执行完整基础 seed。已有数据库不会被脚本清空或重置。
+
+4. 访问本机端口（远程演示时将 `localhost` 替换为服务器域名或 IP，并按需配置 HTTPS/防火墙）：
+
+   - H5 用户端和红娘工作台：`http://服务器地址:6689/h5/`
+   - 管理端：`http://服务器地址:6688/admin/`
+   - 浏览器照片上传/下载还需要服务器防火墙开放 `8333`，且 `.env` 中 `MINIO_PUBLIC_ENDPOINT` 与外部访问域名/IP 一致。
+   - H5 用户端选择“晓燕”等预置账号直接登录，无需真实微信；预置登录码对应 `demo_openid_f02` 等 seed 用户。
+   - 管理员：`admin / demo123`；红娘：`wanghongniang / demo123`。
+
+   只有完成演示数据初始化且账号为 active，预置账号才能进入完整页面流程。`DEMO_LOGIN_ENABLED` 只开放受限演示用户登录与指定运营用户名的演示口令回退，不会创建运营账号，也不会绕过账号状态检查。
+
+5. 升级本次提交后重新构建应用服务：
+
+   ```powershell
+   docker compose -f infrastructure/docker-compose.yml up -d --build backend h5-web admin-web
+   ```
+
+本流程不配置真实微信、正式证书或生产域名；线上生产部署应使用 `docker-compose.prod.yml`，独立配置真实身份凭据，并保持演示登录关闭。
+
 ## 演示数据初始化

 在 Compose 栈健康后执行一次即可；脚本可重复运行，不会清空数据库：