OPC/cmautobuy
2
0
Fork 0
Code Issues 114 Pull Requests Actions Packages Projects Releases Wiki Activity

建立 Admin 部署与运维长期 Wiki 文档 #316

New Issue
Open
opened 2026-08-26 16:26:21 +08:00 by ila · 1 comment
ila commented 2026-08-26 16:26:21 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：需求
  • 父级大工单：#310
  • 所属 MVP / 版本：#311
  • 阶段：阶段 5：常驻服务运维文档
  • 原始需求来源：用户在 2026-08-26 要求参考更新后的 D:\OPC\dev_harness 更新本项目文档和工作流
  • 前置工单：#314、#309
  • 是否允许并行：可与 #315 内容设计并行，但实现时都修改 Wiki 映射，按顺序提交避免冲突。
  • 状态：待验收

要解决什么

Admin 已有常驻生产服务和部署脚本，但没有参考流程要求的独立 Deployment-and-Operations 长期 Wiki 页面。

做什么 / 不做什么

  • 做：基于真实 Go/systemd/nginx/MySQL 8.4 环境和 #309 脚本建立部署运维页面，加入映射并导出 docs/10-deployment-and-operations.md。
  • 不做：不采用参考模板的 Python/supervisor 示例；不写真实密码、Token、私钥或证书内容；不实际部署生产。

怎么做

记录服务概览、环境要求、配置名称与安全来源、首次部署、日常发布、健康检查、日志、备份、schema 迁移、回退和已知限制；命令写明预期结果。

预计修改：Deployment-and-Operations Wiki、wiki-docs.json、docs/10-deployment-and-operations.md

设计证据：非 UI 工作；以 DevHarness 目标提交、事实来源迁移顺序和本工单技术方案作为设计证据。
长期文档影响：有，具体页面和镜像见预计修改。

验收标准

  • 页面描述当前 Go/systemd/nginx/MySQL 架构
  • 部署命令指向 #309 脚本并解释 v31 显式迁移授权
  • 配置只记录名称和来源，不出现秘密
  • 备份、迁移、回退边界和预期结果明确
  • 在线回读和镜像检查通过

怎么验证

Gitea MCP 回读；python dev_scripts/harness.py sync --verify；敏感信息静态检查

风险和回退

运维命令错误会影响生产；本任务只写文档并对照现有 service、脚本和历史部署证据，不执行命令。

## 基本信息 - 类型：需求 - 父级大工单：#310 - 所属 MVP / 版本：#311 - 阶段：阶段 5：常驻服务运维文档 - 原始需求来源：用户在 2026-08-26 要求参考更新后的 `D:\OPC\dev_harness` 更新本项目文档和工作流 - 前置工单：#314、#309 - 是否允许并行：可与 #315 内容设计并行，但实现时都修改 Wiki 映射，按顺序提交避免冲突。 - 状态：待验收 ## 要解决什么 Admin 已有常驻生产服务和部署脚本，但没有参考流程要求的独立 `Deployment-and-Operations` 长期 Wiki 页面。 ## 做什么 / 不做什么 - 做：基于真实 Go/systemd/nginx/MySQL 8.4 环境和 #309 脚本建立部署运维页面，加入映射并导出 `docs/10-deployment-and-operations.md`。 - 不做：不采用参考模板的 Python/supervisor 示例；不写真实密码、Token、私钥或证书内容；不实际部署生产。 ## 怎么做 记录服务概览、环境要求、配置名称与安全来源、首次部署、日常发布、健康检查、日志、备份、schema 迁移、回退和已知限制；命令写明预期结果。 预计修改：Deployment-and-Operations Wiki、`wiki-docs.json`、`docs/10-deployment-and-operations.md` 设计证据：非 UI 工作；以 DevHarness 目标提交、事实来源迁移顺序和本工单技术方案作为设计证据。 长期文档影响：有，具体页面和镜像见预计修改。 ## 验收标准 - [ ] 页面描述当前 Go/systemd/nginx/MySQL 架构 - [ ] 部署命令指向 #309 脚本并解释 v31 显式迁移授权 - [ ] 配置只记录名称和来源，不出现秘密 - [ ] 备份、迁移、回退边界和预期结果明确 - [ ] 在线回读和镜像检查通过 ## 怎么验证 Gitea MCP 回读；`python dev_scripts/harness.py sync --verify`；敏感信息静态检查 ## 风险和回退 运维命令错误会影响生产；本任务只写文档并对照现有 service、脚本和历史部署证据，不执行命令。
ila commented 2026-08-26 17:11:42 +08:00
Author
Owner
Copy Link
Copy Source

实施结果

  • Deployment-and-Operations revision：c15ad8664ed54ffd90a1b9b6d5b8bc77e2256153
  • Deployment-Template revision：78a3f02ad22e9fb94c3437670cb30fef39cac5b8
  • Home 导航 revision：d3e7d43c3ba0868ba4d7deb801f6bce87c41caa9
  • 镜像提交：6df27b6
  • 验证：规则与文档测试 43 项通过；check --strict 通过；秘密值静态扫描通过。
  • 文档按真实 Go/systemd/nginx/MySQL 8.4 与 admin/deploy/ 脚本编写，明确 v31 显式授权、备份和数据库不自动回滚。
  • 未执行生产部署、迁移或恢复。

状态：待验收。

## 实施结果 - Deployment-and-Operations revision：`c15ad8664ed54ffd90a1b9b6d5b8bc77e2256153` - Deployment-Template revision：`78a3f02ad22e9fb94c3437670cb30fef39cac5b8` - Home 导航 revision：`d3e7d43c3ba0868ba4d7deb801f6bce87c41caa9` - 镜像提交：`6df27b6` - 验证：规则与文档测试 43 项通过；`check --strict` 通过；秘密值静态扫描通过。 - 文档按真实 Go/systemd/nginx/MySQL 8.4 与 `admin/deploy/` 脚本编写，明确 v31 显式授权、备份和数据库不自动回滚。 - 未执行生产部署、迁移或恢复。 状态：待验收。
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/cmautobuy#316