# CLAUDE.md

## 项目概览

怀化人社 H5（hhrs）—— 基于 uni-app 构建的移动端 H5 前端，入口 `pages/`，UI 依赖 `uview-ui`。属于 12301-dscp 项目群中的「怀化人社」H5 端。

## Git 规范

- 独立 git 仓库，远程：`https://git.hn12301.net/xuchao/hhrs.git`，主分支 `master`
- 提交信息使用中文
- `.gitignore` 已忽略 `unpackage/`、`node_modules/`、`.DS_Store`；**不要**提交构建产物（unpackage 目录）

## 部署信息

线上为纯静态站点，位于 121.43.239.220（阿里云 ECS / CentOS 7，宿主机 Nginx 直接伺服）：

| 项目 | 内容 |
| --- | --- |
| 站点 | https://hh.hn12301.net/ |
| 网站目录 | `/home/hh/html`（uni-app 构建产物，入口 index.html） |
| Nginx 配置 | `/etc/nginx/conf.d/h5-site-https.conf`（80 catch-all → 301 跳 HTTPS） |
| 证书 | Let's Encrypt ec-256，acme.sh 每月 1/7/13/19 日 01:01 自动续期，手动续期见运维手册 |

**发布流程**：本地 HBuilderX 构建 → 覆盖上传产物到 `/home/hh/html/` → 静态文件即时生效，**无需重启 Nginx**。改过 Nginx 配置才需要 `nginx -t && nginx -s reload`。

**关键注意**：
- 前端 API 基地址指向 `https://dscp-dev.hn12301.net`（= 120.26.254.65，数字化测试环境），**后端不在部署机上**。出现"页面能打开但数据不通"时优先排查 120.26.254.65 的接口
- 页面图片走 OSS：`aliyunoss.hn12301.net/hhrs/`
- SSH 凭据及全部运维细节见 Obsidian 工作资料《121.43.239.220(H5站点服务器)运维手册_2026-08-04.md》
- 数据录入（商铺/资源/中奖等）操作指南见仓库根 docs 的 `hhrs-ops-guide.md`（运营向）