test(system): M1 参数体系集成用例、e2e 脚本与文档更新

- 集成用例 26 项：岗位角色（CRUD/内置保护/权限）+ 参数管理（目录回溯/变更生命周期/值校验/预览金标准）
- 361 天分界断言按 Fraction 数值比较（4/1000 自动约分为 1/250，值相等）
- e2e param_management.py：7 步全通过（含预览金标准 27 天/9.7‰/145.5 元）
- 结果卡补「计提比例」精确分数行（对账透明）
- 三份 README 更新：接口职责/AI 摘要/M1 用例清单与运行记录/e2e 记录

Co-Authored-By: Claude Code <noreply@anthropic.com>

frontend/README.md

@@ -1,11 +1,13 @@
 # 前端
 
-> AI摘要：衍水集团营销人员工资管理系统的前端。Vue 3 + TypeScript + Vite + Element Plus + Pinia。关键文件 `src/api/request.ts`（统一请求封装）、`src/components/layout/BasicLayout.vue`（应用布局与导航）、`src/router/index.ts`（路由守卫）、`src/store/user.ts`（会话状态）。当前完成登录链路与系统管理页面（用户/角色/日志查询），业务模块页面待接入。
+> AI摘要：衍水集团营销人员工资管理系统的前端。Vue 3 + TypeScript + Vite + Element Plus + Pinia。关键文件 `src/api/request.ts`（统一请求封装）、`src/components/layout/BasicLayout.vue`（应用布局与导航）、`src/router/index.ts`（路由守卫）、`src/store/user.ts`（会话状态）。已实现登录链路（2026-10 视觉方向重做：点阵底/涟漪/天光/居中卡片）、系统管理页面、岗位角色与计提参数配置页、Bento 仪表盘首页；视觉体系与设计预览见 `docs/design/视觉方向预览.html`。
 
 ## 职责
 
 - 登录页与图形验证码交互
 - 会话状态管理与路由守卫
+- 岗位角色管理页（模板绑定）、计提参数配置页（分组目录/批次提交/版本对比/导出/计算预览）
+- 首页 Bento 仪表盘（M1 空态设计；业务上线后接入真实统计，图表用 ECharts）
 - 后续：基础数据、业务数据、绩效核算、报表等业务页面
 
 ## 技术栈与版本约束
@@ -136,3 +138,13 @@ E2E_ADMIN_PASSWORD=<开发库admin密码> python e2e/system_management.py
 **验证码图片不显示** —— 多为代理未生效。访问 `http://localhost:5173/api/health` 应返回统一信封格式 JSON。
 
 **`pnpm install` 报 peer 依赖错误** —— 确认 `@vue/devtools-api` 在 `dependencies` 中（pinia 4 的必需 peer）。
+
+## 端到端测试（2026-10-13 追加 · M1 参数体系）
+
+| 脚本 | 覆盖 | 结果 |
+| --- | --- | --- |
+| `e2e/login_flow.py` | 登录链路 8 项 | ✓ 全通过（登录页视觉重做后回归） |
+| `e2e/system_management.py` | 系统管理 13 项 | ✓ 全通过（布局白化后回归） |
+| `e2e/param_management.py` | 计提参数 7 步：目录分组 → 修改入待提交 → 批次提交（立即生效）→ 目录反映新值 → 版本记录 → 恢复种子值 → 计算预览金标准（27 天 / 9.7‰ / 145.5 元） | ✓ 全通过（首跑） |
+
+运行前置：容器 + 后端（8000）+ 前端 dev（5173）；`E2E_ADMIN_PASSWORD` 传管理员密码。

frontend/e2e/param_management.py

@@ -0,0 +1,141 @@
+"""计提参数管理端到端测试（需要容器、后端、前端都在运行）。
+
+覆盖链路（M1 验收）：目录分组展示 → 修改参数入「待提交」→ 批次提交（立即
+生效）→ 目录反映新值 → 版本记录可见 → 计算预览金标准复现（27 天 / 9.7‰ /
+145.5 元）→ 值改回种子值恢复现场。
+
+运行：``E2E_ADMIN_PASSWORD=... python e2e/param_management.py``
+"""
+
+import sys
+
+sys.path.insert(0, __import__("os").path.dirname(__file__))
+
+from playwright.sync_api import sync_playwright
+
+from common import (
+    BASE_URL,
+    E2EFailure,
+    collect_console_errors,
+    expect_toast,
+    fail,
+    login,
+    wait_toast,
+)
+
+if hasattr(sys.stdout, "reconfigure"):
+    sys.stdout.reconfigure(encoding="utf-8")
+
+PARAMS_URL = f"{BASE_URL}/system/params"
+console_errors: list[str] = []
+
+
+def step(title: str) -> None:
+    print(f"—— {title}")
+
+
+def main() -> int:
+    failures: list[str] = []
+    with sync_playwright() as p:
+        browser = p.chromium.launch()
+        page = browser.new_page(viewport={"width": 1440, "height": 860})
+        errors = collect_console_errors(page, console_errors)
+
+        try:
+            login(page, "admin", __import__("os").environ.get("E2E_ADMIN_PASSWORD", "E2ePwd@2026"))
+            page.goto(PARAMS_URL, wait_until="networkidle")
+
+            step("1. 目录分组展示")
+            if page.locator(".group-title", has_text="支付环节").count() == 0:
+                fail("目录分组", "未找到「支付环节」分组")
+            # 展开「支付环节」分组
+            page.locator(".el-collapse-item__header", has_text="支付环节").click()
+            page.wait_for_timeout(300)
+
+            step("2. 修改预付款比例 10 → 12（立即生效）")
+            row = page.locator(".param-table tbody tr", has_text="预付款计提比例").first
+            row.get_by_role("button", name="修改").click()
+            dialog = page.locator(".el-dialog")
+            dialog.locator("input").fill("12")
+            dialog.get_by_role("button", name="加入待提交").click()
+            if "待改为 12" not in page.content():
+                fail("待提交", "参数行未出现「待改为 12」标记")
+
+            step("3. 提交批次")
+            page.get_by_role("button", name="提交变更").click()
+            page.locator(".el-message-box").get_by_role("button", name="提交").click()
+            expect_toast(page, "已提交", "提交批次")
+
+            step("4. 目录反映新值")
+            page.wait_for_timeout(500)
+            row = page.locator(".param-table tbody tr", has_text="预付款计提比例").first
+            if "12" not in row.text_content():
+                fail("目录生效", "提交后目录未显示新值 12")
+
+            step("5. 版本记录可见")
+            page.get_by_role("button", name="版本管理").click()
+            page.wait_for_timeout(500)
+            first_version = page.locator(".el-drawer .el-table tbody tr").first.text_content()
+            if "P2026" not in first_version:
+                fail("版本记录", f"最新记录异常：{first_version}")
+            page.keyboard.press("Escape")
+            page.wait_for_timeout(300)
+
+            step("6. 恢复种子值 10")
+            row = page.locator(".param-table tbody tr", has_text="预付款计提比例").first
+            row.get_by_role("button", name="修改").click()
+            dialog = page.locator(".el-dialog")
+            dialog.locator("input").fill("10")
+            dialog.get_by_role("button", name="加入待提交").click()
+            page.get_by_role("button", name="提交变更").click()
+            page.locator(".el-message-box").get_by_role("button", name="提交").click()
+            wait_toast(page, "已提交")
+            page.wait_for_timeout(400)
+
+            step("7. 计算预览金标准（27 天 / 9.7‰ / 145.5）")
+            page.get_by_role("button", name="计算预览").click()
+            page.wait_for_timeout(600)
+            # 多个抽屉组件常驻 DOM（隐藏未销毁），按标题过滤出预览抽屉
+            drawer = page.locator(".el-drawer").filter(has_text="计算预览").last
+            # 岗位下拉默认 salesperson（v-model 初始值），无需操作
+            drawer.locator(".el-form-item", has_text="发货日").locator("input").click()
+            page.keyboard.type("2025-12-15")
+            page.keyboard.press("Enter")
+            drawer.locator(".el-form-item", has_text="回款到账日").locator("input").click()
+            page.keyboard.type("2026-01-10")
+            page.keyboard.press("Enter")
+            drawer.locator(".el-form-item", has_text="销售额").locator("input").fill("100000")
+            drawer.locator(".el-form-item", has_text="毛利润额").locator("input").fill("45000")
+            drawer.locator(".el-form-item", has_text="本笔回款").locator("input").fill("60000")
+            drawer.get_by_role("button", name="试 算").click()
+            page.wait_for_timeout(900)
+            result_text = drawer.locator(".preview-result").text_content()
+            for expected in ["27 天", "145.5", "97/10000"]:
+                if expected not in result_text:
+                    fail("预览金标准", f"结果缺少 {expected}：{result_text[:200]}")
+
+        except E2EFailure as exc:
+            failures.append(str(exc))
+            page.screenshot(path="e2e/failure.png")
+        except Exception as exc:  # noqa: BLE001
+            import traceback
+            traceback.print_exc()
+            failures.append(f"未预期异常：{exc}")
+            page.screenshot(path="e2e/failure.png")
+        finally:
+            browser.close()
+
+    if failures:
+        print(f"✗ {failures[0]}")
+        if console_errors:
+            print(f"  控制台错误（最近 3 条）：{console_errors[-3:]}")
+        return 1
+
+    print("✓ 计提参数管理端到端：7 步全部通过（目录/待提交/提交/生效/版本/恢复/预览金标准）")
+    if console_errors:
+        print(f"  （控制台非致命消息 {len(console_errors)} 条，见上方日志）")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

frontend/src/views/system/params/index.vue

@@ -738,7 +738,8 @@ onMounted(() => {
             <span>单笔绩效</span><b class="num">{{ previewResult.performance_amount }} 元</b>
           </div>
           <div class="pr-row"><span>回款天数</span><b class="num">{{ previewResult.payment_days }} 天</b></div>
-          <div class="pr-row"><span>计提比例</span><b class="num">{{ previewResult.rate_text }}</b></div>
+          <div class="pr-row"><span>计提比例</span><b class="num">{{ previewResult.rate }}</b></div>
+          <div class="pr-row"><span>计提说明</span><b>{{ previewResult.rate_text }}</b></div>
           <div class="pr-row"><span>折算毛利润额</span><b class="num">{{ previewResult.converted_profit }} 元</b></div>
           <div class="pr-row"><span>毛利润率</span><b class="num">{{ previewResult.profit_rate }}</b></div>
           <div class="pr-row"><span>起付判定</span><b>{{ previewResult.start_payment_ok ? '已达标' : '未达标（累计中）' }}</b></div>