108bf87225
补齐源快照、资料预演、正式导入及工资核算的依赖链路。 新增版本化输入、逐段 FIFO、生成锁和结构化当月调整， 并提供默认关闭的周期采集、有限重试及 Windows 托管。 原始客户资料、私有配置及首页改动不纳入本次提交。 BREAKING CHANGE: 升级前需应用新增迁移，并通过 PAYROLL_MAKER_USER_ID 绑定实际工资制作人，否则业务只读。 旧单批次核算默认关闭；历史兼容需显式启用 PAYROLL_ALLOW_LEGACY_CALCULATION。生产启用和真实金额待验收。
74 lines
2.8 KiB
Python
74 lines
2.8 KiB
Python
"""管理员管理 T+ 只读任务；长任务交给独立 worker 执行。"""
|
|
|
|
from typing import Annotated
|
|
|
|
from fastapi import APIRouter, Path, Query
|
|
|
|
from app.api.deps import DbSession, PayrollWriter, RequestMetaDep, WorkbenchReader
|
|
from app.api.v1.system.tplus_workbench import router as workbench_router
|
|
from app.core.response import ApiResponse, PageResult, ok
|
|
from app.schemas.tplus import (
|
|
TPlusBatchDetailOut,
|
|
TPlusBatchOut,
|
|
TPlusBatchQuery,
|
|
TPlusCreateIn,
|
|
TPlusErrorOut,
|
|
TPlusErrorQuery,
|
|
TPlusOverviewOut,
|
|
TPlusRetryIn,
|
|
)
|
|
from app.services.tplus import query_service, task_service
|
|
|
|
router = APIRouter(prefix="/tplus", tags=["系统管理 · T+ 数据同步"])
|
|
router.include_router(workbench_router)
|
|
BatchNumber = Annotated[str, Path(min_length=1, max_length=32, pattern=r"^[A-Za-z0-9_-]+$")]
|
|
|
|
|
|
@router.get("/overview", response_model=ApiResponse[TPlusOverviewOut])
|
|
def overview(session: DbSession, _: WorkbenchReader):
|
|
"""查询配置状态、任务统计和最近核验。"""
|
|
return ok(query_service.overview(session))
|
|
|
|
|
|
@router.get("/batches", response_model=ApiResponse[PageResult[TPlusBatchOut]])
|
|
def batches(session: DbSession, _: WorkbenchReader, query: Annotated[TPlusBatchQuery, Query()]):
|
|
"""分页查询批次元数据。"""
|
|
return ok(query_service.list_batches(session, query))
|
|
|
|
|
|
@router.get("/batches/{batch_no}", response_model=ApiResponse[TPlusBatchDetailOut])
|
|
def detail(session: DbSession, _: WorkbenchReader, batch_no: BatchNumber):
|
|
"""查询批次详情与受控的核验报告。"""
|
|
return ok(query_service.get_batch(session, batch_no))
|
|
|
|
|
|
@router.get("/batches/{batch_no}/errors", response_model=ApiResponse[PageResult[TPlusErrorOut]])
|
|
def errors(
|
|
session: DbSession,
|
|
_: WorkbenchReader,
|
|
batch_no: BatchNumber,
|
|
query: Annotated[TPlusErrorQuery, Query()],
|
|
):
|
|
"""分页查询异常定位和固定错误说明。"""
|
|
return ok(query_service.list_errors(session, batch_no, query))
|
|
|
|
|
|
@router.post("/batches", response_model=ApiResponse[TPlusBatchDetailOut])
|
|
def create(session: DbSession, admin: PayrollWriter, meta: RequestMetaDep, payload: TPlusCreateIn):
|
|
"""将读取或核验任务持久化排队。"""
|
|
batch = task_service.create_task(session, payload, task_service.TaskActor(admin, meta))
|
|
return ok(query_service.get_batch(session, batch.batch_no))
|
|
|
|
|
|
@router.post("/batches/{batch_no}/retry", response_model=ApiResponse[TPlusBatchDetailOut])
|
|
def retry(
|
|
session: DbSession,
|
|
admin: PayrollWriter,
|
|
meta: RequestMetaDep,
|
|
batch_no: BatchNumber,
|
|
payload: TPlusRetryIn,
|
|
):
|
|
"""新建重试批次，保留原批次与异常历史。"""
|
|
batch = task_service.retry_task(session, batch_no, payload, task_service.TaskActor(admin, meta))
|
|
return ok(query_service.get_batch(session, batch.batch_no))
|