ci-cd-github-actions

GitHub Actions CI/CD Skill（多区域 Flutter + NestJS）

把 flutter-testing 的测试与三 flavor 发布纪律固化成流水线。所有 <PLACEHOLDER> 替换为项目实际值；所有密钥走 GitHub Secrets，禁止进仓库。

0. 流水线总览

workflow	触发	作用
ci.yml	PR / push 到非发布分支	质量门禁：analyze + test（前后端）+ 静态守卫 grep
release-mobile.yml	打 tag v* / 手动 dispatch	★ 三 flavor 矩阵构建 + 产物解包守卫 + 上传制品
deploy-backend.yml	手动 dispatch（含确认输入）/ tag	rsync + pm2 部署后端（对应 backend-production-deploy skill）

铁律：

• ★ 所有凭证（keystore、.p8、match 密码、SSH key、Firebase json）走 secrets，绝不 commit
• ★ 生产部署 workflow 必须手动确认（workflow_dispatch + environment: production 需 reviewer 批准），对齐"未经同意禁止写生产"红线
• ★ flutter / node 版本锁定（flutter-version: 写死，不用 latest），否则 golden 假失败 + 构建漂移

1. CI 质量门禁（ci.yml）

完整模板见 templates/ci.yml。三个并行 job：

job: flutter-quality

- uses: subosito/flutter-action@v2
  with: { flutter-version: '<FLUTTER_VERSION>', channel: stable, cache: true }
- run: flutter pub get
- run: dart run build_runner build --delete-conflicting-outputs   # 生成 freezed/g.dart
- run: flutter gen-l10n
- run: dart format --set-exit-if-changed lib/ test/               # 格式
- run: flutter analyze --fatal-infos
- run: flutter test --coverage --exclude-tags golden
- run: flutter test --tags golden                                 # golden 单独（环境敏感）

job: backend-quality（带 MySQL service container 跑 e2e）

services:
  mysql:
    image: mysql:8
    env: { MYSQL_ROOT_PASSWORD: test, MYSQL_DATABASE: <APP>_test }
    ports: ['3306:3306']
    options: >-
      --health-cmd="mysqladmin ping" --health-interval=5s --health-retries=10
steps:
  - uses: actions/setup-node@v4
    with: { node-version: '<NODE_VERSION>', cache: npm, cache-dependency-path: server/package-lock.json }
  - run: npm ci
    working-directory: server
  - run: npx prisma migrate reset --force        # 用测试库
    working-directory: server
    env: { DATABASE_URL: 'mysql://root:[email protected]:3306/<APP>_test' }
  - run: npm run test
    working-directory: server
  - run: npm run test:e2e
    working-directory: server
    env: { DATABASE_URL: 'mysql://root:[email protected]:3306/<APP>_test' }