Kiwi TCMS 16.0：开源测试管理系统的大版本升级，有哪些值得关注的变动

# 克隆官方 docker-compose 配置
git clone https://github.com/kiwitcms/Kiwi.git kiwi-tcms
cd kiwi-tcms

# 切换到 16.0 对应的标签或分支（具体 tag 名以官方仓库为准）
# git checkout v16.0

# 启动服务
docker-compose up -d

# 等待约 30 秒后检查服务状态
docker-compose ps

# 创建超级用户（首次部署时）
docker-compose exec kiwi python manage.py createsuperuser

"""
Kiwi TCMS API 示例：创建测试用例并关联到测试计划
运行前修改 BASE_URL、USERNAME、PASSWORD
依赖：pip install requests
"""
import requests

BASE_URL = "http://localhost:8080"
USERNAME = "admin"
PASSWORD = "your_password_here"

session = requests.Session()

# 1. 登录获取 CSRF token 和 session cookie
login_url = f"{BASE_URL}/accounts/login/"
resp = session.get(login_url)
csrf_token = session.cookies.get("csrftoken")

resp = session.post(
    login_url,
    data={"username": USERNAME, "password": PASSWORD, "csrfmiddlewaretoken": csrf_token},
    headers={"Referer": login_url},
)
print("登录状态:", resp.status_code)

# 2. 通过 JSON-RPC API 创建测试用例
rpc_url = f"{BASE_URL}/json-rpc/"
csrf_token = session.cookies.get("csrftoken")

payload = {
    "method": "TestCase.create",
    "params": [
        {
            "summary": "登录页面——空密码提交应返回错误提示",
            "text": "前置条件：用户已注册。\n步骤：1. 打开登录页 2. 输入用户名 3. 密码留空 4. 点击提交\n预期：页面显示'密码不能为空'错误提示",
            "case_status_id": 1,  # 1 = Confirmed，具体 ID 需根据你的实例确认
            "category_id": 1,     # 默认分类，可在管理后台查看
            "priority_id": 2,     # 2 = Normal
            "author_id": 1,
        }
    ],
    "id": 1,
}

resp = session.post(
    rpc_url,
    json=payload,
    headers={
        "X-CSRFToken": csrf_token,
        "Referer": BASE_URL,
        "Content-Type": "application/json",
    },
)
result = resp.json()
print("创建用例结果:", result)

case_id = result.get("result", {}).get("id")
if not case_id:
    print("用例创建失败，请检查参数和权限")
    exit(1)

# 3. 创建测试计划并把用例加入计划
plan_payload = {
    "method": "TestPlan.create",
    "params": [
        {
            "name": "v2.5 回归测试计划",
            "text": "覆盖登录模块核心路径",
            "type_id": 1,          # 1 = Unit，可根据实际调整
            "product_id": 1,
            "product_version_id": 1,
            "author_id": 1,
        }
    ],
    "id": 2,
}

resp = session.post(
    rpc_url,
    json=plan_payload,
    headers={"X-CSRFToken": csrf_token, "Referer": BASE_URL, "Content-Type": "application/json"},
)
plan_result = resp.json()
print("创建计划结果:", plan_result)

plan_id = plan_result.get("result", {}).get("id")

# 4. 把用例关联到计划
if plan_id and case_id:
    link_payload = {
        "method": "TestPlan.add_case",
        "params": [plan_id, case_id],
        "id": 3,
    }
    resp = session.post(
        rpc_url,
        json=link_payload,
        headers={"X-CSRFToken": csrf_token, "Referer": BASE_URL, "Content-Type": "application/json"},
    )
    print("关联用例到计划:", resp.json())