 zijunchiang
|
2224195d05
|
docs: 补齐部署必需的 Gitea 域名与属主（不再脱敏成占位符）
域名与仓库属主属于「部署必需且非隐私」的信息，此前写成 `<Gitea 地址>` / `<owner>`
会让文档无法照做（照抄的 clone / 下载命令直接失败）。本次把它们补成真实值：
gitea.kasugano.cn / zijunchiang。口令、访问令牌、数据库口令等**秘密项**继续用占位符。
改动：
- README.md / README.txt：发布包下载地址补成真实 Release 地址
（https://gitea.kasugano.cn/zijunchiang/opendance-web/releases/download/vX.Y.Z/…），
并写明域名与属主是部署必需信息、不是隐私项；
- README.md / README.txt：说明 `<服务器地址>` 是**部署方自己的**服务端地址
（部署方决定），不是被脱敏的信息，避免与「被隐藏的域名」混淆；
- deploy/proxy/README.md：第九节的附件接口复验 curl 补成真实 Gitea 域名与属主；
自检清单里 `<反代地址>` 加一行说明（你们自己的反代域名或 IP）；
- deploy/systemd/opendance-api.service：`Documentation=` 补成真实仓库地址。
|
2026-09-17 03:07:23 +08:00 |
|
|
zijunchiang
|
9f08d316d0
|
docs: 清除文档中的真实部署信息与易混淆 Unicode 字符
需求：公开仓库的说明文档不应暴露开发/部署期信息，且 Gitea 会对 README.txt
报"含模棱两可的 Unicode 字符"。
敏感信息（全部替换为占位符或文档示例值）：
- 真实数据库实例：DB_HOST=192.168.150.10 / DB_USER=dpendance / DB_NAME=dpendance
→ <数据库主机> / opendance_app / opendance（web-server/.env.example、
deploy/.env.example、contracts/database.md ×3 库、project.yaml、README.txt
的建库 SQL、tasks/001、tasks/002）
- 内网网段 192.168.150.0/24 / 192.168.150.20 / 192.168.1.10
→ RFC 5737 文档网段 192.0.2.0/24 等（含测试夹具，行为不变）
- 真实 Gitea 域名 → https://<Gitea 地址>/<owner>/<repo>（systemd 单元、
Windows/Android README 的交叉链接）
- 测试夹具里的真实口令字面量 → 虚构口令（仍覆盖特殊字符场景）
- 保留 /opt/opendance、/var/lib/opendance 等产品默认安装路径（非敏感）
README.txt 易混淆字符：
- 全角拉丁字母（Ｉ/Ｋ 等）与全角 ASCII 标点（（），：；？）→ 半角 + 中文排版空格
- 正文里的乱码字节样例（模å…）→ 改为文字描述
- × → x，★ → *
- 注意：代码/测试/契约里的全角「ＩＫ」是 MMD 真实骨骼名，**必须保留**，
已回滚误改（mmd-skeleton.ts、mmd-vmd.spec.ts、inspect-vmd.mjs、各契约）
验证：168 项单测通过（含 VMD 31 项，确认全角骨骼名未被破坏）。
|
2026-09-15 21:25:25 +08:00 |
|
|
zijunchiang
|
75498db1c0
|
feat(web): 部署方式由 Docker 改为 Linux 原生站点（nginx + systemd）
需求变更：Web 服务端不再使用 Docker，改为直接运行在 Linux 上的网站。
- 移除 deploy/docker-compose.yml、web-server/Dockerfile、
web-server/admin/Dockerfile、web-server/.dockerignore
- 新增 deploy/install.sh：建服务用户与目录 → 装运行期依赖 → 迁移
→ 注册 systemd 服务 → 配置 nginx 站点 → 健康检查，一键完成
- 新增 deploy/systemd/opendance-api.service：ProtectSystem=strict 等
安全加固，ReadWritePaths 限定为上传目录
- 新增 deploy/nginx/opendance.conf：同站点托管管理端静态资源 +
反代 /api /health /static，client_max_body_size 512m，SPA 回退
- 新增 deploy/uninstall.sh：默认保留数据，--purge 才删除
- 新增配置项 HOST（AppConfig.bindHost）：原生部署下 Node 只监听
127.0.0.1，不直接对外暴露，实测外部 IP 不可达
- 同步更新 contracts/rest-api.yaml、DSH.md、project.yaml、README.txt、
tasks/008、tasks/010 与发布打包脚本
|
2026-09-14 22:42:56 +08:00 |
|