Files
Simon facc04aa65 chore: docs 结构整改 + compose 双目录对齐(合并重建提交)
本提交为 .git 对象库损坏后的重建提交,内容等价于原先三个本地提交
(5e2fd4c2 / 57a53c98 / 5d7e1873)的累积结果,未做任何额外改动。

一、docs 结构整改(整改 #14)
根因:重构时新结构为 untracked 文件,执行 git stash(未带 -u)未纳入,
随后 git reset 拉回 HEAD 旧 tracked 树,导致旧树复活、新旧两棵目录
树并存于 docs/,共 791 文件、双分类体系冲突。

修复动作:
- b2 同名异主题文件改名迁移保全 9 个
- C 类 39 个孤立文件按主题正确归类
- A/B1 类 222 个重复文件删除(新结构已有内容副本)
- 9 个旧独有空目录删除
- 270 处内部引用按 verified 映射改写
- 整改记录 #14 登记于 04-运维文档/部署运维

结果:docs 791 → 569 文件,顶层仅规范 8 类 + 治理文件,单树恢复。
残留:约 20 处指向从未存在文件的陈旧死链,归入独立文档卫生任务。

二、compose 双目录对齐(消除踩坑 A)
- docker-compose.yml:nginx 前端挂载全部由根目录 frontend-*/dist
  改为 src/frontend-*/dist(h5 / agent / admin / terminal)
- docker-compose.dev.yml:dev 服务 build context 与卷同步改 src/
- 效果:本地 docker compose up 不再把根目录 stale dist 挂回,
  与线上一致,分叉隐患消除(已 docker compose config 校验通过)

防复发铁律:
- 重构须提交;仓库修复须 git stash -u 或先 commit
- 新结构须 git add 并提交,避免再次 untracked 复活
- H5 改动只动 src/frontend-h5/,禁改根目录遗留 frontend-*/
2026-08-07 22:31:32 +08:00

123 lines
3.8 KiB
Bash

#!/bin/bash
# =============================================================================
# 智能IT支持服务台 — NAS 一键部署脚本
# =============================================================================
# 用法:
# 1. 先编辑 .env 文件,填入 CF_TUNNEL_TOKEN 和修改 POSTGRES_PASSWORD
# 2. 确保文件已上传到 /volume1/docker/wecom-it-desk/
# 3. SSH 登录 NAS 后执行:
# cd /volume1/docker/wecom-it-desk
# bash deploy.sh
# =============================================================================
set -e # 遇到错误立即停止
DEPLOY_DIR="/volume1/docker/wecom-it-desk"
echo "============================================"
echo " 智能IT支持服务台 — NAS 部署"
echo "============================================"
echo ""
# --- 步骤 1:检查 .env ---
if [ ! -f "$DEPLOY_DIR/.env" ]; then
echo "❌ 未找到 .env 文件!"
echo " 请先执行:cp .env.nas .env"
echo " 然后编辑 .env,填入 CF_TUNNEL_TOKEN 和修改 POSTGRES_PASSWORD"
exit 1
fi
# 检查 Token 是否还是占位符
if grep -q "YOUR_TUNNEL_TOKEN_HERE" "$DEPLOY_DIR/.env"; then
echo "❌ .env 中的 CF_TUNNEL_TOKEN 还是占位符!"
echo " 请编辑 .env,将 YOUR_TUNNEL_TOKEN_HERE 替换为实际的 Tunnel Token"
exit 1
fi
echo "✅ .env 文件检查通过"
# --- 步骤 2:检查关键目录 ---
for dir in backend frontend-h5/dist frontend-agent/dist nginx; do
if [ ! -d "$DEPLOY_DIR/$dir" ]; then
echo "❌ 缺少目录:$dir"
exit 1
fi
done
echo "✅ 目录结构检查通过"
# --- 步骤 3:构建后端 Docker 镜像 ---
echo ""
echo ">>> 正在构建后端 Docker 镜像..."
docker compose -f docker-compose.nas.yml build backend
echo "✅ 后端镜像构建完成"
# --- 步骤 4:启动所有服务 ---
echo ""
echo ">>> 正在启动所有服务..."
docker compose -f docker-compose.nas.yml up -d
echo "✅ 服务启动命令已执行"
# --- 步骤 5:等待服务健康 ---
echo ""
echo ">>> 等待服务启动(约 30 秒)..."
sleep 30
# --- 步骤 6:健康检查 ---
echo ""
echo ">>> 执行健康检查..."
# 检查容器状态
echo ""
echo "--- 容器状态 ---"
docker compose -f docker-compose.nas.yml ps
# 检查后端 API
echo ""
echo "--- 后端 API 健康检查 ---"
HEALTH=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:18080/api/health 2>/dev/null || echo "000")
if [ "$HEALTH" = "200" ]; then
echo "✅ 后端 API 正常 (HTTP $HEALTH)"
else
echo "⚠️ 后端 API 返回 HTTP $HEALTH,可能需要等待更长时间"
echo " 查看日志:docker compose -f docker-compose.nas.yml logs backend"
fi
# 检查 H5 前端
echo ""
echo "--- H5 前端健康检查 ---"
H5=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:18080/itdesk/ 2>/dev/null || echo "000")
if [ "$H5" = "200" ]; then
echo "✅ H5 前端正常 (HTTP $H5)"
else
echo "⚠️ H5 前端返回 HTTP $H5"
fi
# 检查坐席工作台
echo ""
echo "--- 坐席工作台健康检查 ---"
AGENT=$(curl -s -o /dev/null -w "%{http_code}" http://localhost:18080/itagent/ 2>/dev/null || echo "000")
if [ "$AGENT" = "200" ]; then
echo "✅ 坐席工作台正常 (HTTP $AGENT)"
else
echo "⚠️ 坐席工作台返回 HTTP $AGENT"
fi
echo ""
echo "============================================"
echo " 部署完成!"
echo "============================================"
echo ""
echo " 📱 H5 员工端: https://itdesk.amanzac.com/itdesk/"
echo " 💻 坐席工作台: https://itdesk.amanzac.com/itagent/"
echo " 🔧 内网调试: http://192.168.3.200:18080/itdesk/"
echo ""
echo " 查看日志:"
echo " docker compose -f docker-compose.nas.yml logs -f"
echo ""
echo " 停止服务:"
echo " docker compose -f docker-compose.nas.yml down"
echo ""