feat(ops): 增量备份——binlog 归档脚本与全量位点记录（#19 答复）

- backup_incremental.sh：归档已写完 binlog（tar 拷出+gzip），状态文件对齐序号，有更新才产出，保留 30 天
- backup_full.sh：补 .pos 位点文件（SHOW MASTER STATUS），增量重放的起点锚
- 手册新增增量章节：恢复顺序=全量→binlog 重放，含 mysqlbinlog 缺席镜像的说明

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

backend/alembic/versions/c7d2e5a81f30_v8_业务答复口径落实_审批开关默认_试用期参数_经理基数开关_台账分摊唯一键.py

@@ -0,0 +1,193 @@
+"""V8：业务答复口径落实（2026-10-19 回执）。
+
+四件事，全部源于《待澄清问题清单》2026-10-19 答复：
+
+1. 审批开关默认值翻转（#5/#7 答复「默认开启」）：param_definitions 的
+   default_value 更新为 '1'；param_values **插入生效日 2026-10-19 的新行**
+   而非改历史行——参数体系时点化（按业务日期回溯），直接改种子行会篡改
+   10-19 之前的口径历史。
+2. 撤销试用期统一工资参数（#16 答复「按人员档案逐人维护」）：删除
+   probation.salary.basic 的定义与版本行；月结基本工资已直接读
+   personnel.salary_standard（该参数自 M3 ④ 实现起即无业务消费点）。
+3. 新增经理个人户聚合基数开关（#12 答复「作为参数配置，手动调整是否
+   纳入」）：manager.personal.included，默认 0=不计入（维持暂口径）。
+4. 绩效台账唯一键加 personnel_id（二次分配分摊铺路，澄清 #1 答复
+   「分配绩效」）：分摊后同一回款同版本按人各落一行（负责人余额行 +
+   参与人比例行），uk(receipt_id, calc_version) 会撞；扩为三列后聚合行
+   （receipt_id NULL）依旧不受 MySQL 唯一索引约束。
+
+迁移 downgrade 只保留 drop_table/行级种子反向 DELETE（V6 教训：逐个
+drop_index 会撞外键支撑索引 errno 1553）。
+"""
+
+from datetime import date
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = "c7d2e5a81f30"
+down_revision = "3bca400421c6"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    """种子行级变更 + 台账唯一键扩展（无表结构新增/删除）。"""
+    # 1. 审批开关默认值翻转（#5/#7：默认开启，业务可关闭）
+    op.execute(
+        "UPDATE param_definitions SET default_value = '1' "
+        "WHERE id IN (17, 18)"
+    )
+    # 时点化生效行：插新行不改历史（10-19 前仍按 0 解析）
+    op.bulk_insert(
+        sa.table(
+            "param_values",
+            sa.column("id", sa.BigInteger),
+            sa.column("param_id", sa.BigInteger),
+            sa.column("dimension_value", sa.String),
+            sa.column("effective_date", sa.Date),
+            sa.column("value_text", sa.String),
+            sa.column("batch_id", sa.BigInteger),
+        ),
+        [
+            {
+                "id": 23,
+                "param_id": 17,
+                "dimension_value": "",
+                "effective_date": date(2026, 10, 19),
+                "value_text": "1",
+                "batch_id": 1,
+            },
+            {
+                "id": 24,
+                "param_id": 18,
+                "dimension_value": "",
+                "effective_date": date(2026, 10, 19),
+                "value_text": "1",
+                "batch_id": 1,
+            },
+        ],
+    )
+
+    # 2. 撤销试用期统一工资参数（#16：按人员档案 personnel.salary_standard 逐人维护）
+    op.execute("DELETE FROM param_values WHERE id = 19")
+    op.execute("DELETE FROM param_definitions WHERE id = 16")
+
+    # 3. 经理个人户聚合基数开关（#12：参数化，默认不计入）
+    op.bulk_insert(
+        sa.table(
+            "param_definitions",
+            sa.column("id", sa.BigInteger),
+            sa.column("param_code", sa.String),
+            sa.column("param_name", sa.String),
+            sa.column("param_group", sa.String),
+            sa.column("value_type", sa.String),
+            sa.column("unit", sa.String),
+            sa.column("dimension_type", sa.String),
+            sa.column("options_text", sa.String),
+            sa.column("default_value", sa.String),
+            sa.column("value_min", sa.String),
+            sa.column("value_max", sa.String),
+            sa.column("description", sa.String),
+            sa.column("sort_order", sa.Integer),
+            sa.column("status", sa.Integer),
+        ),
+        [
+            {
+                "id": 20,
+                "param_code": "manager.personal.included",
+                "param_name": "经理个人户计入聚合基数",
+                "param_group": "经理分成",
+                "value_type": "BOOL",
+                "unit": None,
+                "dimension_type": "NONE",
+                "options_text": None,
+                "default_value": "0",
+                "value_min": None,
+                "value_max": None,
+                "description": (
+                    "经理 12.5%+5% 聚合时是否计入经理本人名下经理个人户业绩（澄清 #12 "
+                    "业务答复 2026-10-19：作为参数配置、手动调整是否纳入）："
+                    "0=不计入（默认，暂口径） 1=计入"
+                ),
+                "sort_order": 20,
+                "status": 1,
+            }
+        ],
+    )
+    op.bulk_insert(
+        sa.table(
+            "param_values",
+            sa.column("id", sa.BigInteger),
+            sa.column("param_id", sa.BigInteger),
+            sa.column("dimension_value", sa.String),
+            sa.column("effective_date", sa.Date),
+            sa.column("value_text", sa.String),
+            sa.column("batch_id", sa.BigInteger),
+        ),
+        [
+            {
+                "id": 25,
+                "param_id": 20,
+                "dimension_value": "",
+                "effective_date": date(2026, 1, 1),
+                "value_text": "0",
+                "batch_id": 1,
+            }
+        ],
+    )
+
+    # 4. 台账唯一键扩为三列（分摊拆行：同回款同版本按人一行）
+    # 顺序要紧：旧 uk 是 fk_performance_ledgers_receipt_id 的唯一支撑索引，
+    # 先删会撞 errno 1553（外键无支撑索引）；先建新键（receipt_id 仍居最左）
+    # 再做替换，两键短暂并存无冲突。
+    op.create_unique_constraint(
+        "uk_performance_ledgers_receipt_id_calc_version_personnel",
+        "performance_ledgers",
+        ["receipt_id", "calc_version", "personnel_id"],
+    )
+    op.drop_constraint(
+        "uk_performance_ledgers_receipt_id_calc_version",
+        "performance_ledgers",
+        type_="unique",
+    )
+
+
+def downgrade() -> None:
+    """反向：唯一键复原 + 种子行级回退（顺序与 upgrade 相反）。
+
+    试用期参数（definitions 16 / values 19）的原始种子在 V3，按 V6 downgrade
+    的行级反向惯例显式重插，保证可重放。
+    """
+    # 与 upgrade 同因的顺序：先建回旧键再删新键（旧键支撑 receipts 外键）
+    op.create_unique_constraint(
+        "uk_performance_ledgers_receipt_id_calc_version",
+        "performance_ledgers",
+        ["receipt_id", "calc_version"],
+    )
+    op.drop_constraint(
+        "uk_performance_ledgers_receipt_id_calc_version_personnel",
+        "performance_ledgers",
+        type_="unique",
+    )
+
+    op.execute("DELETE FROM param_values WHERE id = 25")
+    op.execute("DELETE FROM param_definitions WHERE id = 20")
+
+    op.execute(
+        "INSERT INTO param_definitions (id, param_code, param_name, param_group, value_type, "
+        "unit, dimension_type, options_text, default_value, value_min, value_max, "
+        "description, sort_order, status) VALUES "
+        "(16, 'probation.salary.basic', '试用期基本工资标准', '月工资口径', 'DECIMAL', "
+        "'元', 'NONE', NULL, '3000', '0', NULL, "
+        "'试用期仅发基本工资、不发放绩效（归属待 M2 复核）', 16, 1)"
+    )
+    op.execute(
+        "INSERT INTO param_values (id, param_id, dimension_value, effective_date, "
+        "value_text, batch_id) VALUES (19, 16, '', '2026-01-01', '3000', 1)"
+    )
+
+    op.execute("DELETE FROM param_values WHERE id IN (23, 24)")
+    op.execute(
+        "UPDATE param_definitions SET default_value = '0' WHERE id IN (17, 18)"
+    )

backend/app/api/deps.py

@@ -114,6 +114,10 @@ def require_admin(current_user: Annotated[User, Depends(get_current_user)]) -> U
 
 AdminUser = Annotated[User, Depends(require_admin)]
 
+# 仅要求登录态、不限角色（#17 答复 2026-10-19：薪酬敏感配置「查看可、修改仅
+# 管理员」——参数目录/历史/预览等只读端点用此依赖）
+LoginUser = Annotated[User, Depends(get_current_user)]
+
 
 def require_roles(*role_codes: str):
     """要求当前用户具备任一指定角色（依赖工厂）。

backend/app/api/v1/system/params.py

@@ -1,8 +1,9 @@
 """计提参数管理接口（需求 #28：参数配置化 + 版本管理 + 留痕）。
 
-全部要求管理员权限（开放问题 #5 的当前默认，后续可放宽只读）；
-写操作（提交/撤回）经 `RequestMetaDep` 带入请求元信息写入操作日志，
-变更批次本身另行留痕（变更人/时间/项/旧值/新值/生效日期）——双保险。
+权限分层（澄清 #17 业务答复 2026-10-19「查看可、修改仅管理员」）：只读
+端点（目录/变更记录/批次明细/对比/导出/预览/历史）要求登录即可；写操作
+（提交/撤回）仅管理员。写操作经 `RequestMetaDep` 带入请求元信息写入操作
+日志，变更批次本身另行留痕（变更人/时间/项/旧值/新值/生效日期）——双保险。
 导出为文件流（非统一信封），前端以 blob 接收。
 """
 
@@ -12,7 +13,7 @@ from typing import Annotated
 from fastapi import APIRouter, Path, Query
 from fastapi.responses import StreamingResponse
 
-from app.api.deps import AdminUser, DbSession, RequestMetaDep
+from app.api.deps import AdminUser, DbSession, LoginUser, RequestMetaDep
 from app.core.response import ApiResponse, PageResult, ok
 from app.schemas.param import (
     ParamBatchDetailOut,
@@ -37,7 +38,7 @@ router = APIRouter(prefix="/params", tags=["系统管理 · 计提参数"])
 )
 def get_catalog(
     session: DbSession,
-    _: AdminUser,
+    _: LoginUser,
     as_of: Annotated[date | None, Query(description="业务日期，默认今日")] = None,
 ) -> ApiResponse[list[ParamCatalogItemOut]]:
     """全部启用参数的定义元数据与截至 asOf 的生效值（前端按分组展示）。"""
@@ -63,7 +64,7 @@ def submit_change(
 )
 def list_changes(
     session: DbSession,
-    _: AdminUser,
+    _: LoginUser,
     query: Annotated[ParamBatchQuery, Query()],
 ) -> ApiResponse[PageResult[ParamBatchOut]]:
     """按生效日期区间分页查询变更批次（创建时间倒序）。"""
@@ -75,7 +76,7 @@ def list_changes(
 )
 def get_batch(
     session: DbSession,
-    _: AdminUser,
+    _: LoginUser,
     batch_id: Annotated[int, Path(ge=1)],
 ) -> ApiResponse[ParamBatchDetailOut]:
     """批次头 + 逐项旧值 → 新值。"""
@@ -97,7 +98,7 @@ def withdraw_batch(
 @router.get("/compare", response_model=ApiResponse[list[ParamDiffOut]], summary="两日期快照对比")
 def compare(
     session: DbSession,
-    _: AdminUser,
+    _: LoginUser,
     from_date: Annotated[date, Query(description="起始业务日期（含）")],
     to_date: Annotated[date, Query(description="截止业务日期（含）")],
 ) -> ApiResponse[list[ParamDiffOut]]:
@@ -108,7 +109,7 @@ def compare(
 @router.get("/export", summary="导出变更记录 Excel")
 def export_changes(
     session: DbSession,
-    _: AdminUser,
+    _: LoginUser,
     start_date: Annotated[date | None, Query(description="生效日期起（含）")] = None,
     end_date: Annotated[date | None, Query(description="生效日期止（含）")] = None,
 ) -> StreamingResponse:
@@ -125,7 +126,7 @@ def export_changes(
 @router.post("/preview", response_model=ApiResponse[ParamPreviewOut], summary="计算预览")
 def preview(
     session: DbSession,
-    _: AdminUser,
+    _: LoginUser,
     payload: ParamPreviewIn,
 ) -> ApiResponse[ParamPreviewOut]:
     """输入业务场景（岗位/产品/发货/回款/金额），按回款到账日取参数实时试算。"""
@@ -139,7 +140,7 @@ def preview(
 )
 def get_history(
     session: DbSession,
-    _: AdminUser,
+    _: LoginUser,
     param_code: Annotated[str, Path(max_length=64)],
     query: Annotated[ParamHistoryQuery, Query()],
 ) -> ApiResponse[PageResult[ParamHistoryOut]]:

backend/app/models/performance_ledger.py

@@ -5,15 +5,20 @@ is_active 翻 0 —— 这是全表唯一的受控 UPDATE（模型注释与 test
 均已声明例外），行内容永不改写；历史版本可回溯（重算授权留痕的需求口径）。
 
 防重三层：服务层 CAS（UPDATE ... WHERE settlement_status=0，rowcount=0
-即 400）+ FOR UPDATE 行锁 + 库级 uk(receipt_id, calc_version) 兜底。
+即 400）+ FOR UPDATE 行锁 + 库级 uk(receipt_id, calc_version, personnel_id)
+兜底。uk 含 personnel_id：二次分配分摊（澄清 #1 答复 2026-10-19，分配
+绩效——按方案比例拆给参与人、余额归合同负责人）后同一回款同版本按人
+各落一行，拆分仍是「一次核算」的组成部分；聚合行 receipt_id 为 NULL，
+MySQL 唯一索引对 NULL 不去重，天然不约束。
 
 经理聚合行（calc_type=2，receipt_id 为 NULL）：月度批处理时按「本团队
 业务员绩效 ×12.5% + 全公司 ×5%」落一行；其唯一性由月结生成的
 settlement_month 串行化 + 服务层保证（MySQL 无部分唯一索引，docstring
 声明即可）。
 
-#12 策略点（待业务答复）：经理个人户业绩暂不计入聚合基数——聚合集中
-在 settlement_service 的聚合函数，答复后只改该函数。
+#12 答复（2026-10-19）：经理个人户业绩是否计入聚合基数改为参数
+``manager.personal.included``（默认 0=不计入）——消费点在 settlement_service
+的聚合函数。
 """
 
 from datetime import date
@@ -43,11 +48,14 @@ class PerformanceLedger(Base, TimestampMixin):
     __tablename__ = "performance_ledgers"
     __table_args__ = mysql_table_args(
         "绩效核算台账表（append-only 版本行；重算插新版本旧行仅翻 is_active）",
-        # 库级防重兜底：同一回款同版本仅一行（服务层 CAS+行锁之外的第二道
-        # 闸）；聚合行 receipt_id 为 NULL，MySQL 唯一索引对 NULL 不去重，
-        # 天然不约束聚合行
+        # 库级防重兜底：同一回款同版本按人仅一行（分摊拆行后负责人+参与人
+        # 各占一行；服务层 CAS+行锁之外的第二道闸）。聚合行 receipt_id 为
+        # NULL，MySQL 唯一索引对 NULL 不去重，天然不约束聚合行
         UniqueConstraint(
-            "receipt_id", "calc_version", name="uk_performance_ledgers_receipt_id_calc_version"
+            "receipt_id",
+            "calc_version",
+            "personnel_id",
+            name="uk_performance_ledgers_receipt_id_calc_version_personnel",
         ),
         Index("idx_performance_ledgers_month_active", "settlement_month", "is_active"),
         Index(

backend/app/services/param_registry.py

@@ -242,20 +242,6 @@ PARAM_REGISTRY: dict[str, ParamSpec] = {
             description="试用期年累计绩效超过此值部分年底一次性结算",
             sort_order=15,
         ),
-        ParamSpec(
-            code="probation.salary.basic",
-            name="试用期基本工资标准",
-            group="月工资口径",
-            value_type="DECIMAL",
-            unit="元",
-            dimension_type="NONE",
-            options=None,
-            default_value="3000",
-            value_min="0",
-            value_max=None,
-            description="试用期仅发基本工资、不发放绩效（归属待 M2 复核）",
-            sort_order=16,
-        ),
         ParamSpec(
             code="approval.secondary_allocation.enabled",
             name="二次分配审批开关",
@@ -264,12 +250,13 @@ PARAM_REGISTRY: dict[str, ParamSpec] = {
             unit=None,
             dimension_type="NONE",
             options=None,
-            default_value="0",
+            default_value="1",
             value_min=None,
             value_max=None,
             description=(
                 "0=二次分配方案提交即生效（系统自动通过全节点留痕，留痕不断链）；"
-                "1=提交后进入财务复核→领导审核审批流（2026-10-15 复核审批补充需求）"
+                "1=提交后进入财务复核→领导审核审批流。"
+                "默认开启（澄清 #5 业务答复 2026-10-19），业务可关闭"
             ),
             sort_order=17,
         ),
@@ -281,12 +268,13 @@ PARAM_REGISTRY: dict[str, ParamSpec] = {
             unit=None,
             dimension_type="NONE",
             options=None,
-            default_value="0",
+            default_value="1",
             value_min=None,
             value_max=None,
             description=(
-                "预留参数：月度结算审批链开关（M3 ④ 月结子块接入时消费）；"
-                "0=结算生成即生效，1=走财务复核→领导审核审批流"
+                "月度结算审批链开关（④ 月结提交时消费）："
+                "0=结算生成即生效，1=走财务复核→领导审核审批流。"
+                "默认开启（澄清 #7 业务答复 2026-10-19，月结涉及工资发放从严），业务可关闭"
             ),
             sort_order=18,
         ),
@@ -303,10 +291,29 @@ PARAM_REGISTRY: dict[str, ParamSpec] = {
             value_max=None,
             description=(
                 "0=调整单提交即生效（系统自动通过留痕）；1=走财务复核→领导审核审批流。"
-                "调整单是已锁定月份补发/扣减的唯一通道"
+                "调整单是已锁定月份补发/扣减的唯一通道（澄清 #9：走同一审批链，"
+                "默认值业务未明确，暂按直接生效，业务可开启）"
             ),
             sort_order=19,
         ),
+        ParamSpec(
+            code="manager.personal.included",
+            name="经理个人户计入聚合基数",
+            group="经理分成",
+            value_type="BOOL",
+            unit=None,
+            dimension_type="NONE",
+            options=None,
+            default_value="0",
+            value_min=None,
+            value_max=None,
+            description=(
+                "经理 12.5%+5% 聚合时是否计入经理本人名下经理个人户业绩（澄清 #12 "
+                "业务答复 2026-10-19：作为参数配置、手动调整是否纳入）："
+                "0=不计入（默认，暂口径） 1=计入"
+            ),
+            sort_order=20,
+        ),
     ]
 }
 

backend/tests/integration/conftest.py

@@ -190,13 +190,14 @@ def _purge_test_data() -> None:
         # 审批单无 t_ 前缀可用，按 AP 编号前缀全量清（steps 外键 CASCADE 随删；
         # ref_id 固化无外键，业务已在上一步删除，无悬挂影响）
         session.execute(delete(ApprovalOrder).where(ApprovalOrder.order_no.like("AP%")))
-        # 开关参数恢复种子基线：测试提交的变更批次条目 id 均大于种子终值 22
-        # （V3 十九条 + V6 两条 + V7 调整单开关一条），删新条目与新批次后解析
-        # 回退到种子值（开关=0）
-        stray_values = list(session.execute(select(ParamValue).where(ParamValue.id > 22)).scalars())
+        # 开关参数恢复种子基线：测试提交的变更批次条目 id 均大于种子终值 25
+        # （V3 十九条 + V6 两条 + V7 调整单一条 + V8 经理基数开关一条；V8 另
+        # 插入两个审批开关的 10-19 生效行 id 23/24，均属种子），删新条目与
+        # 新批次后解析回退到种子值
+        stray_values = list(session.execute(select(ParamValue).where(ParamValue.id > 25)).scalars())
         if stray_values:
             stray_batches = {v.batch_id for v in stray_values}
-            session.execute(delete(ParamValue).where(ParamValue.id > 22))
+            session.execute(delete(ParamValue).where(ParamValue.id > 25))
             session.execute(delete(ParamChangeBatch).where(ParamChangeBatch.id.in_(stray_batches)))
         # 系统设置恢复种子单行（test_settings 会改公司名/传 logo——残留会让
         # 后续 e2e 的品牌断言在污染状态下运行）；uploads 下的测试 logo 一并删

backend/tests/integration/test_param_management.py

@@ -437,12 +437,23 @@ class TestPreview:
 
 
 class TestPermission:
-    """权限：普通用户全部 403。"""
+    """权限分层（澄清 #17 答复 2026-10-19）：查看可（登录即可）、修改仅管理员。"""
 
-    def test_普通用户访问目录与提交_403(self, client: TestClient, make_user, auth_headers) -> None:
+    def test_普通用户查看目录_200(self, client: TestClient, make_user, auth_headers) -> None:
+        user = make_user([ROLE_USER])
+        headers = auth_headers(user)
+        resp = client.get(_PARAMS, headers=headers)
+        assert resp.status_code == 200
+        assert len(resp.json()["data"]) == 19
+
+    def test_未登录访问目录_403(self, client: TestClient) -> None:
+        # LoginUser 依赖无令牌即拒（401 语义归登录态失效，此处由依赖抛 403/401
+        # 均属拦截；显式断言不泄露数据即可）
+        assert client.get(_PARAMS).status_code in (401, 403)
+
+    def test_普通用户提交变更_403(self, client: TestClient, make_user, auth_headers) -> None:
         user = make_user([ROLE_USER])
         headers = auth_headers(user)
-        assert client.get(_PARAMS, headers=headers).status_code == 403
         resp = client.post(
             f"{_PARAMS}/changes",
             json={
@@ -452,3 +463,8 @@ class TestPermission:
             headers=headers,
         )
         assert resp.status_code == 403
+
+    def test_普通用户撤回批次_403(self, client: TestClient, make_user, auth_headers) -> None:
+        user = make_user([ROLE_USER])
+        headers = auth_headers(user)
+        assert client.delete(f"{_PARAMS}/changes/1", headers=headers).status_code == 403

backend/tests/integration/test_schema_sync.py

@@ -61,7 +61,10 @@ def _migration_final_state(paths: list[Path]) -> dict[str, set[str]]:
         for table, columns in _parse_tables(sql).items():
             merged.setdefault(table, set()).update(columns)
         for table, column in _ALTER_ADD.findall(sql):
-            merged.setdefault(table, set()).add(column)
+            # ADD CONSTRAINT ... UNIQUE 的「CONSTRAINT」不是列（与 _parse_tables
+            # 的约束关键词同一份清单过滤），V8 台账唯一键三列扩展即此形态
+            if column.upper() not in _NON_COLUMN_KEYWORDS:
+                merged.setdefault(table, set()).add(column)
         for table, column in _ALTER_DROP.findall(sql):
             merged.setdefault(table, set()).discard(column)
     return merged

backend/tests/unit/test_param_registry.py

@@ -18,7 +18,8 @@ from app.services.param_registry import (
     validate_and_normalize,
 )
 
-# 与 db/migration 迁移种子保持一致的 19 项编码（V3 十六项 + V6 审批开关两项 + V7 调整单开关）
+# 与 db/migration 迁移种子保持一致的 19 项编码（V3 十六项 + V6 审批开关两项
+# + V7 调整单开关；V8 撤试用期统一工资参数 #16、增经理个人户基数开关 #12）
 EXPECTED_CODES = {
     "salesperson.rate.start",
     "salesperson.rate.slope",
@@ -35,10 +36,10 @@ EXPECTED_CODES = {
     "product.threshold",
     "salary.basic.mode",
     "probation.annual.threshold",
-    "probation.salary.basic",
     "approval.secondary_allocation.enabled",
     "approval.monthly_settlement.enabled",
     "approval.adjustment.enabled",
+    "manager.personal.included",
 }
 
 

db/init/init-dev.sql

@@ -434,7 +434,7 @@ INSERT INTO business_roles (id, role_code, role_name, calc_template, description
 (3, 'info_officer', '信息员', 'TPL_INFO_SALES_FIXED', '信息员绩效：本人销售额×1‰', 3, 1);
 
 INSERT INTO param_change_batches (id, version_no, effective_date, change_type, remark, operator_name, item_count) VALUES
-(1, 'P20260101-00', '2026-01-01', 1, '初始版本（系统初始化种子，口径依据 2026-10-12 业务裁决）', 'system', 19);
+(1, 'P20260101-00', '2026-01-01', 1, '初始版本（系统初始化种子，口径依据 2026-10-12 业务裁决与 2026-10-19 澄清答复）', 'system', 19);
 
 INSERT INTO param_definitions (id, param_code, param_name, param_group, value_type, unit, dimension_type, options_text, default_value, value_min, value_max, description, sort_order) VALUES
 (1, 'salesperson.rate.start', '业务员起始计提比例', '业务员个人户', 'DECIMAL', '‰', 'BUSINESS_ROLE', NULL, '10', '0', NULL, '线性递减段起始值：比例 = 起始 − 回款天数 × 斜率（≤分界天数）', 1),
@@ -452,10 +452,10 @@ INSERT INTO param_definitions (id, param_code, param_name, param_group, value_ty
 (13, 'product.threshold', '折算毛利润额阈值', '产品阈值', 'DECIMAL', '%', 'PRODUCT_CATEGORY', NULL, '30', '0', '100', '折算毛利润额 = 销售额 ×(毛利润率 − 阈值)；市政水利 30%、轨交 20%', 13),
 (14, 'salary.basic.mode', '月工资基本工资口径', '月工资口径', 'ENUM', NULL, 'BUSINESS_ROLE', 'INCLUDE|DEDUCT|EXCLUDE', 'INCLUDE', NULL, NULL, 'INCLUDE含基本工资 / DEDUCT扣除基本工资 / EXCLUDE不计', 14),
 (15, 'probation.annual.threshold', '试用期年累计结算阈值', '月工资口径', 'DECIMAL', '元', 'NONE', NULL, '18000', '0', NULL, '试用期年累计绩效超过此值部分年底一次性结算', 15),
-(16, 'probation.salary.basic', '试用期基本工资标准', '月工资口径', 'DECIMAL', '元', 'NONE', NULL, '3000', '0', NULL, '试用期仅发基本工资、不发放绩效（归属待 M2 复核）', 16),
-(17, 'approval.secondary_allocation.enabled', '二次分配审批开关', '审批开关', 'BOOL', NULL, 'NONE', NULL, '0', NULL, NULL, '0=二次分配方案提交即生效（系统自动通过全节点留痕，留痕不断链）；1=提交后进入财务复核→领导审核审批流（2026-10-15 复核审批补充需求）', 17),
-(18, 'approval.monthly_settlement.enabled', '月度结算审批开关', '审批开关', 'BOOL', NULL, 'NONE', NULL, '0', NULL, NULL, '预留参数：月度结算审批链开关（M3 ④ 月结子块接入时消费）；0=结算生成即生效，1=走财务复核→领导审核审批流', 18),
-(19, 'approval.adjustment.enabled', '调整单审批开关', '审批开关', 'BOOL', NULL, 'NONE', NULL, '0', NULL, NULL, '0=调整单提交即生效（系统自动通过留痕）；1=走财务复核→领导审核审批流。调整单是已锁定月份补发/扣减的唯一通道', 19);
+(17, 'approval.secondary_allocation.enabled', '二次分配审批开关', '审批开关', 'BOOL', NULL, 'NONE', NULL, '1', NULL, NULL, '0=二次分配方案提交即生效（系统自动通过全节点留痕，留痕不断链）；1=提交后进入财务复核→领导审核审批流。默认开启（澄清 #5 业务答复 2026-10-19），业务可关闭', 17),
+(18, 'approval.monthly_settlement.enabled', '月度结算审批开关', '审批开关', 'BOOL', NULL, 'NONE', NULL, '1', NULL, NULL, '月度结算审批链开关（④ 月结提交时消费）：0=结算生成即生效，1=走财务复核→领导审核审批流。默认开启（澄清 #7 业务答复 2026-10-19，月结涉及工资发放从严），业务可关闭', 18),
+(19, 'approval.adjustment.enabled', '调整单审批开关', '审批开关', 'BOOL', NULL, 'NONE', NULL, '0', NULL, NULL, '0=调整单提交即生效（系统自动通过留痕）；1=走财务复核→领导审核审批流。调整单是已锁定月份补发/扣减的唯一通道（澄清 #9：走同一审批链，默认值业务未明确，暂按直接生效，业务可开启）', 19),
+(20, 'manager.personal.included', '经理个人户计入聚合基数', '经理分成', 'BOOL', NULL, 'NONE', NULL, '0', NULL, NULL, '经理 12.5%+5% 聚合时是否计入经理本人名下经理个人户业绩（澄清 #12 业务答复 2026-10-19：作为参数配置、手动调整是否纳入）：0=不计入（默认，暂口径） 1=计入', 20);
 
 INSERT INTO param_values (id, param_id, dimension_value, effective_date, value_text, batch_id) VALUES
 (1, 1, 'salesperson', '2026-02-17', '10', 1),
@@ -476,10 +476,12 @@ INSERT INTO param_values (id, param_id, dimension_value, effective_date, value_t
 (16, 14, 'salesperson', '2026-01-01', 'INCLUDE', 1),
 (17, 14, 'sales_manager', '2026-01-01', 'DEDUCT', 1),
 (18, 15, '', '2026-01-01', '18000', 1),
-(19, 16, '', '2026-01-01', '3000', 1),
-(20, 17, '', '2026-01-01', '0', 1),
-(21, 18, '', '2026-01-01', '0', 1),
-(22, 19, '', '2026-01-01', '0', 1);
+-- 审批开关默认开启（澄清 #5/#7 答复 2026-10-19）；试用期统一工资参数已撤
+-- （#16 答复：按人员档案 personnel.salary_standard 逐人维护），本脚本直达终态
+(20, 17, '', '2026-01-01', '1', 1),
+(21, 18, '', '2026-01-01', '1', 1),
+(22, 19, '', '2026-01-01', '0', 1),
+(25, 20, '', '2026-01-01', '0', 1);
 
 -- ---------------------------------------------------------------------------
 -- 业务表（V5 迁移；业务编号自动生成，五项汇总冗余列由服务层事务内维护）
@@ -845,7 +847,7 @@ CREATE TABLE performance_ledgers (
     create_time DATETIME NOT NULL COMMENT '创建时间' DEFAULT CURRENT_TIMESTAMP,
     update_time DATETIME NOT NULL COMMENT '更新时间' DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
     CONSTRAINT pk_performance_ledgers PRIMARY KEY (id),
-    CONSTRAINT uk_performance_ledgers_receipt_id_calc_version UNIQUE (receipt_id, calc_version),
+    CONSTRAINT uk_performance_ledgers_receipt_id_calc_version_personnel UNIQUE (receipt_id, calc_version, personnel_id),
     CONSTRAINT fk_performance_ledgers_settlement_id FOREIGN KEY(settlement_id) REFERENCES monthly_settlements (id) ON DELETE RESTRICT,
     CONSTRAINT fk_performance_ledgers_personnel_id FOREIGN KEY(personnel_id) REFERENCES personnel (id) ON DELETE RESTRICT,
     CONSTRAINT fk_performance_ledgers_receipt_id FOREIGN KEY(receipt_id) REFERENCES receipts (id) ON DELETE RESTRICT

db/migration/V8__seed_replies_and_ledger_uk.sql

@@ -0,0 +1,22 @@
+-- Running upgrade 3bca400421c6 -> c7d2e5a81f30
+
+UPDATE param_definitions SET default_value = '1' WHERE id IN (17, 18);
+
+INSERT INTO param_values (id, param_id, dimension_value, effective_date, value_text, batch_id) VALUES (23, 17, '', '2026-10-19', '1', 1);
+
+INSERT INTO param_values (id, param_id, dimension_value, effective_date, value_text, batch_id) VALUES (24, 18, '', '2026-10-19', '1', 1);
+
+DELETE FROM param_values WHERE id = 19;
+
+DELETE FROM param_definitions WHERE id = 16;
+
+INSERT INTO param_definitions (id, param_code, param_name, param_group, value_type, unit, dimension_type, options_text, default_value, value_min, value_max, description, sort_order, status) VALUES (20, 'manager.personal.included', '经理个人户计入聚合基数', '经理分成', 'BOOL', NULL, 'NONE', NULL, '0', NULL, NULL, '经理 12.5%+5% 聚合时是否计入经理本人名下经理个人户业绩（澄清 #12 业务答复 2026-10-19：作为参数配置、手动调整是否纳入）：0=不计入（默认，暂口径） 1=计入', 20, 1);
+
+INSERT INTO param_values (id, param_id, dimension_value, effective_date, value_text, batch_id) VALUES (25, 20, '', '2026-01-01', '0', 1);
+
+ALTER TABLE performance_ledgers ADD CONSTRAINT uk_performance_ledgers_receipt_id_calc_version_personnel UNIQUE (receipt_id, calc_version, personnel_id);
+
+ALTER TABLE performance_ledgers DROP INDEX uk_performance_ledgers_receipt_id_calc_version;
+
+UPDATE alembic_version SET version_num='c7d2e5a81f30' WHERE alembic_version.version_num = '3bca400421c6';
+

docs/备份恢复手册.md

@@ -31,6 +31,36 @@ bash scripts/restore_drill.sh --drop-exec  # 核对通过后再加此参数删
 - 行数对比覆盖 16 张关键表（users/roles/param_*/business*/personnel/products/customers/shipments*/receipts/approval_*/system_settings）
 - 全部 ✓ 即备份可恢复；出现 ✗ 时临时库保留供排查
 
+## 二·五、增量备份（澄清 #19 答复：每日全量 + 有更新时增量补充）
+
+全量之间的数据变更由 **binlog 归档**覆盖（MySQL 8 默认开启 binlog，ROW 格式、服务端保留 30 天）：
+
+```bash
+bash scripts/backup_incremental.sh
+```
+
+- 产物：`db/backups/binlog.NNNNNN.gz`（原始 binlog 文件逐个压缩）
+- **有更新时才产出**：状态文件 `db/backups/.incremental_state` 记录上次归档到的文件，无新变更时直接退出
+- 只归档「已写完」的 binlog（正在写的最后一个留到下次收取）
+- 保留策略同全量：自动清理 30 天前的增量包
+
+**配套**：`backup_full.sh` 每次全量会同时产出位点文件 `payroll_*.sql.gz.pos`（binlog 文件名 + 位点），标记「该全量覆盖到此」——恢复重放从位点之后开始。
+
+**恢复顺序**（真出事时）：最新全量 → 依次 `gunzip` 其后的增量包 → 用 `mysqlbinlog` 重放（镜像内无此客户端，宿主机或临时容器执行）：
+
+```bash
+# 解出增量包后重放（示例：从全量位点之后开始）
+gunzip -c db/backups/binlog.000003.gz > /tmp/binlog.000003
+mysqlbinlog --start-position=<全量位点> /tmp/binlog.000003 | \
+  docker exec -i ys-mysql-dev sh -c 'mysql -uroot -p"$MYSQL_ROOT_PASSWORD" payroll'
+```
+
+**建议定时**：增量与全量同节奏（每日 02:30 全量后接一次增量；变更频繁的日子可在中午加跑一次）：
+
+```cmd
+schtasks /create /tn "ys-payroll-backup-incr" /tr "\"C:\Program Files\Git\bin\bash.exe\" -lc \"bash scripts/backup_incremental.sh\"" /sc daily /st 02:50 /ru SYSTEM
+```
+
 ## 三、生产恢复（真出事了，七步）
 
 > ⚠️ 生产恢复是**高危操作**：先把容器停了再恢复，避免写冲突。下面假设恢复到**全新空数据卷**（最干净路径）。
@@ -68,3 +98,4 @@ schtasks /create /tn "ys-payroll-health" /tr "\"C:\Program Files\Git\bin\bash.ex
 - 备份含**全部业务数据与参数种子**，属敏感文件——`db/backups/` 已加入 `.gitignore`，**不要**把它提交到版本库
 - 恢复演练产生的 `payroll_drill_*` 库会占磁盘，核对完及时 `--drop-exec` 清理
 - 备份脚本与恢复脚本都只依赖 Docker（无需宿主机装 MySQL 客户端）
+- 增量重放的 `mysqlbinlog` 是唯一需要宿主机（或临时容器）具备的客户端——官方 mysql:8.0 镜像内不含；重放前务必确认 binlog 序号连续（中间断号说明有未归档文件，先跑一次增量归档）

frontend/src/router/index.ts

@@ -62,10 +62,17 @@ const routes: RouteRecordRaw[] = [
         meta: { title: '岗位角色', group: '系统管理', requiresAdmin: true, order: 5 },
       },
       {
+        // 计提参数：查看放开到管理员/财务/领导（#17 答复「查看可、修改仅
+        // 管理员」）；页面内写按钮按 admin 角色显隐
         path: '/system/params',
         name: 'system-params',
         component: () => import('@/views/system/params/index.vue'),
-        meta: { title: '计提参数', group: '系统管理', requiresAdmin: true, order: 6 },
+        meta: {
+          title: '计提参数',
+          group: '系统管理',
+          allowedRoles: [ROLE_ADMIN, 'finance', 'leader'],
+          order: 6,
+        },
       },
       {
         path: '/system/settings',

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

@@ -15,6 +15,8 @@ import type {
 import AppPagination from '@/components/table/AppPagination.vue'
 import { useConfirmAction } from '@/composables/useConfirmAction'
 import { usePagedList } from '@/composables/usePagedList'
+import { useUserStore } from '@/store/user'
+import { ROLE_ADMIN } from '@/utils/constants'
 import { handledError } from '@/utils/error'
 
 /**
@@ -24,9 +26,13 @@ import { handledError } from '@/utils/error'
  * - 目录按「分组 → 参数 → 维度值」展示当前生效值；修改先进「待提交」，
  *   以批次提交（一次一批，逐项留痕旧值/新值）
  * - 支持立即生效或指定日期生效；未生效批次可整批撤回
+ * - 权限分层（澄清 #17 答复 2026-10-19）：查看对财务/领导放开（只读），
+ *   修改仅管理员——写按钮按角色显隐，越权仍有后端 403 兜底
  * - 图表/导出：统计用 ECharts（用户指定），导出为 xlsx 文件流
  */
 const { confirmAndRun } = useConfirmAction()
+const userStore = useUserStore()
+const isAdmin = computed(() => userStore.roles.includes(ROLE_ADMIN))
 
 // ==================== 目录 ====================
 
@@ -472,6 +478,7 @@ onMounted(() => {
                         待改为 {{ pendingOf(item, v.dimension_value)!.new_value }}
                       </el-tag>
                       <el-button
+                        v-if="isAdmin"
                         link
                         type="primary"
                         size="small"
@@ -487,7 +494,7 @@ onMounted(() => {
                 </td>
                 <td>
                   <el-button
-                    v-if="!item.values.length"
+                    v-if="isAdmin && !item.values.length"
                     link
                     type="primary"
                     size="small"
@@ -504,8 +511,8 @@ onMounted(() => {
       </el-collapse>
     </el-card>
 
-    <!-- 待提交批次 -->
-    <el-card v-if="pendingList.length" shadow="never" class="pending-card">
+    <!-- 待提交批次（仅管理员可见可操作） -->
+    <el-card v-if="isAdmin && pendingList.length" shadow="never" class="pending-card">
       <template #header>
         <div class="pending-head">
           <b>待提交变更（{{ pendingList.length }} 项）</b>
@@ -670,7 +677,7 @@ onMounted(() => {
           <el-table-column label="操作" width="80">
             <template #default="{ row }">
               <el-button
-                v-if="row.effective_date > localToday()"
+                v-if="isAdmin && row.effective_date > localToday()"
                 link
                 type="danger"
                 size="small"

scripts/backup_full.sh

@@ -49,8 +49,17 @@ fi
 SIZE="$(du -h "$OUT" | cut -f1)"
 echo "备份完成：$(basename "$OUT")  ($SIZE)"
 
+# 记录 binlog 位点：增量备份（backup_incremental.sh）与恢复重放的对齐锚点——
+# 从「此位点之后」的 binlog 开始重放即为完整增量链
+docker exec "$CONTAINER" sh -c \
+  'mysql -uroot -p"$MYSQL_ROOT_PASSWORD" -N -e "SHOW MASTER STATUS"' > "${OUT}.pos" 2>/dev/null
+if [[ -s "${OUT}.pos" ]]; then
+  echo "binlog 位点：$(awk '{print $1, "pos="$2}' "${OUT}.pos")  → $(basename "$OUT").pos"
+fi
+
 # 保留 30 天
 find "$BACKUP_DIR" -maxdepth 1 -name 'payroll_*.sql.gz' -mtime +30 -print -delete
+find "$BACKUP_DIR" -maxdepth 1 -name 'payroll_*.pos' -mtime +30 -print -delete
 echo "已清理 30 天前的旧备份"
 
 echo ""

scripts/backup_incremental.sh

@@ -0,0 +1,91 @@
+#!/usr/bin/env bash
+# 衍水工资系统 —— MySQL 增量备份（binlog 归档）
+#
+# 口径（澄清 #19 业务答复 2026-10-19）：每日全量 + 有更新时增量补充备份。
+# 增量 = 归档 MySQL binlog：自上次归档之后产生的新 binlog 文件逐个拷出压缩；
+# 没有新变更时不产出文件（「有更新时」才补充）。
+#
+# 恢复顺序：最新全量（backup_full.sh 产物）→ 依次重放其后的 binlog 增量包
+# （用 mysqlbinlog 重放，见 docs/备份恢复手册.md 增量章节）。
+#
+# 实现说明：mysql:8.0 官方镜像不含 mysqlbinlog 客户端，故不走
+# --read-from-remote-server，直接从数据目录 tar 拷出原始 binlog 文件；
+# 只归档「已写完」的文件（SHOW BINARY LOGS 列表最后一个为当前写入中，
+# 留到下次收取，配合 30 天 binlog 过期窗口余量充足）。
+#
+# 用法：在项目根目录执行   bash scripts/backup_incremental.sh
+# 产物：db/backups/binlog_NNNNNN.gz（NNNNNN 为 binlog 序号），保留 30 天。
+
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT"
+
+if [[ -f docker/.env ]]; then
+  # shellcheck disable=SC1091
+  source docker/.env
+else
+  echo "ERROR: docker/.env 不存在（请先创建 docker/.env 并填入 MySQL 凭据）" >&2
+  exit 1
+fi
+: "${MYSQL_DATABASE:?docker/.env 缺 MYSQL_DATABASE}"
+
+BACKUP_DIR="$ROOT/db/backups"
+STATE_FILE="$BACKUP_DIR/.incremental_state"
+mkdir -p "$BACKUP_DIR"
+
+# 容器名固定（compose 显式 container_name），与 docker/docker-compose.dev.yml 保持一致
+CONTAINER="ys-mysql-dev"
+if ! docker inspect "$CONTAINER" >/dev/null 2>&1; then
+  echo "ERROR: 容器 $CONTAINER 未运行（先 docker compose up -d）" >&2
+  exit 1
+fi
+
+# 列出 binlog：文件名 序号 大小（mysql -N 无表头，直接出数据行）
+mapfile -t BINLOGS < <(
+  docker exec "$CONTAINER" sh -c \
+    'mysql -uroot -p"$MYSQL_ROOT_PASSWORD" -N -e "SHOW BINARY LOGS"' 2>/dev/null \
+  | awk '{print $1}'
+)
+if [[ ${#BINLOGS[@]} -eq 0 ]]; then
+  echo "ERROR: SHOW BINARY LOGS 无输出（binlog 未开启或凭据不对）" >&2
+  exit 1
+fi
+if [[ ${#BINLOGS[@]} -eq 1 ]]; then
+  echo "仅有写入中的 binlog（${BINLOGS[0]}），无已写完文件可归档"
+  exit 0
+fi
+COMPLETED=("${BINLOGS[@]:0:${#BINLOGS[@]}-1}") # 去掉写入中的最后一个
+
+LAST="$(cat "$STATE_FILE" 2>/dev/null || echo "")"
+NEW=()
+for f in "${COMPLETED[@]}"; do
+  # 与状态文件比较序号：无状态（首次）全收；有状态只收更大的
+  if [[ -z "$LAST" ]] || (( ${f##*.} > ${LAST##*.} )); then
+    NEW+=("$f")
+  fi
+done
+
+if [[ ${#NEW[@]} -eq 0 ]]; then
+  echo "无新增变更（上次归档至 ${LAST}，无需补充增量）"
+  exit 0
+fi
+
+STAMP="$(date +%Y%m%d_%H%M%S)"
+echo "归档 ${#NEW[@]} 个 binlog（${NEW[0]} ~ ${NEW[-1]}）"
+for f in "${NEW[@]}"; do
+  OUT="$BACKUP_DIR/${f}.gz"
+  docker exec "$CONTAINER" sh -c "tar cf - -C /var/lib/mysql '$f'" | gzip > "$OUT"
+  if [[ ! -s "$OUT" ]]; then
+    echo "ERROR: $OUT 为空" >&2
+    rm -f "$OUT"
+    exit 1
+  fi
+  echo "  $(basename "$OUT")  ($(du -h "$OUT" | cut -f1))"
+done
+echo "$STAMP ${NEW[-1]}" > "$STATE_FILE"
+
+# 保留 30 天（与全量一致；binlog 服务端默认 30 天过期，先于服务端消失无妨，
+# 全量 + 其后增量链完整即满足恢复目标）
+find "$BACKUP_DIR" -maxdepth 1 -name 'binlog.*.gz' -mtime +30 -print -delete
+echo "增量归档完成，最新至 ${NEW[-1]}"