# App Expo 部署文档

> app-expo 前端应用的 CI/CD 部署说明，基于 GitHub Actions，无 EAS 依赖。

## 概述

统一部署 Pipeline 支持三个环境：

| 环境 | 触发源 | 用途 |
|------|--------|------|
| **dev** | `main` 分支 | 开发 + 内部测试 |
| **stage** | `staging` 分支 | 预发布 |
| **prod** | `v*.*.*` 标签 | 正式发布 |

## 环境映射

环境由触发源自动推断，无需额外配置：

```
main     → dev
staging  → stage
v*.*.*   → prod
```

## 触发条件

- **Push**：推送至 `main` / `staging` 或 `v*.*.*` 标签
- **路径过滤**：仅当 `app-expo/` 或 `.github/workflows/app-expo-deploy.yml` 有变更时触发
- **手动触发**：`workflow_dispatch` 可选择 dev / stage / prod

## 使用方式

### Dev（开发 + 内部测试）

```bash
git push origin main
```

合并后自动执行：质量检查、构建、上传 artifact（保留 14 天）。

### Stage（预发布）

```bash
git push origin staging
```

若没有 `staging` 分支，可先创建：

```bash
git checkout -b staging
git push -u origin staging
```

构建产物保留 30 天。

### Prod（正式发布）

```bash
git tag v1.0.0
git push origin v1.0.0
```

将自动：构建、打包 zip、创建 GitHub Release、上传 artifact（保留 90 天）。

### 手动触发

1. 打开仓库 **Actions** 标签
2. 选择 **App Expo Deploy**
3. 点击 **Run workflow**
4. 选择环境（dev / stage / prod）
5. 若选 prod，可填写版本号（如 `1.0.0`）

## 版本规则（SemVer）

| 类型 | 示例 | 说明 |
|------|------|------|
| **PATCH** | v1.0.0 → v1.0.1 | bug 修复、小改动 |
| **MINOR** | v1.0.0 → v1.1.0 | 新功能、向后兼容 |
| **MAJOR** | v1.0.0 → v2.0.0 | 重大变更、不兼容 |

## 各环境行为

| 步骤 | dev | stage | prod |
|------|-----|-------|------|
| 质量检查（format/lint/test） | ✓ | - | - |
| Web 构建 | ✓ | ✓ | ✓ |
| 上传 artifact | ✓ (14 天) | ✓ (30 天) | ✓ (90 天) |
| 创建 GitHub Release | - | - | ✓ |

## GitHub Environments

在 **Settings → Environments** 中可配置 `dev`、`staging`、`production`：

- 为各环境配置独立 secrets
- 为 production 配置审批规则
- 环境与 workflow 自动关联

## 产物说明

- **dev / stage**：`app-expo/dist` 目录（静态 Web 构建）
- **prod**：`app-expo-v{version}-web.zip`，附带于 GitHub Release

## 相关文件

- 工作流：`.github/workflows/app-expo-deploy.yml`
- 应用配置：`app-expo/app.config.ts`