# -*- coding: utf-8 -*-
"""
hr-system 系统支撑模块（ocai 口径）。

本模块承载权限、日志、工作台与员工服务提醒等横切能力。当前批次交付
审计底座（T09 / F12）：

- write_audit_log    全量写操作公共入口（供 hr-org/hr-roster/hr-flow/
                      hr-contract/hr-report 等模块直接调用）
- audit_log_list     操作日志查询（时间/类型/操作人筛选）
- audit_log_detail   操作日志详情（前后值对比）
- mask_*             敏感字段脱敏（身份证前3后3 / 手机前3后4）

契约：models/hr_system/sys_audit_log.json（已冻结，只增表）。
端点：/hrsystem/api/audit_log_list.dspy、/hrsystem/api/audit_log_detail.dspy。
"""

from .audit import (  # noqa: F401
    AUDIT_OP,
    HANDLERS,
    audit_log_detail,
    audit_log_list,
    mask_id_number,
    mask_json,
    mask_mobile,
    mask_value,
    write_audit_log,
)

__all__ = [
    "AUDIT_OP",
    "HANDLERS",
    "audit_log_detail",
    "audit_log_list",
    "mask_id_number",
    "mask_json",
    "mask_mobile",
    "mask_value",
    "write_audit_log",
]


def register(server_env):
    """在 ahserver ServerEnv 中注册横切公共函数与端点。

    server_env 为 ahserver 的 ServerEnv 实例，register_func / register_handler
    为约定的注册方法（不同 ahserver 版本方法名可能为 add_func / add_handler，
    由 T02 脚手架统一适配）。
    """
    server_env.register_func("write_audit_log", write_audit_log)
    server_env.register_func("mask_id_number", mask_id_number)
    server_env.register_func("mask_mobile", mask_mobile)
    server_env.register_func("mask_json", mask_json)
    for name, fn in HANDLERS.items():
        server_env.register_handler(name, fn)
    return True