240 lines
8.6 KiB
Python
240 lines
8.6 KiB
Python
#!/usr/bin/env python3
|
||
"""使用真实 Chrome 登录系统并生成 HTML 使用手册所需截图。
|
||
|
||
依赖本机 Google Chrome;通过 Chrome DevTools Protocol 操作页面,不额外安装
|
||
浏览器自动化包。运行前先启动 ``uvicorn app.main:app --port 8000``。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
import json
|
||
import shutil
|
||
import subprocess
|
||
import tempfile
|
||
import time
|
||
import urllib.request
|
||
from pathlib import Path
|
||
|
||
from websockets.sync.client import connect
|
||
|
||
|
||
ROOT = Path(__file__).resolve().parents[1]
|
||
OUT = ROOT / "web" / "public" / "help" / "assets"
|
||
BASE = "http://127.0.0.1:8000"
|
||
CHROME = "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"
|
||
PORT = 9227
|
||
|
||
|
||
def api_login(username: str, password: str) -> dict:
|
||
body = json.dumps({"username": username, "password": password}).encode()
|
||
req = urllib.request.Request(
|
||
f"{BASE}/api/v1/auth/login",
|
||
data=body,
|
||
headers={"Content-Type": "application/json"},
|
||
)
|
||
with urllib.request.urlopen(req, timeout=20) as resp:
|
||
return json.load(resp)
|
||
|
||
|
||
class CDP:
|
||
def __init__(self, ws_url: str) -> None:
|
||
self.ws = connect(ws_url, max_size=64 * 1024 * 1024, legacy=True)
|
||
self.seq = 0
|
||
|
||
def call(self, method: str, params: dict | None = None) -> dict:
|
||
self.seq += 1
|
||
current = self.seq
|
||
self.ws.send(json.dumps({"id": current, "method": method, "params": params or {}}))
|
||
while True:
|
||
msg = json.loads(self.ws.recv(timeout=30))
|
||
if msg.get("id") == current:
|
||
if "error" in msg:
|
||
raise RuntimeError(f"{method}: {msg['error']}")
|
||
return msg.get("result", {})
|
||
|
||
def eval(self, expression: str):
|
||
result = self.call(
|
||
"Runtime.evaluate",
|
||
{"expression": expression, "returnByValue": True, "awaitPromise": True},
|
||
)
|
||
return result.get("result", {}).get("value")
|
||
|
||
def wait_text(self, text: str, timeout: float = 25) -> None:
|
||
deadline = time.time() + timeout
|
||
expression = f"document.body && document.body.innerText.includes({json.dumps(text)})"
|
||
while time.time() < deadline:
|
||
if self.eval(expression):
|
||
time.sleep(0.7)
|
||
return
|
||
time.sleep(0.25)
|
||
raise TimeoutError(f"页面未出现文字:{text}")
|
||
|
||
def navigate(self, path: str, text: str | None = None) -> None:
|
||
self.call("Page.navigate", {"url": f"{BASE}{path}"})
|
||
time.sleep(0.5)
|
||
if text:
|
||
self.wait_text(text)
|
||
|
||
def screenshot(self, name: str) -> None:
|
||
result = self.call(
|
||
"Page.captureScreenshot",
|
||
{"format": "png", "fromSurface": True, "captureBeyondViewport": False},
|
||
)
|
||
import base64
|
||
|
||
(OUT / name).write_bytes(base64.b64decode(result["data"]))
|
||
print(f"captured {name}")
|
||
|
||
|
||
def wait_debug_port() -> dict:
|
||
deadline = time.time() + 20
|
||
while time.time() < deadline:
|
||
try:
|
||
with urllib.request.urlopen(f"http://127.0.0.1:{PORT}/json/version", timeout=1) as resp:
|
||
return json.load(resp)
|
||
except Exception:
|
||
time.sleep(0.2)
|
||
raise RuntimeError("Chrome 调试端口未就绪")
|
||
|
||
|
||
def page_target() -> dict:
|
||
with urllib.request.urlopen(f"http://127.0.0.1:{PORT}/json/list", timeout=3) as resp:
|
||
targets = json.load(resp)
|
||
page = next((item for item in targets if item.get("type") == "page"), None)
|
||
if page is None:
|
||
raise RuntimeError("Chrome 中没有可用页面")
|
||
return page
|
||
|
||
|
||
def main() -> None:
|
||
OUT.mkdir(parents=True, exist_ok=True)
|
||
profile = Path(tempfile.mkdtemp(prefix="unis-hrms-chrome-"))
|
||
chrome = subprocess.Popen(
|
||
[
|
||
CHROME,
|
||
"--headless=new",
|
||
f"--remote-debugging-port={PORT}",
|
||
f"--user-data-dir={profile}",
|
||
"--no-first-run",
|
||
"--no-default-browser-check",
|
||
"--disable-gpu",
|
||
"--hide-scrollbars",
|
||
"--window-size=1600,1080",
|
||
"about:blank",
|
||
],
|
||
stdout=subprocess.DEVNULL,
|
||
stderr=subprocess.DEVNULL,
|
||
)
|
||
try:
|
||
wait_debug_port()
|
||
cdp = CDP(page_target()["webSocketDebuggerUrl"])
|
||
cdp.call("Page.enable")
|
||
cdp.call("Runtime.enable")
|
||
cdp.call("Emulation.setDeviceMetricsOverride", {
|
||
"width": 1600, "height": 1080, "deviceScaleFactor": 1, "mobile": False,
|
||
})
|
||
|
||
cdp.navigate("/login", "登录工作台")
|
||
cdp.screenshot("01-login.png")
|
||
|
||
plans = [
|
||
("admin", "admin123", "/dashboard", "今日组织概览", "02-dashboard.png"),
|
||
("admin", "admin123", "/employees", "员工档案", "03-employees.png"),
|
||
("admin", "admin123", "/org/job-levels", "职级职等", "04-job-levels.png"),
|
||
("admin", "admin123", "/payroll/batches", "月度算薪", "06-payroll.png"),
|
||
("admin", "admin123", "/benefits/enrollments", "参保登记", "07-benefits.png"),
|
||
("admin", "admin123", "/system/roles", "角色权限", "08-roles.png"),
|
||
]
|
||
token_for = {}
|
||
for username, password, path, text, name in plans:
|
||
pair = token_for.get(username)
|
||
if pair is None:
|
||
pair = api_login(username, password)
|
||
token_for[username] = pair
|
||
cdp.navigate("/login")
|
||
cdp.eval(
|
||
"localStorage.setItem('unis-hrms-auth', "
|
||
+ json.dumps(json.dumps({
|
||
"state": {"token": pair["access_token"], "refresh": pair["refresh_token"]},
|
||
"version": 0,
|
||
}))
|
||
+ ")"
|
||
)
|
||
cdp.navigate(path, text)
|
||
cdp.screenshot(name)
|
||
|
||
# 职级行内打开“报销标准”抽屉,展示多项目配置。
|
||
cdp.navigate("/org/job-levels", "职级职等")
|
||
clicked = cdp.eval(
|
||
"(() => { const b=[...document.querySelectorAll('button')]"
|
||
".find(x => x.innerText.includes('报销标准')); if (!b) return false; b.click(); return true })()"
|
||
)
|
||
if not clicked:
|
||
raise RuntimeError("未找到报销标准按钮")
|
||
cdp.wait_text("可配置多个报销项目")
|
||
cdp.screenshot("05-expense-standards.png")
|
||
|
||
# 普通员工 Web 自助:导航直接呈现与 H5 同名的 5 项。
|
||
pair = api_login("emp", "emp123456")
|
||
token_for["emp"] = pair
|
||
cdp.navigate("/login")
|
||
cdp.eval(
|
||
"localStorage.setItem('unis-hrms-auth', "
|
||
+ json.dumps(json.dumps({
|
||
"state": {"token": pair["access_token"], "refresh": pair["refresh_token"]},
|
||
"version": 0,
|
||
}))
|
||
+ ")"
|
||
)
|
||
cdp.navigate("/dashboard", "常用自助入口")
|
||
cdp.screenshot("09-web-self-home.png")
|
||
cdp.navigate("/self/profile", "我的信息")
|
||
cdp.screenshot("10-web-self-profile.png")
|
||
cdp.eval(
|
||
"(() => { const b=[...document.querySelectorAll('span,a,button')]"
|
||
".find(x => x.innerText.trim()==='修改资料'); if (!b) return false; b.click(); return true })()"
|
||
)
|
||
cdp.wait_text("提交审核")
|
||
cdp.screenshot("11-profile-audit.png")
|
||
|
||
# H5 自动识别由单独的手机视口验证。
|
||
cdp.call("Emulation.setDeviceMetricsOverride", {
|
||
"width": 390, "height": 844, "deviceScaleFactor": 2, "mobile": True,
|
||
})
|
||
cdp.call("Emulation.setUserAgentOverride", {
|
||
"userAgent": (
|
||
"Mozilla/5.0 (iPhone; CPU iPhone OS 18_0 like Mac OS X) "
|
||
"AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.0 Mobile/15E148 Safari/604.1"
|
||
),
|
||
})
|
||
cdp.navigate("/m", "最新实发工资")
|
||
cdp.screenshot("12-h5-home.png")
|
||
cdp.navigate("/m/profile", "我的信息")
|
||
cdp.screenshot("13-h5-profile.png")
|
||
|
||
# 审批中心使用 HR 账号(拥有审批权且有员工档案)。
|
||
pair = token_for.get("hr") or api_login("hr", "hr123456")
|
||
cdp.navigate("/login")
|
||
cdp.eval(
|
||
"localStorage.setItem('unis-hrms-auth', "
|
||
+ json.dumps(json.dumps({
|
||
"state": {"token": pair["access_token"], "refresh": pair["refresh_token"]},
|
||
"version": 0,
|
||
}))
|
||
+ ")"
|
||
)
|
||
cdp.navigate("/m/approvals", "审批中心")
|
||
cdp.screenshot("14-approvals.png")
|
||
cdp.ws.close()
|
||
finally:
|
||
chrome.terminate()
|
||
try:
|
||
chrome.wait(timeout=5)
|
||
except subprocess.TimeoutExpired:
|
||
chrome.kill()
|
||
shutil.rmtree(profile, ignore_errors=True)
|
||
|
||
|
||
if __name__ == "__main__":
|
||
main()
|