576 lines
30 KiB
Python
576 lines
30 KiB
Python
#!/usr/bin/env python3
|
||
"""按业务给的《财务及资质材料使用申请流程》流转图,把这条流程配到系统里。
|
||
|
||
cd backend/scripts
|
||
python3 -m material_apply # 表单(库里没有才建)+ 岗位角色 + 流程,校验后发布
|
||
python3 -m material_apply --report # 只把库里的设计读回来对一遍,并逐环节试算审批人
|
||
python3 -m material_apply --run # 再跑两张真单据把「正常线」和「退回线」走通,跑完清干净
|
||
|
||
设计口径(图上两处要翻译成平台语义的地方):
|
||
|
||
* 「创建」在图上是一个圈。本平台把起始圈拆成「开始 + 创建」两拍:开始是引擎入口,
|
||
「创建」才是经办人真正填单送审的环节。流程级「发起人自审跳过」保持关闭,只开在三个
|
||
审批环节上——流程级一开,起草环节会被发起人自己跳过,经办人手上就再也看不到这张单
|
||
(见 ``engine.approval_flags`` 的说明)。
|
||
* 图下方那条从「创建」拉到「总经理」的线是退回线。三个审批环节的「退回」统一指定退回
|
||
「创建」,由经办人补正后重新提交。退回弹窗里的「直返本环节」(``way=jump``)对应的就是
|
||
图上这条线,但引擎目前只写了 ``work.go_back_store``、还没有消费它
|
||
(``backend/app/engine/engine.py:1935``),所以选了直返也会重走部门主管。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
import argparse
|
||
import hashlib
|
||
import json
|
||
import sys
|
||
from datetime import date, datetime, timedelta
|
||
from pathlib import Path
|
||
|
||
sys.path.insert(0, str(Path(__file__).resolve().parent))
|
||
|
||
from expense import common # noqa: E402
|
||
from expense.common import cc_rule, ok, person_ref, row # noqa: E402
|
||
|
||
PROCESS_NAME = "财务及资质材料使用申请流程"
|
||
FORM_NAME = "财务及资质材料使用申请流程"
|
||
CATEGORY_NAME = "财务管理"
|
||
SMOKE_PREFIX = "(冒烟)"
|
||
|
||
DESC_FORM = (
|
||
"财务及资质材料使用申请单:申请项目、财务/资质/人员/业绩四组材料、材料类型、"
|
||
"申请有效期与申请事由"
|
||
)
|
||
DESC_PROCESS = (
|
||
"财务及资质材料使用:经办人创建 → 部门主管 → 总经理 → 商务、办公室主任 → 归档;"
|
||
"任一审批环节都可退回「创建」,由经办人补正后重新提交"
|
||
)
|
||
|
||
#: 图纸点名的岗位在本系统里还没有对应角色时,按环节名建好、名单留空等人填。
|
||
#: 名单一律由使用方在「组织 - 角色」里维护,脚本只在角色不存在时建,绝不覆盖已有名单。
|
||
#: 名单为空时环节按 emptyApprover 兜底(转交系统管理员),待办不会丢,也不会误发给别人。
|
||
POSTS: list[tuple[str, str]] = [
|
||
("总经理", "总经理审批岗(费用报销、财务及资质材料使用共用)"),
|
||
("商务、办公室主任", "财务及资质材料使用申请流程:商务与办公室主任(材料归口发放)"),
|
||
]
|
||
|
||
#: 用来试算审批人的样例发起人:软件开发事业部的真人,部门主管解析得到人。
|
||
SAMPLE_IDS: list[int] = [442, 437, 449]
|
||
|
||
#: 资质与财务材料目录(照业务给的单子抄)。只有这张单子用,就不单开数据字典了。
|
||
FINANCE_OPTIONS = [("auditReport", "审计报告及财务报表(具体要求请补充到备注)")]
|
||
QUALIFICATION_OPTIONS = [
|
||
("licenseOriginal", "营业执照(正本)"),
|
||
("licenseCopy", "营业执照(副本)"),
|
||
("safetyOriginal", "安全生产许可证(正本)"),
|
||
("safetyCopy", "安全生产许可证(副本)"),
|
||
("intellectOriginal", "电子与智能化工程专业承包贰级(正本)"),
|
||
("intellectCopy", "电子与智能化工程专业承包贰级(副本)"),
|
||
("qualityCopy", "质量管理体系认证证书(副本)"),
|
||
("environmentCopy", "环境管理体系认证证书(副本)"),
|
||
("ohsmsCopy", "职业健康安全管理体系认证证书(副本)"),
|
||
("ismsCopy", "信息安全管理体系认证证书(副本)"),
|
||
("itsmsCopy", "信息技术服务管理体系认证证书(副本)"),
|
||
("cqAnfangFirst", "重庆市安防工程从业资格壹级证书"),
|
||
("cqTefangMember", "重庆市公共安全技术防范协会会员证书"),
|
||
("top100Honor", "中国安防百强工程商荣誉证书"),
|
||
("advancedUnit", "中国安防工程建设先进单位奖"),
|
||
("softwareCopyright", "软件著作权(AI智慧环保工地监管平台)"),
|
||
("other", "其它(其它要求请补充到备注)"),
|
||
]
|
||
STAFF_OPTIONS = [
|
||
("staffCertificate", "人员证书"),
|
||
("staffSocialSecurity", "人员社保(具体要求请补充到备注)"),
|
||
]
|
||
PERFORMANCE_OPTIONS = [("salesPerformance", "公司销售业绩(具体要求请补充到备注)")]
|
||
MATERIAL_TYPE_OPTIONS = [
|
||
("original", "原件(如选择,具体要求请补充到备注)"),
|
||
("electronic", "电子档"),
|
||
]
|
||
|
||
|
||
def _options(pairs: list[tuple[str, str]]) -> list[dict]:
|
||
return [{"value": value, "label": label} for value, label in pairs]
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 表单:库里有同名表单就原样绑定,绝不覆盖设计器里改过的东西
|
||
# --------------------------------------------------------------------------
|
||
|
||
|
||
def form_fields() -> list[dict]:
|
||
return [
|
||
{"key": "title", "label": "标题", "type": "title", "span": 12, "required": True,
|
||
"titleMode": "rule",
|
||
"titleRule": {"mode": "template", "template": "{流程名称}({部门})-{发起人}{工号}-{日期}",
|
||
"maxLength": 80, "editable": True, "refresh": False},
|
||
"placeholder": "系统按「流程名称(部门)-发起人工号-日期」生成,可以改"},
|
||
{"key": "handler", "label": "经办人", "type": "user", "span": 6},
|
||
{"key": "applyDept", "label": "申请部门", "type": "dept", "span": 6},
|
||
{"key": "project", "label": "申请项目", "type": "text", "span": 12, "required": True,
|
||
"placeholder": "写清楚用在哪个项目 / 哪次投标,审批人按这个判断给不给"},
|
||
{"key": "financeMaterials", "label": "财务资料", "type": "checkbox", "span": 12,
|
||
"options": _options(FINANCE_OPTIONS)},
|
||
{"key": "qualificationMaterials", "label": "资质资料", "type": "checkbox", "span": 12,
|
||
"options": _options(QUALIFICATION_OPTIONS)},
|
||
{"key": "staffMaterials", "label": "人员资料", "type": "checkbox", "span": 12,
|
||
"options": _options(STAFF_OPTIONS)},
|
||
{"key": "performanceMaterials", "label": "业绩资料", "type": "checkbox", "span": 12,
|
||
"options": _options(PERFORMANCE_OPTIONS)},
|
||
{"key": "materialType", "label": "材料类型", "type": "checkbox", "span": 12,
|
||
"required": True, "options": _options(MATERIAL_TYPE_OPTIONS),
|
||
"help": "选了「原件」意味着证照正本要带出公司,总经理与商务办公室会重点看有效期"},
|
||
{"key": "validRange", "label": "申请有效期", "type": "daterange", "span": 12,
|
||
"required": True, "help": "材料外借的起止日期,到期由归档环节留痕"},
|
||
{"key": "reason", "label": "申请事由", "type": "textarea", "span": 12, "rows": 3},
|
||
{"key": "remark", "label": "备注", "type": "textarea", "span": 12, "rows": 3,
|
||
"help": "对材料的具体要求写在这里:份数、是否盖章、是否需要审计报告某几年等"},
|
||
]
|
||
|
||
|
||
def form_content() -> dict:
|
||
return {"fields": form_fields(), "layout": {"columns": 12, "label_width": 110}}
|
||
|
||
|
||
#: 单子上会被审批人看到的字段,权限按环节切换用这一份键名清单
|
||
FIELD_KEYS = [item["key"] for item in form_fields()]
|
||
DRAFT_PERMS = {
|
||
**{key: "editable" for key in FIELD_KEYS},
|
||
"title": "required",
|
||
"project": "required",
|
||
"materialType": "required",
|
||
"validRange": "required",
|
||
}
|
||
#: 审批环节只读单据,只有备注留一格:材料发放口径(份数 / 盖章 / 归还日期)常在批的时候才定
|
||
AUDIT_PERMS = {**{key: "readonly" for key in FIELD_KEYS}, "remark": "editable"}
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 流程:开始 → 创建 → 部门主管 → 总经理 → 商务、办公室主任 → 归档
|
||
# --------------------------------------------------------------------------
|
||
|
||
|
||
def act(aid: str, type_: str, name: str, x: int, y: int, form: str = "", **config) -> dict:
|
||
note = str(config.pop("help", "") or "")
|
||
return {"id": aid, "type": type_, "name": name, "alias": name, "description": note,
|
||
"x": x, "y": y, "form": form, "order_number": x, "config": config}
|
||
|
||
|
||
def rt(name: str, src: str, dst: str, order: int = 0) -> dict:
|
||
digest = hashlib.sha1(f"{src}|{dst}|{order}".encode("utf-8")).hexdigest()[:18]
|
||
return {"id": f"rt{digest}", "name": name, "alias": name, "from_activity": src,
|
||
"to_activity": dst, "decision": "", "expression": "", "order_number": order}
|
||
|
||
|
||
MAIN_Y = 300
|
||
|
||
|
||
def process_design(form_id: str, *, smoke: bool = False) -> dict:
|
||
"""``smoke=True`` 把环节上的「发起人自审跳过」关掉:验证时全程用系统管理员一个人
|
||
办完所有环节,不关掉的话第一个审批环节之后的环节会被自动通过,测不出环节有没有配歪。"""
|
||
skip_self = not smoke
|
||
harness = [row("person", HARNESS_ACCOUNT)]
|
||
|
||
def n(tail, type_, name, x, **cfg):
|
||
return act(f"ma_{tail}", type_, name, x, MAIN_Y, form_id if type_ == "manual" else "", **cfg)
|
||
|
||
def b(tail):
|
||
return f"ma_{tail}"
|
||
|
||
back_to_creator = {"type": "define", "data": ["创建"], "way": "step"}
|
||
activities = [
|
||
n("begin", "begin", "开始", 40),
|
||
n("create", "manual", "创建", 260, first=True, taskValues=[row("creator")], mode="any",
|
||
allowGoBack=False, allowTransfer=True, allowAddTask=True, allowCc=True,
|
||
allowComment=True, allowPress=True, allowRecall=True, allowShare=True,
|
||
formPerms=DRAFT_PERMS,
|
||
help="经办人填写材料清单与有效期并送审"),
|
||
n("dept", "manual", "部门主管", 520, mode="any",
|
||
taskValues=harness if smoke else [row("creatorUnitManager")], skipStarter=skip_self,
|
||
emptyApprover="toAdmin", allowGoBack=True, allowAddTask=True, allowPress=True,
|
||
goBackConfig=back_to_creator, expireType="hours", expireValue=24,
|
||
timeoutAction="notify", formPerms=AUDIT_PERMS,
|
||
help="本部门使用本部门材料由主管确认;主管就是经办人自己时自动跳过"),
|
||
n("gm", "manual", "总经理", 820, mode="any",
|
||
taskValues=harness if smoke else [row("role", "总经理")], skipStarter=skip_self,
|
||
emptyApprover="toAdmin", allowGoBack=True, allowAddTask=True, allowTransfer=True,
|
||
goBackConfig=back_to_creator, expireType="hours", expireValue=24,
|
||
timeoutAction="notify", formPerms=AUDIT_PERMS,
|
||
ccRules=[cc_rule("complete", [row("creator")], opinion="总经理已批准,请等候商务、办公室发放材料")],
|
||
help="证照原件外借与对外提供财务数据在这里把关;退回到「创建」就是图纸下方那条线"),
|
||
n("business", "manual", "商务、办公室主任", 1140, mode="any",
|
||
taskValues=harness if smoke else [row("role", "商务、办公室主任")], skipStarter=skip_self,
|
||
emptyApprover="toAdmin", allowGoBack=True, allowAddTask=True, allowCc=True,
|
||
goBackConfig=back_to_creator, expireType="hours", expireValue=48,
|
||
timeoutAction="notify", formPerms=AUDIT_PERMS,
|
||
help="材料归口发放:核对份数、是否盖章、登记借阅台账"),
|
||
n("archive", "end", "归档", 1440,
|
||
ccRules=[cc_rule("arrive", [row("creator"), row("role", "商务、办公室主任")],
|
||
opinion="材料使用申请已归档,请按申请有效期登记发放与归还")],
|
||
help="终止环节:单据进档案,抄送经办人与材料归口人记台账"),
|
||
]
|
||
|
||
routes = [
|
||
rt("提交", b("begin"), b("create")),
|
||
rt("送审", b("create"), b("dept")),
|
||
rt("部门主管已批", b("dept"), b("gm")),
|
||
rt("总经理已批", b("gm"), b("business")),
|
||
rt("商务办公室已批", b("business"), b("archive")),
|
||
]
|
||
return {
|
||
"activities": activities,
|
||
"routes": routes,
|
||
"latest_form": form_id,
|
||
# 起草环节要真的停一下让经办人填单,所以流程级「发起人不重复审批」保持关闭;
|
||
# 「同一人前面批过后面自动通过」打开,兼顾一人多岗的小部门。
|
||
"approval_config": {"skipStarter": False, "dedup": "all"},
|
||
"canvas": {"zoom": 0.9, "note": "财务及资质材料使用申请:创建 → 部门主管 → 总经理 → 商务、办公室主任 → 归档"},
|
||
}
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 落库
|
||
# --------------------------------------------------------------------------
|
||
|
||
|
||
def find_form(token: str) -> dict | None:
|
||
for item in ok("GET", "/process/forms", token):
|
||
if item["name"] == FORM_NAME:
|
||
return ok("GET", f"/process/forms/{item['id']}", token)
|
||
return None
|
||
|
||
|
||
def build_form(token: str) -> str:
|
||
print("\n=== 表单 ===")
|
||
existing = find_form(token)
|
||
if existing is not None:
|
||
keys = [f["key"] for f in existing["content"].get("fields", [])]
|
||
missing = [key for key in FIELD_KEYS if key not in keys]
|
||
print(f" 复用库里的「{FORM_NAME}」(id={existing['id']},{len(keys)} 个字段),不覆盖设计器的改动")
|
||
if missing:
|
||
raise SystemExit(f"表单「{FORM_NAME}」缺少流程要用到的字段:{missing},请先到表单设计里补上")
|
||
return existing["id"]
|
||
|
||
content = form_content()
|
||
problems = ok("POST", "/process/forms/validate", token, {"content": content}).get("problems", [])
|
||
if problems:
|
||
raise SystemExit("表单设计校验未通过:\n " + "\n ".join(problems))
|
||
saved = ok("POST", "/process/forms", token,
|
||
{"name": FORM_NAME, "description": DESC_FORM, "content": content,
|
||
"editable": "edit"})
|
||
kinds = sorted({f["type"] for f in content["fields"]})
|
||
print(f" 库里没有「{FORM_NAME}」,按图纸新建:{len(content['fields'])} 个字段")
|
||
print(f" 类型:{'、'.join(kinds)}")
|
||
return saved["id"]
|
||
|
||
|
||
def build_posts(token: str) -> None:
|
||
print("\n=== 岗位角色 ===")
|
||
existing = {r["name"]: r for r in ok("GET", "/org/roles", token)}
|
||
for name, description in POSTS:
|
||
if name in existing:
|
||
members = existing[name].get("list_auth") or []
|
||
state = f"名单 {len(members)} 人" if members else "名单为空(待填,环节先转交系统管理员)"
|
||
print(f" {name}:已存在,{state},脚本不动名单")
|
||
continue
|
||
ok("POST", "/org/roles", token, {"name": name, "description": description,
|
||
"list_auth": [], "unit": ""})
|
||
print(f" {name}:新建,名单待填(环节先按「转交系统管理员」兜底)")
|
||
|
||
|
||
def category_id(token: str) -> str:
|
||
for item in ok("GET", "/process/categories", token):
|
||
if item["name"] == CATEGORY_NAME:
|
||
return item["id"]
|
||
created = ok("POST", "/process/categories", token,
|
||
{"name": CATEGORY_NAME, "description": "报销、付款、借款、材料使用等财务类流程",
|
||
"order_number": 1, "enabled": True})
|
||
return created["id"]
|
||
|
||
|
||
def save_design(token: str, pid: str, design: dict) -> dict:
|
||
return ok("PUT", f"/process/processes/{pid}/design", token, {
|
||
"activities": design["activities"], "routes": design["routes"],
|
||
"latest_form": design["latest_form"], "canvas": design["canvas"],
|
||
"approval_config": design["approval_config"]})
|
||
|
||
|
||
def set_approval(token: str, pid: str, config: dict) -> None:
|
||
ok("PUT", f"/process/processes/{pid}", token, {"approval_config": config})
|
||
|
||
|
||
def build_process(token: str, form_id: str) -> dict:
|
||
print("\n=== 流程 ===")
|
||
body = {"name": PROCESS_NAME, "description": DESC_PROCESS, "category": category_id(token),
|
||
"icon": "document", "color": "#0f766e", "order_number": 10, "open_create": True,
|
||
"latest_form": form_id}
|
||
existing = next((p for p in ok("GET", "/process/processes", token, params={"page_size": 200})
|
||
if p["name"] == PROCESS_NAME), None)
|
||
process = (ok("PUT", f"/process/processes/{existing['id']}", token, body) if existing
|
||
else ok("POST", "/process/processes", token, body))
|
||
pid = process["id"]
|
||
design = process_design(form_id)
|
||
saved = save_design(token, pid, design)
|
||
problems = ok("POST", f"/process/processes/{pid}/validate", token)["problems"]
|
||
if problems:
|
||
raise SystemExit("流程校验未通过:\n " + "\n ".join(problems))
|
||
ok("POST", f"/process/processes/{pid}/publish", token,
|
||
{"comment": "按流转图建立:创建 → 部门主管 → 总经理 → 商务、办公室主任 → 归档"})
|
||
kinds = sorted({a["type"] for a in saved["activities"]})
|
||
print(f" {PROCESS_NAME}:{len(saved['activities'])} 环节 / {len(saved['routes'])} 路由,校验通过并已发布")
|
||
print(f" 环节类型:{'、'.join(kinds)}")
|
||
return {"id": pid, "design": saved}
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 复核
|
||
# --------------------------------------------------------------------------
|
||
|
||
|
||
def sample_identity(token: str) -> str:
|
||
cat = common.directory(token)
|
||
for person_id in SAMPLE_IDS:
|
||
if cat["ref"].get(person_id):
|
||
return person_ref(cat, person_id)
|
||
for person_id, value in cat["ref"].items():
|
||
if cat["name"].get(person_id) not in ("系统管理员", "DSH Hub Admin"):
|
||
return value
|
||
raise SystemExit("组织里找不到一个能试算的真人,先确认统一身份同步是否跑过")
|
||
|
||
|
||
def report(token: str) -> dict:
|
||
process = next((p for p in ok("GET", "/process/processes", token, params={"page_size": 200})
|
||
if p["name"] == PROCESS_NAME), None)
|
||
if process is None:
|
||
raise SystemExit(f"库里还没有「{PROCESS_NAME}」")
|
||
detail = ok("GET", f"/process/processes/{process['id']}", token)
|
||
sample = sample_identity(token)
|
||
print(f"\n=== 复核:{PROCESS_NAME} ===")
|
||
print(f" 状态:{'已发布' if detail['published'] else '未发布'} / "
|
||
f"{'启用' if detail['enabled'] else '停用'},版本 v{detail['version']},"
|
||
f"默认表单「{detail['latest_form_name']}」")
|
||
print(f" 审批规则:{json.dumps(detail['approval_config'], ensure_ascii=False)}")
|
||
roles = {r["name"]: r for r in ok("GET", "/org/roles", token)}
|
||
cat = common.directory(token)
|
||
who = next((cat["name"].get(int(k), "") for k in cat["ref"]
|
||
if cat["ref"][k] == sample), "样例身份")
|
||
print(f" 审批人按样例发起人「{who}」试算,实际发起人不同则解析结果不同")
|
||
for activity in detail["activities"]:
|
||
config = activity.get("config") or {}
|
||
sources = config.get("taskValues") or []
|
||
line = ""
|
||
if sources:
|
||
preview = ok("POST", "/process/approvers/preview", token,
|
||
{"taskValues": sources, "asIdentity": sample})
|
||
who = "、".join(p["person_name"] or p["name"] for p in preview["identities"]) or "(试算不到人)"
|
||
src = ",".join(f"{i.get('type')}:{'/'.join(i.get('data') or []) or '-'}" for i in sources)
|
||
line = f" <- {src} => {who}"
|
||
if preview["unknown"]:
|
||
line += f" 【认不出的名字:{preview['unknown']}】"
|
||
note = []
|
||
if config.get("emptyApprover"):
|
||
note.append(f"空审批人兜底={config['emptyApprover']}")
|
||
if config.get("skipStarter"):
|
||
note.append("发起人自审跳过")
|
||
if config.get("allowGoBack"):
|
||
note.append(f"可退回 {((config.get('goBackConfig') or {}).get('data') or ['上一环节'])}")
|
||
if config.get("ccRules"):
|
||
note.append(f"抄送 {len(config['ccRules'])} 条")
|
||
tail = f" [{';'.join(note)}]" if note else ""
|
||
print(f" [{activity['type']:<7}] {activity['name']}{line}{tail}")
|
||
for item in sources:
|
||
if str(item.get("type")) == "role":
|
||
for role_name in item.get("data") or []:
|
||
if not (roles.get(str(role_name), {}).get("list_auth") or []):
|
||
print(f" ! 角色「{role_name}」名单为空,实际派单会转交系统管理员")
|
||
print("\n 路由:")
|
||
names = {a["id"]: a["name"] for a in detail["activities"]}
|
||
for route in detail["routes"]:
|
||
tail = f" | {route['expression']}" if route.get("expression") else ""
|
||
print(f" {names.get(route['from_activity'], '?')} -[{route['name']}]-> "
|
||
f"{names.get(route['to_activity'], '?')}{tail}")
|
||
return detail
|
||
|
||
|
||
# --------------------------------------------------------------------------
|
||
# 跑通验证:正常线 + 退回线,全程用系统管理员,跑完自己清干净
|
||
# --------------------------------------------------------------------------
|
||
|
||
CASES: list[dict] = [
|
||
{
|
||
"short": "正常线",
|
||
"case": "正常线:创建 → 部门主管 → 总经理 → 商务、办公室主任 → 归档",
|
||
"steps": [{"activity": name} for name in
|
||
("创建", "部门主管", "总经理", "商务、办公室主任")],
|
||
"expect_goback": False,
|
||
"expect_cc": True,
|
||
},
|
||
{
|
||
"short": "退回线",
|
||
"case": "退回线:总经理退回「创建」补正,重新提交后走完(图纸下方那条线)",
|
||
"steps": [{"activity": "创建"}, {"activity": "部门主管"},
|
||
{"activity": "总经理", "go_back": "创建"},
|
||
{"activity": "创建"}, {"activity": "部门主管"}, {"activity": "总经理"},
|
||
{"activity": "商务、办公室主任"}],
|
||
"expect_goback": True,
|
||
"expect_cc": True,
|
||
},
|
||
]
|
||
|
||
|
||
def smoke_data(case: dict) -> dict:
|
||
start = date.today() + timedelta(days=1)
|
||
end = start + timedelta(days=14)
|
||
return {
|
||
# 标题带上冒烟前缀,跑完按这个前缀清单据,绝不碰正经单据
|
||
"title": f"{SMOKE_PREFIX}{case['short']}-{datetime.now():%m%d%H%M%S}",
|
||
"handler": common.ADMIN_ACCOUNT,
|
||
"project": "(冒烟)XX 数据中心智能化项目投标",
|
||
"financeMaterials": ["auditReport"],
|
||
"qualificationMaterials": ["licenseCopy", "qualityCopy", "ismsCopy"],
|
||
"staffMaterials": ["staffCertificate"],
|
||
"performanceMaterials": ["salesPerformance"],
|
||
"materialType": ["original", "electronic"],
|
||
"validRange": [start.isoformat(), end.isoformat()],
|
||
"reason": "投标需要,向招标方提供营业执照、体系证书与近三年审计报告",
|
||
"remark": "冒烟数据,脚本跑完自动清理",
|
||
}
|
||
|
||
|
||
def pending_task(token: str, job: str, expect: str) -> dict:
|
||
"""等下一拍落定,确认单子确实停在预期环节上,并把待办取回来。"""
|
||
detail = common.wait_activity(token, job, seconds=40)
|
||
if detail["status"] != "running":
|
||
raise SystemExit(f"预期还有环节「{expect}」,单据却已经 {detail['status']}")
|
||
names = sorted({t["activity_name"] for t in detail["tasks"]})
|
||
if expect not in names:
|
||
raise SystemExit(f"预期环节「{expect}」,实际停在 {names}")
|
||
return next(t for t in detail["tasks"] if t["activity_name"] == expect)
|
||
|
||
|
||
#: 验证档专用的替身账号。三处原因让「一个人办完全程」不能直接照生产档跑:
|
||
#:
|
||
#: * 系统管理员的默认身份是历史遗留的 ``优尼森科技\\综合管理部\\系统管理员\\localadmin``,
|
||
#: 这个部门在同步回来的组织树里并不存在,``creatorUnitManager`` 对管理员建的单永远解析
|
||
#: 不出人,只能走空审批人兜底;
|
||
#: * ``toAdmin`` 兜底又刻意不把待办塞回建单的那个管理员(``engine._fallback_identities``
|
||
#: 里的 ``identity != work.creator_identity``),于是这一环会被判成没人可派直接通过;
|
||
#: * 把岗位角色临时改成管理员名单(``cost_reimburse.py`` 的老办法)会写组织数据:两个脚本
|
||
#: 并行跑时备份/还原会互相盖掉,2026-10-14 实测把真人总经理从「总经理」名单里挤了出去。
|
||
#:
|
||
#: 所以验证档把三个审批环节的找人来源统一换成管理员本人,压根不碰组织数据;生产档用的仍是
|
||
#: ``creatorUnitManager`` 与「总经理」「商务、办公室主任」两个角色,真人解析由 ``--report``
|
||
#: 拿组织内样例发起人试算来证明。
|
||
HARNESS_ACCOUNT = "localadmin"
|
||
|
||
|
||
def role_snapshot(token: str) -> dict[str, list[str]]:
|
||
"""岗位角色名单快照:验证只该动这条流程的设计,组织数据一个字节都不许变。"""
|
||
return {r["name"]: sorted(r.get("list_auth") or []) for r in ok("GET", "/org/roles", token)}
|
||
|
||
|
||
def walk(session: dict, process_id: str, case: dict) -> dict:
|
||
token = session["access_token"]
|
||
started = ok("POST", "/job", token, {"process": process_id, "data": smoke_data(case)})
|
||
job = started["job"]
|
||
trace: list[str] = []
|
||
handlers: list[str] = []
|
||
for step in case["steps"]:
|
||
task = pending_task(token, job, step["activity"])
|
||
handlers.append(f"{step['activity']}={task.get('identity_name') or task.get('person') or '?'}")
|
||
if step.get("go_back"):
|
||
options = ok("GET", f"/task/{task['id']}/goback-targets", token)
|
||
picked = next((o for o in options if o["name"] == step["go_back"]), None)
|
||
if picked is None:
|
||
raise SystemExit(f"「{step['activity']}」的退回目标里没有「{step['go_back']}」,"
|
||
f"实际可选:{[o['name'] for o in options]}")
|
||
ok("POST", f"/task/{task['id']}/goback", token,
|
||
{"activity": picked["id"], "way": "jump",
|
||
"opinion": "资质资料要补一句用于哪个标段,退回补充"})
|
||
trace.append(f"{step['activity']}→退回{step['go_back']}")
|
||
else:
|
||
routes = task.get("route_name_list") or []
|
||
common.execute(session, task, routes[0] if routes else "", f"{step['activity']}同意")
|
||
trace.append(step["activity"])
|
||
common.wait_activity(token, job, seconds=40)
|
||
detail = common.job_detail(token, job)
|
||
if detail["status"] == "running":
|
||
raise SystemExit(f"单据没走完,停在 {[t['activity_name'] for t in detail['tasks']]}")
|
||
types = common.log_types(token, job)
|
||
if ("goBack" in types) != case["expect_goback"]:
|
||
raise SystemExit(f"退回痕迹与预期不符:日志类型 {types}")
|
||
ccs = common.read_list(session, job=job, kind="cc")
|
||
if case["expect_cc"] and not ccs:
|
||
raise SystemExit("归档环节一条抄送都没发出去,抄送规则没生效")
|
||
return {"job": job, "serial": detail.get("serial", ""), "title": detail["title"],
|
||
"trace": trace, "status_label": detail.get("status_label") or detail["status"],
|
||
"cc": len(ccs), "log_types": types, "handlers": handlers}
|
||
|
||
|
||
def run_smoke(pid: str, form_id: str) -> None:
|
||
print("\n=== 跑通验证(三个审批环节都挂到系统管理员名下,不给真人派待办)===")
|
||
token = common.admin()
|
||
session = common.login(common.ADMIN_ACCOUNT, common.ADMIN_PASSWORD)
|
||
roles_before = role_snapshot(token)
|
||
# 验证档只改两处:单人办完全程时「发起人自审跳过」与「同一人批过自动通过」会把环节
|
||
# 吞掉,一起关掉;三个审批环节的找人来源换成管理员本人(理由见 HARNESS_ACCOUNT)。
|
||
# 兜底策略、超时、抄送、字段权限一律不动。引擎读的是实时设计,改完就跑,不必再发一版。
|
||
save_design(token, pid, process_design(form_id, smoke=True))
|
||
set_approval(token, pid, {"skipStarter": False, "dedup": "none"})
|
||
try:
|
||
for case in CASES:
|
||
result = walk(session, pid, case)
|
||
print(f" {case['case']}")
|
||
print(f" 单号 {result['serial']} 标题「{result['title']}」")
|
||
print(f" 办理:{' -> '.join(result['trace'])} -> 归档|最终 {result['status_label']}"
|
||
f"|抄送 {result['cc']} 条")
|
||
print(f" 派给:{'、'.join(result['handlers'])}")
|
||
finally:
|
||
save_design(token, pid, process_design(form_id))
|
||
set_approval(token, pid, {"skipStarter": False, "dedup": "all"})
|
||
drifted = {name: {"跑前": before, "跑后": role_snapshot(token)[name]}
|
||
for name, before in roles_before.items()
|
||
if role_snapshot(token)[name] != before}
|
||
if drifted:
|
||
print(" ! 岗位角色名单被改动,请立即核对:" + json.dumps(drifted, ensure_ascii=False))
|
||
problems = ok("POST", f"/process/processes/{pid}/validate", token)["problems"]
|
||
print("\n 设计已还原" + ("(岗位名单没被动过)" if not drifted else "") + (f",但校验还有问题:{problems}" if problems else ",校验通过"))
|
||
from expense.purge import purge
|
||
print(" 清掉验证单据:" + json.dumps(purge([SMOKE_PREFIX]), ensure_ascii=False))
|
||
|
||
|
||
def find_process_id(token: str) -> str:
|
||
process = next((p for p in ok("GET", "/process/processes", token, params={"page_size": 200})
|
||
if p["name"] == PROCESS_NAME), None)
|
||
if process is None:
|
||
raise SystemExit(f"库里还没有「{PROCESS_NAME}」,先不带 --only-run 建一遍")
|
||
return process["id"]
|
||
|
||
|
||
def main() -> int:
|
||
parser = argparse.ArgumentParser(description="建财务及资质材料使用申请流程")
|
||
parser.add_argument("--report", action="store_true", help="只把库里的设计读回来对一遍")
|
||
parser.add_argument("--run", action="store_true", help="跑两张真单据把正常线与退回线走通,跑完删单")
|
||
parser.add_argument("--only-run", action="store_true", help="配合 --run:只跑验证,不重建设计")
|
||
args = parser.parse_args()
|
||
token = common.admin()
|
||
print(f"接口:{common.BASE}")
|
||
if args.report:
|
||
report(token)
|
||
return 0
|
||
if args.only_run:
|
||
pid = find_process_id(token)
|
||
form_id = ok("GET", f"/process/processes/{pid}", token)["latest_form"]
|
||
else:
|
||
form_id = build_form(token)
|
||
build_posts(token)
|
||
pid = build_process(token, form_id)["id"]
|
||
report(token)
|
||
if args.run:
|
||
run_smoke(pid, form_id)
|
||
return 0
|
||
|
||
|
||
if __name__ == "__main__":
|
||
sys.exit(main())
|