feat(knowledge): add search service

2026-01-29 20:35:07 -06:00
parent c6a65869c6
commit c26b7d4e64
7 changed files with 1109 additions and 3 deletions
--- a/apps/api/src/knowledge/search.controller.ts
+++ b/apps/api/src/knowledge/search.controller.ts
@@ -0,0 +1,88 @@
+import { Controller, Get, Query, UseGuards } from "@nestjs/common";
+import { SearchService } from "./services/search.service";
+import { SearchQueryDto, TagSearchDto, RecentEntriesDto } from "./dto";
+import { AuthGuard } from "../auth/guards/auth.guard";
+import { WorkspaceGuard, PermissionGuard } from "../common/guards";
+import { Workspace, Permission, RequirePermission } from "../common/decorators";
+
+/**
+ * Controller for knowledge search endpoints
+ * All endpoints require authentication and workspace context
+ */
+@Controller("knowledge/search")
+@UseGuards(AuthGuard, WorkspaceGuard, PermissionGuard)
+export class SearchController {
+  constructor(private readonly searchService: SearchService) {}
+
+  /**
+   * GET /api/knowledge/search
+   * Full-text search across knowledge entries
+   * Searches title and content with relevance ranking
+   * Requires: Any workspace member
+   *
+   * @query q - The search query string (required)
+   * @query status - Filter by entry status (optional)
+   * @query page - Page number (default: 1)
+   * @query limit - Results per page (default: 20, max: 100)
+   */
+  @Get()
+  @RequirePermission(Permission.WORKSPACE_ANY)
+  async search(
+    @Workspace() workspaceId: string,
+    @Query() query: SearchQueryDto
+  ) {
+    return this.searchService.search(query.q, workspaceId, {
+      status: query.status,
+      page: query.page,
+      limit: query.limit,
+    });
+  }
+
+  /**
+   * GET /api/knowledge/search/by-tags
+   * Search entries by tags (entries must have ALL specified tags)
+   * Requires: Any workspace member
+   *
+   * @query tags - Comma-separated list of tag slugs (required)
+   * @query status - Filter by entry status (optional)
+   * @query page - Page number (default: 1)
+   * @query limit - Results per page (default: 20, max: 100)
+   */
+  @Get("by-tags")
+  @RequirePermission(Permission.WORKSPACE_ANY)
+  async searchByTags(
+    @Workspace() workspaceId: string,
+    @Query() query: TagSearchDto
+  ) {
+    return this.searchService.searchByTags(query.tags, workspaceId, {
+      status: query.status,
+      page: query.page,
+      limit: query.limit,
+    });
+  }
+
+  /**
+   * GET /api/knowledge/search/recent
+   * Get recently modified entries
+   * Requires: Any workspace member
+   *
+   * @query limit - Maximum number of entries (default: 10, max: 50)
+   * @query status - Filter by entry status (optional)
+   */
+  @Get("recent")
+  @RequirePermission(Permission.WORKSPACE_ANY)
+  async recentEntries(
+    @Workspace() workspaceId: string,
+    @Query() query: RecentEntriesDto
+  ) {
+    const entries = await this.searchService.recentEntries(
+      workspaceId,
+      query.limit || 10,
+      query.status
+    );
+    return {
+      data: entries,
+      count: entries.length,
+    };
+  }
+}