crm-backend-matt/crm-lead/src/main/java/com/crm/lead/constant/LeadConstants.java

package com.crm.lead.constant;

/**
 * 线索模块常量
 */
public interface LeadConstants {

    /*-------- 线索状态（7 态，ticket 03 定稿）---------*/

    int STATUS_UNDISTRIBUTED = 1;  // 未分发
    int STATUS_PENDING = 2;        // 待领取
    int STATUS_CLAIMED = 3;        // 已领取
    int STATUS_FOLLOWING = 4;      // 跟进中
    int STATUS_CONVERTED = 5;      // 已转商机（终态）
    int STATUS_EXPIRED = 6;        // 过期失效
    int STATUS_VOID = 7;           // 线索作废

    /*-------- 反馈情况（独立字段，不进状态机）---------*/

    int FEEDBACK_VALID = 1;    // 有效
    int FEEDBACK_INVALID = 2;  // 无效
    int FEEDBACK_NONE = 3;     // 未反馈

    /*-------- 反馈记录状态（lead_feedback，Amendment 2）---------*/

    int FEEDBACK_RECORD_DRAFT = 1;     // 草稿
    int FEEDBACK_RECORD_SUBMITTED = 2; // 已提交

    /*-------- 字典分组 code（对齐 crm-dict 内置种子，frontend-integration 票据 02）---------*/

    String DICT_GROUP_LEAD_SOURCE = "lead_source";
    String DICT_GROUP_BRAND = "brand";
    String DICT_GROUP_PRODUCT = "product";
    String DICT_GROUP_SCENE = "scene";

    /*-------- 列偏好 scopeKey（预留，尚未接线）---------
     * 线索四视图列偏好的作用范围键，每菜单独立（参 crm-preference/CONTEXT.md 「scope」）。
     * scope_key 由业务方（crm-lead）约定稳定 code，crm-preference 仅作不透明字符串存储、不持有语义。
     * 消费点：线索列表接入列偏好时的 crm-lead controller（尚未实现）。
     * 依赖方向：crm-lead → crm-preference 单向，故 crm-preference 不得反向引用本常量（否则成环）。
     */

    String SCOPE_PUBLIC_POOL = "lead.public_pool";
    String SCOPE_MY_LEAD = "lead.my_lead";
    String SCOPE_MY_FOLLOW = "lead.my_follow";
    String SCOPE_MANAGE = "lead.manage";

    /*-------- 业务错误码（65xxx）--------*/

    int CODE_LEAD_INVALID = 65001;
    int CODE_LEAD_NOT_EXIST = 65002;
    int CODE_STATUS_NOT_ALLOWED = 65003;
    int CODE_NOT_OWNER = 65004;
    int CODE_CLAIM_RULE_DENIED = 65005;
    int CODE_DAILY_CLAIM_EXCEEDED = 65006;
    int CODE_HOLD_LIMIT_EXCEEDED = 65007;
    int CODE_CONVERT_FAILED = 65008;
    int CODE_LEAD_CONVERTED = 65009;  // 已转商机，不可删/改
    int CODE_CAS_FAIL = 65010;        // 乐观锁冲突
}