# JNPF 全栈 docker-compose 操作入口（详见 docs/docker-compose-guide.md）
.PHONY: help jars jars-microservice flow-engine prepare web-dist check-web-dist pull-infra images preflight up up-no-pull images-offline down restart ps logs smoke

# ── 第三方基础设施镜像：SWR 长名 → 本地短名 ──────────────────────────────────
# compose 里写的是短名（cx-redis / cx-onlyoffice / cx-nginx），由下面的 pull-infra retag 而来。
# `docker tag` 只是给同一个 image ID 挂别名，不复制数据（0 字节开销）。
SWR := swr.cn-north-4.myhuaweicloud.com/ddn-k8s/docker.io

help: ## 显示本帮助
	@grep -E '^[a-z-]+:.*##' $(MAKEFILE_LIST) | awk -F':.*## ' '{printf "  make %-10s %s\n", $$1, $$2}'

jars: ## Maven 打包全部业务 jar（业务镜像构建的前置）
	mvn clean package -DskipTests

# 2026-08-11 平台聚合：默认（monolith）产出 jnpf-platform 一个 fat jar，取代原来
# oauth/system/visualdev/flowable/file/message/permission/visualdata/app 九个。
# 九个 *-server 模块的源码**保留未删**，由各自父 pom 的 microservice profile 门控。
# 回滚到微服务形态 = 本目标 + 还原 config/*/discovery.yaml 的九个服务名端口
# + 放回 docker-compose.yml / start-all.sh 里被注释的九段。不需要 git revert。
jars-microservice: ## 回滚用：按微服务形态打包（额外产出九个平台服务 fat jar）
	mvn -P microservice clean package -DskipTests

flow-engine: ## 构建自有流程引擎 jar（独立工程，不在父 POM，故单独构建）
	mvn -f jnpf-flow-engine/pom.xml clean package -DskipTests

# 业务镜像 COPY 宿主 target/*.jar（非多阶段构建），故 images 前必须先有业务 jar。
# 用哨兵校验避免"干净机器忘了 make jars → docker COPY 阶段晦涩失败"：缺失即报错提示。
# 不直接让 images 依赖 jars，是为保留本地"编一次、反复起"的迭代速度（全量 mvn 约 10min）。
check-jars:
	@test -f jnpf-gateway/target/jnpf-gateway-*.jar || { \
	  echo "错误：未找到业务 jar（jnpf-gateway/target/*.jar）"; \
	  echo "  请先构建全部业务 jar：make jars"; exit 1; }

prepare: flow-engine ## 构建并暂存自建流程引擎 jar 到镜像上下文（不入 git）
	./docker/flow-engine/prepare-context.sh

web-dist: ## 构建前端并快照 dist 到镜像上下文（前端仓库路径可 FRONTEND_REPO= 覆盖；只拷不构建 SKIP_BUILD=1）
	./docker/frontend/sync-dist.sh

# 与 check-jars 同理：不让 images 直接依赖 web-dist（前端构建数分钟级），
# 只做存在性哨兵；dist 是否新鲜看 docker/frontend/dist/.build-info
check-web-dist:
	@test -f docker/frontend/dist/index.html || { \
	  echo "错误：未找到前端产物（docker/frontend/dist/index.html）"; \
	  echo "  请先构建前端：make web-dist"; exit 1; }

pull-infra: ## 拉取第三方基础设施镜像并 retag 成短名（cx-redis / cx-onlyoffice / cx-nginx）
	docker pull --platform linux/amd64 $(SWR)/redis:8.4.0-alpine
	docker tag  $(SWR)/redis:8.4.0-alpine  cx-redis:8.4.0-alpine
	# OnlyOffice DS 同样走 SWR（2026-08-19）：Hub 直连在国内网络稳定超时。
	# 镜像 ~2GB，首次拉取偏慢；compose 里对应短名 cx-onlyoffice:9.4.0.1。
	docker pull --platform linux/amd64 $(SWR)/onlyoffice/documentserver:9.4.0.1
	docker tag  $(SWR)/onlyoffice/documentserver:9.4.0.1  cx-onlyoffice:9.4.0.1
	# cx-nginx 是 cx-web 的**构建基底**（Dockerfile FROM），不是 compose 的 image 字段——
	# 故它只在 .env 设了 NGINX_BASE_IMAGE=cx-nginx:1.27-alpine 时被消费；未设则走
	# compose 默认的 Docker Hub 多架构 nginx:1.27-alpine（arm64 原生，但需 Hub 可达）。
	docker pull --platform linux/amd64 $(SWR)/nginx:1.27-alpine
	docker tag  $(SWR)/nginx:1.27-alpine  cx-nginx:1.27-alpine
	@echo "基础设施镜像已就绪（短名 → 架构）："
	@for i in cx-redis:8.4.0-alpine cx-onlyoffice:9.4.0.1 cx-nginx:1.27-alpine; do \
	  printf '  %-24s %s\n' "$$i" "$$(docker image inspect --format '{{.Architecture}}' $$i 2>/dev/null || echo '缺失')"; \
	done

# 取代原先的 `docker compose pull --ignore-buildable`：compose 里没有 build 段的服务
# 恰好就是那三个第三方基础设施服务（redis/namesrv/broker），它们现在用短名，
# 裸 pull 会去 docker.io 找不存在的仓库。pull-infra 覆盖同一批镜像且带 retag。
# --profile localdb 是构建期必须的：cx-postgres 在该 profile 内（默认不启动，见 compose 服务块），
# 不带它 `compose build` 会跳过 PG 镜像，交付/正式环境起栈时才发现没镜像。
# 构建全集 ≠ 启动集合：这里只保证镜像齐，起哪些服务仍由 .env 的 COMPOSE_PROFILES 决定。
images: check-jars check-web-dist prepare pull-infra ## 确保全部镜像就绪：自建的构建（cx/postgres、cx/flow-engine、业务、前端），第三方的拉取+retag
	docker compose --profile localdb build

# up/up-no-pull 强制前置 preflight（Backlog C1）：空卷/空库/缺 .env 键在 compose up 前拦下，
# 消灭"空库 PG 却 healthy、业务全线连不上"的静默失败；确要跳过 SKIP_PREFLIGHT=1
preflight: ## 部署自举校验：docker/内存/.env 必填键/数据卷/三库 schema/种子数据/共享配置文件/业务角色
	@if [ "$(SKIP_PREFLIGHT)" = "1" ]; then echo "跳过 preflight（SKIP_PREFLIGHT=1）"; \
	else ./docker/preflight.sh; fi

up: images preflight ## 镜像就绪后一键启动全栈（冷启动约 5-8 分钟：PG→业务自动排队）
	docker compose up -d
	docker compose ps

up-no-pull: preflight ## 跳过构建与拉取，用本地已有镜像起全栈（离线/快速迭代；镜像缺失直接报错）
	docker compose up -d --no-build --pull never
	docker compose ps

images-offline: check-jars check-web-dist prepare ## 组装整栈 amd64 离线交付包到 dist/（详见 docs/docker-compose-guide.md §14）
	./docker/delivery/assemble-offline-package.sh

# --profile localdb 不能省：compose 的 down 只覆盖当前启用 profile 内的服务（实测：profile 关闭时
# 该容器会被原样留着跑）。带上它，无论本环境用不用栈内 PG，停栈都是干净的（没起过则是空操作）。
down: ## 全部停止并移除容器（数据安全：pgdata 是 external 卷，永不删除）
	docker compose --profile localdb down

restart: ## 重启全栈容器（原地重启，不重建容器/不丢 MQ 无持久化消息）
	docker compose restart

ps: ## 查看容器状态与健康
	docker compose ps

logs: ## 跟踪某服务日志：make logs s=cx-lims
	docker compose logs -f $(s)

smoke: ## 冒烟三段：gateway 登录 + 前端静态 200 + 经 80 反代登录（L017 脚本；与 site.Makefile 同步维护）
	@set -o pipefail; \
	MD5=$$(command -v md5 >/dev/null 2>&1 && echo md5 || echo md5sum); \
	hash5() { if [ "$$MD5" = md5 ]; then md5; else md5sum | cut -d' ' -f1; fi; }; \
	KEYHEX=$$(printf '%s' "$$(printf '%s' 'EY8WePvjM5GGwQzn' | hash5)" | xxd -p | tr -d '\n'); \
	ENC=$$(printf '%s' "$$(printf '%s' '123456' | hash5)" | openssl enc -aes-256-ecb -K "$$KEYHEX" -nosalt | xxd -p | tr -d '\n'); \
	RESP=$$(curl -fsS -X POST http://127.0.0.1:30000/api/oauth/Login -H 'Content-Type: application/x-www-form-urlencoded' \
	  --data-urlencode account=admin --data-urlencode "password=$$ENC" \
	  --data-urlencode grant_type=password --data-urlencode origin=password); \
	echo "$$RESP" | head -c 200; echo; \
	echo "$$RESP" | grep -q '"code":200' || { echo "冒烟失败：登录未返回 code 200（gateway 30000 直连）"; exit 1; }; \
	curl -fsS -o /dev/null http://127.0.0.1:80/ || { echo "冒烟失败：前端静态入口 http://127.0.0.1:80/ 不通"; exit 1; }; \
	RESP2=$$(curl -fsS -X POST http://127.0.0.1:80/api/oauth/Login -H 'Content-Type: application/x-www-form-urlencoded' \
	  --data-urlencode account=admin --data-urlencode "password=$$ENC" \
	  --data-urlencode grant_type=password --data-urlencode origin=password); \
	echo "$$RESP2" | grep -q '"code":200' || { echo "冒烟失败：经前端 80 反代登录未返回 code 200"; exit 1; }; \
	echo "冒烟通过 ✓（gateway 直连 + 前端静态 + 80 反代登录）"