unis_hrms/tests/test_flows.py

441 lines
23 KiB
Python
Raw Permalink Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

"""端到端业务流程:档案异动、福利参保、月度算薪、员工自助请假。"""
from __future__ import annotations
from datetime import date, timedelta
# ------------------------------------------------------------------ 组织架构 ----
def test_department_crud_roundtrip(client, admin):
created = client.post("/api/v1/org/departments", headers=admin,
json={"name": "测试中心", "code": "QA-CENTER", "cost_center": "CC999"})
assert created.status_code == 200, created.text
dep = created.json()
assert dep["code"] == "QA-CENTER"
child = client.post("/api/v1/org/departments", headers=admin,
json={"name": "测试一组", "code": "QA-ONE", "parent_id": dep["id"]})
assert child.status_code == 200, child.text
tree = client.get("/api/v1/org/departments/tree", headers=admin).json()
node = next(n for n in tree if n["id"] == dep["id"])
assert {c["id"] for c in node["children"]} >= {child.json()["id"]}
updated = client.patch(f"/api/v1/org/departments/{dep['id']}", headers=admin,
json={"remark": "由自动化测试创建"})
assert updated.status_code == 200 and updated.json()["remark"] == "由自动化测试创建"
assert client.delete(f"/api/v1/org/departments/{child.json()['id']}",
headers=admin).status_code == 200
assert client.delete(f"/api/v1/org/departments/{dep['id']}", headers=admin).status_code == 200
assert client.get(f"/api/v1/org/departments/{dep['id']}", headers=admin).status_code == 404
# ------------------------------------------------------------------ 员工档案 ----
def test_employee_lifecycle(client, admin, hr):
created = client.post("/api/v1/employees", headers=admin,
json={"name": "测试员工", "gender": "女", "status": "probation",
"hire_date": date.today().isoformat(), "engage_form": "正式"})
assert created.status_code == 200, created.text
emp = created.json()
assert emp["work_no"], "工号应由后端自动生成"
detail = client.get(f"/api/v1/employees/{emp['id']}", headers=admin)
assert detail.status_code == 200 and detail.json()["name"] == "测试员工"
dossier = client.get(f"/api/v1/employees/{emp['id']}/dossier", headers=hr).json()
assert dossier["employee"]["work_no"] == emp["work_no"]
for key in ("educations", "work_histories", "families", "certificates", "contracts",
"changes", "adjustments", "documents"):
assert key in dossier, f"360 档案缺少 {key}"
edu = client.post("/api/v1/employee-educations", headers=hr,
json={"employee_id": emp["id"], "school": "测试大学", "degree": "本科",
"start_date": "2015-09-01", "end_date": "2019-06-30",
"is_highest": True})
assert edu.status_code == 200, edu.text
assert any(e["id"] == edu.json()["id"]
for e in client.get(f"/api/v1/employees/{emp['id']}/dossier",
headers=hr).json()["educations"])
# 立即生效的调岗
moved = client.post(f"/api/v1/employees/{emp['id']}/transfer", headers=hr,
json={"department_id": 8, "effective_date": date.today().isoformat(),
"reason": "测试调岗", "direct": True})
assert moved.status_code == 200, moved.text
after = client.get(f"/api/v1/employees/{emp['id']}", headers=admin).json()
assert after["department_id"] == 8
# 走审批的调岗:先 pending,再由 HR 批准
pending = client.post(f"/api/v1/employees/{emp['id']}/transfer", headers=hr,
json={"department_id": 9, "position_id": 2,
"effective_date": date.today().isoformat(),
"reason": "待审批调岗"})
assert pending.status_code == 200, pending.text
changes = client.get("/api/v1/employee-changes", headers=hr,
params={"employee_id": emp["id"], "status": "pending"}).json()["items"]
assert changes, "应存在待审批异动"
approved = client.post(f"/api/v1/employee-changes/{changes[0]['id']}/approve", headers=hr,
json={"status": "approved", "comment": "同意"})
assert approved.status_code == 200, approved.text
assert client.get(f"/api/v1/employees/{emp['id']}",
headers=admin).json()["department_id"] == 9
client.delete(f"/api/v1/employees/{emp['id']}", headers=admin)
# ------------------------------------------------------------------ 福利保险 ----
def test_benefit_item_enrollment_and_record(client, admin):
item = client.post("/api/v1/benefits/items", headers=admin,
json={"name": "测试补贴", "code": "TEST-ALLOW", "category": "subsidy",
"default_amount": 300, "unit": "元", "period": "monthly"})
assert item.status_code == 200, item.text
item_id = item.json()["id"]
# 新建员工应自动完成入职三件套:劳动合同 + 薪资标准 + 参保登记
emp = client.post("/api/v1/employees", headers=admin,
json={"name": "参保测试员", "gender": "男", "status": "active",
"hire_date": "2026-01-01", "engage_form": "正式", "monthly_salary": 16000,
"contract_start": "2026-01-01", "contract_term_years": 3}).json()
assert emp["custom_fields"]["base_salary"] == 16000, "入职定薪应落到 custom_fields.base_salary"
contracts = client.get("/api/v1/employee-contracts", headers=admin,
params={"employee_id": emp["id"]}).json()["items"]
assert len(contracts) == 1 and contracts[0]["status"] == "active", "入职应自动生成劳动合同"
assert contracts[0]["end_date"] == "2029-01-01", "合同期限应按 contract_term_years 推算"
standards = client.get("/api/v1/payroll/standards", headers=admin,
params={"employee_id": emp["id"]}).json()["items"]
assert len(standards) == 1 and standards[0]["is_active"], "入职应自动生成薪资标准"
enrollments = client.get("/api/v1/benefits/enrollments", headers=admin,
params={"employee_id": emp["id"]}).json()["items"]
assert len(enrollments) == 1, "入职应自动完成参保登记"
enrollment = enrollments[0]
assert enrollment["plan_name"], "参保登记应回填方案名称"
plan = enrollment["plan_id"]
# 同一员工同一方案不允许重复参保
again = client.post("/api/v1/benefits/enrollments", headers=admin,
json={"employee_id": emp["id"], "plan_id": plan,
"start_date": "2026-01-01", "status": "active"})
assert again.status_code == 409, again.text
# 手动调整缴费基数与薪资标准(模拟 HR 完善定薪信息)
assert client.patch(f"/api/v1/benefits/enrollments/{enrollment['id']}", headers=admin,
json={"social_base": 12000, "fund_base": 12000}).status_code == 200
assert client.patch(f"/api/v1/payroll/standards/{standards[0]['id']}", headers=admin,
json={"overrides": {"base_salary": 12000,
"perf_salary": 4000}}).status_code == 200
record = client.post("/api/v1/benefits/records", headers=admin,
json={"employee_id": emp["id"], "item_id": item_id,
"year": 2026, "month": 9, "amount": 300, "quantity": 1,
"status": "pending"})
assert record.status_code == 200, record.text
assert record.json()["item_name"] == "测试补贴"
matrix = client.get("/api/v1/benefits/leave-balances/matrix", headers=admin).json()
assert "rows" in matrix and "types" in matrix
assert client.delete(f"/api/v1/benefits/records/{record.json()['id']}",
headers=admin).status_code == 200
assert client.delete(f"/api/v1/benefits/enrollments/{enrollment['id']}",
headers=admin).status_code == 200
assert client.delete(f"/api/v1/benefits/items/{item_id}", headers=admin).status_code == 200
assert client.delete(f"/api/v1/employees/{emp['id']}", headers=admin).status_code == 200
# ------------------------------------------------------------------ 月度算薪 ----
def test_payroll_full_cycle(client, admin, login):
payroll = login("payroll")
year = 2027
init = client.post("/api/v1/payroll/periods/init", headers=payroll, json={"year": year})
assert init.status_code == 200, init.text
periods = client.get("/api/v1/payroll/periods", headers=payroll,
params={"year": year, "page_size": 12}).json()["items"]
assert periods, "年度计薪期间应已初始化"
period = periods[-1]
batch = client.post("/api/v1/payroll/batches", headers=payroll,
json={"name": f"{year} 自动化测试工资表", "period_id": period["id"],
"scope": {}})
assert batch.status_code == 200, batch.text
batch_id = batch.json()["id"]
assert batch.json()["year"] == year and batch.json()["status"] == "draft"
preview = client.get(f"/api/v1/payroll/batches/{batch_id}/preview", headers=payroll)
assert preview.status_code == 200, preview.text
rows = preview.json()["items"]
assert rows and all("employee_id" in r for r in rows)
calc = client.post(f"/api/v1/payroll/batches/{batch_id}/calculate", headers=payroll, json={})
assert calc.status_code == 200, calc.text
summary = calc.json()
assert summary["employee_count"] == len(rows) > 0
assert abs(summary["net_total"] - (summary["gross_total"]
- summary["deduction_total"])) < 0.5
detail = client.get(f"/api/v1/payroll/batches/{batch_id}", headers=payroll).json()
assert detail["status"] == "calculated" and detail["net_total"]
slips = client.get("/api/v1/payroll/payslips", headers=payroll,
params={"batch_id": batch_id, "page_size": 5}).json()
assert slips["total"] == summary["employee_count"]
# 未审核不能发放;审核 -> 发布工资条 -> 发放(发放自动推送/确认工资条)
assert client.post(f"/api/v1/payroll/batches/{batch_id}/pay", headers=payroll).status_code == 400
assert client.post(f"/api/v1/payroll/batches/{batch_id}/approve", headers=payroll,
json={"comment": "自动化测试审核"}).status_code == 200
published = client.post(f"/api/v1/payroll/batches/{batch_id}/publish", headers=payroll)
assert published.status_code == 200 and published.json()["published"] == slips["total"]
paid = client.post(f"/api/v1/payroll/batches/{batch_id}/pay", headers=payroll)
assert paid.status_code == 200, paid.text
assert paid.json()["bank_batch_no"] and paid.json()["employee_count"] == slips["total"]
draft_slips = client.get("/api/v1/payroll/payslips", headers=payroll,
params={"batch_id": batch_id, "status": "draft"}).json()
assert draft_slips["total"] == 0
export = client.get(f"/api/v1/payroll/batches/{batch_id}/export", headers=payroll)
assert export.status_code == 200 and export.headers["content-type"].startswith(
"application/vnd.openxmlformats")
# -------------------------------------------------------------- 员工自助流程 ----
def test_selfservice_leave_request_lifecycle(client, employee, hr, login):
manager = login("manager")
me = client.get("/api/v1/auth/me", headers=employee).json()["employee"]
balances = client.get("/api/v1/self/home", headers=employee).json()
assert "leave_balances" in balances or "balances" in balances, list(balances)
types = client.get("/api/v1/benefits/leave-types", headers=hr,
params={"page_size": 50}).json()["items"]
leave_type = next(t for t in types if not t.get("requires_certificate"))
start = (date.today() + timedelta(days=30)).isoformat()
before = client.get("/api/v1/benefits/leave-balances", headers=hr,
params={"employee_id": me["id"], "leave_type_id": leave_type["id"],
"year": date.today().year + 1}).json()["items"]
created = client.post("/api/v1/self/leave", headers=employee,
json={"leave_type_id": leave_type["id"], "start_date": start,
"end_date": start, "period": "full", "reason": "自动化测试请假"})
assert created.status_code == 200, created.text
request_id = created.json()["id"]
mine = client.get("/api/v1/self/leave", headers=employee).json()
assert any(r["id"] == request_id for r in (mine.get("items") or mine))
pending = client.get("/api/v1/self/approvals", headers=manager,
params={"kind": "leave", "status": "pending"}).json()
assert pending, "主管应看到待审批请假"
approved = client.post(f"/api/v1/benefits/leave-requests/{request_id}/approve", headers=hr,
json={"status": "approved", "comment": "同意"})
assert approved.status_code == 200, approved.text
row = client.get(f"/api/v1/benefits/leave-requests/{request_id}", headers=hr).json()
assert row["status"] == "approved" and row["approver_name"]
assert row["employee_id"] == me["id"]
# 重复审批应被拒绝
again = client.post(f"/api/v1/benefits/leave-requests/{request_id}/approve", headers=hr,
json={"status": "rejected"})
assert again.status_code in (400, 409)
assert before is not None
def test_selfservice_profile_request_is_applied(client, employee, hr):
me = client.get("/api/v1/auth/me", headers=employee).json()["employee"]
submitted = client.post("/api/v1/self/profile-requests", headers=employee,
json={"changes": {"address": "测试地址 100 号"}, "reason": "搬家"})
assert submitted.status_code == 200, submitted.text
request_id = submitted.json()["id"]
snapshots = client.get("/api/v1/self/profile", headers=employee).json()["requests"]
snapshot = next(row for row in snapshots if row["id"] == request_id)
assert snapshot["changes"]["address"]["after"] == "测试地址 100 号"
assert snapshot["status"] == "pending"
listed = client.get("/api/v1/employee-profile-requests", headers=hr,
params={"status": "pending"}).json()["items"]
assert any(r["id"] == request_id for r in listed)
approved = client.post(f"/api/v1/employee-profile-requests/{request_id}/approve", headers=hr,
json={"status": "approved", "comment": "已核实"})
assert approved.status_code == 200, approved.text
fresh = client.get(f"/api/v1/employees/{me['id']}", headers=hr).json()
assert fresh["address"] == "测试地址 100 号"
def test_legacy_profile_patch_cannot_bypass_approval(client, employee, hr):
"""旧 PATCH 入口只能生成审批单,不能把内容直接写进员工档案。"""
old_email = client.get("/api/v1/self/profile", headers=employee).json()["employee"]["email"]
target = f"audit-{old_email or 'employee'}@example.com"
submitted = client.patch("/api/v1/self/profile", headers=employee, json={"email": target})
assert submitted.status_code == 200, submitted.text
body = submitted.json()
assert body["status"] == "pending"
unchanged = client.get("/api/v1/self/profile", headers=employee).json()["employee"]["email"]
assert unchanged == old_email, "审核前不得直接修改档案"
approved = client.post(
f"/api/v1/employee-profile-requests/{body['id']}/approve",
headers=hr,
json={"status": "approved", "comment": "自动化审核"},
)
assert approved.status_code == 200, approved.text
changed = client.get("/api/v1/self/profile", headers=employee).json()["employee"]["email"]
assert changed == target
def test_payslip_privacy_between_employees(client, login):
a = login("emp00001")
b = login("emp00002")
mine = client.get("/api/v1/self/payslips", headers=a).json()["items"]
theirs = client.get("/api/v1/self/payslips", headers=b).json()["items"]
assert mine and theirs
assert not ({s["id"] for s in mine} & {s["id"] for s in theirs})
victim = theirs[0]["id"]
assert client.get(f"/api/v1/self/payslips/{victim}", headers=a).status_code in (403, 404)
def _balance_remaining(client, employee, leave_type_id: int) -> float:
"""从自助端读取某假期类型的剩余额度(remaining = total - used - frozen)。"""
opts = client.get("/api/v1/self/leave/options", headers=employee).json()
row = next(o for o in opts if o["id"] == leave_type_id)
return float(row["remaining"])
def test_leave_cancel_releases_frozen_balance(client, employee, hr):
"""撤销请假必须释放冻结额度(回归:_apply_leave_balance 未导入导致 500)。"""
types = client.get("/api/v1/self/leave/options", headers=employee).json()
balanced = [t for t in types if t.get("requires_balance") and t["remaining"] >= 2]
assert balanced, "种子数据应包含有余量的额度型假期"
leave_type = balanced[0]
lid = leave_type["id"]
base = _balance_remaining(client, employee, lid)
day = date(date.today().year, 6, 15).isoformat() # 保持在当前额度年度内
created = client.post("/api/v1/self/leave", headers=employee,
json={"leave_type_id": lid, "start_date": day, "end_date": day,
"period": "full", "reason": "撤销回归测试"})
assert created.status_code == 200, created.text
request_id, days = created.json()["id"], float(created.json()["days"])
# 提交后额度被冻结
assert abs(_balance_remaining(client, employee, lid) - (base - days)) < 1e-6
cancelled = client.delete(f"/api/v1/self/leave/{request_id}", headers=employee)
assert cancelled.status_code == 200, cancelled.text
assert abs(_balance_remaining(client, employee, lid) - base) < 1e-6, "撤销后额度未释放"
# 已撤销的申请不能再次撤销
assert client.delete(f"/api/v1/self/leave/{request_id}",
headers=employee).status_code in (404, 409)
def test_self_approval_center_decides_leave(client, employee, admin):
"""自助审批中心审批额度型请假,通过后冻结额度转为已用(回归:同一处 NameError)。"""
types = client.get("/api/v1/self/leave/options", headers=employee).json()
balanced = [t for t in types if t.get("requires_balance") and t["remaining"] >= 1]
assert balanced, "种子数据应包含有余量的额度型假期"
leave_type = balanced[0]
lid = leave_type["id"]
base = _balance_remaining(client, employee, lid)
day = date(date.today().year, 7, 15).isoformat() # 保持在当前额度年度内
created = client.post("/api/v1/self/leave", headers=employee,
json={"leave_type_id": lid, "start_date": day, "end_date": day,
"period": "full", "reason": "审批中心回归测试"})
assert created.status_code == 200, created.text
request_id, days = created.json()["id"], float(created.json()["days"])
# 待审批队列里必须能看到这条
pending = client.get("/api/v1/self/approvals", headers=admin,
params={"type": "leave", "status": "pending"}).json()
assert any(x["id"] == request_id for x in pending["items"]), "审批中心应列出该请假申请"
decided = client.post(f"/api/v1/self/approvals/leave/{request_id}/decide", headers=admin,
json={"status": "approved", "comment": "同意"})
assert decided.status_code == 200, decided.text
row = client.get("/api/v1/self/leave", headers=employee).json()["items"]
mine = next(r for r in row if r["id"] == request_id)
assert mine["status"] == "approved" and mine["comment"] == "同意"
# 通过后:冻结转为已用,剩余额度同样减少 days
assert abs(_balance_remaining(client, employee, lid) - (base - days)) < 1e-6
# 重复审批必须被拒绝,且额度不被二次扣减
again = client.post(f"/api/v1/self/approvals/leave/{request_id}/decide", headers=admin,
json={"status": "rejected"})
assert again.status_code in (400, 409), again.text
assert abs(_balance_remaining(client, employee, lid) - (base - days)) < 1e-6
def test_leave_balance_not_generated_error_is_explicit(client, employee):
"""跨年度请假时,后端应给出「额度未生成」而非误导性的「剩余 0 天」。"""
types = client.get("/api/v1/self/leave/options", headers=employee).json()
balanced = [t for t in types if t.get("requires_balance")]
assert balanced
next_year = date(date.today().year + 1, 3, 10).isoformat()
resp = client.post("/api/v1/self/leave", headers=employee,
json={"leave_type_id": balanced[0]["id"], "start_date": next_year,
"end_date": next_year, "period": "full", "reason": "跨年度额度校验"})
assert resp.status_code == 400
assert resp.json()["code"] == "balance_not_generated", resp.text
def test_active_contracts_are_never_expired(client, hr):
"""种子数据自检:状态为 active 的合同不应已过期,否则 H5 会显示负数剩余天数。"""
today = date.today().isoformat()
items, page = [], 1
while True:
resp = client.get("/api/v1/employee-contracts", headers=hr,
params={"status": "active", "page": page, "page_size": 200})
assert resp.status_code == 200, resp.text
body = resp.json()
items += body["items"]
if page >= (body.get("pages") or 1):
break
page += 1
assert items, "应存在生效中的合同"
assert [c["contract_no"] for c in items if c["end_date"] < today] == []
assert all(c["renew_reminder"] == (c["days_to_end"] is not None and 0 <= c["days_to_end"] <= 90)
for c in items)
def test_self_home_contract_never_negative(client):
"""自助首页的合同摘要必须区分「即将到期」与「已到期」,且不会出现负剩余天数。"""
for username, pwd in (("emp", "emp123456"), ("hr", "hr123456"), ("manager", "mgr123456")):
tok = client.post("/api/v1/auth/login",
json={"username": username, "password": pwd}).json()["access_token"]
headers = {"Authorization": f"Bearer {tok}"}
data = client.get("/api/v1/self/home", headers=headers).json()
contract = data["contract"]
assert contract, f"{username} 应能看到自己的合同"
assert contract["status"] == "active", contract
assert contract["days_left"] is not None and contract["days_left"] >= 0, contract
assert contract["expired"] is False
assert contract["renew_soon"] == (0 <= contract["days_left"] <= 90)
def test_self_home_exposes_approval_counts(client, manager, hr, login):
"""有审批权的账号,首页要拿到「待我审批」的分类计数。"""
for headers in (manager, hr):
data = client.get("/api/v1/self/home", headers=headers).json()
approvals = data["approvals"]
assert approvals["total"] > 0, approvals
assert approvals["total"] == sum(approvals["counts"].values())
assert set(approvals["counts"]) >= {"leave", "change", "adjustment"}
data = client.get("/api/v1/self/home", headers=login("emp")).json()
assert data["approvals"] == {"total": 0, "counts": {}}