docs(server): 台账更新为 rencaika.dqrcfwpt.com 的现状（含证书双轨与续期口径）

yeg

6 天以前 3df441bf6426a80be37b864c3b600f1249d925da

docs(server): 台账更新为 rencaika.dqrcfwpt.com 的现状（含证书双轨与续期口径）

记下：测试环境改新子域、LE 证书自动续期（2027-01-06）与腾讯云证书人工续期（2027-02-11）并存、80 上 ACME 例外不能删、微信服务器域名改填不带端口的新域名。同时作废「退域名补 A 记录」那条待办（甲方已持有那两个名字），并更正旧证书是腾讯云而非华为云签发的说法。

 .scratch/server-testenv/README.md

@@ -55,14 +55,19 @@
> 命令通道单次只能带约 4KB，所以 dist（4.4MB）走不了命令通道——这是当初需要人工 SFTP 传包的原因，
> 现在用「服务器自建」绕过去了。

## HTTPS（2026-09-29 已上线）
## HTTPS（2026-09-29 已上线；2026-10-08 域名变更）

> **2026-10-08 域名变更**：甲方把 `www.dqrcfwpt.com` 与退域名 `dqrcfwpt.com` 解析到了他们自己的机器（公司官网），
> 那两个名字**已不在我们手上**。测试环境改用新建子域 **`rencaika.dqrcfwpt.com`**，证书换成
> **Let's Encrypt（certbot 自动续期）**。本节里凡提到 `www` / `:8081` 的表述都是**变更前**的历史；
> 当前口径以下面「端口」与「证书」两行为准。另：旧证书是**腾讯云**签发（不是华为云）。

| 项 | 值 |
|---|---|
| 证书 | 华为云签发的 DV（TrustAsia 签发）。`/etc/nginx/ssl/talent-card/server.crt` 是**含中间链的 bundle**（4451 字节），`server.key` 权限 `600` |
| 覆盖域名（SAN） | `dqrcfwpt.com` + `www.dqrcfwpt.com` |
| **到期** | **2027-02-11** ⚠️ **不会自动续到本机** —— 到期前在华为云重新下载再传一次（或那时改用 Let's Encrypt：80 已通，certbot 一条命令且自带自动续期） |
| 端口 | **8081 = 测试环境（TLS）**：`https://www.dqrcfwpt.com:8081/`；**8082 = 测试环境（明文兜底）**：`http://117.172.73.106:8082/`；**443 = 生产预留，现在是占位页**（`/data/talent-card/placeholder/index.html`，正文「本域名对应的生产环境尚未部署」）；80 只做 301 跳转到 https |
| 证书（两套并存，nginx 按 SNI 选） | ① **`rencaika.dqrcfwpt.com`** → **Let's Encrypt**：`/etc/letsencrypt/live/rencaika.dqrcfwpt.com/fullchain.pem` + `privkey.pem`；② `www`/退域名 → **腾讯云**签发的 DV：`/etc/nginx/ssl/talent-card/server.crt`（**含中间链的 bundle**，4451 字节）+ `server.key`（`600`）。**之后换腾讯云证书到新子域：只改 443/8081 那两块里的两行路径再 reload，不需要动别的。** |
| 覆盖域名（SAN） | ① `rencaika.dqrcfwpt.com`（LE 那张）② `dqrcfwpt.com` + `www.dqrcfwpt.com`（腾讯云那张） |
| **到期** | ① **2027-01-06**（LE，**`certbot.timer` 自动续期，不用人管** —— 前提是 80 上的 `/.well-known/acme-challenge/` 直读例外别删）② **2027-02-11**（腾讯云那张，**人工**：到期前重新下载再传一次） |
| 端口 | **`rencaika.dqrcfwpt.com` 就是测试环境**：**443**（`https://rencaika.dqrcfwpt.com`，正式入口、**不带端口**）与 **8081**（同机兼容）都提供完整功能；**8082 = 明文兜底**（`http://117.172.73.106:8082/`，给 IP 访问；HSTS 管不到 IP，这条永远可用）；**80 只做 301**，且给 `/.well-known/acme-challenge/` 留了直读例外（**删了证书就自动续期不了，且是静默失败**）。旧名字 `www`/退域名的 443 仍挂着生产占位页，但甲方已把那两个名字指走，**那段实际不生效、可删**。 |
| ⚠️ 为什么 8081 必须是 TLS、明文要另开 8082 | 443 上发了 HSTS，而 **HSTS 按「主机」生效、覆盖该主机的所有端口**（RFC 6797 §8.3），且升级时**显式端口会保留**（`http://host:8081` → `https://host:8081`）。所以 8081 若只说纯 HTTP，浏览器（只要访问过一次域名）一律打不开。**也不能让 nginx 用两个 server 块在 8081 上分别 listen 明文与 ssl** —— 同一个 address:port 的 ssl 标志必须一致，混用直接校验失败，报 `no "ssl_certificate" is defined for the "listen ... ssl" directive`，而且**错误行号指向那个明文块**，极易看错地方（2026-09-29 就在这里绕了几圈）。所以拆成 8081(TLS) + 8082(明文)。 |
| 生产上线时 | 把 443 块里的 `root` 与 `location` 换成 `include snippets/talent-card-locations.conf;`，80 的 301 不用动。该域名上的 `/api` 目前返回 503 JSON，避免请求落到静态页被误解为可用 |
| HSTS | `max-age=86400`（1 天），**没有** `includeSubDomains` / `preload` |
@@ -77,11 +82,11 @@
- **汇付的五个回调地址**现在可以是真实公网 HTTPS 了，形如
  `https://www.dqrcfwpt.com/api/payments/huifu/notify`——这解掉了 `.scratch/pending-order-payment-flow/README.md`
  里 F1 那个长期项。**要在汇付控台逐条注册**，且与本地 yml 的 `HUIFU_*_NOTIFY_URL` 保持一致。
- **微信小程序的服务器域名**可以填 `https://www.dqrcfwpt.com`（request / uploadFile / downloadFile 都要）。
- **微信小程序的服务器域名**填 **`https://rencaika.dqrcfwpt.com`**（request / uploadFile / downloadFile 都要，**不带端口**）。

**还没做的：**
- 退域名 `dqrcfwpt.com` **没有 A 记录**（公网解析实测 `ENODATA`）→ `https://dqrcfwpt.com` 用不了。
  在腾讯云补一条 `@` 的 A 记录即可（**证书已覆盖它，不用重签**）。
- ~~退域名 `dqrcfwpt.com` 没有 A 记录~~ **已作废**：2026-10-08 起 `dqrcfwpt.com` 与 `www` 都解析到甲方的机器
  （公司官网），我们不再持有这两个名字，原来那条「补 A 记录」的待办随之取消。
- **8081 仍是全公网可达的明文端口**，上面挂着后台 API。HTTPS 已稳定，建议请云管理方关掉它；
  在那之前它仍是唯一的明文入口。
- `CORS_ALLOWED_ORIGINS` 里没有 `http://www.dqrcfwpt.com`（80 那条）——**已无关紧要**，因为 80 现在 301 到 https。
@@ -92,8 +97,8 @@

| 位置 | 值 |
|---|---|
| 代码 | `rencaika/config/api.uts` 与 `rencaika_merchant/config/api.uts`：`apiEnvironment = 'staging'` + `stagingBaseUrl = 'https://www.dqrcfwpt.com:8081'` |
| 微信后台 → 开发管理 → 服务器域名 | request / uploadFile / downloadFile **都填** `https://www.dqrcfwpt.com:8081`；socket / udp / tcp **留空**（两个小程序零 WebSocket 用法，已 grep 确认） |
| 代码 | `rencaika/config/api.uts` 与 `rencaika_merchant/config/api.uts`：`apiEnvironment = 'staging'` + `stagingBaseUrl = 'https://rencaika.dqrcfwpt.com'` |
| 微信后台 → 开发管理 → 服务器域名 | request / uploadFile / downloadFile **都填** `https://rencaika.dqrcfwpt.com`（**不带端口**，与代码里的 `stagingBaseUrl` 一致）；socket / udp / tcp **留空**（两个小程序零 WebSocket 用法，已 grep 确认） |
| 体验成员 | 「成员管理」里逐个加微信号；配额以后台实时提示为准 |

- **两个 appid 各配一遍**：人才端 `wxcfee477acb54d179`（后端 `app.wechat.mini-program.app-id` 与它一致）、商户端 `wx550e520ad19458ea`。