mirror of
https://gitee.com/mateos/mateclaw.git
synced 2026-09-13 19:23:42 +08:00
60 lines
2.6 KiB
Java
60 lines
2.6 KiB
Java
package vip.mate.wiki.controller;
|
|
|
|
import io.swagger.v3.oas.annotations.Operation;
|
|
import io.swagger.v3.oas.annotations.tags.Tag;
|
|
import lombok.RequiredArgsConstructor;
|
|
import org.springframework.web.bind.annotation.DeleteMapping;
|
|
import org.springframework.web.bind.annotation.GetMapping;
|
|
import org.springframework.web.bind.annotation.PathVariable;
|
|
import org.springframework.web.bind.annotation.PostMapping;
|
|
import org.springframework.web.bind.annotation.RequestMapping;
|
|
import org.springframework.web.bind.annotation.RestController;
|
|
import vip.mate.common.result.R;
|
|
import vip.mate.wiki.hotcache.HotCacheUpdateReason;
|
|
import vip.mate.wiki.hotcache.HotCacheUpdateScheduler;
|
|
import vip.mate.wiki.hotcache.WikiHotCacheService;
|
|
import vip.mate.wiki.model.WikiHotCacheEntity;
|
|
|
|
/**
|
|
* Operator endpoints for the KB hot cache: inspect the current snapshot,
|
|
* trigger a manual rebuild, or wipe the cache so the next event-driven
|
|
* rebuild starts from scratch.
|
|
*
|
|
* <p>Sits behind the standard JWT-protected {@code /api/v1} prefix.
|
|
*/
|
|
@RestController
|
|
@RequestMapping("/api/v1/wiki/hot-cache")
|
|
@RequiredArgsConstructor
|
|
@Tag(name = "Wiki Hot Cache", description = "Operator endpoints for the KB-level recent activity snapshot")
|
|
public class WikiHotCacheController {
|
|
|
|
private final WikiHotCacheService service;
|
|
private final HotCacheUpdateScheduler scheduler;
|
|
|
|
@Operation(summary = "Get the current hot cache snapshot for a KB",
|
|
description = "Returns null data if no rebuild has run yet.")
|
|
@GetMapping("/{kbId}")
|
|
public R<WikiHotCacheEntity> get(@PathVariable Long kbId) {
|
|
return R.ok(service.findByKb(kbId).orElse(null));
|
|
}
|
|
|
|
@Operation(summary = "Schedule a manual rebuild of the hot cache",
|
|
description = "Async — the scheduler runs the LLM call on a virtual thread. "
|
|
+ "MANUAL bypasses the debounce window so operator triggers always run. "
|
|
+ "Poll GET to see progress.")
|
|
@PostMapping("/{kbId}/regenerate")
|
|
public R<Void> regenerate(@PathVariable Long kbId) {
|
|
scheduler.scheduleRebuild(kbId, HotCacheUpdateReason.MANUAL);
|
|
return R.ok();
|
|
}
|
|
|
|
@Operation(summary = "Soft-delete the hot cache row",
|
|
description = "The next event-driven rebuild will create a fresh row. "
|
|
+ "Use this to clear a wedged cache without waiting for the staleness window.")
|
|
@DeleteMapping("/{kbId}")
|
|
public R<Void> reset(@PathVariable Long kbId) {
|
|
service.findByKb(kbId).ifPresent(row -> service.softDelete(row.getId()));
|
|
return R.ok();
|
|
}
|
|
}
|