package org.springblade.modules.martial.service;

import com.baomidou.mybatisplus.extension.service.IService;
import org.springblade.modules.martial.excel.ResultExportExcel;
import org.springblade.modules.martial.pojo.entity.MartialResult;
import org.springblade.modules.martial.pojo.vo.CertificateVO;

import java.math.BigDecimal;
import java.util.List;

/**
 * Result 服务类
 *
 * @author BladeX
 */
public interface IMartialResultService extends IService<MartialResult> {

	/**
	 * 计算有效平均分（去掉最高分和最低分）
	 */
	BigDecimal calculateValidAverageScore(Long athleteId, Long projectId);

	/**
	 * 应用难度系数
	 */
	BigDecimal applyDifficultyCoefficient(BigDecimal averageScore, Long projectId);

	/**
	 * 计算最终成绩
	 */
	MartialResult calculateFinalScore(Long athleteId, Long projectId);

	/**
	 * 自动排名
	 */
	void autoRanking(Long projectId);

	/**
	 * 分配奖牌
	 */
	void assignMedals(Long projectId);

	/**
	 * 成绩复核
	 */
	void reviewResult(Long resultId, String reviewNote, BigDecimal adjustment);

	/**
	 * 发布成绩
	 */
	void publishResults(Long projectId);

	/**
	 * 撤销发布
	 */
	void unpublishResults(Long projectId);

	/**
	 * Task 3.1: 导出成绩单
	 */
	List<ResultExportExcel> exportResults(Long competitionId, Long projectId);

	/**
	 * Task 3.4: 生成证书数据
	 */
	CertificateVO generateCertificateData(Long resultId);

	/**
	 * Task 3.4: 批量生成证书数据
	 */
	List<CertificateVO> batchGenerateCertificates(Long projectId);

}
