chore: init company-deploy-skills with dokploy-gitea-deploy

2026-07-31 09:47:16 +08:00
commit 7b56a16fbc
7 changed files with 1125 additions and 0 deletions
--- a/dokploy-gitea-deploy/references/sequence.md
+++ b/dokploy-gitea-deploy/references/sequence.md
@@ -0,0 +1,104 @@
+# 时序
+
+## 默认：MCP 全链路（业务部署）
+
+```text
+用户              Agent                 company-deploy-mcp      Gitea         Dokploy
+ │                  │                         │                  │               │
+ │ 部署/上线         │                         │                  │               │
+ │─────────────────►│                         │                  │               │
+ │                  │ whoami / get_my_quota    │                  │               │
+ │                  │────────────────────────►│                  │               │
+ │                  │ Dockerfile + 本地校验    │                  │               │
+ │                  │ ensure_repository       │                  │               │
+ │                  │────────────────────────►│──建库(可选)─────►│               │
+ │                  │◄────────────────────────│◄─────────────────│               │
+ │                  │ git push（企业凭据）     │                  │               │
+ │                  │───────────────────────────────────────────►│               │
+ │                  │ create_deployment_plan  │                  │               │
+ │                  │────────────────────────►│                  │               │
+ │                  │ apply_deployment_plan   │                  │               │
+ │                  │────────────────────────►│                  │               │
+ │                  │                         │ ensure app       │               │
+ │                  │                         │ mounts (/data+)  │               │
+ │                  │                         │ postgres/mysql?  │               │
+ │                  │                         │ domain buxi+5+LE │               │
+ │                  │                         │ deploy ──────────┼──────────────►│
+ │                  │                         │                  │  clone/build  │
+ │                  │ get_deployment_status   │                  │  run          │
+ │                  │────────────────────────►│──status──────────┼──────────────►│
+ │                  │ 探活 https://buxi….     │                  │               │
+ │ 交付 HTTPS 链接   │                         │                  │               │
+ │◄─────────────────│                         │                  │               │
+```
+
+要点：
+
+- **建库 / 挂卷 / PG·MySQL / 域名 / deploy** 全在 MCP `apply` 内  
+- **push** 只在 Agent 本机  
+- 业务用户不接触 Gitea / Dokploy / Token  
+
+参数与示例：`mcp-deploy.md`。域名与证书：`domain.md`。
+
+---
+
+## 日常二次发布（MCP）
+
+```text
+用户 → Agent → git push → create_deployment_plan(新 SHA)
+                         → apply_deployment_plan
+                         → 复用 mapping（域名、卷、库、配额名额）
+                         → 轮询 + 探活
+```
+
+- 同一 `repo` + `environment`：**不新建** Dokploy 应用名额  
+- 域名 host **不变**  
+- 数据卷 **不变**（应用须写在挂载路径）  
+- plan 一次性；每次发布新建 plan  
+
+---
+
+## Legacy：直连 Dokploy（运维例外）
+
+```text
+用户                Agent                 Gitea                Dokploy
+ │                    │                     │                     │
+ │ 明确要求直连        │                     │                     │
+ │───────────────────►│ source .env.deploy  │                     │
+ │                    │ Dockerfile          │                     │
+ │                    │ 建仓+git push       │                     │
+ │                    │────────────────────►│                     │
+ │                    │ application.*       │                     │
+ │                    │ mounts / domain     │                     │
+ │                    │ application.deploy  │                     │
+ │                    │──────────────────────────────────────────►│
+ │                    │ 轮询 + 探活         │                     │
+ │◄───────────────────│                     │                     │
+```
+
+仅当 MCP 不可用且有 `.env.deploy` + `DEPLOY_AUTHORIZED=true`。  
+默认对话 **不要** 走这条。
+
+---
+
+## 责任边界
+
+| 角色 | MCP 路径 | Legacy 路径 |
+|------|----------|-------------|
+| 用户 | 飞书登录拿 `buxi_`；说「部署」 | 提供/保管 `.env.deploy`（运维） |
+| Agent | 工程 + push + 调 MCP 工具 + 交付 URL | 工程 + push + 直调 Dokploy API |
+| company-deploy-mcp | 身份/配额/审计/Gitea 建库/Dokploy 编排 | — |
+| Gitea | 源码 | 源码 |
+| Dokploy | 构建运行/卷/库/Traefik+LE | 同左（Agent 直调） |
+
+---
+
+## 异步语义
+
+| 动作 | 含义 |
+|------|------|
+| `apply_deployment_plan` 返回 200 | 已受理编排与 deploy 请求 |
+| `deploymentRequested: true` | 不等于用户已可稳定访问 |
+| 上线完成 | Dokploy 部署终态成功 +（Web）HTTPS 探活通过 |
+
+构建失败：`get_deployment_status` / `get_sanitized_logs`，修代码或 Dockerfile 后新 SHA 再 plan+apply。