1461a8d113
按 2026-11-02 需求补齐计划交付后端能力： - 角色授权：权限目录化，接口统一准入校验，未登记默认拒绝； 管理员判断改为按数据库角色重新判定，防止权限码持有者绕过 - 系统监控：单进程采集资源、请求与异常指标，分钟级聚合， 阈值配置化；敏感配置增加 repr 保护，Redis 密码 URL 转义 - 试用期计提：按回款日判定并写入快照，年度结清与调整单联动； 人员模型补试用期、离职日期与工资版本历史字段 - 计提模板：公式骨架受控，页面维护名称与参数绑定 - T+ 采集：自动化配置表与进度查询 内置角色禁停用保护对齐模块注释；核算规则版本提为常量并 补充批量核算失败堆栈日志。 影响范围：后端全部模块、数据库迁移 V22-V28 验证：uv run ruff check 通过；922 个单元测试全部通过； 集成测试因本机 MySQL 数据卷被其他容器锁定暂未运行
112 lines
3.7 KiB
Python
112 lines
3.7 KiB
Python
"""正式工资资料、FIFO核算和逐段明细入口。"""
|
|
|
|
from typing import Annotated
|
|
|
|
from fastapi import APIRouter, Path, Query
|
|
from fastapi.responses import Response
|
|
from pydantic import BaseModel, Field
|
|
|
|
from app.api.deps import DbSession, LoginUser, PayrollWriter, RequestMetaDep
|
|
from app.core.response import PageQuery, ok
|
|
from app.schemas.payroll import AllocationAdjustmentIn, PayrollMonthIn, PayrollSetupIn
|
|
from app.services import payroll_calculation, payroll_inputs, payroll_months, settlement_service
|
|
|
|
router = APIRouter(prefix="/payroll", tags=["正式工资核算"])
|
|
|
|
|
|
class ProbationAdjustmentIn(BaseModel):
|
|
personnel_id: int = Field(ge=1)
|
|
year: str = Field(pattern=r"^20\d{2}$")
|
|
fingerprint: str = Field(min_length=64, max_length=64)
|
|
reason: str = Field(min_length=1, max_length=255)
|
|
|
|
|
|
@router.post("/probation/adjustments")
|
|
def probation_adjustment(payload: ProbationAdjustmentIn, session: DbSession, actor: PayrollWriter, meta: RequestMetaDep):
|
|
from app.services.probation_service import adjustment as apply
|
|
|
|
return ok(apply(session, payload, actor, meta))
|
|
|
|
|
|
@router.get("/probation")
|
|
def probation_preview(session: DbSession, _: LoginUser, month: str, personnel_id: int | None = None):
|
|
from app.services import probation_service
|
|
|
|
return ok(probation_service.preview(session, month, personnel_id))
|
|
|
|
|
|
@router.get("/probation/export")
|
|
def probation_export(session: DbSession, _: LoginUser, month: str):
|
|
from app.services import probation_service
|
|
|
|
return Response(probation_service.export(session, month),
|
|
media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
|
|
headers={"Content-Disposition": 'attachment; filename="probation_balances.xlsx"'})
|
|
|
|
|
|
@router.get("/salary-export/{month}")
|
|
def salary_export(month: str, session: DbSession, _: LoginUser):
|
|
from app.core.month import validate_month
|
|
from app.services.salary_completion import export_settlement
|
|
|
|
validate_month(month)
|
|
return Response(export_settlement(session, month),
|
|
media_type="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
|
|
headers={"Content-Disposition": 'attachment; filename="monthly_salary.xlsx"'})
|
|
|
|
|
|
@router.get("/months/{month}")
|
|
def month_state(
|
|
month: Annotated[str, Path(pattern=r"^20[0-9]{2}-(0[1-9]|1[0-2])$")],
|
|
session: DbSession,
|
|
_: LoginUser,
|
|
):
|
|
return ok(payroll_months.month_state(session, month))
|
|
|
|
|
|
@router.get("/businesses/{business_id}/input")
|
|
def input_detail(business_id: int, session: DbSession, _: LoginUser):
|
|
return ok(payroll_inputs.detail(session, business_id))
|
|
|
|
|
|
@router.post("/businesses/{business_id}/input")
|
|
def save_input(
|
|
business_id: int,
|
|
payload: PayrollSetupIn,
|
|
session: DbSession,
|
|
actor: PayrollWriter,
|
|
meta: RequestMetaDep,
|
|
):
|
|
return ok(payroll_inputs.setup(session, business_id, payload, actor, meta))
|
|
|
|
|
|
@router.post("/businesses/{business_id}/calculate")
|
|
def calculate(
|
|
business_id: int,
|
|
payload: PayrollMonthIn,
|
|
session: DbSession,
|
|
actor: PayrollWriter,
|
|
meta: RequestMetaDep,
|
|
):
|
|
return ok(
|
|
payroll_calculation.calculate(
|
|
session, business_id, payload.month, operator=actor, meta=meta, reason=payload.reason
|
|
)
|
|
)
|
|
|
|
|
|
@router.get("/ledger/{ledger_id}/allocations")
|
|
def allocations(
|
|
ledger_id: int, query: Annotated[PageQuery, Query()], session: DbSession, _: LoginUser
|
|
):
|
|
return ok(payroll_calculation.allocation_page(session, ledger_id, query))
|
|
|
|
|
|
@router.post("/allocation-adjustments")
|
|
def adjustment(
|
|
payload: AllocationAdjustmentIn, session: DbSession, actor: PayrollWriter, meta: RequestMetaDep
|
|
):
|
|
return ok(
|
|
settlement_service.create_allocation_adjustment(session, payload, operator=actor, meta=meta)
|
|
)
|