speccore 8.3.158 → 8.3.160

package/templates/database-example.md

@@ -1,223 +0,0 @@
-# 数据库设计规范示例
-
-> 本文件为数据库设计规范示例，涵盖命名、字段、索引、分表等经典规则。
-> 复制到项目后按需修改，或作为 `.speccore/RULES/database.md` 的素材。
-
----
-
-## 1. 命名规范
-
-### 1.1 表命名
-
-| 规则 | 示例 | 说明 |
-|:---|:---|:---|
-| 小写 + 下划线 | `user_profile` | 全部小写，单词间用 `_` 分隔 |
-| 复数形式 | `orders` `users` | 表名用复数 |
-| 业务前缀 | `oms_order` `cms_article` | 多模块项目加前缀区分 |
-| 禁用保留字 | — | 不要用 `order` `group` `key` 等 SQL 保留字 |
-
-### 1.2 字段命名
-
-| 规则 | 正例 | 反例 |
-|:---|:---|:---|
-| 小写 + 下划线 | `created_at` | `createdAt` `Created_At` |
-| 外键格式 | `user_id` `order_id` | `uid` `oid` |
-| 布尔字段 | `is_deleted` `is_active` | `deleted` `active` |
-| 状态字段 | `status` + 枚举说明 | `state`（模糊） |
-| 时间字段 | `created_at` `updated_at` | `create_time`（不一致） |
-
-### 1.3 索引命名
-
-| 类型 | 命名格式 | 示例 |
-|:---|:---|:---|
-| 主键 | `pk_表名` | `pk_users` |
-| 唯一索引 | `uk_表名_字段` | `uk_users_phone` |
-| 普通索引 | `idx_表名_字段` | `idx_orders_user_id` |
-| 联合索引 | `idx_表名_字段1_字段2` | `idx_orders_user_id_status` |
-
----
-
-## 2. 字段设计规范
-
-### 2.1 必备字段（每张表必须有）
-
-| 字段名 | 类型 | 默认值 | 说明 |
-|:---|:---|:---|:---|
-| `id` | `BIGINT UNSIGNED` | 自增 | 主键，建议使用雪花 ID |
-| `created_at` | `DATETIME(3)` | `CURRENT_TIMESTAMP(3)` | 创建时间，毫秒精度 |
-| `updated_at` | `DATETIME(3)` | `CURRENT_TIMESTAMP(3)` | 更新时间，ON UPDATE 自动更新 |
-| `created_by` | `BIGINT UNSIGNED` | `NULL` | 创建人 ID |
-| `updated_by` | `BIGINT UNSIGNED` | `NULL` | 更新人 ID |
-| `deleted_at` | `DATETIME(3)` | `NULL` | 软删除时间，NULL 表示未删除 |
-| `deleted_by` | `BIGINT UNSIGNED` | `NULL` | 删除人 ID |
-| `version` | `INT UNSIGNED` | `0` | 乐观锁版本号 |
-
-### 2.2 常用字段类型选择
-
-| 场景 | 推荐类型 | 不推荐 | 说明 |
-|:---|:---|:---|:---|
-| 主键 | `BIGINT UNSIGNED` | `INT` | 防止溢出 |
-| 金额 | `BIGINT`（分） | `DECIMAL` `FLOAT` | 整数存储，避免精度问题 |
-| 手机号 | `VARCHAR(20)` | `BIGINT` | 支持国际号码、国家码 |
-| 邮箱 | `VARCHAR(128)` | `TEXT` | 有长度限制，可建索引 |
-| 用户名 | `VARCHAR(64)` | `TEXT` | — |
-| 密码 | `VARCHAR(255)` | `CHAR(32)` | 需兼容 bcrypt 等哈希长度 |
-| 状态枚举 | `TINYINT UNSIGNED` | `VARCHAR` | 节省空间，配合代码枚举 |
-| 大文本 | `TEXT` | `VARCHAR(65535)` | 文章、评论等内容 |
-| JSON 数据 | `JSON` | `TEXT` | MySQL 5.7+ / PostgreSQL 原生支持 |
-| IP 地址 | `VARBINARY(16)` | `VARCHAR(45)` | 兼容 IPv4/IPv6 |
-| 时间戳 | `DATETIME(3)` | `TIMESTAMP` | DATETIME 无时区歧义，范围更大 |
-
-### 2.3 字段约束
-
-- **NOT NULL 优先：** 尽量不让字段为 NULL，用默认值代替
-- **状态字段必须有注释：** 说明每个值的含义
-- **JSON 字段必须定义结构：** 即使类型是 JSON，也要在文档中定义字段结构
-- **大字段单独表：** TEXT/BLOB 超过 1KB 建议拆到副表
-
----
-
-## 3. 索引设计规范
-
-### 3.1 索引原则
-
-1. **where 条件字段必建索引** — 特别是高频查询条件
-2. **联合索引最左前缀** — `(a, b, c)` 可以覆盖 `a` `a,b` `a,b,c`，但不能覆盖 `b` `c`
-3. **覆盖索引优先** — 查询字段都在索引中，避免回表
-4. **索引不是越多越好** — 单表索引不超过 5 个，联合索引字段不超过 4 个
-5. **区分度低的字段放前面** — 性别（区分度 2）放前面，创建时间（区分度高）放后面
-6. **冗余索引清理** — `(a)` 和 `(a,b)` 并存时，`(a)` 是冗余的
-
-### 3.2 索引示例
-
-```sql
--- 用户表
-CREATE TABLE users (
-  id BIGINT UNSIGNED PRIMARY KEY AUTO_INCREMENT,
-  phone VARCHAR(20) NOT NULL,
-  email VARCHAR(128),
-  username VARCHAR(64) NOT NULL,
-  status TINYINT UNSIGNED NOT NULL DEFAULT 1 COMMENT '1-正常 2-冻结 3-注销',
-  created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
-  updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3) ON UPDATE CURRENT_TIMESTAMP(3),
-  deleted_at DATETIME(3) DEFAULT NULL,
-  
-  UNIQUE KEY uk_users_phone (phone),
-  UNIQUE KEY uk_users_email (email),
-  UNIQUE KEY uk_users_username (username),
-  KEY idx_users_status_created (status, created_at)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表';
-```
-
-### 3.3 索引禁忌
-
-- ❌ 不要在低区分度字段上单独建索引（如 `status` 只有 2 个值）
-- ❌ 不要对频繁更新的字段建索引（更新成本 = 数据更新 + 索引更新）
-- ❌ 不要在 WHERE 条件中对字段做函数运算（如 `WHERE DATE(created_at) = '2026-09-10'`）
-- ❌ 不要用 `SELECT *`，只查需要的字段，尽量覆盖索引
-
----
-
-## 4. 分表分库策略
-
-### 4.1 何时分表
-
-| 条件 | 策略 |
-|:---|:---|
-| 单表数据 > 500 万 | 水平分表 |
-| 单表数据 > 1 亿 | 水平分库 + 分表 |
-| 字段数 > 50 | 垂直拆分（大字段拆副表） |
-| 冷热数据明显 | 归档表（近 3 个月热数据 + 历史归档表） |
-
-### 4.2 分表路由键选择
-
-| 场景 | 路由键 | 说明 |
-|:---|:---|:---|
-| 用户相关数据 | `user_id` | 按用户维度分片，查询集中在单分片 |
-| 订单数据 | `order_id` 或 `user_id` | 订单号含时间戳可直接路由 |
-| 时间序列数据 | `created_at` | 按时间范围分片，便于归档清理 |
-| 地理位置数据 | `region_code` | 按地区分片，就近访问 |
-
-### 4.3 分表示例
-
-```sql
--- 订单表按 user_id % 128 分片
--- 物理表：order_000 ~ order_127
--- 路由规则：order_{user_id % 128}
-
-CREATE TABLE order_000 (
-  id BIGINT UNSIGNED PRIMARY KEY,
-  order_no VARCHAR(32) NOT NULL,
-  user_id BIGINT UNSIGNED NOT NULL,
-  total_amount BIGINT NOT NULL COMMENT '金额（分）',
-  status TINYINT UNSIGNED NOT NULL,
-  created_at DATETIME(3) NOT NULL,
-  
-  UNIQUE KEY uk_order_no (order_no),
-  KEY idx_user_id_created (user_id, created_at)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-```
-
----
-
-## 5. 软删除与数据归档
-
-### 5.1 软删除实现
-
-```sql
--- 查询时默认过滤软删除数据
-SELECT * FROM users WHERE deleted_at IS NULL;
-
--- 需要包含已删除数据时显式指定
-SELECT * FROM users WHERE deleted_at IS NOT NULL;
-```
-
-### 5.2 数据归档策略
-
-| 数据类型 | 保留时间 | 归档方式 |
-|:---|:---|:---|
-| 操作日志 | 90 天 | 超过后迁移到归档表或 OSS |
-| 订单数据 | 3 年 | 冷数据归档到历史库 |
-| 系统日志 | 30 天 | ELK 设置过期策略 |
-| 审计日志 | 3 年 | 单独存储，不可删除 |
-
----
-
-## 6. SQL 编写规范
-
-### 6.1 SELECT
-
-- 必须指定字段，禁止 `SELECT *`
-- 分页查询必须带 `ORDER BY`，否则结果不稳定
-- 大批量查询使用 `LIMIT + 游标`，避免深分页 `OFFSET 1000000`
-
-### 6.2 INSERT/UPDATE/DELETE
-
-- INSERT 必须指定字段名：`INSERT INTO t (a, b) VALUES (?, ?)`
-- UPDATE 必须带 WHERE 条件，禁止全表更新
-- DELETE 必须带 WHERE 条件，生产环境建议用软删除代替
-
-### 6.3 事务
-
-- 事务尽量短，不要在事务中调外部接口
-- 更新多个表时，按相同顺序加锁，避免死锁
-- 批量操作使用 `INSERT ... ON DUPLICATE KEY UPDATE` 或 `REPLACE INTO`
-
----
-
-## 7. 数据库评审清单
-
-新建或修改表时必须检查：
-
-- [ ] 表名符合命名规范（小写 + 下划线 + 复数）
-- [ ] 包含必备字段（id, created_at, updated_at, deleted_at, version）
-- [ ] 主键使用 BIGINT UNSIGNED
-- [ ] 金额字段用 BIGINT（分）存储
-- [ ] 状态字段有注释说明每个值的含义
-- [ ] 外键字段建立索引
-- [ ] WHERE 条件字段建立索引
-- [ ] 联合索引符合最左前缀原则
-- [ ] 单表索引数量 ≤ 5
-- [ ] 表和字段都有 COMMENT 注释
-- [ ] 字符集使用 utf8mb4
-- [ ] 引擎使用 InnoDB

package/templates/deploy-docker/README.md

@@ -1,284 +0,0 @@
-# Docker 部署指南
-
-> 本目录提供前后端 Docker 部署的模板和示例，涵盖本地构建、镜像仓库推送、远程服务器拉取运行全流程。
-
----
-
-## 目录结构
-
-```
-deploy-docker/
-├── frontend.Dockerfile      # 前端 Nginx 多阶段构建示例
-├── nginx.conf               # Nginx 自定义配置（SPA 路由 + API 代理 + 静态缓存）
-├── docker-compose.yml       # 前后端 + MySQL + Redis 编排示例
-├── deploy-remote.sh         # 服务器端 Docker 部署脚本
-└── README.md                # 本文件
-```
-
----
-
-## 核心问题解答
-
-### Q1: Docker 部署是否需要上传文件？
-
-**不需要传统意义上的 SCP 文件上传**，但有三种等价的"文件传输"方式：
-
-| 方式 | 说明 | 适用场景 |
-|------|------|----------|
-| **镜像仓库**（推荐） | `docker build` → `docker push` → 远程 `docker pull` | 有私有 registry（Harbor/Nexus/阿里云 ACR） |
-| **docker save + scp** | `docker save` 导出 tar → scp 到服务器 → `docker load` | 无 registry 的内网环境 |
-| **远程 build** | SSH 到服务器，在服务器上 `docker build` | 服务器性能强于本地 |
-
-speccore `docker` 类型默认采用**镜像仓库方式**（推荐）。
-
-### Q2: 远程服务器上如何部署？
-
-speccore `docker` 类型现已支持 `host` 字段，部署流程如下：
-
-```yaml
-deploy:
-  staging:
-    type: docker
-    dockerfile: ./Dockerfile
-    registry: registry.example.com      # 镜像仓库（远程部署必填）
-    image: my-project/order-service
-    tag: staging
-    host: deployer@staging-server.com   # 远程服务器（新增支持）
-    key: ~/.ssh/id_rsa
-    # script: 自定义远程命令（可选，默认执行 pull → stop → rm → run）
-```
-
-执行流程：
-1. **本地** `docker build`
-2. **本地** `docker push registry.example.com/my-project/order-service:staging`
-3. **SSH 远程** `docker pull && docker stop && docker rm && docker run`
-
-### Q3: 前端 + 后端都有 Docker，怎么一起部署？
-
-**方式 A：分别部署（推荐，解耦前后端发布节奏）**
-
-```yaml
-# PROJECT.yaml
-platforms:
-  - name: admin-web
-    type: frontend
-    code_path: ./admin-web
-    deploy:
-      staging:
-        type: docker
-        dockerfile: ./Dockerfile
-        registry: registry.example.com
-        image: my-project/admin-web
-        tag: staging
-        host: deployer@staging-server.com
-        key: ~/.ssh/id_rsa
-        # 自定义端口映射
-        script: "docker pull registry.example.com/my-project/admin-web:staging && docker stop admin-web 2>/dev/null; docker rm admin-web 2>/dev/null; docker run -d --name admin-web --restart always -p 80:80 registry.example.com/my-project/admin-web:staging"
-
-  - name: order-service
-    type: backend
-    code_path: ./order-service
-    deploy:
-      staging:
-        type: docker
-        dockerfile: ./Dockerfile
-        registry: registry.example.com
-        image: my-project/order-service
-        tag: staging
-        host: deployer@staging-server.com
-        key: ~/.ssh/id_rsa
-        script: "docker pull registry.example.com/my-project/order-service:staging && docker stop order-service 2>/dev/null; docker rm order-service 2>/dev/null; docker run -d --name order-service --restart always -p 8080:8080 registry.example.com/my-project/order-service:staging"
-```
-
-分别执行：
-```bash
-speccore deploy --env staging --platform admin-web
-speccore deploy --env staging --platform order-service
-```
-
-**方式 B：Docker Compose 统一部署**
-
-将 `docker-compose.yml` 放到服务器，speccore 负责 push 镜像，服务器端执行 compose：
-
-```yaml
-# PROJECT.yaml
-platforms:
-  - name: fullstack
-    type: infra
-    code_path: ./infra/docker
-    deploy:
-      staging:
-        type: script
-        script: ./scripts/deploy-compose.sh
-```
-
-```bash
-# scripts/deploy-compose.sh（在服务器上执行）
-docker-compose -f /opt/deploy/docker-compose.yml pull
-docker-compose -f /opt/deploy/docker-compose.yml up -d
-```
-
----
-
-## 各文件说明
-
-### frontend.Dockerfile
-
-前端多阶段构建：
-- **阶段 1**（Node）：`npm ci && npm run build`
-- **阶段 2**（Nginx）：托管 `dist/` 静态资源
-
-支持通过 `BUILD_ENV` 构建参数切换环境：
-```bash
-docker build --build-arg BUILD_ENV=staging -t admin-web:staging .
-```
-
-### nginx.conf
-
-- SPA 路由回退（`try_files`）
-- 静态资源长期缓存
-- `/api/` 代理到后端容器
-
-### docker-compose.yml
-
-完整编排示例，包含：
-- `frontend`（Nginx）
-- `backend`（Spring Boot / Node）
-- `mysql`（数据库，可选）
-- `redis`（缓存，可选）
-
-通过 `.env` 文件注入敏感配置：
-```bash
-# .env
-REGISTRY=registry.example.com
-TAG=staging
-PROFILE=staging
-DB_PASSWORD=your-db-pass
-REDIS_PASSWORD=your-redis-pass
-```
-
-### deploy-remote.sh
-
-服务器端容器管理脚本：
-- 拉取最新镜像
-- 停止并删除旧容器
-- 清理旧镜像（保留最近 3 个标签）
-- 启动新容器
-- 状态检查
-
----
-
-## 快速开始
-
-### 场景 1：前端 Docker 部署到远程服务器
-
-```bash
-# 1. 复制 Dockerfile
-cp templates/deploy-docker/frontend.Dockerfile admin-web/Dockerfile
-cp templates/deploy-docker/nginx.conf admin-web/nginx.conf
-
-# 2. 配置 PROJECT.yaml
-#    type: docker, host: 服务器地址, registry: 镜像仓库
-
-# 3. 部署
-speccore deploy --env staging --platform admin-web
-```
-
-### 场景 2：后端 Java Docker 部署
-
-见 `templates/deploy-java/Dockerfile`（已包含多阶段构建）。
-
-### 场景 3：前后端 + 数据库一次性启动
-
-```bash
-# 在服务器上
-scp templates/deploy-docker/docker-compose.yml deployer@server:/opt/deploy/
-scp templates/deploy-docker/.env deployer@server:/opt/deploy/
-
-ssh deployer@server "cd /opt/deploy && docker-compose up -d"
-```
-
----
-
-## 数据库 / Redis 配置
-
-### 方式 1：独立数据库（推荐生产环境）
-
-数据库和 Redis 由运维独立维护，应用通过环境变量连接：
-
-```yaml
-# docker-compose.yml 中 backend 的 environment
-- DB_HOST=prod-mysql.internal
-- DB_PORT=3306
-- DB_NAME=order_db
-- DB_USER=order_user
-- DB_PASS=${DB_PASSWORD}
-- REDIS_HOST=prod-redis.internal
-- REDIS_PORT=6379
-```
-
-### 方式 2：Docker Compose 内置数据库（推荐测试环境）
-
-直接使用 `docker-compose.yml` 中的 `mysql` 和 `redis` 服务，应用通过服务名连接：
-
-```yaml
-# backend 的 environment
-- DB_HOST=mysql      # Docker 网络内服务名即主机名
-- REDIS_HOST=redis
-```
-
-### 方式 3：Spring Boot 多环境配置
-
-```yaml
-# src/main/resources/application-staging.yml
-spring:
-  datasource:
-    url: jdbc:mysql://${DB_HOST:mysql}:${DB_PORT:3306}/${DB_NAME:order_db}
-    username: ${DB_USER:root}
-    password: ${DB_PASS:}
-  data:
-    redis:
-      host: ${REDIS_HOST:redis}
-      port: ${REDIS_PORT:6379}
-      password: ${REDIS_PASS:}
-```
-
----
-
-## 常见问题
-
-**Q: 没有镜像仓库怎么办？**
-
-使用 `docker save + scp + docker load`：
-
-```bash
-# 本地
-docker build -t order-service:staging .
-docker save order-service:staging | gzip > order-service-staging.tar.gz
-scp order-service-staging.tar.gz deployer@server:/tmp/
-
-# 远程
-ssh deployer@server "gunzip -c /tmp/order-service-staging.tar.gz | docker load"
-ssh deployer@server "docker stop order-service; docker rm order-service; docker run -d --name order-service -p 8080:8080 order-service:staging"
-```
-
-或改用 `script` 类型，将上述命令写入脚本由 speccore 执行。
-
-**Q: 如何查看远程容器日志？**
-
-```bash
-ssh deployer@server "docker logs -f order-service --tail 100"
-```
-
-**Q: 如何回滚？**
-
-```bash
-# 重新部署上一个标签
-speccore deploy --env staging --platform order-service --skip-build
-# 然后手动在服务器上 docker run 指定旧标签
-```
-
-或保留多个标签版本：
-```bash
-ssh deployer@server "docker stop order-service; docker rm order-service; docker run -d --name order-service order-service:v1.2.3"
-```

package/templates/deploy-docker/deploy-remote.sh

@@ -1,79 +0,0 @@
-#!/bin/bash
-# ═══════════════════════════════════════════════════════════
-# Docker 远程部署脚本（服务器端执行）
-# ═══════════════════════════════════════════════════════════
-#
-# 用法：
-#   ./deploy-remote.sh <image> <container-name> [run-args]
-#
-# 示例：
-#   ./deploy-remote.sh registry.example.com/order-service:staging order-service "-p 8080:8080 -e SPRING_PROFILES_ACTIVE=staging"
-#
-# 该脚本用于服务器端手动更新容器，也可作为 speccore deploy script 的远程命令。
-# ═══════════════════════════════════════════════════════════
-
-set -euo pipefail
-
-IMAGE="${1:-}"
-NAME="${2:-}"
-RUN_ARGS="${3:-}"
-
-if [ -z "$IMAGE" ] || [ -z "$NAME" ]; then
-  echo "用法: $0 <image> <container-name> [run-args]"
-  echo "示例: $0 registry.example.com/order-service:staging order-service \"-p 8080:8080\""
-  exit 1
-fi
-
-echo "========================================"
-echo "Docker 远程部署"
-echo "镜像: $IMAGE"
-echo "容器: $NAME"
-echo "========================================"
-
-# ── 1. 拉取最新镜像 ──
-echo "📥 拉取镜像..."
-docker pull "$IMAGE"
-
-# ── 2. 停止并删除旧容器 ──
-if docker ps -a --format '{{.Names}}' | grep -q "^${NAME}$"; then
-  echo "🛑 停止旧容器: $NAME"
-  docker stop "$NAME" || true
-  echo "🗑️  删除旧容器: $NAME"
-  docker rm "$NAME" || true
-else
-  echo "ℹ️ 无旧容器需要清理"
-fi
-
-# ── 3. 清理旧镜像（保留最近 3 个标签） ──
-echo "🧹 清理旧镜像..."
-IMAGE_BASE=$(echo "$IMAGE" | cut -d: -f1)
-docker images "$IMAGE_BASE" --format '{{.Repository}}:{{.Tag}}' | tail -n +4 | xargs -r docker rmi || true
-
-# ── 4. 启动新容器 ──
-echo "🚀 启动新容器..."
-if [ -n "$RUN_ARGS" ]; then
-  # shellcheck disable=SC2086
-  docker run -d --name "$NAME" --restart always $RUN_ARGS "$IMAGE"
-else
-  docker run -d --name "$NAME" --restart always "$IMAGE"
-fi
-
-# ── 5. 等待并检查状态 ──
-echo "⏳ 等待容器启动..."
-sleep 3
-
-if docker ps --format '{{.Names}}' | grep -q "^${NAME}$"; then
-  echo "✅ 容器已启动: $NAME"
-else
-  echo "❌ 容器启动失败"
-  echo "📋 日志:"
-  docker logs "$NAME" --tail 50 || true
-  exit 1
-fi
-
-# ── 6. 显示状态 ──
-echo ""
-echo "========================================"
-echo "📋 部署完成"
-echo "========================================"
-docker ps --filter "name=$NAME" --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

package/templates/deploy-docker/docker-compose.yml

@@ -1,113 +0,0 @@
-# ═══════════════════════════════════════════════════════════
-# 前后端 Docker Compose 编排示例
-# ═══════════════════════════════════════════════════════════
-#
-# 适用场景：一台服务器上同时部署前端 + 后端 + 数据库/Redis
-#
-# 用法：
-#   1. 将本文件复制到服务器上的部署目录
-#   2. 配置 .env 文件（数据库密码等敏感信息）
-#   3. 执行: docker-compose up -d
-#
-# 与 speccore deploy 结合：
-#   - speccore 负责 build && push 镜像
-#   - 服务器端手动或通过 CI 执行 docker-compose pull && up -d
-#   - 也可将 docker-compose 作为 speccore 的 script 部署方式执行
-# ═══════════════════════════════════════════════════════════
-
-version: "3.8"
-
-services:
-  # ── 前端 ──
-  frontend:
-    image: ${REGISTRY:-registry.example.com}/my-project/admin-web:${TAG:-staging}
-    container_name: admin-web
-    restart: unless-stopped
-    ports:
-      - "80:80"
-    networks:
-      - app-network
-    depends_on:
-      - backend
-    healthcheck:
-      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost/"]
-      interval: 30s
-      timeout: 3s
-      retries: 3
-      start_period: 10s
-
-  # ── 后端 ──
-  backend:
-    image: ${REGISTRY:-registry.example.com}/my-project/order-service:${TAG:-staging}
-    container_name: order-service
-    restart: unless-stopped
-    ports:
-      - "8080:8080"
-    environment:
-      - SPRING_PROFILES_ACTIVE=${PROFILE:-staging}
-      - JAVA_OPTS=-Xms512m -Xmx1024m
-      # 数据库连接（建议通过 .env 或 Docker Secrets 注入密码）
-      - DB_HOST=mysql
-      - DB_PORT=3306
-      - DB_NAME=order_db
-      - DB_USER=root
-      - DB_PASS=${DB_PASSWORD:-secret}
-      # Redis 连接
-      - REDIS_HOST=redis
-      - REDIS_PORT=6379
-      - REDIS_PASS=${REDIS_PASSWORD:-}
-    networks:
-      - app-network
-    depends_on:
-      mysql:
-        condition: service_healthy
-      redis:
-        condition: service_started
-    healthcheck:
-      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/actuator/health"]
-      interval: 30s
-      timeout: 5s
-      retries: 5
-      start_period: 60s
-
-  # ── MySQL（如需内置数据库，否则删除此段） ──
-  mysql:
-    image: mysql:8.0
-    container_name: mysql
-    restart: unless-stopped
-    environment:
-      - MYSQL_ROOT_PASSWORD=${DB_PASSWORD:-secret}
-      - MYSQL_DATABASE=order_db
-    ports:
-      - "3306:3306"
-    volumes:
-      - mysql-data:/var/lib/mysql
-      # - ./init.sql:/docker-entrypoint-initdb.d/init.sql
-    networks:
-      - app-network
-    healthcheck:
-      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
-      interval: 10s
-      timeout: 5s
-      retries: 5
-
-  # ── Redis（如需内置缓存，否则删除此段） ──
-  redis:
-    image: redis:7-alpine
-    container_name: redis
-    restart: unless-stopped
-    command: redis-server --requirepass ${REDIS_PASSWORD:-}
-    ports:
-      - "6379:6379"
-    volumes:
-      - redis-data:/data
-    networks:
-      - app-network
-
-networks:
-  app-network:
-    driver: bridge
-
-volumes:
-  mysql-data:
-  redis-data: