package com.ruoyi.other.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.ruoyi.common.core.web.domain.AjaxResult;
import com.ruoyi.other.api.domain.TGroupCompany;

import java.math.BigDecimal;

/**
 * <p>
 * 公司（企业）管理 服务类
 * </p>
 *
 * @author mxcd
 * @since 2026-09-22
 */
public interface TGroupCompanyService extends IService<TGroupCompany> {

    /**
     * 公司详情（企业概况附带车队数量、本月充值金额统计）
     *
     * @param id 公司ID
     * @return 公司详情；公司不存在时返回 null
     */
    TGroupCompany getDetail(Integer id);

    /**
     * 公司详情并聚合充电用户信息（VIN码/刷卡/白名单三类合并列表）。
     * 仅供管理后台公司详情接口使用；远程 remoteGet 保持 getDetail 不聚合，避免跨服务循环调用。
     *
     * @param id 公司ID
     * @return 公司详情（含充电用户信息列表）
     */
    TGroupCompany getDetailWithChargingUsers(Integer id);

    /**
     * 添加公司并同步创建登录账号（sys_user，roleType=5）
     *
     * @param company 公司（含账号、密码）
     * @return 操作结果
     */
    AjaxResult addCompany(TGroupCompany company);

    /**
     * 编辑公司并同步登录账号资料（不修改密码）
     *
     * @param company 公司
     * @return 操作结果
     */
    AjaxResult editCompany(TGroupCompany company);

    /**
     * 删除公司并停用其登录账号（delFlag=2）
     *
     * @param id 公司ID
     * @return 操作结果
     */
    AjaxResult delCompany(Integer id);

    /**
     * 修改公司账户模式（公司管理-账户模式弹窗使用）
     *
     * @param id          公司ID
     * @param accountMode 账户模式（1=共享模式，2=分配模式）
     * @return 操作结果
     */
    AjaxResult updateAccountMode(Integer id, Integer accountMode);

    /**
     * 结算公司余额（解锁锁定额并按实际消费扣减，允许扣成负数）
     * <p>订单号非空时按订单号幂等：公司余额变更与账户侧消费流水配套写入，
     * 结算失败回退订单状态后的补偿重试不会重复结算。</p>
     *
     * @param companyId    公司ID
     * @param lockedAmount 申请时锁定额（用于释放）
     * @param actualAmount 实际消费金额
     * @param orderCode    充电订单号（幂等键，可为空）
     * @param userInfo     分配对象（共享模式为企业名称）
     * @param userName     分配对象名称
     * @param remark       备注
     * @return 结算后可用余额
     */
    BigDecimal settleBalance(Integer companyId, BigDecimal lockedAmount, BigDecimal actualAmount, String orderCode,
                             String userInfo, String userName, String remark);

}