a3680f7d3e
- 修改pages目录下的Vue组件注释 - 修改api目录下的接口注释 - 修改mock目录下的模拟数据注释 - 修改utils/dataAdapter.js中的注释 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
188 lines
3.9 KiB
JavaScript
188 lines
3.9 KiB
JavaScript
/**
|
||
* API接口 - 评分模块
|
||
* 真实后端接口调用（需要后端实现）
|
||
*/
|
||
|
||
import request from '@/utils/request.js'
|
||
|
||
/**
|
||
* 获取扣分项列表
|
||
* @param {Object} params
|
||
* @param {String} params.projectId - 项目ID
|
||
* @returns {Promise}
|
||
*/
|
||
export function getDeductions(params) {
|
||
return request({
|
||
url: '/blade-martial/deductionItem/list',
|
||
method: 'GET',
|
||
params: {
|
||
...params,
|
||
current: 1,
|
||
size: 100
|
||
}
|
||
})
|
||
}
|
||
|
||
/**
|
||
* 提交评分
|
||
* @param {Object} data
|
||
* @param {String} data.athleteId - 选手ID
|
||
* @param {String} data.judgeId - 评委ID
|
||
* @param {Number} data.score - 评分
|
||
* @param {Array} data.deductions - 扣分项
|
||
* @param {String} data.note - 备注
|
||
* @returns {Promise}
|
||
*/
|
||
export function submitScore(data) {
|
||
return request({
|
||
url: '/mini/score/submit',
|
||
method: 'POST',
|
||
data,
|
||
showLoading: true,
|
||
loadingText: '提交中...'
|
||
})
|
||
}
|
||
|
||
/**
|
||
* 获取评分详情（主裁判查看）
|
||
* @param {Object} params
|
||
* @param {String} params.athleteId - 选手ID
|
||
* @returns {Promise}
|
||
*
|
||
* 注意：此接口需要后端实现
|
||
* 建议路径: GET /api/mini/score/detail/{athleteId}
|
||
*/
|
||
export function getScoreDetail(params) {
|
||
return request({
|
||
url: `/mini/score/detail/${params.athleteId}`,
|
||
method: 'GET',
|
||
showLoading: true
|
||
})
|
||
}
|
||
|
||
/**
|
||
* 修改评分（主裁判）
|
||
* @param {Object} data
|
||
* @param {String} data.athleteId - 选手ID
|
||
* @param {String} data.modifierId - 修改人ID
|
||
* @param {Number} data.modifiedScore - 修改后的分数
|
||
* @param {String} data.note - 修改原因
|
||
* @returns {Promise}
|
||
*
|
||
* 注意：此接口需要后端实现
|
||
* 建议路径: PUT /api/mini/score/modify
|
||
*/
|
||
export function modifyScore(data) {
|
||
return request({
|
||
url: '/api/mini/score/modify',
|
||
method: 'PUT',
|
||
data,
|
||
showLoading: true,
|
||
loadingText: '修改中...'
|
||
})
|
||
}
|
||
|
||
/**
|
||
* 获取选手列表
|
||
* @param {Object} params
|
||
* @param {String} params.judgeId - 裁判ID
|
||
* @param {Number} params.refereeType - 裁判类型（1-主裁判, 2-裁判员）
|
||
* @param {String} params.projectId - 项目ID（可选）
|
||
* @param {String} params.venueId - 场地ID（可选）
|
||
* @returns {Promise}
|
||
*
|
||
* 注意：此接口需要后端实现
|
||
* 建议路径: GET /api/mini/score/athletes
|
||
*/
|
||
export function getAthletes(params) {
|
||
return request({
|
||
url: '/api/mini/score/athletes',
|
||
method: 'GET',
|
||
params,
|
||
showLoading: true
|
||
})
|
||
}
|
||
|
||
export default {
|
||
getDeductions,
|
||
submitScore,
|
||
getScoreDetail,
|
||
modifyScore,
|
||
getAthletes
|
||
}
|
||
|
||
/**
|
||
* 后端接口规范（待实现）：
|
||
*
|
||
* 1. GET /api/mini/score/detail/{athleteId}
|
||
*
|
||
* 响应：
|
||
* {
|
||
* "code": 200,
|
||
* "success": true,
|
||
* "msg": "操作成功",
|
||
* "data": {
|
||
* "athleteInfo": {
|
||
* "athleteId": "1",
|
||
* "name": "张三",
|
||
* "idCard": "123456789000000000",
|
||
* "team": "少林寺武术大学院",
|
||
* "number": "123-4567898275",
|
||
* "totalScore": 8.907
|
||
* },
|
||
* "judgeScores": [
|
||
* {
|
||
* "judgeId": "1",
|
||
* "judgeName": "欧阳丽娜",
|
||
* "score": 8.907,
|
||
* "scoreTime": "2025-06-25 09:15:00",
|
||
* "note": ""
|
||
* }
|
||
* ],
|
||
* "modification": null
|
||
* }
|
||
* }
|
||
*
|
||
* SQL示例：
|
||
* SELECT
|
||
* s.judge_id AS judgeId,
|
||
* s.judge_name AS judgeName,
|
||
* s.score,
|
||
* s.score_time AS scoreTime,
|
||
* s.note
|
||
* FROM martial_score s
|
||
* WHERE s.athlete_id = #{athleteId}
|
||
* ORDER BY s.score_time ASC
|
||
*
|
||
* ---
|
||
*
|
||
* 2. PUT /api/mini/score/modify
|
||
*
|
||
* 请求：
|
||
* {
|
||
* "athleteId": "1",
|
||
* "modifierId": "789",
|
||
* "modifiedScore": 8.910,
|
||
* "note": "修改原因"
|
||
* }
|
||
*
|
||
* 响应：
|
||
* {
|
||
* "code": 200,
|
||
* "success": true,
|
||
* "msg": "修改成功",
|
||
* "data": {
|
||
* "athleteId": "1",
|
||
* "originalScore": 8.907,
|
||
* "modifiedScore": 8.910,
|
||
* "modifyTime": "2025-06-25 10:00:00"
|
||
* }
|
||
* }
|
||
*
|
||
* 实现逻辑：
|
||
* 1. 验证权限（只有主裁判可以修改）
|
||
* 2. 保存 originalScore（如果是第一次修改）
|
||
* 3. 更新 totalScore
|
||
* 4. 记录 modifyReason 和 modifyTime
|
||
*/
|