1461a8d113
按 2026-11-02 需求补齐计划交付后端能力： - 角色授权：权限目录化，接口统一准入校验，未登记默认拒绝； 管理员判断改为按数据库角色重新判定，防止权限码持有者绕过 - 系统监控：单进程采集资源、请求与异常指标，分钟级聚合， 阈值配置化；敏感配置增加 repr 保护，Redis 密码 URL 转义 - 试用期计提：按回款日判定并写入快照，年度结清与调整单联动； 人员模型补试用期、离职日期与工资版本历史字段 - 计提模板：公式骨架受控，页面维护名称与参数绑定 - T+ 采集：自动化配置表与进度查询 内置角色禁停用保护对齐模块注释；核算规则版本提为常量并 补充批量核算失败堆栈日志。 影响范围：后端全部模块、数据库迁移 V22-V28 验证：uv run ruff check 通过；922 个单元测试全部通过； 集成测试因本机 MySQL 数据卷被其他容器锁定暂未运行
141 lines
5.7 KiB
Python
141 lines
5.7 KiB
Python
"""营销人员模型：人员档案、产品辐射区域与市场拓展计划。
|
||
|
||
- 岗位（business_role_id）决定计提公式模板，与工资标准同属「同步不覆盖」的
|
||
人工维护字段（对照表 #26 落地口径，表注释标注供 M4 同步模块遵守）
|
||
- manager_id 自引用表达「经理带团队」：NULL=经理本人或未分配；M3 经理
|
||
12.5% 聚合、M4 部门汇总均按该关系展开，无需独立团队表
|
||
- 一期营销人员不登录系统，不与 users 关联；若后续开放自助查工资再加列
|
||
"""
|
||
|
||
from datetime import date
|
||
from decimal import Decimal
|
||
|
||
from sqlalchemy import JSON, Date, ForeignKey, Numeric, String
|
||
from sqlalchemy.orm import Mapped, mapped_column
|
||
|
||
from app.models.base import (
|
||
BIGINT_UNSIGNED,
|
||
TINYINT_TYPE,
|
||
Base,
|
||
TimestampMixin,
|
||
TPlusSyncMixin,
|
||
mysql_table_args,
|
||
)
|
||
|
||
# personnel.status 的在职值（对照 BUSINESS_STATUS_* 集中在 models/business.py
|
||
# 的先例：状态语义单点导出，业务/客户两侧的归属校验共用，防魔数各自漂移）
|
||
PERSONNEL_STATUS_ACTIVE = 1
|
||
|
||
|
||
class Personnel(Base, TimestampMixin, TPlusSyncMixin):
|
||
"""营销人员表（需求 2.1.1）。
|
||
|
||
表名 personnel 为集合名词（单复数同形），本身即复数语义。
|
||
试用期人员绩效照算不发放（对照表 #17），is_probation 供 M3 区分。
|
||
"""
|
||
|
||
__tablename__ = "personnel"
|
||
__table_args__ = mysql_table_args("营销人员表（T+同步不覆盖岗位与工资标准）")
|
||
|
||
id: Mapped[int] = mapped_column(
|
||
BIGINT_UNSIGNED, primary_key=True, autoincrement=True, comment="主键ID"
|
||
)
|
||
personnel_name: Mapped[str] = mapped_column(String(64), nullable=False, comment="姓名")
|
||
business_role_id: Mapped[int] = mapped_column(
|
||
BIGINT_UNSIGNED,
|
||
ForeignKey("business_roles.id", ondelete="RESTRICT"),
|
||
nullable=False,
|
||
index=True,
|
||
comment="岗位角色ID（决定计提公式模板；T+同步不覆盖）",
|
||
)
|
||
manager_id: Mapped[int | None] = mapped_column(
|
||
BIGINT_UNSIGNED,
|
||
ForeignKey("personnel.id", ondelete="RESTRICT"),
|
||
index=True,
|
||
comment="直属营销经理ID（NULL=经理本人或未分配；团队成员关系锚点）",
|
||
)
|
||
phone: Mapped[str | None] = mapped_column(String(20), comment="联系电话")
|
||
hire_date: Mapped[date | None] = mapped_column(Date, comment="入职日期")
|
||
is_probation: Mapped[int] = mapped_column(
|
||
TINYINT_TYPE,
|
||
nullable=False,
|
||
server_default="0",
|
||
comment="是否试用期：1是 0否（试用期绩效照算不发放）",
|
||
)
|
||
probation_start_date: Mapped[date | None] = mapped_column(
|
||
Date, comment="试用期开始日（含当日）"
|
||
)
|
||
regularization_date: Mapped[date | None] = mapped_column(
|
||
Date, comment="转正生效日（当日不再属于试用期）"
|
||
)
|
||
resignation_date: Mapped[date | None] = mapped_column(
|
||
Date, comment="离职生效日（当日起不计基本工资）"
|
||
)
|
||
salary_standard: Mapped[Decimal | None] = mapped_column(
|
||
Numeric(12, 2), comment="月工资标准（元；T+同步不覆盖）"
|
||
)
|
||
salary_history_json: Mapped[list | None] = mapped_column(
|
||
JSON,
|
||
comment="工资标准、岗位及任职资料生效版本",
|
||
)
|
||
status: Mapped[int] = mapped_column(
|
||
TINYINT_TYPE,
|
||
nullable=False,
|
||
server_default="1",
|
||
comment="状态：1在职 0离职（离职人员不可再被业务/客户归属引用）",
|
||
)
|
||
remark: Mapped[str | None] = mapped_column(String(255), comment="备注")
|
||
|
||
|
||
class PersonnelRegion(Base, TimestampMixin):
|
||
"""产品辐射区域表（需求 2.1.1）：人员负责的产品辐射地理范围，1:N 子表。
|
||
|
||
随人员编辑整表替换维护，无独立管理诉求，故不加 T+ 预留列。
|
||
"""
|
||
|
||
__tablename__ = "personnel_regions"
|
||
__table_args__ = mysql_table_args("产品辐射区域表")
|
||
|
||
id: Mapped[int] = mapped_column(
|
||
BIGINT_UNSIGNED, primary_key=True, autoincrement=True, comment="主键ID"
|
||
)
|
||
personnel_id: Mapped[int] = mapped_column(
|
||
BIGINT_UNSIGNED,
|
||
ForeignKey("personnel.id", ondelete="RESTRICT"),
|
||
nullable=False,
|
||
index=True,
|
||
comment="人员ID（personnel.id）",
|
||
)
|
||
region_name: Mapped[str] = mapped_column(
|
||
String(128), nullable=False, comment="区域名称（产品辐射地理范围）"
|
||
)
|
||
remark: Mapped[str | None] = mapped_column(String(255), comment="备注")
|
||
|
||
|
||
class PersonnelPlan(Base, TimestampMixin):
|
||
"""市场拓展计划表（需求 2.1.1）：计划期间 + 计划内容 + 指标说明的自由条目。
|
||
|
||
结构化指标粒度待 T+ 字段映射确认，先以自由条目容器落地；条目最终由
|
||
T+ 同步确定，故预留 source_no 单列（无索引：查询按 personnel_id 走）。
|
||
"""
|
||
|
||
__tablename__ = "personnel_plans"
|
||
__table_args__ = mysql_table_args("市场拓展计划表")
|
||
|
||
id: Mapped[int] = mapped_column(
|
||
BIGINT_UNSIGNED, primary_key=True, autoincrement=True, comment="主键ID"
|
||
)
|
||
personnel_id: Mapped[int] = mapped_column(
|
||
BIGINT_UNSIGNED,
|
||
ForeignKey("personnel.id", ondelete="RESTRICT"),
|
||
nullable=False,
|
||
index=True,
|
||
comment="人员ID（personnel.id）",
|
||
)
|
||
plan_period: Mapped[str] = mapped_column(
|
||
String(32), nullable=False, comment="计划期间（如 2026Q1、2026-05）"
|
||
)
|
||
plan_content: Mapped[str] = mapped_column(String(500), nullable=False, comment="计划内容")
|
||
target_desc: Mapped[str | None] = mapped_column(String(255), comment="指标说明（文字描述）")
|
||
source_no: Mapped[str | None] = mapped_column(String(64), comment="T+ 原始条目号（预留）")
|