# 🚀 快速参考 - Filament Admin 部署

## 一键部署（3 步完成）

```bash
# 1️⃣ 检查配置
make check-config

# 2️⃣ 构建镜像
make build

# 3️⃣ 部署服务
make deploy
```

## 完整流程

### 📋 部署前准备
```bash
# 检查系统要求
make check-config

# 或手动检查
./check-config.sh
```

### 🏗️ 构建镜像
```bash
# 方法 1：使用 Make（推荐）
make build

# 方法 2：使用脚本
./build.sh

# 方法 3：直接 Docker
docker compose -f docker-compose.prod.yml build --no-cache
```

### 🚀 部署应用
```bash
# 方法 1：使用 Make（推荐）
make deploy

# 方法 2：使用脚本
./deploy.sh

# 方法 3：直接 Docker
docker compose -f docker-compose.prod.yml up -d
```

### ✅ 验证部署
```bash
# 方法 1：使用 Make
make verify

# 方法 2：使用脚本
./verify.sh

# 方法 3：手动验证
curl http://localhost:5019/admin
docker compose -f docker-compose.prod.yml ps
```

## 🔧 常用操作

### 查看状态
```bash
# 容器状态
docker compose -f docker-compose.prod.yml ps

# 实时日志
make logs
# 或
docker compose -f docker-compose.prod.yml logs -f

# 最近 100 行日志
docker compose -f docker-compose.prod.yml logs --tail=100
```

### 启停操作
```bash
# 重启
make restart
# 或
docker compose -f docker-compose.prod.yml restart

# 停止
make stop
# 或
docker compose -f docker-compose.prod.yml down

# 启动
make up
# 或
docker compose -f docker-compose.prod.yml up -d
```

### 清理资源
```bash
# 清理容器和镜像
make clean
# 或
docker compose -f docker-compose.prod.yml down -v
docker system prune -f
```

## 🌐 访问信息

- **管理后台**：[http://localhost:5019/admin](http://localhost:5019/admin)
- **健康检查**：`docker compose -f docker-compose.prod.yml ps`

## ⚙️ 重要配置

### .env 文件关键配置
```env
APP_ENV=production         # 生产环境
APP_DEBUG=false            # 关闭调试
APP_URL=http://localhost:5019

DB_CONNECTION=sqlite       # 或 mysql/pgsql
KNOWLEDGE_API_BASE=...     # 知识图谱 API 地址
QUESTION_BANK_API_BASE=... # 题库 API 地址
```

### 端口修改
编辑 `docker-compose.prod.yml`：
```yaml
ports:
  - "8080:8000"  # 改为您需要的端口
```

### 使用 MySQL 数据库
1. 编辑 `.env`：
   ```env
   DB_CONNECTION=mysql
   DB_HOST=mysql
   DB_PORT=3306
   DB_DATABASE=filament_admin
   DB_USERNAME=filament_user
   DB_PASSWORD=your_password
   ```

2. 取消 `docker-compose.prod.yml` 中 MySQL 服务注释

## 🐛 故障排除

### 端口占用
```bash
# 查看占用进程
lsof -i :5019

# 解决：修改端口或停止占用进程
```

### 权限错误
```bash
# 修复权限
sudo chown -R $USER:$USER storage bootstrap/cache
chmod -R 775 storage bootstrap/cache
```

### 构建失败
```bash
# 清理重新构建
docker system prune -a
make build
```

### 查看详细错误
```bash
make logs
```

## 📚 更多资源

- 📖 [详细部署指南](./DEPLOYMENT.md)
- 🚀 [快速开始](./QUICKSTART.md)
- 📊 [部署总结](./README-DEPLOYMENT.md)

## 📞 支持命令

```bash
# 查看所有命令
make help

# 检查配置
make check-config

# 验证部署
make verify
```

---

**提示**：生产环境部署前，请务必：
1. ✅ 修改 `.env` 中的 API 地址
2. ✅ 设置强密码
3. ✅ 配置域名和 SSL
4. ✅ 设置定期备份