298 lines
9.8 KiB
Java
298 lines
9.8 KiB
Java
/*
|
|
* 自然写教学资源管理与内容分发系统软件 V1.0
|
|
* controller/DotCodeController.java - 点阵码生成API
|
|
* controller/AuditController.java - 内容审核API
|
|
*/
|
|
package com.writech.resource.controller;
|
|
|
|
import java.util.*;
|
|
import java.util.logging.Logger;
|
|
|
|
/**
|
|
* 点阵码生成控制器
|
|
*
|
|
* 提供点阵码资源的生成、查询、绑定等API接口。
|
|
* 点阵码是自然写系统的核心技术资源。
|
|
*/
|
|
public class DotCodeController {
|
|
|
|
private static final Logger logger =
|
|
Logger.getLogger(DotCodeController.class.getName());
|
|
|
|
/**
|
|
* 生成点阵码资源包 POST /api/v1/dotcode/generate
|
|
*
|
|
* 为指定资源(字帖/试卷/课件)生成配套的点阵码。
|
|
* 点阵码ID全局唯一分配,生成后可叠加到PDF模板上。
|
|
*/
|
|
public Map<String, Object> generateDotCode(Map<String, Object> request) {
|
|
String resourceId = (String) request.get("resource_id");
|
|
int pageCount = (int) request.getOrDefault("page_count", 1);
|
|
double pageWidth = (double) request.getOrDefault("page_width", 210.0);
|
|
double pageHeight = (double) request.getOrDefault("page_height", 297.0);
|
|
boolean overlay = (boolean) request.getOrDefault("overlay_on_template", false);
|
|
|
|
logger.info(String.format(
|
|
"点阵码生成请求: resource=%s, pages=%d, size=%.0fx%.0f, overlay=%b",
|
|
resourceId, pageCount, pageWidth, pageHeight, overlay
|
|
));
|
|
|
|
// 参数校验
|
|
if (resourceId == null || resourceId.isEmpty()) {
|
|
Map<String, Object> err = new HashMap<>();
|
|
err.put("code", 400);
|
|
err.put("message", "resource_id不能为空");
|
|
return err;
|
|
}
|
|
if (pageCount < 1 || pageCount > 500) {
|
|
Map<String, Object> err = new HashMap<>();
|
|
err.put("code", 400);
|
|
err.put("message", "页数须在1-500之间");
|
|
return err;
|
|
}
|
|
|
|
// 调用点阵码生成服务
|
|
// DotCodeService.DotCodeGenerateRequest genReq = new DotCodeService.DotCodeGenerateRequest();
|
|
// genReq.setResourceId(resourceId);
|
|
// genReq.setPageCount(pageCount);
|
|
// DotCodeService.DotCodeGenerateResult result = dotCodeService.generateDotCodes(genReq);
|
|
|
|
Map<String, Object> result = new HashMap<>();
|
|
result.put("code", 0);
|
|
result.put("message", "点阵码生成成功");
|
|
result.put("data", Map.of(
|
|
"resource_id", resourceId,
|
|
"page_count", pageCount,
|
|
"dot_code_ids", new ArrayList<>(),
|
|
"output_file_url", ""
|
|
));
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* 查询点阵码绑定信息 GET /api/v1/dotcode/binding/{dotCodeId}
|
|
*
|
|
* 根据点阵码ID查询其绑定的资源和页面信息。
|
|
* 用于点阵笔采集到坐标后定位到具体页面。
|
|
*/
|
|
public Map<String, Object> queryBinding(long dotCodeId) {
|
|
logger.info("查询点阵码绑定: dotCodeId=" + dotCodeId);
|
|
|
|
// DotCodeBinding binding = dotCodeService.queryBinding(dotCodeId);
|
|
// if (binding == null) {
|
|
// return errorResponse(404, "点阵码绑定信息不存在");
|
|
// }
|
|
|
|
Map<String, Object> result = new HashMap<>();
|
|
result.put("code", 0);
|
|
result.put("data", Map.of(
|
|
"dot_code_id", dotCodeId,
|
|
"resource_id", "",
|
|
"page_index", 0,
|
|
"area_type", "full_page",
|
|
"area", Map.of("x", 0, "y", 0, "width", 210, "height", 297)
|
|
));
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* 查询资源关联的所有点阵码 GET /api/v1/dotcode/resource/{resourceId}
|
|
*/
|
|
public Map<String, Object> queryByResource(String resourceId) {
|
|
logger.info("查询资源点阵码: resource=" + resourceId);
|
|
|
|
// List<DotCodeBinding> bindings = dotCodeService.queryByResourceId(resourceId);
|
|
|
|
Map<String, Object> result = new HashMap<>();
|
|
result.put("code", 0);
|
|
result.put("data", Map.of(
|
|
"resource_id", resourceId,
|
|
"bindings", new ArrayList<>()
|
|
));
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* 撤销点阵码绑定 DELETE /api/v1/dotcode/binding/{dotCodeId}
|
|
*
|
|
* 撤销后该点阵码ID可被重新分配。
|
|
* 仅管理员可执行此操作。
|
|
*/
|
|
public Map<String, Object> revokeBinding(long dotCodeId, String operatorId) {
|
|
logger.info(String.format(
|
|
"撤销点阵码绑定: dotCodeId=%d, operator=%s", dotCodeId, operatorId
|
|
));
|
|
|
|
// dotCodeService.revokeBinding(dotCodeId);
|
|
|
|
Map<String, Object> result = new HashMap<>();
|
|
result.put("code", 0);
|
|
result.put("message", "点阵码绑定已撤销");
|
|
return result;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 内容审核控制器
|
|
*
|
|
* 提供资源内容审核的完整流程API:
|
|
* - 待审核资源列表查询
|
|
* - 审核通过/驳回/退回操作
|
|
* - 批量审核
|
|
* - 审核记录查询
|
|
* - 审核统计仪表盘
|
|
*/
|
|
class AuditController {
|
|
|
|
private static final Logger logger =
|
|
Logger.getLogger(AuditController.class.getName());
|
|
|
|
/**
|
|
* 获取待审核资源列表 GET /api/v1/resource/audit/pending
|
|
*
|
|
* 按上传时间排序,支持按类型和学科过滤。
|
|
*/
|
|
public Map<String, Object> getPendingList(
|
|
String type,
|
|
String subject,
|
|
int page,
|
|
int pageSize
|
|
) {
|
|
logger.info(String.format(
|
|
"待审核列表: type=%s, subject=%s, page=%d", type, subject, page
|
|
));
|
|
|
|
// 查询MySQL: status = 'PENDING'
|
|
// List<Resource> pending = resourceMapper.selectByStatus("PENDING", type, subject, page, pageSize);
|
|
// int total = resourceMapper.countByStatus("PENDING", type, subject);
|
|
|
|
Map<String, Object> result = new HashMap<>();
|
|
result.put("code", 0);
|
|
result.put("data", Map.of(
|
|
"total", 0,
|
|
"page", page,
|
|
"items", new ArrayList<>()
|
|
));
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* 执行审核操作 PUT /api/v1/resource/audit/{id}
|
|
*
|
|
* 审核通过后资源自动进入CDN分发,可被终端检索下载。
|
|
* 驳回后通知上传者修改。
|
|
*/
|
|
public Map<String, Object> performAudit(
|
|
String resourceId,
|
|
Map<String, Object> auditData
|
|
) {
|
|
String action = (String) auditData.get("action");
|
|
String comment = (String) auditData.get("comment");
|
|
String auditorId = (String) auditData.get("auditor_id");
|
|
|
|
logger.info(String.format(
|
|
"审核操作: resource=%s, action=%s, auditor=%s",
|
|
resourceId, action, auditorId
|
|
));
|
|
|
|
// 校验审核动作合法性
|
|
Set<String> validActions = new HashSet<>(Arrays.asList(
|
|
"APPROVE", "REJECT", "RETURN"
|
|
));
|
|
if (!validActions.contains(action)) {
|
|
Map<String, Object> err = new HashMap<>();
|
|
err.put("code", 400);
|
|
err.put("message", "不合法的审核操作: " + action);
|
|
return err;
|
|
}
|
|
|
|
// 调用审核服务
|
|
// AuditService.AuditRequest req = new AuditService.AuditRequest();
|
|
// req.setResourceId(resourceId);
|
|
// req.setAction(AuditService.AuditAction.valueOf(action));
|
|
// req.setComment(comment);
|
|
// req.setAuditorId(auditorId);
|
|
// return auditService.performAudit(req);
|
|
|
|
Map<String, Object> result = new HashMap<>();
|
|
result.put("code", 0);
|
|
result.put("message", "审核操作成功");
|
|
result.put("data", Map.of(
|
|
"resource_id", resourceId,
|
|
"action", action,
|
|
"new_status", "APPROVE".equals(action) ? "APPROVED" : "REJECTED"
|
|
));
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* 批量审核 POST /api/v1/resource/audit/batch
|
|
*/
|
|
public Map<String, Object> batchAudit(Map<String, Object> batchRequest) {
|
|
List<String> resourceIds = (List<String>) batchRequest.get("resource_ids");
|
|
String action = (String) batchRequest.get("action");
|
|
String comment = (String) batchRequest.get("comment");
|
|
String auditorId = (String) batchRequest.get("auditor_id");
|
|
|
|
logger.info(String.format(
|
|
"批量审核: count=%d, action=%s", resourceIds.size(), action
|
|
));
|
|
|
|
// return auditService.batchAudit(resourceIds, action, comment, auditorId);
|
|
|
|
Map<String, Object> result = new HashMap<>();
|
|
result.put("code", 0);
|
|
result.put("data", Map.of(
|
|
"total", resourceIds.size(),
|
|
"success", resourceIds.size(),
|
|
"failed", 0
|
|
));
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* 查询审核记录 GET /api/v1/resource/audit/records
|
|
*/
|
|
public Map<String, Object> getAuditRecords(
|
|
String resourceId,
|
|
String auditorId,
|
|
int page,
|
|
int pageSize
|
|
) {
|
|
logger.info(String.format(
|
|
"审核记录查询: resource=%s, auditor=%s", resourceId, auditorId
|
|
));
|
|
|
|
// return auditService.queryAuditRecords(resourceId, auditorId, page, pageSize);
|
|
|
|
Map<String, Object> result = new HashMap<>();
|
|
result.put("code", 0);
|
|
result.put("data", Map.of(
|
|
"total", 0,
|
|
"page", page,
|
|
"items", new ArrayList<>()
|
|
));
|
|
return result;
|
|
}
|
|
|
|
/**
|
|
* 审核统计仪表盘 GET /api/v1/resource/audit/stats
|
|
*
|
|
* 返回待审核数量、今日已审核数量、通过率等统计。
|
|
*/
|
|
public Map<String, Object> getAuditStats() {
|
|
// return auditService.getAuditStats();
|
|
|
|
Map<String, Object> result = new HashMap<>();
|
|
result.put("code", 0);
|
|
result.put("data", Map.of(
|
|
"pending_count", 0,
|
|
"approved_today", 0,
|
|
"rejected_today", 0,
|
|
"approval_rate", 0.0,
|
|
"avg_audit_hours", 0.0
|
|
));
|
|
return result;
|
|
}
|
|
}
|