# 脚本说明

## seed_test_users.py：插入测试用户（供测试工程师使用）

向 `users` 表插入 6 个测试账号（管理员、市场部、工程部、技经部、财务部、物贸部各一），**统一密码：123456**。

**用法**

```bash
cd backend
source .venv/bin/activate
PYTHONPATH=src python scripts/seed_test_users.py
```

**测试账号**

| 账号 (username) | 角色     | 密码   |
|-----------------|----------|--------|
| admin           | 管理员   | 123456 |
| market          | 市场部   | 123456 |
| engineer        | 工程部   | 123456 |
| tech            | 技经部   | 123456 |
| finance         | 财务部   | 123456 |
| material        | 物贸部   | 123456 |

（新建项目仅市场部可调，其他角色可查看/修改。）

---

## clean_db.py：清空项目与操作日志表

清空 `projects`、`operation_logs` 表（保留 `users`）。用于重新导入前清理数据。

**用法**

```bash
cd backend
source .venv/bin/activate
PYTHONPATH=src python scripts/clean_db.py
```

**清理并重新导入（一条命令）**

```bash
cd backend && source .venv/bin/activate && PYTHONPATH=src python scripts/clean_db.py && PYTHONPATH=src python scripts/import_xls.py ../docs/example.xls
```

---

## import_xls.py：导入 example.xls 到 projects 表

将 `docs/example.xls` 中的项目数据导入 ocean 数据库的 `projects` 表。

**前置条件**

1. 已执行 `schema.sql` 创建数据库和表。
2. 已配置 `.env`（MySQL 连接信息）。
3. 已安装依赖：`pip install -r requirements.txt`（含 mysql-connector-python、xlrd）。

**用法**

```bash
cd backend
source .venv/bin/activate
PYTHONPATH=src python scripts/import_xls.py
```

默认读取 `../docs/example.xls`（相对 backend）。也可指定路径：

```bash
PYTHONPATH=src python scripts/import_xls.py /path/to/example.xls
```

**说明**

- 使用第一个 Sheet；表头为第 3 行（row 2），数据从第 6 行（row 5）开始。
- 仅导入「合同编号」非空的行；若「项目名称」为空则用合同编号或「未命名」。
- 表头与 `schema.sql`、`初始需求` 对齐（含「其中：」等前缀的列已映射）。
- 导入成功后输出：成功条数、跳过条数。