"""
库存管理工具函数模块

提供进销存系统通用的工具函数，包括：
- 订单编号生成器（采购订单、销售订单、库存变动等）
"""
from datetime import datetime, timezone
import secrets


def generate_order_no(prefix: str) -> str:
    """生成订单编号
    
    Args:
        prefix: 订单类型前缀，如 PO（采购订单）、SO（销售订单）、SM（库存变动）
    
    Returns:
        格式为 {prefix}{YYYYMMDDHHMMSS}{8位随机字符} 的订单编号
    """
    date_str = datetime.now(timezone.utc).strftime("%Y%m%d%H%M%S")
    random_str = secrets.token_hex(4).upper()
    return f"{prefix}{date_str}{random_str}"