# 🚀 快速开始指南

## 📋 前提条件

- ✅ Gitea 已安装并配置 Actions
- ✅ 服务器已安装 Docker 和 Docker Compose
- ✅ 服务器可通过 SSH 访问
- ✅ 端口 8080 可用

## ⚡ 5 分钟快速部署

### 步骤 1: 推送代码

```bash
cd /Users/hahaha/projects/kt-financial-system

# 添加所有修改
git add .

# 提交更改
git commit -m "ci: 优化 CI/CD 配置"

# 推送到 main 分支
git push origin main
```

### 步骤 2: 查看部署进度

1. 打开 Gitea 仓库页面：
   ```
   https://gitea.ktyun.cc/chenjiangjiang/kt-financial-system
   ```

2. 点击顶部的 `Actions` 标签

3. 查看最新的 workflow run 状态：
   - 🟡 黄色：正在执行
   - 🟢 绿色：执行成功
   - 🔴 红色：执行失败

### 步骤 3: 访问应用

部署成功后，访问：
```
http://172.16.74.149:8080
```

## 🎯 一键部署命令

```bash
# 克隆仓库（如果还没有）
git clone https://gitea.ktyun.cc/chenjiangjiang/kt-financial-system.git
cd kt-financial-system

# 推送触发部署
git push origin main

# 或使用部署脚本（手动部署）
./deploy.sh
```

## 📊 部署时间线

| 阶段 | 时间 | 说明 |
|------|------|------|
| Build and Test | 3-8 分钟 | 构建和测试 |
| Deploy | 2-5 分钟 | 部署到服务器 |
| Health Check | 30 秒 | 健康检查 |
| **总计** | **5-15 分钟** | 完整部署流程 |

## 🔍 检查部署状态

### 方法 1: Gitea Actions

1. 打开 Actions 页面
2. 查看最新的 run
3. 点击查看详细日志

### 方法 2: 服务器检查

```bash
# SSH 登录服务器
ssh atai@172.16.74.149

# 检查容器状态
cd /home/atai/kt-financial-system
sudo docker-compose ps

# 查看日志
sudo docker-compose logs --tail=50
```

### 方法 3: 健康检查

```bash
# 测试前端
curl -I http://172.16.74.149:8080

# 测试 API
curl http://172.16.74.149:8080/api/ping
```

## ⚠️ 常见问题

### 问题 1: Actions 没有触发

**解决方案**：
1. 确认 Gitea Actions 已启用
2. 检查 `.gitea/workflows/deploy.yml` 文件是否存在
3. 确认推送的是 `main` 分支

### 问题 2: 构建失败

**解决方案**：
1. 查看 Actions 日志，定位错误
2. 确认本地可以成功构建：`pnpm build`
3. 检查依赖是否正确安装

### 问题 3: 部署失败

**解决方案**：
1. 检查 SSH 连接：`ssh atai@172.16.74.149`
2. 确认服务器有足够的磁盘空间：`df -h`
3. 检查 Docker 服务：`sudo systemctl status docker`

### 问题 4: 健康检查失败

**解决方案**：
1. 等待更长时间，服务可能还在启动
2. 检查容器日志：`sudo docker-compose logs`
3. 手动测试：`curl http://localhost:8080`

## 🎉 成功标志

部署成功后，你会看到：

### Gitea Actions
```
✅ Build and Test - 成功
✅ Deploy - 成功
✅ Health Check - 成功
```

### 服务器
```bash
$ sudo docker-compose ps
NAME                    STATUS              PORTS
kt-financial-system     Up                  0.0.0.0:8080->80/tcp
```

### 浏览器
- ✅ 页面正常显示
- ✅ 登录功能正常
- ✅ 主要功能可用

## 📚 下一步

- 📖 阅读 [配置说明](.gitea/README.md)
- 🧪 查看 [测试指南](.gitea/TEST_GUIDE.md)
- 🚀 了解 [改进建议](.gitea/IMPROVEMENTS.md)
- 📝 查看 [变更日志](.gitea/CHANGELOG.md)

## 💡 小贴士

1. **首次部署**：首次部署会比较慢（8-10 分钟），后续会有缓存加速
2. **手动触发**：可以在 Actions 页面手动触发部署
3. **查看日志**：遇到问题先查看 Actions 日志
4. **健康检查**：部署后会自动进行健康检查
5. **版本检查**：如果代码无变化，会自动跳过部署

## 🆘 获取帮助

如需帮助，请：
1. 查看文档：`.gitea/` 目录下的文档
2. 查看日志：Gitea Actions 日志和服务器日志
3. 创建 Issue：在仓库中创建 Issue
4. 联系团队：联系技术支持团队

---

**快速链接**：
- 🌐 应用地址：http://172.16.74.149:8080
- 📦 Gitea 仓库：https://gitea.ktyun.cc/chenjiangjiang/kt-financial-system
- 🤖 Actions：https://gitea.ktyun.cc/chenjiangjiang/kt-financial-system/actions