xuqmGroup/XuqmGroup-PrivateDeploy
1
0
派生 0
代码 工单 合并请求 Actions 软件包 项目 版本发布 百科 动态
3242e7d088
XuqmGroup-PrivateDeploy/docs/acceptance-checklist.md

50 行
2.0 KiB
Markdown
原始文件 普通视图 文件历史

chore: scaffold private deployment repository
2026-05-18 19:49:31 +08:00
# 验收清单
docs: 全面更新文档，清理过期内容，对齐最新设计 主要变更： - README.md: 重写，入口改为一键 install.sh，补充架构图和端口表 - runbook.md: 重写，移除旧脚本引用和内部 agent 规则，补充 nginx 配置和端口对照 - configuration.md: 更新端口表（11224-11231），移除 docs-site 引用， 补充内置 nginx 说明（nginx-bundled profile） - deployment-defaults.md: 改为通用模板，移除明文密码、真实 IP 和客户信息 - acceptance-checklist.md: 重写，改为直接 curl 端口验证，补充 license 和 nginx 验收项 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-20 16:06:42 +08:00
## 部署流程
chore: scaffold private deployment repository
2026-05-18 19:49:31 +08:00
docs: 全面更新文档，清理过期内容，对齐最新设计 主要变更： - README.md: 重写，入口改为一键 install.sh，补充架构图和端口表 - runbook.md: 重写，移除旧脚本引用和内部 agent 规则，补充 nginx 配置和端口对照 - configuration.md: 更新端口表（11224-11231），移除 docs-site 引用， 补充内置 nginx 说明（nginx-bundled profile） - deployment-defaults.md: 改为通用模板，移除明文密码、真实 IP 和客户信息 - acceptance-checklist.md: 重写，改为直接 curl 端口验证，补充 license 和 nginx 验收项 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-20 16:06:42 +08:00
- [ ] `install.sh` 可一键完成完整部署（含租户初始化）
- [ ] 新建租户模式：账号可正常登录控制台
- [ ] 迁移租户模式：使用迁移密钥（`pmk_`）完成导入，账号和应用数据完整
- [ ] 部署完成后输出端口表和 nginx 参考配置
chore: scaffold private deployment repository
2026-05-18 19:49:31 +08:00
docs: 全面更新文档，清理过期内容，对齐最新设计 主要变更： - README.md: 重写，入口改为一键 install.sh，补充架构图和端口表 - runbook.md: 重写，移除旧脚本引用和内部 agent 规则，补充 nginx 配置和端口对照 - configuration.md: 更新端口表（11224-11231），移除 docs-site 引用， 补充内置 nginx 说明（nginx-bundled profile） - deployment-defaults.md: 改为通用模板，移除明文密码、真实 IP 和客户信息 - acceptance-checklist.md: 重写，改为直接 curl 端口验证，补充 license 和 nginx 验收项 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-20 16:06:42 +08:00
## 基础服务
chore: scaffold private deployment repository
2026-05-18 19:49:31 +08:00
docs: 全面更新文档，清理过期内容，对齐最新设计 主要变更： - README.md: 重写，入口改为一键 install.sh，补充架构图和端口表 - runbook.md: 重写，移除旧脚本引用和内部 agent 规则，补充 nginx 配置和端口对照 - configuration.md: 更新端口表（11224-11231），移除 docs-site 引用， 补充内置 nginx 说明（nginx-bundled profile） - deployment-defaults.md: 改为通用模板，移除明文密码、真实 IP 和客户信息 - acceptance-checklist.md: 重写，改为直接 curl 端口验证，补充 license 和 nginx 验收项 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-20 16:06:42 +08:00
- [ ] tenant-service 健康：`curl http://127.0.0.1:11224/actuator/health` 返回 200
- [ ] 控制台前端可访问：`curl http://127.0.0.1:11226` 返回 HTML
- [ ] 文件服务可访问：`curl http://127.0.0.1:11225/file/health` 返回正常
- [ ] 私有化模式确认：`/api/private/deployment/status` 返回 `"mode":"PRIVATE"`
- [ ] 注册入口关闭：`"tenantRegisterEnabled":false`
chore: scaffold private deployment repository
2026-05-18 19:49:31 +08:00
## 可选服务
docs: 全面更新文档，清理过期内容，对齐最新设计 主要变更： - README.md: 重写，入口改为一键 install.sh，补充架构图和端口表 - runbook.md: 重写，移除旧脚本引用和内部 agent 规则，补充 nginx 配置和端口对照 - configuration.md: 更新端口表（11224-11231），移除 docs-site 引用， 补充内置 nginx 说明（nginx-bundled profile） - deployment-defaults.md: 改为通用模板，移除明文密码、真实 IP 和客户信息 - acceptance-checklist.md: 重写，改为直接 curl 端口验证，补充 license 和 nginx 验收项 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-20 16:06:42 +08:00
- [ ] im-service 健康：`curl http://127.0.0.1:11228/actuator/health` 返回 200
docs: 整理全量文档 - README: 补充 reset.sh 快速入口和脚本对比表 - runbook: 新增「容器重置」章节和「故障排查」（502/crash-loop/WebSocket/镜像未生效） - configuration: 修正端口表（im=11228/push=11229/update=11230/license=11231）， 补充 SPRING_DATASOURCE_PASSWORD 设计说明，移除已废弃的 environment 密码块说明 - acceptance-checklist: 修正端口号，补充 WebSocket 多层透传说明，移除不存在的 11227 行 - deployment-defaults: 同步端口表，补充 reset.sh 和 WebSocket 注意事项 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-21 11:48:45 +08:00
- [ ] update-service 健康：`curl http://127.0.0.1:11230/actuator/health` 返回 200
- [ ] license-service 健康：`curl http://127.0.0.1:11231/actuator/health` 返回 200
docs: 全面更新文档，清理过期内容，对齐最新设计 主要变更： - README.md: 重写，入口改为一键 install.sh，补充架构图和端口表 - runbook.md: 重写，移除旧脚本引用和内部 agent 规则，补充 nginx 配置和端口对照 - configuration.md: 更新端口表（11224-11231），移除 docs-site 引用， 补充内置 nginx 说明（nginx-bundled profile） - deployment-defaults.md: 改为通用模板，移除明文密码、真实 IP 和客户信息 - acceptance-checklist.md: 重写，改为直接 curl 端口验证，补充 license 和 nginx 验收项 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-20 16:06:42 +08:00
- [ ] push-service 已启动（厂商凭据按需填写）
## 中间件
- [ ] MySQL managed 模式：容器自动启动，数据目录 `data/mysql/` 持久化
- [ ] Redis managed 模式：容器自动启动，AOF 持久化
- [ ] 重启容器后数据完整
## License
- [ ] 所有应用在 `app_licenses` 表有对应记录
- [ ] `/api/license/admin/apps/:appKey` 返回 200，不出现 404
chore: scaffold private deployment repository
2026-05-18 19:49:31 +08:00
docs: 全面更新文档，清理过期内容，对齐最新设计 主要变更： - README.md: 重写，入口改为一键 install.sh，补充架构图和端口表 - runbook.md: 重写，移除旧脚本引用和内部 agent 规则，补充 nginx 配置和端口对照 - configuration.md: 更新端口表（11224-11231），移除 docs-site 引用， 补充内置 nginx 说明（nginx-bundled profile） - deployment-defaults.md: 改为通用模板，移除明文密码、真实 IP 和客户信息 - acceptance-checklist.md: 重写，改为直接 curl 端口验证，补充 license 和 nginx 验收项 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-20 16:06:42 +08:00
## Nginx 配置
chore: scaffold private deployment repository
2026-05-18 19:49:31 +08:00
docs: 全面更新文档，清理过期内容，对齐最新设计 主要变更： - README.md: 重写，入口改为一键 install.sh，补充架构图和端口表 - runbook.md: 重写，移除旧脚本引用和内部 agent 规则，补充 nginx 配置和端口对照 - configuration.md: 更新端口表（11224-11231），移除 docs-site 引用， 补充内置 nginx 说明（nginx-bundled profile） - deployment-defaults.md: 改为通用模板，移除明文密码、真实 IP 和客户信息 - acceptance-checklist.md: 重写，改为直接 curl 端口验证，补充 license 和 nginx 验收项 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-20 16:06:42 +08:00
- [ ] 宿主机 nginx 配置后，通过外部地址可访问控制台
- [ ] `/api/im/` 路由到 im-service（11228）
docs: 整理全量文档 - README: 补充 reset.sh 快速入口和脚本对比表 - runbook: 新增「容器重置」章节和「故障排查」（502/crash-loop/WebSocket/镜像未生效） - configuration: 修正端口表（im=11228/push=11229/update=11230/license=11231）， 补充 SPRING_DATASOURCE_PASSWORD 设计说明，移除已废弃的 environment 密码块说明 - acceptance-checklist: 修正端口号，补充 WebSocket 多层透传说明，移除不存在的 11227 行 - deployment-defaults: 同步端口表，补充 reset.sh 和 WebSocket 注意事项 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-21 11:48:45 +08:00
- [ ] `/ws/im` WebSocket 连接正常（需每层 nginx 透传 `Upgrade` / `Connection` 头）
- [ ] `/api/v1/updates/` 路由到 update-service（11230），不被通用 `/api/` 拦截
- [ ] `/api/license/` 路由到 license-service（11231），不被通用 `/api/` 拦截
docs: 全面更新文档，清理过期内容，对齐最新设计 主要变更： - README.md: 重写，入口改为一键 install.sh，补充架构图和端口表 - runbook.md: 重写，移除旧脚本引用和内部 agent 规则，补充 nginx 配置和端口对照 - configuration.md: 更新端口表（11224-11231），移除 docs-site 引用， 补充内置 nginx 说明（nginx-bundled profile） - deployment-defaults.md: 改为通用模板，移除明文密码、真实 IP 和客户信息 - acceptance-checklist.md: 重写，改为直接 curl 端口验证，补充 license 和 nginx 验收项 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-20 16:06:42 +08:00
- [ ] `/file/` 支持大文件上传（500MB）
chore: scaffold private deployment repository
2026-05-18 19:49:31 +08:00
## 公有化隔离
docs: 全面更新文档，清理过期内容，对齐最新设计 主要变更： - README.md: 重写，入口改为一键 install.sh，补充架构图和端口表 - runbook.md: 重写，移除旧脚本引用和内部 agent 规则，补充 nginx 配置和端口对照 - configuration.md: 更新端口表（11224-11231），移除 docs-site 引用， 补充内置 nginx 说明（nginx-bundled profile） - deployment-defaults.md: 改为通用模板，移除明文密码、真实 IP 和客户信息 - acceptance-checklist.md: 重写，改为直接 curl 端口验证，补充 license 和 nginx 验收项 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-20 16:06:42 +08:00
- [ ] SDK 配置不包含公有化地址 `dev.xuqinmin.com`
- [ ] `config/sdk/xuqm-private-sdk.json` 中所有 URL 指向私有部署地址
- [ ] 私有化改造不影响公有化配置和部署链路
在新工单中引用 复制永久链接