@llryiop/avatar-boot-cli 1.0.0

package/templates/.claude/skills/database-design/SKILL.md

@@ -0,0 +1,377 @@
+---
+name: database-design
+description: |
+  根据业务需求生成数据库表 DDL 和索引建议，遵循项目数据库设计规范。
+  触发词: database design, table design, DDL, schema, ER, 数据库设计, 表设计, 建表
+---
+
+# 数据库设计技能 (Database Design Skill)
+
+## 概述
+
+本技能根据业务需求描述，生成符合 Avatar Boot 项目规范的数据库表 DDL、索引设计和优化建议。输出可直接用于 CRUD 代码生成。
+
+---
+
+## 输入要求
+
+提供业务需求描述，例如：
+
+```
+设计一个订单管理系统，需要管理：
+- 订单信息：订单号、用户ID、订单金额、订单状态、备注
+- 订单商品明细：关联订单、商品ID、商品名称、数量、单价、小计
+- 订单状态包括：待支付、已支付、已发货、已完成、已取消
+```
+
+---
+
+## 输出内容
+
+1. **DDL 建表语句** — 完整的 CREATE TABLE 语句
+2. **索引建议** — 索引设计及理由
+3. **设计说明** — 关键设计决策的说明
+
+---
+
+## 命名规范
+
+### 表命名
+
+| 规则 | 说明 | 正确示例 | 错误示例 |
+|------|------|----------|----------|
+| snake_case 全小写 | 统一使用下划线分隔 | `t_user_order` | `T_UserOrder`, `tUserOrder` |
+| 模块前缀 `t_` | 所有业务表以 `t_` 开头 | `t_user` | `user`, `tb_user` |
+| 有意义的英文名词 | 清晰表达表的业务含义 | `t_order_item` | `t_oi`, `t_table1` |
+| 关联表命名 | 两个实体名拼接 | `t_user_role` | `t_ur` |
+
+### 字段命名
+
+| 规则 | 说明 | 正确示例 | 错误示例 |
+|------|------|----------|----------|
+| snake_case 全小写 | 统一使用下划线分隔 | `user_name` | `userName`, `UserName` |
+| 布尔字段 `is_` 前缀 | 表示是否的字段 | `is_deleted`, `is_active` | `deleted`, `active` |
+| 时间字段 `_time` 后缀 | 表示时间的字段 | `create_time`, `pay_time` | `created`, `payDate` |
+| 状态字段 `status` | 表示状态的字段 | `order_status` | `order_state`, `sts` |
+| 外键字段 `_id` 后缀 | 引用其他表主键 | `user_id`, `order_id` | `user`, `fk_user` |
+
+---
+
+## 必需字段
+
+每张业务表必须包含以下四个字段：
+
+```sql
+-- 主键：BIGINT 类型，雪花算法生成，不自增
+id BIGINT NOT NULL COMMENT '主键ID',
+
+-- 创建时间：记录数据创建时间
+create_time DATETIME NOT NULL COMMENT '创建时间',
+
+-- 更新时间：记录数据最后更新时间
+update_time DATETIME NOT NULL COMMENT '更新时间',
+
+-- 逻辑删除：0-未删除 1-已删除，不做物理删除
+is_deleted TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除：0-未删除 1-已删除',
+```
+
+> 注意：`id` 使用 BIGINT 而非 AUTO_INCREMENT，由应用层（MyBatis Plus ASSIGN_ID）生成雪花 ID。
+
+---
+
+## 数据类型指南
+
+### 类型选择原则
+
+| 场景 | 推荐类型 | 说明 |
+|------|----------|------|
+| 主键、外键 | `BIGINT` | 统一使用 BIGINT，兼容雪花 ID |
+| 短文本（名称、标题） | `VARCHAR(n)` | 明确指定长度，n ≤ 255 |
+| 长文本（描述、备注） | `VARCHAR(n)` 或 `TEXT` | 长度可预估用 VARCHAR，不可预估用 TEXT |
+| 超长文本（文章内容） | `TEXT` / `LONGTEXT` | 仅在必要时使用 |
+| 金额、价格 | `DECIMAL(p, s)` | 禁止使用 FLOAT / DOUBLE，推荐 DECIMAL(10, 2) |
+| 整数计数 | `INT` | 一般场景 |
+| 小整数（状态、类型） | `TINYINT` | 0-127 范围的枚举值 |
+| 日期时间 | `DATETIME` | 不使用 TIMESTAMP（2038 年问题） |
+| 仅日期 | `DATE` | 如生日、有效日期 |
+| 布尔值 | `TINYINT` | 0 和 1，不使用 BIT |
+| JSON 数据 | `JSON` | MySQL 5.7+ 支持，需要 JSON 查询时使用 |
+| 大字段（图片、文件） | 不存库 | 存储到对象存储（OSS），数据库只存 URL |
+
+### 字段长度建议
+
+| 字段类型 | 推荐长度 | 说明 |
+|----------|----------|------|
+| 用户名 | VARCHAR(64) | |
+| 手机号 | VARCHAR(20) | 预留国际号码长度 |
+| 邮箱 | VARCHAR(128) | |
+| URL | VARCHAR(512) | |
+| IP 地址 | VARCHAR(45) | 兼容 IPv6 |
+| 标题 | VARCHAR(200) | |
+| 备注/描述 | VARCHAR(500) | |
+| 订单号 | VARCHAR(32) | |
+| 密码哈希 | VARCHAR(128) | BCrypt 等哈希结果 |
+
+---
+
+## 索引设计原则
+
+### 索引类型
+
+| 索引类型 | 使用场景 | DDL 语法 |
+|----------|----------|----------|
+| 主键索引 | 每表必须有 | `PRIMARY KEY (id)` |
+| 唯一索引 | 业务唯一约束 | `UNIQUE KEY uk_xxx (col)` |
+| 普通索引 | 高频查询条件 | `KEY idx_xxx (col)` |
+| 组合索引 | 多条件联合查询 | `KEY idx_xxx (col1, col2)` |
+
+### 索引命名规范
+
+| 索引类型 | 前缀 | 示例 |
+|----------|------|------|
+| 主键 | `pk_` | `PRIMARY KEY (id)` |
+| 唯一索引 | `uk_` | `UNIQUE KEY uk_username (username)` |
+| 普通索引 | `idx_` | `KEY idx_user_id (user_id)` |
+| 组合索引 | `idx_` | `KEY idx_status_create_time (status, create_time)` |
+
+### 组合索引最左前缀原则
+
+组合索引 `(a, b, c)` 可以满足以下查询：
+- `WHERE a = ?` — 命中
+- `WHERE a = ? AND b = ?` — 命中
+- `WHERE a = ? AND b = ? AND c = ?` — 命中
+- `WHERE b = ?` — 不命中
+- `WHERE b = ? AND c = ?` — 不命中
+
+设计组合索引时，将区分度高的列放在前面。
+
+### 覆盖索引
+
+当查询的所有字段都在索引中时，MySQL 可以直接从索引中读取数据，无需回表：
+
+```sql
+-- 索引: idx_status_create_time (status, create_time)
+-- 覆盖索引查询（只查索引中的字段）
+SELECT status, create_time FROM t_order WHERE status = 1;
+```
+
+### 索引设计建议
+
+1. **高频查询条件**必须建索引（WHERE、JOIN 条件）
+2. **区分度低的字段**不建议单独建索引（如 `status` 只有几个值）
+3. **区分度低 + 高频**可组合其他字段建联合索引
+4. 单表索引数量建议不超过 **5 个**
+5. 索引字段总长度建议不超过 **256 字节**
+6. **频繁更新的字段**不建议建索引
+
+---
+
+## 外键设计
+
+### 逻辑外键（推荐）
+
+使用逻辑外键，不创建物理外键约束：
+
+```sql
+-- 推荐：逻辑外键，不添加 FOREIGN KEY 约束
+CREATE TABLE t_order_item (
+    id BIGINT NOT NULL COMMENT '主键ID',
+    order_id BIGINT NOT NULL COMMENT '订单ID',  -- 逻辑外键
+    product_id BIGINT NOT NULL COMMENT '商品ID', -- 逻辑外键
+    ...
+    PRIMARY KEY (id),
+    KEY idx_order_id (order_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订单商品明细表';
+```
+
+### 物理外键（禁止）
+
+```sql
+-- 禁止：物理外键约束，影响性能和运维
+FOREIGN KEY (order_id) REFERENCES t_order(id)
+```
+
+**原因**：
+- 物理外键影响数据库写入性能
+- 增加数据库运维复杂度（数据迁移、分库分表受限）
+- 级联操作可能导致意外的数据变更
+- 数据完整性由应用层保证
+
+---
+
+## 大表分区策略
+
+当预估单表数据量超过 **500 万行**时，考虑分区或分表：
+
+### 时间范围分区
+
+适用于日志表、流水表等按时间增长的数据：
+
+```sql
+CREATE TABLE t_operation_log (
+    id BIGINT NOT NULL COMMENT '主键ID',
+    operation_type VARCHAR(32) NOT NULL COMMENT '操作类型',
+    content TEXT COMMENT '操作内容',
+    create_time DATETIME NOT NULL COMMENT '创建时间',
+    PRIMARY KEY (id, create_time)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='操作日志表'
+PARTITION BY RANGE (TO_DAYS(create_time)) (
+    PARTITION p202601 VALUES LESS THAN (TO_DAYS('2026-02-01')),
+    PARTITION p202602 VALUES LESS THAN (TO_DAYS('2026-03-01')),
+    PARTITION p202603 VALUES LESS THAN (TO_DAYS('2026-04-01')),
+    PARTITION pmax VALUES LESS THAN MAXVALUE
+);
+```
+
+### 分表建议
+
+当分区无法满足需求时，考虑按业务维度分表：
+
+- **按用户 ID 取模分表**：`t_order_00` ~ `t_order_15`
+- **按时间分表**：`t_order_202601` ~ `t_order_202612`
+
+---
+
+## DDL 完整示例
+
+以订单系统为例：
+
+```sql
+-- ----------------------------
+-- 订单表
+-- ----------------------------
+CREATE TABLE t_order (
+    id BIGINT NOT NULL COMMENT '主键ID',
+    order_no VARCHAR(32) NOT NULL COMMENT '订单号',
+    user_id BIGINT NOT NULL COMMENT '用户ID',
+    total_amount DECIMAL(10, 2) NOT NULL DEFAULT 0.00 COMMENT '订单总金额',
+    order_status TINYINT NOT NULL DEFAULT 0 COMMENT '订单状态：0-待支付 1-已支付 2-已发货 3-已完成 4-已取消',
+    remark VARCHAR(500) DEFAULT NULL COMMENT '备注',
+    pay_time DATETIME DEFAULT NULL COMMENT '支付时间',
+    create_time DATETIME NOT NULL COMMENT '创建时间',
+    update_time DATETIME NOT NULL COMMENT '更新时间',
+    is_deleted TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除：0-未删除 1-已删除',
+    PRIMARY KEY (id),
+    UNIQUE KEY uk_order_no (order_no),
+    KEY idx_user_id (user_id),
+    KEY idx_status_create_time (order_status, create_time)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订单表';
+
+-- ----------------------------
+-- 订单商品明细表
+-- ----------------------------
+CREATE TABLE t_order_item (
+    id BIGINT NOT NULL COMMENT '主键ID',
+    order_id BIGINT NOT NULL COMMENT '订单ID',
+    product_id BIGINT NOT NULL COMMENT '商品ID',
+    product_name VARCHAR(200) NOT NULL COMMENT '商品名称',
+    quantity INT NOT NULL DEFAULT 1 COMMENT '数量',
+    unit_price DECIMAL(10, 2) NOT NULL COMMENT '单价',
+    subtotal DECIMAL(10, 2) NOT NULL COMMENT '小计',
+    create_time DATETIME NOT NULL COMMENT '创建时间',
+    update_time DATETIME NOT NULL COMMENT '更新时间',
+    is_deleted TINYINT NOT NULL DEFAULT 0 COMMENT '逻辑删除：0-未删除 1-已删除',
+    PRIMARY KEY (id),
+    KEY idx_order_id (order_id),
+    KEY idx_product_id (product_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订单商品明细表';
+```
+
+---
+
+## 审查清单
+
+设计完成后，按以下清单逐项检查：
+
+### 表结构审查
+
+- [ ] 表名符合 `t_模块_实体` 命名规范
+- [ ] 字段名符合 snake_case 命名规范
+- [ ] 包含 `id`, `create_time`, `update_time`, `is_deleted` 四个必需字段
+- [ ] `id` 使用 `BIGINT NOT NULL`，不自增
+- [ ] 每个字段都有 `COMMENT` 注释
+- [ ] 字段类型选择合理（金额用 DECIMAL，时间用 DATETIME）
+- [ ] VARCHAR 长度合理，不过大也不过小
+- [ ] NOT NULL / DEFAULT 约束合理
+- [ ] 表有 `COMMENT` 注释
+- [ ] 字符集使用 `utf8mb4`
+
+### 索引审查
+
+- [ ] 主键索引存在
+- [ ] 业务唯一字段有唯一索引
+- [ ] 高频查询条件有索引覆盖
+- [ ] 外键字段有普通索引
+- [ ] 组合索引遵循最左前缀原则
+- [ ] 索引命名符合 `uk_` / `idx_` 前缀规范
+- [ ] 单表索引数量不超过 5 个
+- [ ] 无冗余索引（已被其他组合索引覆盖的单列索引）
+
+### 关联关系审查
+
+- [ ] 使用逻辑外键，无物理 FOREIGN KEY 约束
+- [ ] 外键字段类型与引用表主键类型一致（BIGINT）
+- [ ] 关联关系在 COMMENT 中说明
+
+---
+
+## 最佳实践
+
+1. **先理解业务再建表** — 充分理解业务需求后再设计表结构，避免反复修改
+2. **适度冗余** — 允许适度的数据冗余以减少 JOIN 查询（如订单表存商品名称）
+3. **预留扩展** — 状态字段使用 TINYINT 而非 ENUM，方便扩展
+4. **避免过度设计** — 不要为不确定的未来需求添加字段
+5. **字段默认值** — 尽量为字段设置合理的默认值
+6. **注释完整** — 每个字段和表都要有清晰的中文注释
+7. **金额用分** — 如果精度要求高，可以考虑用 BIGINT 存储分，避免浮点精度问题
+8. **状态值说明** — 状态字段的 COMMENT 中列出所有可能的值及含义
+
+---
+
+## 常见问题排查
+
+### Q: VARCHAR 和 TEXT 如何选择？
+
+- 长度可预估且 ≤ 65535 字节：使用 `VARCHAR(n)`
+- 长度不可预估或超长内容：使用 `TEXT`
+- VARCHAR 可以建索引，TEXT 只能建前缀索引
+- VARCHAR 参与排序和分组性能优于 TEXT
+
+### Q: DATETIME 和 TIMESTAMP 如何选择？
+
+推荐统一使用 `DATETIME`：
+- DATETIME 范围：1000-01-01 ~ 9999-12-31
+- TIMESTAMP 范围：1970-01-01 ~ 2038-01-19（存在 2038 年问题）
+- DATETIME 不受时区影响，存什么取什么
+- TIMESTAMP 自动时区转换，跨时区可能导致混乱
+
+### Q: 如何处理枚举值字段？
+
+推荐使用 `TINYINT` + COMMENT 说明：
+
+```sql
+-- 推荐
+order_status TINYINT NOT NULL DEFAULT 0 COMMENT '订单状态：0-待支付 1-已支付 2-已发货 3-已完成 4-已取消'
+
+-- 不推荐：MySQL ENUM 类型
+order_status ENUM('PENDING', 'PAID', 'SHIPPED') COMMENT '订单状态'
+```
+
+原因：TINYINT 更灵活，新增枚举值不需要 ALTER TABLE。
+
+### Q: 需要存储树形结构怎么设计？
+
+推荐使用 `parent_id` 邻接表模式：
+
+```sql
+CREATE TABLE t_department (
+    id BIGINT NOT NULL COMMENT '主键ID',
+    parent_id BIGINT NOT NULL DEFAULT 0 COMMENT '父级ID，顶级为0',
+    name VARCHAR(100) NOT NULL COMMENT '部门名称',
+    sort INT NOT NULL DEFAULT 0 COMMENT '排序号',
+    ...
+    KEY idx_parent_id (parent_id)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='部门表';
+```
+
+如需高效查询整棵子树，可额外添加 `path` 字段存储路径（如 `/1/3/7/`）。

package/templates/.claude/skills/deployment-config/SKILL.md

@@ -0,0 +1,277 @@
+---
+name: deployment-config
+description: |
+  部署配置技能 - 生成 Docker / Kubernetes 部署配置模板。
+  triggers: Docker, Dockerfile, K8s, Kubernetes, deployment, 部署配置
+globs:
+  - "Dockerfile"
+  - "docker-compose*.yml"
+  - "k8s/**/*.yml"
+  - "k8s/**/*.yaml"
+  - "deploy/**/*.yml"
+  - "deploy/**/*.yaml"
+---
+
+# 部署配置 (Deployment Config)
+
+## 概述
+
+为 Avatar Boot (Spring Boot 3.5.3 + Java 21) 项目生成生产级 Docker 与 Kubernetes
+部署配置，涵盖多阶段构建、资源限制、健康检查、环境变量注入等。
+
+---
+
+## 1. Dockerfile 多阶段构建
+
+```dockerfile
+# ==================== 构建阶段 ====================
+FROM maven:3.9-eclipse-temurin-21-alpine AS builder
+
+WORKDIR /build
+COPY pom.xml .
+# 先下载依赖，利用 Docker 缓存层
+RUN mvn dependency:go-offline -B
+
+COPY src ./src
+RUN mvn package -DskipTests -B && \
+    # 使用 Spring Boot layertools 拆分 jar，优化镜像层缓存
+    java -Djarmode=layertools -jar target/*.jar extract --destination extracted
+
+# ==================== 运行阶段 ====================
+FROM eclipse-temurin:21-jre-alpine AS runtime
+
+# 安全: 不使用 root 用户
+RUN addgroup -S appgroup && adduser -S appuser -G appgroup
+USER appuser
+
+WORKDIR /app
+
+# 按变更频率分层 COPY，最大化缓存命中
+COPY --from=builder /build/extracted/dependencies/ ./
+COPY --from=builder /build/extracted/spring-boot-loader/ ./
+COPY --from=builder /build/extracted/snapshot-dependencies/ ./
+COPY --from=builder /build/extracted/application/ ./
+
+# JVM 调优参数
+ENV JAVA_OPTS="-XX:+UseG1GC \
+  -XX:MaxRAMPercentage=75.0 \
+  -XX:+UseContainerSupport \
+  -Djava.security.egd=file:/dev/./urandom"
+
+EXPOSE 8080
+
+# 健康检查
+HEALTHCHECK --interval=30s --timeout=5s --start-period=60s --retries=3 \
+  CMD wget -qO- http://localhost:8080/actuator/health || exit 1
+
+ENTRYPOINT ["sh", "-c", "java ${JAVA_OPTS} org.springframework.boot.loader.launch.JarLauncher"]
+```
+
+---
+
+## 2. Kubernetes Deployment
+
+```yaml
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: ${APP_NAME}
+  namespace: ${NAMESPACE}
+  labels:
+    app: ${APP_NAME}
+    version: ${APP_VERSION}
+spec:
+  replicas: 2
+  revisionHistoryLimit: 5
+  strategy:
+    type: RollingUpdate
+    rollingUpdate:
+      maxSurge: 1
+      maxUnavailable: 0
+  selector:
+    matchLabels:
+      app: ${APP_NAME}
+  template:
+    metadata:
+      labels:
+        app: ${APP_NAME}
+        version: ${APP_VERSION}
+      annotations:
+        prometheus.io/scrape: "true"
+        prometheus.io/port: "8080"
+        prometheus.io/path: "/actuator/prometheus"
+    spec:
+      serviceAccountName: ${APP_NAME}
+      terminationGracePeriodSeconds: 60
+      containers:
+        - name: ${APP_NAME}
+          image: ${REGISTRY}/${APP_NAME}:${APP_VERSION}
+          imagePullPolicy: IfNotPresent
+          ports:
+            - name: http
+              containerPort: 8080
+              protocol: TCP
+          # -------- 资源限制 --------
+          resources:
+            requests:
+              cpu: "250m"
+              memory: "512Mi"
+            limits:
+              cpu: "1000m"
+              memory: "1024Mi"
+          # -------- 健康检查 --------
+          startupProbe:
+            httpGet:
+              path: /actuator/health/liveness
+              port: http
+            initialDelaySeconds: 30
+            periodSeconds: 10
+            failureThreshold: 10
+          livenessProbe:
+            httpGet:
+              path: /actuator/health/liveness
+              port: http
+            periodSeconds: 15
+            timeoutSeconds: 3
+            failureThreshold: 3
+          readinessProbe:
+            httpGet:
+              path: /actuator/health/readiness
+              port: http
+            periodSeconds: 10
+            timeoutSeconds: 3
+            failureThreshold: 3
+          # -------- 环境变量 --------
+          env:
+            - name: SPRING_PROFILES_ACTIVE
+              value: "${PROFILE}"
+            - name: JAVA_OPTS
+              value: "-XX:+UseG1GC -XX:MaxRAMPercentage=75.0"
+            - name: TZ
+              value: "Asia/Shanghai"
+          envFrom:
+            - configMapRef:
+                name: ${APP_NAME}-config
+            - secretRef:
+                name: ${APP_NAME}-secret
+          # -------- 挂载 --------
+          volumeMounts:
+            - name: logs
+              mountPath: /app/logs
+      volumes:
+        - name: logs
+          emptyDir: {}
+      imagePullSecrets:
+        - name: registry-secret
+```
+
+---
+
+## 3. Kubernetes Service
+
+```yaml
+apiVersion: v1
+kind: Service
+metadata:
+  name: ${APP_NAME}
+  namespace: ${NAMESPACE}
+  labels:
+    app: ${APP_NAME}
+spec:
+  type: ClusterIP
+  ports:
+    - name: http
+      port: 80
+      targetPort: http
+      protocol: TCP
+  selector:
+    app: ${APP_NAME}
+```
+
+---
+
+## 4. Kubernetes Ingress
+
+```yaml
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: ${APP_NAME}
+  namespace: ${NAMESPACE}
+  annotations:
+    nginx.ingress.kubernetes.io/proxy-body-size: "50m"
+    nginx.ingress.kubernetes.io/proxy-read-timeout: "60"
+    nginx.ingress.kubernetes.io/proxy-send-timeout: "60"
+    nginx.ingress.kubernetes.io/ssl-redirect: "true"
+    cert-manager.io/cluster-issuer: "letsencrypt-prod"
+spec:
+  ingressClassName: nginx
+  tls:
+    - hosts:
+        - ${APP_DOMAIN}
+      secretName: ${APP_NAME}-tls
+  rules:
+    - host: ${APP_DOMAIN}
+      http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service:
+                name: ${APP_NAME}
+                port:
+                  name: http
+```
+
+---
+
+## 5. ConfigMap 与 Secret
+
+```yaml
+# ConfigMap - 非敏感配置
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: ${APP_NAME}-config
+  namespace: ${NAMESPACE}
+data:
+  NACOS_SERVER_ADDR: "nacos.middleware:8848"
+  NACOS_NAMESPACE: "production"
+  APP_LOG_LEVEL: "INFO"
+---
+# Secret - 敏感配置 (值需 base64 编码)
+apiVersion: v1
+kind: Secret
+metadata:
+  name: ${APP_NAME}-secret
+  namespace: ${NAMESPACE}
+type: Opaque
+data:
+  DB_PASSWORD: "cGFzc3dvcmQ="          # echo -n 'password' | base64
+  REDIS_PASSWORD: "cmVkaXNwYXNz"       # echo -n 'redispass' | base64
+  KAFKA_SASL_PASSWORD: "a2Fma2FwYXNz"  # echo -n 'kafkapass' | base64
+```
+
+---
+
+## Best Practices
+
+1. **镜像构建**: 使用多阶段构建减小镜像体积；利用 Spring Boot layertools 拆分 jar 层，加速增量构建。
+2. **非 root 运行**: 容器内使用非 root 用户，降低安全风险。
+3. **资源限制**: 始终设置 requests 和 limits；`MaxRAMPercentage=75.0` 预留内存给堆外。
+4. **健康检查三件套**: startupProbe (启动) + livenessProbe (存活) + readinessProbe (就绪) 缺一不可。
+5. **滚动更新**: `maxUnavailable: 0` 保证更新期间无损；`terminationGracePeriodSeconds` 给足优雅关闭时间。
+6. **敏感信息**: 密码、密钥必须放 Secret，禁止写入 ConfigMap 或镜像中。
+7. **时区**: 容器默认 UTC，需显式设置 `TZ=Asia/Shanghai`。
+
+## Troubleshooting
+
+| 问题 | 排查方向 |
+|------|----------|
+| Pod 启动 CrashLoopBackOff | 检查 `startupProbe` 配置，增大 `initialDelaySeconds` 或 `failureThreshold` |
+| OOMKilled | 调大 `resources.limits.memory`，检查 JVM `MaxRAMPercentage` 是否合理 |
+| 镜像拉取失败 | 确认 `imagePullSecrets` 配置正确，镜像 tag 是否存在 |
+| 服务不可达 | 检查 Service selector 与 Pod labels 是否匹配；确认 `readinessProbe` 通过 |
+| 配置未生效 | ConfigMap / Secret 更新后需重启 Pod，或使用 Nacos 动态配置 |
+| 滚动更新卡住 | 检查新 Pod 是否通过 readinessProbe；`kubectl rollout status` 查看详情 |
+| 日志中文乱码 | Dockerfile 中添加 `ENV LANG=C.UTF-8` |