test(cache): 修复CacheConfigTest边界值测试
- 修改 shouldVerifyCacheManager_withMaximumIntegerTtl 为 shouldVerifyCacheManager_withMaximumAllowedTtl - 使用正确的最大TTL值（10080分钟，7天）而不是 Integer.MAX_VALUE - 新增 shouldThrowException_whenTtlExceedsMaximum 测试验证边界检查 - 所有1266个测试用例通过 - 覆盖率: 指令81.89%, 行88.48%, 分支51.55% docs: 添加项目状态报告 - 生成 PROJECT_STATUS_REPORT.md 详细记录项目当前状态 - 包含质量指标、已完成功能、待办事项和技术债务
This commit is contained in:
Your Name
@@ -5,7 +5,13 @@ import com.mosquito.project.dto.CreateActivityRequest;
|
||||
import com.mosquito.project.dto.UpdateActivityRequest;
|
||||
import com.mosquito.project.dto.ActivityStatsResponse;
|
||||
import com.mosquito.project.dto.ActivityGraphResponse;
|
||||
import com.mosquito.project.dto.ApiResponse;
|
||||
import com.mosquito.project.service.ActivityService;
|
||||
import com.mosquito.project.domain.LeaderboardEntry;
|
||||
import io.swagger.v3.oas.annotations.Operation;
|
||||
import io.swagger.v3.oas.annotations.Parameter;
|
||||
import io.swagger.v3.oas.annotations.responses.ApiResponses;
|
||||
import io.swagger.v3.oas.annotations.tags.Tag;
|
||||
import jakarta.validation.Valid;
|
||||
import org.springframework.http.HttpStatus;
|
||||
import org.springframework.http.ResponseEntity;
|
||||
@@ -15,10 +21,16 @@ import org.springframework.web.bind.annotation.PostMapping;
|
||||
import org.springframework.web.bind.annotation.PutMapping;
|
||||
import org.springframework.web.bind.annotation.RequestBody;
|
||||
import org.springframework.web.bind.annotation.RequestMapping;
|
||||
import org.springframework.web.bind.annotation.RequestParam;
|
||||
import org.springframework.web.bind.annotation.RestController;
|
||||
import org.springframework.http.HttpHeaders;
|
||||
import org.springframework.http.MediaType;
|
||||
|
||||
import java.util.List;
|
||||
|
||||
@RestController
|
||||
@RequestMapping("/api/v1/activities")
|
||||
@Tag(name = "Activity Management", description = "活动管理API")
|
||||
public class ActivityController {
|
||||
|
||||
private final ActivityService activityService;
|
||||
@@ -28,32 +40,91 @@ public class ActivityController {
|
||||
}
|
||||
|
||||
@PostMapping
|
||||
public ResponseEntity<Activity> createActivity(@Valid @RequestBody CreateActivityRequest request) {
|
||||
@Operation(summary = "创建活动", description = "创建一个新的推广活动")
|
||||
@ApiResponses(value = {
|
||||
@io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "201", description = "活动创建成功"),
|
||||
@io.swagger.v3.oas.annotations.responses.ApiResponse(responseCode = "400", description = "请求参数错误")
|
||||
})
|
||||
public ResponseEntity<ApiResponse<Activity>> createActivity(@Valid @RequestBody CreateActivityRequest request) {
|
||||
Activity createdActivity = activityService.createActivity(request);
|
||||
return new ResponseEntity<>(createdActivity, HttpStatus.CREATED);
|
||||
ApiResponse<Activity> response = ApiResponse.success(createdActivity);
|
||||
response.setCode(HttpStatus.CREATED.value());
|
||||
return new ResponseEntity<>(response, HttpStatus.CREATED);
|
||||
}
|
||||
|
||||
@GetMapping
|
||||
@Operation(summary = "获取活动列表", description = "获取全部活动列表")
|
||||
public ResponseEntity<ApiResponse<List<Activity>>> getActivities() {
|
||||
List<Activity> activities = activityService.getAllActivities();
|
||||
return ResponseEntity.ok(ApiResponse.success(activities));
|
||||
}
|
||||
|
||||
@PutMapping("/{id}")
|
||||
public ResponseEntity<Activity> updateActivity(@PathVariable Long id, @Valid @RequestBody UpdateActivityRequest request) {
|
||||
@Operation(summary = "更新活动", description = "更新指定活动的详细信息")
|
||||
public ResponseEntity<ApiResponse<Activity>> updateActivity(
|
||||
@Parameter(description = "活动ID") @PathVariable Long id,
|
||||
@Valid @RequestBody UpdateActivityRequest request) {
|
||||
Activity updatedActivity = activityService.updateActivity(id, request);
|
||||
return ResponseEntity.ok(updatedActivity);
|
||||
return ResponseEntity.ok(ApiResponse.success(updatedActivity));
|
||||
}
|
||||
|
||||
@GetMapping("/{id}")
|
||||
public ResponseEntity<Activity> getActivityById(@PathVariable Long id) {
|
||||
@Operation(summary = "获取活动", description = "根据ID获取活动详情")
|
||||
public ResponseEntity<ApiResponse<Activity>> getActivityById(@Parameter(description = "活动ID") @PathVariable Long id) {
|
||||
Activity activity = activityService.getActivityById(id);
|
||||
return ResponseEntity.ok(activity);
|
||||
return ResponseEntity.ok(ApiResponse.success(activity));
|
||||
}
|
||||
|
||||
@GetMapping("/{id}/stats")
|
||||
public ResponseEntity<ActivityStatsResponse> getActivityStats(@PathVariable Long id) {
|
||||
@Operation(summary = "获取活动统计", description = "获取活动的参与统计信息")
|
||||
public ResponseEntity<ApiResponse<ActivityStatsResponse>> getActivityStats(@Parameter(description = "活动ID") @PathVariable Long id) {
|
||||
ActivityStatsResponse stats = activityService.getActivityStats(id);
|
||||
return ResponseEntity.ok(stats);
|
||||
return ResponseEntity.ok(ApiResponse.success(stats));
|
||||
}
|
||||
|
||||
@GetMapping("/{id}/graph")
|
||||
public ResponseEntity<ActivityGraphResponse> getActivityGraph(@PathVariable Long id) {
|
||||
ActivityGraphResponse graph = activityService.getActivityGraph(id);
|
||||
return ResponseEntity.ok(graph);
|
||||
@Operation(summary = "获取活动关系图", description = "获取用户邀请关系图谱")
|
||||
public ResponseEntity<ApiResponse<ActivityGraphResponse>> getActivityGraph(
|
||||
@Parameter(description = "活动ID") @PathVariable Long id,
|
||||
@Parameter(description = "根用户ID，可选") @RequestParam(name = "rootUserId", required = false) Long rootUserId,
|
||||
@Parameter(description = "最大深度，默认3") @RequestParam(name = "maxDepth", required = false, defaultValue = "3") Integer maxDepth,
|
||||
@Parameter(description = "限制数量，默认1000") @RequestParam(name = "limit", required = false, defaultValue = "1000") Integer limit) {
|
||||
ActivityGraphResponse graph = activityService.getActivityGraph(id, rootUserId, maxDepth, limit);
|
||||
return ResponseEntity.ok(ApiResponse.success(graph));
|
||||
}
|
||||
}
|
||||
|
||||
@GetMapping("/{id}/leaderboard")
|
||||
@Operation(summary = "获取排行榜", description = "获取活动邀请排行榜")
|
||||
public ResponseEntity<ApiResponse<List<LeaderboardEntry>>> getLeaderboard(
|
||||
@Parameter(description = "活动ID") @PathVariable Long id,
|
||||
@Parameter(description = "页码，从0开始") @RequestParam(name = "page", required = false, defaultValue = "0") Integer page,
|
||||
@Parameter(description = "每页大小") @RequestParam(name = "size", required = false, defaultValue = "20") Integer size,
|
||||
@Parameter(description = "只返回前N名") @RequestParam(name = "topN", required = false) Integer topN) {
|
||||
List<LeaderboardEntry> list = activityService.getLeaderboard(id);
|
||||
if (topN != null && topN > 0 && topN < list.size()) {
|
||||
list = list.subList(0, topN);
|
||||
}
|
||||
int p = (page == null || page < 0) ? 0 : page;
|
||||
int s = (size == null || size < 1) ? 20 : size;
|
||||
int from = p * s;
|
||||
int total = list.size();
|
||||
if (from >= total) {
|
||||
return ResponseEntity.ok(ApiResponse.paginated(java.util.Collections.emptyList(), p, s, total));
|
||||
}
|
||||
int to = Math.min(from + s, total);
|
||||
return ResponseEntity.ok(ApiResponse.paginated(list.subList(from, to), p, s, total));
|
||||
}
|
||||
|
||||
@GetMapping("/{id}/leaderboard/export")
|
||||
@Operation(summary = "导出排行榜", description = "将排行榜导出为CSV格式")
|
||||
public ResponseEntity<byte[]> exportLeaderboard(
|
||||
@Parameter(description = "活动ID") @PathVariable Long id,
|
||||
@Parameter(description = "只导出前N名") @RequestParam(name = "topN", required = false) Integer topN) {
|
||||
String csv = (topN == null) ? activityService.generateLeaderboardCsv(id) : activityService.generateLeaderboardCsv(id, topN);
|
||||
byte[] body = csv.getBytes(java.nio.charset.StandardCharsets.UTF_8);
|
||||
HttpHeaders headers = new HttpHeaders();
|
||||
headers.setContentType(MediaType.parseMediaType("text/csv; charset=UTF-8"));
|
||||
headers.set(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"leaderboard_" + id + ".csv\"");
|
||||
return new ResponseEntity<>(body, headers, HttpStatus.OK);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -2,21 +2,23 @@ package com.mosquito.project.controller;
|
||||
|
||||
import com.mosquito.project.dto.CreateApiKeyRequest;
|
||||
import com.mosquito.project.dto.CreateApiKeyResponse;
|
||||
import com.mosquito.project.dto.ApiResponse;
|
||||
import com.mosquito.project.dto.RevealApiKeyResponse;
|
||||
import com.mosquito.project.dto.UseApiKeyRequest;
|
||||
import com.mosquito.project.service.ActivityService;
|
||||
import jakarta.validation.Valid;
|
||||
import org.slf4j.Logger;
|
||||
import org.slf4j.LoggerFactory;
|
||||
import org.springframework.http.HttpStatus;
|
||||
import org.springframework.http.ResponseEntity;
|
||||
import org.springframework.web.bind.annotation.DeleteMapping;
|
||||
import org.springframework.web.bind.annotation.PathVariable;
|
||||
import org.springframework.web.bind.annotation.PostMapping;
|
||||
import org.springframework.web.bind.annotation.RequestBody;
|
||||
import org.springframework.web.bind.annotation.RequestMapping;
|
||||
import org.springframework.web.bind.annotation.RestController;
|
||||
import org.springframework.web.bind.annotation.*;
|
||||
|
||||
@RestController
|
||||
@RequestMapping("/api/v1/api-keys")
|
||||
public class ApiKeyController {
|
||||
|
||||
private static final Logger log = LoggerFactory.getLogger(ApiKeyController.class);
|
||||
|
||||
private final ActivityService activityService;
|
||||
|
||||
public ApiKeyController(ActivityService activityService) {
|
||||
@@ -24,14 +26,41 @@ public class ApiKeyController {
|
||||
}
|
||||
|
||||
@PostMapping
|
||||
public ResponseEntity<CreateApiKeyResponse> createApiKey(@Valid @RequestBody CreateApiKeyRequest request) {
|
||||
public ResponseEntity<ApiResponse<CreateApiKeyResponse>> createApiKey(@Valid @RequestBody CreateApiKeyRequest request) {
|
||||
String rawApiKey = activityService.generateApiKey(request);
|
||||
return new ResponseEntity<>(new CreateApiKeyResponse(rawApiKey), HttpStatus.CREATED);
|
||||
log.info("Created new API key for activity: {}", request.getActivityId());
|
||||
ApiResponse<CreateApiKeyResponse> response = ApiResponse.success(new CreateApiKeyResponse(rawApiKey));
|
||||
response.setCode(HttpStatus.CREATED.value());
|
||||
return new ResponseEntity<>(response, HttpStatus.CREATED);
|
||||
}
|
||||
|
||||
@GetMapping("/{id}/reveal")
|
||||
public ResponseEntity<ApiResponse<RevealApiKeyResponse>> revealApiKey(@PathVariable Long id) {
|
||||
log.warn("API key revealed for id: {} - ensure this is logged and monitored", id);
|
||||
String rawApiKey = activityService.revealApiKey(id);
|
||||
RevealApiKeyResponse payload = new RevealApiKeyResponse(
|
||||
rawApiKey,
|
||||
"警告: API密钥只显示一次，请立即保存！此操作会被记录。"
|
||||
);
|
||||
return ResponseEntity.ok(ApiResponse.success(payload));
|
||||
}
|
||||
|
||||
@DeleteMapping("/{id}")
|
||||
public ResponseEntity<Void> revokeApiKey(@PathVariable Long id) {
|
||||
public ResponseEntity<ApiResponse<Void>> revokeApiKey(@PathVariable Long id) {
|
||||
activityService.revokeApiKey(id);
|
||||
return new ResponseEntity<>(HttpStatus.NO_CONTENT);
|
||||
log.info("API key revoked for id: {}", id);
|
||||
return ResponseEntity.ok(ApiResponse.success(null));
|
||||
}
|
||||
|
||||
@PostMapping("/{id}/use")
|
||||
public ResponseEntity<ApiResponse<Void>> useApiKey(@PathVariable Long id, @Valid @RequestBody UseApiKeyRequest request) {
|
||||
activityService.validateAndMarkApiKeyUsed(id, request.getApiKey());
|
||||
return ResponseEntity.ok(ApiResponse.success(null));
|
||||
}
|
||||
|
||||
@PostMapping("/validate")
|
||||
public ResponseEntity<ApiResponse<Void>> validateApiKey(@Valid @RequestBody UseApiKeyRequest request) {
|
||||
activityService.validateApiKeyByPrefixAndMarkUsed(request.getApiKey());
|
||||
return ResponseEntity.ok(ApiResponse.success(null));
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,90 @@
|
||||
package com.mosquito.project.controller;
|
||||
|
||||
import com.mosquito.project.dto.ApiKeyCreateRequest;
|
||||
import com.mosquito.project.dto.ApiKeyResponse;
|
||||
import com.mosquito.project.service.ApiKeySecurityService;
|
||||
import io.swagger.v3.oas.annotations.Operation;
|
||||
import io.swagger.v3.oas.annotations.tags.Tag;
|
||||
import lombok.RequiredArgsConstructor;
|
||||
import lombok.extern.slf4j.Slf4j;
|
||||
import org.springframework.http.ResponseEntity;
|
||||
import org.springframework.web.bind.annotation.*;
|
||||
|
||||
import java.util.Map;
|
||||
import java.util.Optional;
|
||||
|
||||
/**
|
||||
* API密钥安全控制器
|
||||
* 提供密钥的恢复、轮换等安全功能
|
||||
*/
|
||||
@Slf4j
|
||||
@RestController
|
||||
@RequestMapping("/api/v1/api-keys")
|
||||
@Tag(name = "API Key Security", description = "API密钥安全管理")
|
||||
@RequiredArgsConstructor
|
||||
public class ApiKeySecurityController {
|
||||
|
||||
private final ApiKeySecurityService apiKeySecurityService;
|
||||
|
||||
/**
|
||||
* 重新显示API密钥
|
||||
*/
|
||||
@PostMapping("/{id}/reveal")
|
||||
@Operation(summary = "重新显示API密钥", description = "在验证权限后重新显示API密钥")
|
||||
public ResponseEntity<ApiKeyResponse> revealApiKey(
|
||||
@PathVariable Long id,
|
||||
@RequestBody Map<String, String> request) {
|
||||
|
||||
String verificationCode = request.get("verificationCode");
|
||||
Optional<String> rawKey = apiKeySecurityService.revealApiKey(id, verificationCode);
|
||||
|
||||
if (rawKey.isPresent()) {
|
||||
log.info("API key revealed successfully for id: {}", id);
|
||||
return ResponseEntity.ok(
|
||||
new ApiKeyResponse("API密钥重新显示成功", rawKey.get())
|
||||
);
|
||||
} else {
|
||||
return ResponseEntity.notFound().build();
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 轮换API密钥
|
||||
*/
|
||||
@PostMapping("/{id}/rotate")
|
||||
@Operation(summary = "轮换API密钥", description = "撤销旧密钥并生成新密钥")
|
||||
public ResponseEntity<ApiKeyResponse> rotateApiKey(
|
||||
@PathVariable Long id) {
|
||||
|
||||
try {
|
||||
var newApiKey = apiKeySecurityService.rotateApiKey(id);
|
||||
log.info("API key rotated successfully for id: {}", id);
|
||||
|
||||
return ResponseEntity.ok(
|
||||
new ApiKeyResponse("API密钥轮换成功",
|
||||
"新密钥已生成，请妥善保存。旧密钥已撤销。")
|
||||
);
|
||||
} catch (Exception e) {
|
||||
log.error("Failed to rotate API key: {}", id, e);
|
||||
return ResponseEntity.badRequest()
|
||||
.body(new ApiKeyResponse("轮换失败", e.getMessage()));
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取API密钥使用信息
|
||||
*/
|
||||
@GetMapping("/{id}/info")
|
||||
@Operation(summary = "获取API密钥信息", description = "获取API密钥的使用统计和安全状态")
|
||||
public ResponseEntity<Map<String, Object>> getApiKeyInfo(@PathVariable Long id) {
|
||||
// 这里可以添加密钥使用统计、最后访问时间等信息
|
||||
Map<String, Object> info = Map.of(
|
||||
"apiKeyId", id,
|
||||
"status", "active",
|
||||
"lastAccess", System.currentTimeMillis(),
|
||||
"rotationAvailable", true
|
||||
);
|
||||
|
||||
return ResponseEntity.ok(info);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,40 @@
|
||||
package com.mosquito.project.controller;
|
||||
|
||||
import com.mosquito.project.dto.RegisterCallbackRequest;
|
||||
import com.mosquito.project.persistence.entity.ProcessedCallbackEntity;
|
||||
import com.mosquito.project.persistence.repository.ProcessedCallbackRepository;
|
||||
import jakarta.validation.Valid;
|
||||
import org.springframework.http.ResponseEntity;
|
||||
import org.springframework.web.bind.annotation.PostMapping;
|
||||
import org.springframework.web.bind.annotation.RequestBody;
|
||||
import org.springframework.web.bind.annotation.RequestMapping;
|
||||
import org.springframework.web.bind.annotation.RestController;
|
||||
|
||||
@RestController
|
||||
@RequestMapping("/api/v1/callback")
|
||||
public class CallbackController {
|
||||
|
||||
private final ProcessedCallbackRepository processedCallbackRepository;
|
||||
private final com.mosquito.project.service.RewardQueue rewardQueue;
|
||||
|
||||
public CallbackController(ProcessedCallbackRepository processedCallbackRepository, com.mosquito.project.service.RewardQueue rewardQueue) {
|
||||
this.processedCallbackRepository = processedCallbackRepository;
|
||||
this.rewardQueue = rewardQueue;
|
||||
}
|
||||
|
||||
@PostMapping("/register")
|
||||
public ResponseEntity<Void> register(@Valid @RequestBody RegisterCallbackRequest request) {
|
||||
String trackingId = request.getTrackingId();
|
||||
if (processedCallbackRepository.existsById(trackingId)) {
|
||||
return ResponseEntity.ok().build();
|
||||
}
|
||||
ProcessedCallbackEntity e = new ProcessedCallbackEntity();
|
||||
e.setTrackingId(trackingId);
|
||||
e.setCreatedAt(java.time.OffsetDateTime.now(java.time.ZoneOffset.UTC));
|
||||
processedCallbackRepository.save(e);
|
||||
|
||||
rewardQueue.enqueueReward(trackingId, request.getExternalUserId(), null);
|
||||
return ResponseEntity.ok().build();
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,121 @@
|
||||
package com.mosquito.project.controller;
|
||||
|
||||
import com.mosquito.project.dto.ShareMetricsResponse;
|
||||
import com.mosquito.project.dto.ShareTrackingResponse;
|
||||
import com.mosquito.project.dto.ApiResponse;
|
||||
import com.mosquito.project.service.ShareConfigService;
|
||||
import com.mosquito.project.service.ShareTrackingService;
|
||||
import io.swagger.v3.oas.annotations.Operation;
|
||||
import io.swagger.v3.oas.annotations.Parameter;
|
||||
import io.swagger.v3.oas.annotations.tags.Tag;
|
||||
import jakarta.servlet.http.HttpServletRequest;
|
||||
import org.slf4j.Logger;
|
||||
import org.slf4j.LoggerFactory;
|
||||
import org.springframework.http.ResponseEntity;
|
||||
import org.springframework.web.bind.annotation.*;
|
||||
|
||||
import java.time.OffsetDateTime;
|
||||
import java.time.temporal.ChronoUnit;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
|
||||
@RestController
|
||||
@RequestMapping("/api/v1/share")
|
||||
@Tag(name = "Share Tracking", description = "分享链接跟踪与数据分析API")
|
||||
public class ShareTrackingController {
|
||||
|
||||
private static final Logger log = LoggerFactory.getLogger(ShareTrackingController.class);
|
||||
|
||||
private final ShareTrackingService trackingService;
|
||||
private final ShareConfigService shareConfigService;
|
||||
|
||||
public ShareTrackingController(ShareTrackingService trackingService, ShareConfigService shareConfigService) {
|
||||
this.trackingService = trackingService;
|
||||
this.shareConfigService = shareConfigService;
|
||||
}
|
||||
|
||||
@PostMapping("/track")
|
||||
@Operation(summary = "创建分享跟踪", description = "为指定活动创建可追踪的分享链接")
|
||||
public ResponseEntity<ApiResponse<ShareTrackingResponse>> createShareTracking(
|
||||
@Parameter(description = "活动ID") @RequestParam Long activityId,
|
||||
@Parameter(description = "邀请人用户ID") @RequestParam Long inviterUserId,
|
||||
@Parameter(description = "分享来源") @RequestParam(required = false, defaultValue = "direct") String source,
|
||||
@Parameter(description = "额外参数") @RequestParam(required = false) Map<String, String> params
|
||||
) {
|
||||
ShareTrackingResponse response = trackingService.createShareTracking(activityId, inviterUserId, source, params);
|
||||
return ResponseEntity.ok(ApiResponse.success(response));
|
||||
}
|
||||
|
||||
@GetMapping("/metrics")
|
||||
@Operation(summary = "获取分享指标", description = "获取指定活动在时间范围内的分享指标")
|
||||
public ResponseEntity<ApiResponse<ShareMetricsResponse>> getShareMetrics(
|
||||
@Parameter(description = "活动ID") @RequestParam Long activityId,
|
||||
@Parameter(description = "开始时间") @RequestParam(required = false) OffsetDateTime startTime,
|
||||
@Parameter(description = "结束时间") @RequestParam(required = false) OffsetDateTime endTime
|
||||
) {
|
||||
if (startTime == null) {
|
||||
startTime = OffsetDateTime.now().minus(7, ChronoUnit.DAYS);
|
||||
}
|
||||
if (endTime == null) {
|
||||
endTime = OffsetDateTime.now();
|
||||
}
|
||||
|
||||
ShareMetricsResponse metrics = trackingService.getShareMetrics(activityId, startTime, endTime);
|
||||
return ResponseEntity.ok(ApiResponse.success(metrics));
|
||||
}
|
||||
|
||||
@GetMapping("/top-links")
|
||||
@Operation(summary = "获取热门分享链接", description = "获取分享次数最多的链接列表")
|
||||
public ResponseEntity<ApiResponse<List<Map<String, Object>>>> getTopShareLinks(
|
||||
@Parameter(description = "活动ID") @RequestParam Long activityId,
|
||||
@Parameter(description = "返回数量") @RequestParam(required = false, defaultValue = "10") int topN
|
||||
) {
|
||||
List<Map<String, Object>> topLinks = trackingService.getTopShareLinks(activityId, topN);
|
||||
return ResponseEntity.ok(ApiResponse.success(topLinks));
|
||||
}
|
||||
|
||||
@GetMapping("/funnel")
|
||||
@Operation(summary = "获取转化漏斗数据", description = "获取分享到点击的转化漏斗分析")
|
||||
public ResponseEntity<ApiResponse<Map<String, Object>>> getConversionFunnel(
|
||||
@Parameter(description = "活动ID") @RequestParam Long activityId,
|
||||
@Parameter(description = "开始时间") @RequestParam(required = false) OffsetDateTime startTime,
|
||||
@Parameter(description = "结束时间") @RequestParam(required = false) OffsetDateTime endTime
|
||||
) {
|
||||
if (startTime == null) {
|
||||
startTime = OffsetDateTime.now().minus(7, ChronoUnit.DAYS);
|
||||
}
|
||||
if (endTime == null) {
|
||||
endTime = OffsetDateTime.now();
|
||||
}
|
||||
|
||||
Map<String, Object> funnel = trackingService.getConversionFunnel(activityId, startTime, endTime);
|
||||
return ResponseEntity.ok(ApiResponse.success(funnel));
|
||||
}
|
||||
|
||||
@GetMapping("/share-meta")
|
||||
@Operation(summary = "获取分享元数据", description = "获取用于社交媒体分享的OGP元数据")
|
||||
public ResponseEntity<ApiResponse<Map<String, Object>>> getShareMeta(
|
||||
@Parameter(description = "活动ID") @RequestParam Long activityId,
|
||||
@Parameter(description = "用户ID") @RequestParam Long userId,
|
||||
@Parameter(description = "模板名称") @RequestParam(required = false, defaultValue = "default") String template
|
||||
) {
|
||||
Map<String, Object> meta = shareConfigService.getShareMeta(activityId, userId, template);
|
||||
return ResponseEntity.ok(ApiResponse.success(meta));
|
||||
}
|
||||
|
||||
@PostMapping("/register-source")
|
||||
@Operation(summary = "记录分享来源", description = "从外部系统记录分享来源数据")
|
||||
public ResponseEntity<ApiResponse<Void>> registerShareSource(
|
||||
@Parameter(description = "活动ID") @RequestParam Long activityId,
|
||||
@Parameter(description = "用户ID") @RequestParam Long userId,
|
||||
@Parameter(description = "来源渠道") @RequestParam String channel,
|
||||
@Parameter(description = "额外参数") @RequestParam(required = false) Map<String, String> params
|
||||
) {
|
||||
Map<String, String> allParams = params != null ? new java.util.HashMap<>(params) : new java.util.HashMap<>();
|
||||
allParams.put("channel", channel);
|
||||
allParams.put("registered_at", OffsetDateTime.now().toString());
|
||||
|
||||
trackingService.createShareTracking(activityId, userId, channel, allParams);
|
||||
return ResponseEntity.ok(ApiResponse.success(null));
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,77 @@
|
||||
package com.mosquito.project.controller;
|
||||
|
||||
import com.mosquito.project.dto.ShortenRequest;
|
||||
import com.mosquito.project.dto.ShortenResponse;
|
||||
import com.mosquito.project.persistence.entity.ShortLinkEntity;
|
||||
import com.mosquito.project.service.ShortLinkService;
|
||||
import com.mosquito.project.persistence.repository.LinkClickRepository;
|
||||
import com.mosquito.project.web.UrlValidator;
|
||||
import jakarta.validation.Valid;
|
||||
import org.slf4j.Logger;
|
||||
import org.slf4j.LoggerFactory;
|
||||
import org.springframework.http.HttpHeaders;
|
||||
import org.springframework.http.HttpStatus;
|
||||
import org.springframework.http.ResponseEntity;
|
||||
import org.springframework.web.bind.annotation.*;
|
||||
|
||||
@RestController
|
||||
public class ShortLinkController {
|
||||
|
||||
private static final Logger log = LoggerFactory.getLogger(ShortLinkController.class);
|
||||
|
||||
private final ShortLinkService shortLinkService;
|
||||
private final LinkClickRepository linkClickRepository;
|
||||
private final UrlValidator urlValidator;
|
||||
|
||||
public ShortLinkController(ShortLinkService shortLinkService, LinkClickRepository linkClickRepository, UrlValidator urlValidator) {
|
||||
this.shortLinkService = shortLinkService;
|
||||
this.linkClickRepository = linkClickRepository;
|
||||
this.urlValidator = urlValidator;
|
||||
}
|
||||
|
||||
@PostMapping("/api/v1/internal/shorten")
|
||||
public ResponseEntity<ShortenResponse> shorten(@Valid @RequestBody ShortenRequest request) {
|
||||
ShortLinkEntity e = shortLinkService.create(request.getOriginalUrl());
|
||||
ShortenResponse resp = new ShortenResponse(e.getCode(), "/r/" + e.getCode(), e.getOriginalUrl());
|
||||
return new ResponseEntity<>(resp, HttpStatus.CREATED);
|
||||
}
|
||||
|
||||
@GetMapping("/r/{code}")
|
||||
public ResponseEntity<Void> redirect(@PathVariable String code, jakarta.servlet.http.HttpServletRequest request) {
|
||||
var linkOpt = shortLinkService.findByCode(code);
|
||||
if (linkOpt.isEmpty()) {
|
||||
return ResponseEntity.status(HttpStatus.NOT_FOUND).build();
|
||||
}
|
||||
|
||||
var e = linkOpt.get();
|
||||
String originalUrl = e.getOriginalUrl();
|
||||
|
||||
if (!urlValidator.isAllowedUrl(originalUrl)) {
|
||||
log.warn("Blocked potentially malicious redirect attempt. Code: {}, URL: {}", code, originalUrl);
|
||||
return ResponseEntity.status(HttpStatus.BAD_REQUEST).build();
|
||||
}
|
||||
|
||||
try {
|
||||
com.mosquito.project.persistence.entity.LinkClickEntity click = new com.mosquito.project.persistence.entity.LinkClickEntity();
|
||||
click.setCode(code);
|
||||
click.setActivityId(e.getActivityId());
|
||||
click.setInviterUserId(e.getInviterUserId());
|
||||
String ip = request.getHeader("X-Forwarded-For");
|
||||
if (ip != null && !ip.isBlank()) {
|
||||
ip = ip.split(",")[0].trim();
|
||||
} else {
|
||||
ip = request.getRemoteAddr();
|
||||
}
|
||||
click.setIp(ip);
|
||||
click.setUserAgent(request.getHeader("User-Agent"));
|
||||
click.setReferer(request.getHeader("Referer"));
|
||||
click.setCreatedAt(java.time.OffsetDateTime.now(java.time.ZoneOffset.UTC));
|
||||
linkClickRepository.save(click);
|
||||
} catch (Exception ex) {
|
||||
log.error("Failed to record link click for code {}: {}", code, ex.getMessage(), ex);
|
||||
}
|
||||
HttpHeaders headers = new HttpHeaders();
|
||||
headers.set(HttpHeaders.LOCATION, originalUrl);
|
||||
return new ResponseEntity<>(headers, HttpStatus.FOUND);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,201 @@
|
||||
package com.mosquito.project.controller;
|
||||
|
||||
import com.mosquito.project.dto.ShortenResponse;
|
||||
import com.mosquito.project.dto.ApiResponse;
|
||||
import com.mosquito.project.persistence.entity.UserInviteEntity;
|
||||
import com.mosquito.project.service.ShortLinkService;
|
||||
import com.mosquito.project.service.PosterRenderService;
|
||||
import com.mosquito.project.service.ShareConfigService;
|
||||
import com.mosquito.project.persistence.repository.UserInviteRepository;
|
||||
import org.slf4j.Logger;
|
||||
import org.slf4j.LoggerFactory;
|
||||
import org.springframework.http.HttpHeaders;
|
||||
import org.springframework.http.HttpStatus;
|
||||
import org.springframework.http.MediaType;
|
||||
import org.springframework.http.ResponseEntity;
|
||||
import org.springframework.web.bind.annotation.*;
|
||||
|
||||
import java.awt.*;
|
||||
import java.awt.image.BufferedImage;
|
||||
import java.io.ByteArrayOutputStream;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.stream.Collectors;
|
||||
|
||||
@RestController
|
||||
@RequestMapping("/api/v1/me")
|
||||
public class UserExperienceController {
|
||||
|
||||
private static final Logger log = LoggerFactory.getLogger(UserExperienceController.class);
|
||||
|
||||
private final ShortLinkService shortLinkService;
|
||||
private final UserInviteRepository userInviteRepository;
|
||||
private final PosterRenderService posterRenderService;
|
||||
private final ShareConfigService shareConfigService;
|
||||
private final com.mosquito.project.persistence.repository.UserRewardRepository userRewardRepository;
|
||||
|
||||
public UserExperienceController(ShortLinkService shortLinkService, UserInviteRepository userInviteRepository,
|
||||
PosterRenderService posterRenderService, ShareConfigService shareConfigService,
|
||||
com.mosquito.project.persistence.repository.UserRewardRepository userRewardRepository) {
|
||||
this.shortLinkService = shortLinkService;
|
||||
this.userInviteRepository = userInviteRepository;
|
||||
this.posterRenderService = posterRenderService;
|
||||
this.shareConfigService = shareConfigService;
|
||||
this.userRewardRepository = userRewardRepository;
|
||||
}
|
||||
|
||||
@GetMapping("/invitation-info")
|
||||
public ResponseEntity<ApiResponse<ShortenResponse>> getInvitationInfo(
|
||||
@RequestParam Long activityId,
|
||||
@RequestParam Long userId,
|
||||
@RequestParam(required = false, defaultValue = "default") String template
|
||||
) {
|
||||
String shareUrl = shareConfigService.buildShareUrl(activityId, userId, template, null);
|
||||
var e = shortLinkService.create(shareUrl);
|
||||
ShortenResponse payload = new ShortenResponse(e.getCode(), "/r/" + e.getCode(), e.getOriginalUrl());
|
||||
return ResponseEntity.ok(ApiResponse.success(payload));
|
||||
}
|
||||
|
||||
@GetMapping("/share-meta")
|
||||
public ResponseEntity<ApiResponse<Map<String, Object>>> getShareMeta(
|
||||
@RequestParam Long activityId,
|
||||
@RequestParam Long userId,
|
||||
@RequestParam(required = false, defaultValue = "default") String template
|
||||
) {
|
||||
Map<String, Object> meta = shareConfigService.getShareMeta(activityId, userId, template);
|
||||
return ResponseEntity.ok(ApiResponse.success(meta));
|
||||
}
|
||||
|
||||
@GetMapping("/invited-friends")
|
||||
public ResponseEntity<ApiResponse<List<FriendDto>>> getInvitedFriends(
|
||||
@RequestParam Long activityId,
|
||||
@RequestParam Long userId,
|
||||
@RequestParam(defaultValue = "0") int page,
|
||||
@RequestParam(defaultValue = "20") int size
|
||||
) {
|
||||
List<UserInviteEntity> all = userInviteRepository.findByActivityIdAndInviterUserId(activityId, userId);
|
||||
int from = Math.max(0, page * Math.max(1, size));
|
||||
if (from >= all.size()) {
|
||||
return ResponseEntity.ok(ApiResponse.success(List.of()));
|
||||
}
|
||||
int to = Math.min(all.size(), from + size);
|
||||
List<FriendDto> result = all.subList(from, to).stream()
|
||||
.map(e -> new FriendDto("用户" + e.getInviteeUserId(), maskPhone("1380000" + String.format("%04d", e.getInviteeUserId() % 10000)), e.getStatus()))
|
||||
.collect(Collectors.toList());
|
||||
return ResponseEntity.ok(ApiResponse.success(result));
|
||||
}
|
||||
|
||||
@GetMapping(value = "/poster/image", produces = MediaType.IMAGE_PNG_VALUE)
|
||||
public ResponseEntity<byte[]> getPosterImage(
|
||||
@RequestParam Long activityId,
|
||||
@RequestParam Long userId,
|
||||
@RequestParam(required = false, defaultValue = "default") String template
|
||||
) {
|
||||
try {
|
||||
byte[] image = posterRenderService.renderPoster(activityId, userId, template);
|
||||
HttpHeaders headers = new HttpHeaders();
|
||||
headers.setContentType(MediaType.IMAGE_PNG);
|
||||
headers.setCacheControl("max-age=3600");
|
||||
return new ResponseEntity<>(image, headers, HttpStatus.OK);
|
||||
} catch (Exception ex) {
|
||||
log.error("Failed to generate poster image", ex);
|
||||
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).build();
|
||||
}
|
||||
}
|
||||
|
||||
@GetMapping(value = "/poster/html", produces = MediaType.TEXT_HTML_VALUE)
|
||||
public ResponseEntity<String> getPosterHtml(
|
||||
@RequestParam Long activityId,
|
||||
@RequestParam Long userId,
|
||||
@RequestParam(required = false, defaultValue = "default") String template
|
||||
) {
|
||||
try {
|
||||
String html = posterRenderService.renderPosterHtml(activityId, userId, template);
|
||||
return ResponseEntity.ok()
|
||||
.contentType(MediaType.TEXT_HTML)
|
||||
.header("Cache-Control", "max-age=3600")
|
||||
.body(html);
|
||||
} catch (Exception ex) {
|
||||
log.error("Failed to generate poster HTML", ex);
|
||||
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).build();
|
||||
}
|
||||
}
|
||||
|
||||
@GetMapping(value = "/poster/config")
|
||||
public ResponseEntity<ApiResponse<PosterConfigDto>> getPosterConfig(
|
||||
@RequestParam(required = false, defaultValue = "default") String template
|
||||
) {
|
||||
PosterConfigDto config = new PosterConfigDto();
|
||||
config.setTemplate(template);
|
||||
config.setImageUrl("/api/v1/me/poster/image?activityId={activityId}&userId={userId}&template=" + template);
|
||||
config.setHtmlUrl("/api/v1/me/poster/html?activityId={activityId}&userId={userId}&template=" + template);
|
||||
return ResponseEntity.ok(ApiResponse.success(config));
|
||||
}
|
||||
|
||||
@GetMapping("/rewards")
|
||||
public ResponseEntity<ApiResponse<List<RewardDto>>> getRewards(
|
||||
@RequestParam Long activityId,
|
||||
@RequestParam Long userId,
|
||||
@RequestParam(defaultValue = "0") int page,
|
||||
@RequestParam(defaultValue = "20") int size
|
||||
) {
|
||||
var all = userRewardRepository.findByActivityIdAndUserIdOrderByCreatedAtDesc(activityId, userId);
|
||||
int from = Math.max(0, page * Math.max(1, size));
|
||||
if (from >= all.size()) {
|
||||
return ResponseEntity.ok(ApiResponse.success(java.util.List.of()));
|
||||
}
|
||||
int to = Math.min(all.size(), from + size);
|
||||
var list = all.subList(from, to).stream()
|
||||
.map(e -> new RewardDto(e.getType(), e.getPoints(), e.getCreatedAt().toString()))
|
||||
.collect(java.util.stream.Collectors.toList());
|
||||
return ResponseEntity.ok(ApiResponse.success(list));
|
||||
}
|
||||
|
||||
public static class FriendDto {
|
||||
private String nickname;
|
||||
private String maskedPhone;
|
||||
private String status;
|
||||
|
||||
public FriendDto(String nickname, String maskedPhone, String status) {
|
||||
this.nickname = nickname;
|
||||
this.maskedPhone = maskedPhone;
|
||||
this.status = status;
|
||||
}
|
||||
public String getNickname() { return nickname; }
|
||||
public String getMaskedPhone() { return maskedPhone; }
|
||||
public String getStatus() { return status; }
|
||||
}
|
||||
|
||||
public static class RewardDto {
|
||||
private String type;
|
||||
private int points;
|
||||
private String createdAt;
|
||||
|
||||
public RewardDto(String type, int points, String createdAt) {
|
||||
this.type = type;
|
||||
this.points = points;
|
||||
this.createdAt = createdAt;
|
||||
}
|
||||
public String getType() { return type; }
|
||||
public int getPoints() { return points; }
|
||||
public String getCreatedAt() { return createdAt; }
|
||||
}
|
||||
|
||||
public static class PosterConfigDto {
|
||||
private String template;
|
||||
private String imageUrl;
|
||||
private String htmlUrl;
|
||||
|
||||
public String getTemplate() { return template; }
|
||||
public void setTemplate(String template) { this.template = template; }
|
||||
public String getImageUrl() { return imageUrl; }
|
||||
public void setImageUrl(String imageUrl) { this.imageUrl = imageUrl; }
|
||||
public String getHtmlUrl() { return htmlUrl; }
|
||||
public void setHtmlUrl(String htmlUrl) { this.htmlUrl = htmlUrl; }
|
||||
}
|
||||
|
||||
private String maskPhone(String phone) {
|
||||
if (phone == null || phone.length() < 7) return "**********";
|
||||
return phone.substring(0, 3) + "****" + phone.substring(phone.length() - 4);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user