@igstack/app-catalog-backend-core 6.10.2 → 6.11.0

package/dist/server/controller.d.mts

@@ -1,8 +1,11 @@
 import { AppCatalogData, Resource } from "../types/common/appCatalogTypes.mjs";
 import { AcTrpcContext } from "./acTrpcContext.mjs";
 import { BetterAuth } from "../modules/auth/auth.mjs";
+import { CommunityToolsOptions } from "../middleware/types.mjs";
 import { FeedbackList, FeedbackView } from "../modules/feedback/service.mjs";
+import { ToolPreview } from "../modules/communityTools/writeService.mjs";
 import * as _trpc_server0 from "@trpc/server";
+import * as _igstack_app_catalog_shared_core0 from "@igstack/app-catalog-shared-core";
 import * as better_auth0 from "better-auth";
 
 //#region src/server/controller.d.ts
@@ -12,6 +15,7 @@ import * as better_auth0 from "better-auth";
  */
 declare function createTrpcRouter(auth?: BetterAuth, options?: {
   devLoginEnabled?: boolean;
+  communityTools?: CommunityToolsOptions;
 }): _trpc_server0.TRPCBuiltRouter<{
   ctx: AcTrpcContext;
   meta: object;
@@ -63,6 +67,8 @@ declare function createTrpcRouter(auth?: BetterAuth, options?: {
     list: _trpc_server0.TRPCQueryProcedure<{
       input: {
         resourceSlug: string;
+      } | {
+        communityToolSlug: string;
       };
       output: FeedbackList;
       meta: object;
@@ -75,6 +81,7 @@ declare function createTrpcRouter(auth?: BetterAuth, options?: {
     add: _trpc_server0.TRPCMutationProcedure<{
       input: {
         resourceSlug?: string | undefined;
+        communityToolSlug?: string | undefined;
         subject?: string | undefined;
         body?: string | undefined;
         attachmentIds?: string[] | undefined;
@@ -100,6 +107,142 @@ declare function createTrpcRouter(auth?: BetterAuth, options?: {
       meta: object;
     }>;
   }>>;
+  communityTools: _trpc_server0.TRPCBuiltRouter<{
+    ctx: AcTrpcContext;
+    meta: object;
+    errorShape: _trpc_server0.TRPCDefaultErrorShape;
+    transformer: false;
+  }, _trpc_server0.TRPCDecorateCreateRouterOptions<{
+    config: _trpc_server0.TRPCQueryProcedure<{
+      input: void;
+      output: {
+        enabled: boolean;
+      };
+      meta: object;
+    }>;
+    list: _trpc_server0.TRPCQueryProcedure<{
+      input: void;
+      output: _igstack_app_catalog_shared_core0.CommunityTool[];
+      meta: object;
+    }>;
+    countByApp: _trpc_server0.TRPCQueryProcedure<{
+      input: void;
+      output: Record<string, number>;
+      meta: object;
+    }>;
+    get: _trpc_server0.TRPCQueryProcedure<{
+      input: {
+        slug: string;
+      };
+      output: _igstack_app_catalog_shared_core0.CommunityTool;
+      meta: object;
+    }>;
+    recordView: _trpc_server0.TRPCMutationProcedure<{
+      input: {
+        slug: string;
+      };
+      output: {
+        views30d: number;
+        viewsAll: number;
+      };
+      meta: object;
+    }>;
+    pins: _trpc_server0.TRPCQueryProcedure<{
+      input: void;
+      output: _igstack_app_catalog_shared_core0.CommunityTool[];
+      meta: object;
+    }>;
+    pin: _trpc_server0.TRPCMutationProcedure<{
+      input: {
+        slug: string;
+      };
+      output: void;
+      meta: object;
+    }>;
+    like: _trpc_server0.TRPCMutationProcedure<{
+      input: {
+        slug: string;
+      };
+      output: void;
+      meta: object;
+    }>;
+    unlike: _trpc_server0.TRPCMutationProcedure<{
+      input: {
+        slug: string;
+      };
+      output: void;
+      meta: object;
+    }>;
+    unpin: _trpc_server0.TRPCMutationProcedure<{
+      input: {
+        slug: string;
+      };
+      output: void;
+      meta: object;
+    }>;
+    reorderPins: _trpc_server0.TRPCMutationProcedure<{
+      input: {
+        slugs: string[];
+      };
+      output: void;
+      meta: object;
+    }>;
+    preview: _trpc_server0.TRPCMutationProcedure<{
+      input: {
+        url: string;
+      };
+      output: ToolPreview;
+      meta: object;
+    }>;
+    add: _trpc_server0.TRPCMutationProcedure<{
+      input: {
+        url: string;
+        name: string;
+        summary: string;
+        descriptionMd: string;
+        ownerSlugs: string[];
+        tags: {
+          kind: "app" | "topic";
+          value: string;
+        }[];
+        ownerNames?: string[] | undefined;
+      };
+      output: _igstack_app_catalog_shared_core0.CommunityTool;
+      meta: object;
+    }>;
+    edit: _trpc_server0.TRPCMutationProcedure<{
+      input: {
+        url: string;
+        name: string;
+        summary: string;
+        descriptionMd: string;
+        ownerSlugs: string[];
+        tags: {
+          kind: "app" | "topic";
+          value: string;
+        }[];
+        slug: string;
+        ownerNames?: string[] | undefined;
+      };
+      output: _igstack_app_catalog_shared_core0.CommunityTool;
+      meta: object;
+    }>;
+    archive: _trpc_server0.TRPCMutationProcedure<{
+      input: {
+        slug: string;
+        reason: string;
+      };
+      output: void;
+      meta: object;
+    }>;
+    approve: _trpc_server0.TRPCMutationProcedure<{
+      input: {
+        slug: string;
+      };
+      output: void;
+      meta: object;
+    }>;
+  }>>;
   auth: _trpc_server0.TRPCBuiltRouter<{
     ctx: AcTrpcContext;
     meta: {};

package/dist/server/controller.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"controller.d.mts","names":[],"sources":["../../src/server/controller.ts"],"mappings":";;;;;;;;;;;;iBAmCgB,gBAAA,CACd,IAAA,GAAO,UAAA,EACP,OAAA;EAAY,eAAA;AAAA,kBAA2B,eAAA;OADtB,aAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAwCP,UAAA,GAAa,UAAA,QAAkB,gBAAA"}
+{"version":3,"file":"controller.d.mts","names":[],"sources":["../../src/server/controller.ts"],"mappings":";;;;;;;;;;;;;;;iBAqCgB,gBAAA,CACd,IAAA,GAAO,UAAA,EACP,OAAA;EACE,eAAA;EACA,cAAA,GAAiB,qBAAA;AAAA,kBAClB,eAAA;OADuC,aAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA0C9B,UAAA,GAAa,UAAA,QAAkB,gBAAA"}

package/dist/server/controller.mjs

@@ -2,6 +2,7 @@ import { getAppCatalogData, updateAiMemory, updateApp } from "../modules/appCata
 import { createAuthRouter } from "../modules/auth/authRouter.mjs";
 import { publicProcedure, router, t } from "./trpcSetup.mjs";
 import { createFeedbackRouter } from "../modules/feedback/feedbackRouter.mjs";
+import { createCommunityToolsRouter } from "../modules/communityTools/router.mjs";
 import { z } from "zod";
 
 //#region src/server/controller.ts
@@ -43,6 +44,7 @@ function createTrpcRouter(auth, options) {
 			})
 		}),
 		feedback: createFeedbackRouter(),
+		communityTools: createCommunityToolsRouter(options?.communityTools),
 		auth: createAuthRouter(t, auth, options)
 	});
 }

package/dist/server/controller.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"controller.mjs","names":["updateAppService","updateAiMemoryService"],"sources":["../../src/server/controller.ts"],"sourcesContent":["import {\n  getAppCatalogData,\n  updateAiMemory as updateAiMemoryService,\n  updateApp as updateAppService,\n} from '../modules/appCatalog/service'\nimport type { AppCatalogData } from '../types'\nimport type { Resource } from '../types/common/appCatalogTypes'\n\nimport type { BetterAuth } from '../modules/auth/auth'\nimport { createAuthRouter } from '../modules/auth/authRouter.js'\nimport { createFeedbackRouter } from '../modules/feedback/feedbackRouter'\nimport { publicProcedure, router, t } from './trpcSetup'\nimport { z } from 'zod'\n\nconst updateAppInputSchema = z.object({\n  id: z.string(),\n  data: z\n    .object({\n      displayName: z.string().optional(),\n      abbreviation: z.string().max(20).nullable().optional(),\n      slug: z.string().optional(),\n      appUrl: z.string().optional(),\n      description: z.string().optional(),\n      sources: z.array(z.string()).optional(),\n      aiPrompt: z.string().nullable().optional(),\n    })\n    .refine((d) => Object.keys(d).length > 0, {\n      message: 'At least one field required',\n    }),\n})\n\n/**\n * Create the main tRPC router with optional auth instance\n * @param auth - Optional Better Auth instance for auth-related queries\n */\nexport function createTrpcRouter(\n  auth?: BetterAuth,\n  options?: { devLoginEnabled?: boolean },\n) {\n  return router({\n    appCatalog: router({\n      getData: publicProcedure.query(\n        async ({ ctx }): Promise<AppCatalogData> => {\n          const baseData = await getAppCatalogData()\n          const versions = await ctx.companySpecificBackend.getVersionInfo?.()\n\n          return {\n            ...baseData,\n            ...(versions && { versions }),\n          }\n        },\n      ),\n      updateApp: publicProcedure\n        .input(updateAppInputSchema)\n        .mutation(async ({ input }): Promise<Resource> => {\n          return updateAppService(input)\n        }),\n      updateAiMemory: publicProcedure\n        .input(\n          z.object({\n            id: z.string(),\n            aiMemory: z.string().nullable(),\n          }),\n        )\n        .mutation(async ({ input }): Promise<Resource> => {\n          return updateAiMemoryService(input)\n        }),\n    }),\n\n    feedback: createFeedbackRouter(),\n\n    // Auth routes (requires auth instance)\n    auth: createAuthRouter(t, auth, options),\n  })\n}\n\nexport type TRPCRouter = ReturnType<typeof createTrpcRouter>\n"],"mappings":";;;;;;;AAcA,MAAM,uBAAuB,EAAE,OAAO;CACpC,IAAI,EAAE,QAAQ;CACd,MAAM,EACH,OAAO;EACN,aAAa,EAAE,QAAQ,CAAC,UAAU;EAClC,cAAc,EAAE,QAAQ,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU;EACtD,MAAM,EAAE,QAAQ,CAAC,UAAU;EAC3B,QAAQ,EAAE,QAAQ,CAAC,UAAU;EAC7B,aAAa,EAAE,QAAQ,CAAC,UAAU;EAClC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;EACvC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,UAAU;EAC3C,CAAC,CACD,QAAQ,MAAM,OAAO,KAAK,EAAE,CAAC,SAAS,GAAG,EACxC,SAAS,+BACV,CAAC;CACL,CAAC;;;;;AAMF,SAAgB,iBACd,MACA,SACA;AACA,QAAO,OAAO;EACZ,YAAY,OAAO;GACjB,SAAS,gBAAgB,MACvB,OAAO,EAAE,UAAmC;IAC1C,MAAM,WAAW,MAAM,mBAAmB;IAC1C,MAAM,WAAW,MAAM,IAAI,uBAAuB,kBAAkB;AAEpE,WAAO;KACL,GAAG;KACH,GAAI,YAAY,EAAE,UAAU;KAC7B;KAEJ;GACD,WAAW,gBACR,MAAM,qBAAqB,CAC3B,SAAS,OAAO,EAAE,YAA+B;AAChD,WAAOA,UAAiB,MAAM;KAC9B;GACJ,gBAAgB,gBACb,MACC,EAAE,OAAO;IACP,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,QAAQ,CAAC,UAAU;IAChC,CAAC,CACH,CACA,SAAS,OAAO,EAAE,YAA+B;AAChD,WAAOC,eAAsB,MAAM;KACnC;GACL,CAAC;EAEF,UAAU,sBAAsB;EAGhC,MAAM,iBAAiB,GAAG,MAAM,QAAQ;EACzC,CAAC"}
+{"version":3,"file":"controller.mjs","names":["updateAppService","updateAiMemoryService"],"sources":["../../src/server/controller.ts"],"sourcesContent":["import {\n  getAppCatalogData,\n  updateAiMemory as updateAiMemoryService,\n  updateApp as updateAppService,\n} from '../modules/appCatalog/service'\nimport type { AppCatalogData } from '../types'\nimport type { Resource } from '../types/common/appCatalogTypes'\n\nimport type { BetterAuth } from '../modules/auth/auth'\nimport { createAuthRouter } from '../modules/auth/authRouter.js'\nimport { createFeedbackRouter } from '../modules/feedback/feedbackRouter'\nimport { createCommunityToolsRouter } from '../modules/communityTools/router'\nimport type { CommunityToolsOptions } from '../middleware/types'\nimport { publicProcedure, router, t } from './trpcSetup'\nimport { z } from 'zod'\n\nconst updateAppInputSchema = z.object({\n  id: z.string(),\n  data: z\n    .object({\n      displayName: z.string().optional(),\n      abbreviation: z.string().max(20).nullable().optional(),\n      slug: z.string().optional(),\n      appUrl: z.string().optional(),\n      description: z.string().optional(),\n      sources: z.array(z.string()).optional(),\n      aiPrompt: z.string().nullable().optional(),\n    })\n    .refine((d) => Object.keys(d).length > 0, {\n      message: 'At least one field required',\n    }),\n})\n\n/**\n * Create the main tRPC router with optional auth instance\n * @param auth - Optional Better Auth instance for auth-related queries\n */\nexport function createTrpcRouter(\n  auth?: BetterAuth,\n  options?: {\n    devLoginEnabled?: boolean\n    communityTools?: CommunityToolsOptions\n  },\n) {\n  return router({\n    appCatalog: router({\n      getData: publicProcedure.query(\n        async ({ ctx }): Promise<AppCatalogData> => {\n          const baseData = await getAppCatalogData()\n          const versions = await ctx.companySpecificBackend.getVersionInfo?.()\n\n          return {\n            ...baseData,\n            ...(versions && { versions }),\n          }\n        },\n      ),\n      updateApp: publicProcedure\n        .input(updateAppInputSchema)\n        .mutation(async ({ input }): Promise<Resource> => {\n          return updateAppService(input)\n        }),\n      updateAiMemory: publicProcedure\n        .input(\n          z.object({\n            id: z.string(),\n            aiMemory: z.string().nullable(),\n          }),\n        )\n        .mutation(async ({ input }): Promise<Resource> => {\n          return updateAiMemoryService(input)\n        }),\n    }),\n\n    feedback: createFeedbackRouter(),\n\n    communityTools: createCommunityToolsRouter(options?.communityTools),\n\n    // Auth routes (requires auth instance)\n    auth: createAuthRouter(t, auth, options),\n  })\n}\n\nexport type TRPCRouter = ReturnType<typeof createTrpcRouter>\n"],"mappings":";;;;;;;;AAgBA,MAAM,uBAAuB,EAAE,OAAO;CACpC,IAAI,EAAE,QAAQ;CACd,MAAM,EACH,OAAO;EACN,aAAa,EAAE,QAAQ,CAAC,UAAU;EAClC,cAAc,EAAE,QAAQ,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU;EACtD,MAAM,EAAE,QAAQ,CAAC,UAAU;EAC3B,QAAQ,EAAE,QAAQ,CAAC,UAAU;EAC7B,aAAa,EAAE,QAAQ,CAAC,UAAU;EAClC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;EACvC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,UAAU;EAC3C,CAAC,CACD,QAAQ,MAAM,OAAO,KAAK,EAAE,CAAC,SAAS,GAAG,EACxC,SAAS,+BACV,CAAC;CACL,CAAC;;;;;AAMF,SAAgB,iBACd,MACA,SAIA;AACA,QAAO,OAAO;EACZ,YAAY,OAAO;GACjB,SAAS,gBAAgB,MACvB,OAAO,EAAE,UAAmC;IAC1C,MAAM,WAAW,MAAM,mBAAmB;IAC1C,MAAM,WAAW,MAAM,IAAI,uBAAuB,kBAAkB;AAEpE,WAAO;KACL,GAAG;KACH,GAAI,YAAY,EAAE,UAAU;KAC7B;KAEJ;GACD,WAAW,gBACR,MAAM,qBAAqB,CAC3B,SAAS,OAAO,EAAE,YAA+B;AAChD,WAAOA,UAAiB,MAAM;KAC9B;GACJ,gBAAgB,gBACb,MACC,EAAE,OAAO;IACP,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE,QAAQ,CAAC,UAAU;IAChC,CAAC,CACH,CACA,SAAS,OAAO,EAAE,YAA+B;AAChD,WAAOC,eAAsB,MAAM;KACnC;GACL,CAAC;EAEF,UAAU,sBAAsB;EAEhC,gBAAgB,2BAA2B,SAAS,eAAe;EAGnE,MAAM,iBAAiB,GAAG,MAAM,QAAQ;EACzC,CAAC"}

package/dist/server/trpcSetup.mjs

@@ -60,5 +60,5 @@ const adminProcedure = t.procedure.use(isAdminMiddleware);
 const protectedProcedure = t.procedure.use(isAuthenticated);
 
 //#endregion
-export { publicProcedure, router, t };
+export { adminProcedure, protectedProcedure, publicProcedure, router, t };
 //# sourceMappingURL=trpcSetup.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@igstack/app-catalog-backend-core",
-  "version": "6.10.2",
+  "version": "6.11.0",
   "description": "Backend core library for App Catalog",
   "homepage": "https://github.com/lislon/app-catalog",
   "repository": {
@@ -44,8 +44,8 @@
     "tsyringe": "^4.10.0",
     "yaml": "^2.8.0",
     "zod": "^4.3.5",
-    "@igstack/app-catalog-shared-core": "6.10.2",
-    "@igstack/app-catalog-table-sync": "6.10.2"
+    "@igstack/app-catalog-shared-core": "6.11.0",
+    "@igstack/app-catalog-table-sync": "6.11.0"
   },
   "devDependencies": {
     "@tanstack/vite-config": "^0.4.3",
@@ -57,6 +57,7 @@
     "@types/node": "^24.3.0",
     "@types/pg": "^8.18.0",
     "esbuild": "^0.25.5",
+    "playwright-core": "^1.59.0",
     "prisma": "^7.4.2",
     "prisma-json-types-generator": "^4.1.1",
     "tsdown": "^0.21.0",
@@ -67,12 +68,18 @@
   "peerDependencies": {
     "@prisma/adapter-pg": "^7.4.2",
     "@prisma/client": "^7.4.2",
-    "pg": "^8.20.0"
+    "pg": "^8.20.0",
+    "playwright-core": ">=1.40.0"
+  },
+  "peerDependenciesMeta": {
+    "playwright-core": {
+      "optional": true
+    }
   },
   "engines": {
     "node": ">=24"
   },
-  "gitHead": "f3e5b024e83e55773503820fdb5bfd858319b6d1",
+  "gitHead": "f4c72c2178cd9a3ec6695cfbb243ff3d0737ad1b",
   "scripts": {
     "build": "tsdown",
     "build:lenient": "tsdown",

package/prisma/schema.prisma

@@ -218,6 +218,10 @@ model DbFeedback {
   resourceId String?
   resource   DbResource? @relation(fields: [resourceId], references: [id], onDelete: Cascade)
 
+  /// Feedback about a community tool rather than a catalog resource.
+  communityToolId String?
+  communityTool   DbCommunityTool? @relation(fields: [communityToolId], references: [id], onDelete: Cascade)
+
   /// What the visitor was looking for when nothing matched. Set only when resourceId is
   /// null — it is the whole substance of a new-app ask, and the thing we research.
   subject String?
@@ -228,10 +232,19 @@ model DbFeedback {
   /// widening the wordlist later cannot rename everybody's history.
   authorAlias String
 
+  /// Optional: authenticated user id when feedback is submitted by a logged-in user.
+  authorUserId String?
+  /// Optional: authenticated user's name when feedback is submitted by a logged-in user.
+  authorName String?
+
   /// Optional: a bare flag with no words is a valid signal, and the cheapest one a
   /// passing visitor can send.
   body String?
 
+  /// 'marker' for a row the system writes when a community tool changes: it has no
+  /// author to edit or withdraw it. Null for a visitor's own feedback.
+  kind String?
+
   attachments DbFeedbackAttachment[]
 
   /// Set on a later edit, so the UI can mark it edited. Null when never edited.
@@ -248,6 +261,7 @@ model DbFeedback {
   updatedAt DateTime @updatedAt
 
   @@index([resourceId, createdAt])
+  @@index([communityToolId, createdAt])
   @@index([authorHash])
   /// Drives the unreviewed counts on both surfaces: open items, newest first.
   @@index([status, createdAt])
@@ -352,3 +366,150 @@ model SourceReference {
 
   @@unique([resourceId, url])
 }
+
+// ========== Community Tools Models ==========
+
+enum CommunityTagKind {
+  app
+  topic
+}
+
+/// A community-contributed tool or resource shared by catalog users.
+model DbCommunityTool {
+  id String @id @default(cuid())
+
+  slug String @unique
+  name String
+  url  String
+  /// Lowercase hostname extracted from url for fast host-based queries.
+  host String
+
+  summary       String
+  descriptionMd String
+
+  addedByUserId String
+  addedByName   String
+
+  /// Person slugs who maintain this tool.
+  owners DbCommunityToolOwner[]
+
+  /// Owners who are not in the person directory, by name only.
+  namedOwners DbCommunityToolNamedOwner[]
+
+  /// Categorization tags (app associations and topic labels).
+  tags DbCommunityToolTag[]
+
+  /// View tracking for ranking.
+  views DbCommunityToolView[]
+
+  /// User pins for personalized ordering.
+  pins DbCommunityToolPin[]
+
+  /// One per person who liked it.
+  likes DbCommunityToolLike[]
+
+  /// Feedback comments about this tool.
+  feedback DbFeedback[]
+
+  /// When a maintainer last reviewed this entry.
+  reviewedAt     DateTime?
+  reviewedByName String?
+
+  /// Last automated check for availability.
+  lastCheckAt DateTime?
+
+  /// When the tool first started failing checks (null when healthy).
+  failingSince DateTime?
+
+  /// When archived (null when active).
+  archivedAt     DateTime?
+  archivedReason String?
+  /// 'auto' for automated archival after prolonged failure, or user name for manual archival.
+  archivedBy     String?
+
+  /// Asset references for screenshots and favicon.
+  screenshotAssetId String?
+  faviconAssetId    String?
+  /// When screenshots were last captured.
+  capturedAt        DateTime?
+  /// When the site itself last changed: its page's Last-Modified, at the last visit that sent one.
+  siteUpdatedAt     DateTime?
+
+  createdAt DateTime @default(now())
+  updatedAt DateTime @updatedAt
+
+  @@index([host])
+  @@index([createdAt])
+}
+
+/// Many-to-many join between community tools and their owners.
+model DbCommunityToolOwner {
+  toolId     String
+  tool       DbCommunityTool @relation(fields: [toolId], references: [id], onDelete: Cascade)
+  personSlug String
+
+  @@id([toolId, personSlug])
+}
+
+/// A signed-in person liked the tool; their name is kept for "Liked by".
+model DbCommunityToolLike {
+  toolId    String
+  tool      DbCommunityTool @relation(fields: [toolId], references: [id], onDelete: Cascade)
+  userId    String
+  userName  String
+  createdAt DateTime        @default(now())
+
+  @@id([toolId, userId])
+}
+
+/// An owner outside the person directory: shown by name, never an editor.
+model DbCommunityToolNamedOwner {
+  toolId String
+  tool   DbCommunityTool @relation(fields: [toolId], references: [id], onDelete: Cascade)
+  name   String
+
+  @@id([toolId, name])
+}
+
+/// Tags attached to community tools (app associations and topics).
+model DbCommunityToolTag {
+  toolId String
+  tool   DbCommunityTool @relation(fields: [toolId], references: [id], onDelete: Cascade)
+
+  kind  CommunityTagKind
+  value String
+
+  @@id([toolId, kind, value])
+  @@index([kind, value])
+}
+
+/// View tracking for community tools (one row per viewer per tool per day).
+model DbCommunityToolView {
+  toolId String
+  tool   DbCommunityTool @relation(fields: [toolId], references: [id], onDelete: Cascade)
+
+  /// Hash of actor id for anonymous view tracking.
+  actorHash String
+  /// Optional user id for authenticated views.
+  userId    String?
+
+  /// Day this view occurred (UTC date, time truncated).
+  day DateTime @db.Date
+  /// Exact timestamp of the view.
+  at  DateTime @default(now())
+
+  @@id([toolId, actorHash, day])
+  @@index([userId, at])
+}
+
+/// User-specific tool pins for personalized ordering.
+model DbCommunityToolPin {
+  userId String
+  toolId String
+  tool   DbCommunityTool @relation(fields: [toolId], references: [id], onDelete: Cascade)
+
+  /// Position in the user's pinned list (lower = higher in list).
+  position Int
+
+  @@id([userId, toolId])
+}