<?php

namespace App\Enums;

/**
 * CRM 病例标记位 ea_case_cstm.label_bit
 *
 * 对应 service 项目的 Eainc\Enum\Cases\LabelBitEnum。
 *
 * 数据流：
 *  1. CRM（service）通过 /case/update/bit 写入 ea_case_cstm.label_bit，
 *     并投递 case_basic_info_change 事件（携带 labelBit）；
 *  2. agent-be 的 CaseEventHandleService::fillCase 消费事件后写入
 *     cases.is_need_pfp = label_bit & DebtEnum::needMoney()，
 *     其中 needMoney() 是 configs 表 stuck_payment_reason 里所有 key 的按位或。
 *
 * 也就是说 is_need_pfp 并不是布尔值，而是「被 stuck_payment_reason 过滤后的卡款原因位图」。
 */
final class CaseLabelBit
{
    /** @var int bit0 允许 APP 授信放行（非卡款原因） */
    public const ALLOW_PROCESS_BY_HONEST = 1;

    /** @var int bit1 新病例订单卡生产 */
    public const APPLIANCE_NEED_MONEY = 2;

    /** @var int bit2 产品变更（升档）卡生产 */
    public const UPGRADE_NEED_MONEY = 4;

    /** @var int bit3 病例延期产品卡生产 */
    public const EXTENSION_NEED_MONEY = 8;

    /** @var array<int,string> CRM 侧原始位含义 */
    private const CRM_LABELS = [
        self::ALLOW_PROCESS_BY_HONEST => '允许APP授信放行',
        self::APPLIANCE_NEED_MONEY => '新病例订单卡生产',
        self::UPGRADE_NEED_MONEY => '产品变更卡生产',
        self::EXTENSION_NEED_MONEY => '病例延期卡生产',
    ];

    /** @var array<int,string> 面向用户的原因解释 */
    private const DESCRIPTIONS = [
        self::ALLOW_PROCESS_BY_HONEST => '允许 APP 走授信放行的开关，不属于卡款原因，不会计入 is_need_pfp',
        self::APPLIANCE_NEED_MONEY => '新病例订单款项未结清，CRM 把病例卡在生产前，需要代理在代理端确认进产',
        self::UPGRADE_NEED_MONEY => '病例做了产品变更（升档），差价款项未结清，需要代理确认进产后才会放行',
        self::EXTENSION_NEED_MONEY => '病例服务年限延期的费用未结清，需要先结清费用才能继续生产',
    ];

    public static function crmLabel(int $bit): string
    {
        return self::CRM_LABELS[$bit] ?? ('未知标记位 '.$bit);
    }

    public static function description(int $bit): string
    {
        return self::DESCRIPTIONS[$bit] ?? '未在 CRM 枚举中定义的标记位，需确认 CRM 是否新增了卡款原因';
    }

    /**
     * 拆出位图中所有置位的 bit
     *
     * @return int[]
     */
    public static function split(int $value): array
    {
        $bits = [];
        for ($bit = 1; $bit > 0 && $bit <= $value; $bit <<= 1) {
            if (($value & $bit) === $bit) {
                $bits[] = $bit;
            }
        }

        return $bits;
    }

    /**
     * 把位图翻译成可读文本，如「新病例订单卡生产 / 产品变更卡生产」
     */
    public static function toText(int $value): string
    {
        if ($value <= 0) {
            return '无标记';
        }

        return implode(' / ', array_map(
            static fn (int $bit): string => self::crmLabel($bit),
            self::split($value)
        ));
    }
}