# 首次部署说明

## 快速开始（推荐方式）

使用更新后的脚本一键完成所有初始化：

```bash
cd backend
python add_status_field.py --init
```

这将自动完成：
1. 检查数据库连接
2. 执行数据库迁移（makemigrations + migrate）
3. 创建管理员用户（admin/admin123）
4. 创建默认用户组
5. 收集静态文件

## 使用 Django 标准命令

如果您更喜欢使用 Django 的标准命令，也可以按以下步骤执行：

```bash
cd backend

# 1. 生成迁移文件
python manage.py makemigrations

# 2. 应用迁移
python manage.py migrate

# 3. 创建管理员用户（交互式）
python manage.py createsuperuser
```

## 脚本功能说明

### add_status_field.py - 首次部署初始化脚本

**完整初始化：**
```bash
python add_status_field.py --init
```

**分步执行：**
```bash
# 仅执行数据库迁移
python add_status_field.py --migrate

# 仅创建管理员用户
python add_status_field.py --create-admin

# 仅创建用户组
python add_status_field.py --create-groups

# 仅收集静态文件
python add_status_field.py --collect-static
```

### check_users.py - 用户管理脚本

**列出所有用户：**
```bash
python check_users.py --list
```

**创建管理员用户：**
```bash
python check_users.py --create-admin
```

**创建测试用户：**
```bash
python check_users.py --create-test
```

**创建用户组：**
```bash
python check_users.py --create-groups
```

**列出所有用户组：**
```bash
python check_users.py --list-groups
```

**一键初始化用户数据：**
```bash
python check_users.py --init
```

## 默认账号信息

**管理员账号：**
- 用户名: `admin`
- 密码: `admin123`

⚠️ **重要提示：** 请在首次登录后立即修改默认密码！

**测试账号：**
- `testuser` / `test123` - 测试用户
- `developer` / `dev123` - 开发人员

## 部署前准备

1. **配置数据库连接**

编辑 `backend/conf/env.py` 文件：

```python
DATABASE_NAME = 'your_database_name'
DATABASE_USER = 'your_database_user'
DATABASE_PASSWORD = 'your_database_password'
DATABASE_HOST = 'localhost'
DATABASE_PORT = '3306'
```

2. **创建数据库**

在 MySQL 中执行：

```sql
CREATE DATABASE your_database_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

3. **安装依赖**

```bash
cd backend
pip install -r requirements.txt
```

## 启动服务

**开发环境：**
```bash
cd backend
python manage.py runserver
```

**生产环境：**
```bash
cd backend
gunicorn backend.wsgi:application -c gunicorn_conf.py
```

## 数据库表结构

### lunaruser 应用
- `lunaruser_myuser` - 用户表（包含 phone、show_hosts、name、status 字段）

### lunarlink 应用
- `project` - 项目信息表
- `config` - 环境信息表
- `api` - 接口信息表
- `case` - 用例信息表
- `case_step` - 用例步骤表
- `variables` - 全局变量表
- `debugtalk` - 驱动代码表
- `report` - 测试报告表
- `report_detail` - 测试报告详情表
- `relation` - 树形结构关系表
- `visit` - 访问日志表
- `login_log` - 登录日志表

## 常见问题

### 1. 数据库连接失败

检查 `conf/env.py` 中的数据库配置是否正确，确保数据库已创建且用户有足够的权限。

### 2. 迁移失败

确保数据库表不存在或为空。如果之前有迁移历史，可能需要删除 `migrations` 目录下的迁移文件（保留 `__init__.py`）。

### 3. 静态文件收集失败

确保 `STATIC_ROOT` 目录有写入权限。

### 4. 用户已存在

脚本会自动检测用户是否已存在，如果存在则跳过创建。

## 技术支持

如有问题，请查看项目文档或联系技术支持团队。