page analytics init

apps/server/src/database/migrations/20260809T000000-page-views.ts

@@ -0,0 +1,50 @@
+import { Kysely, sql } from 'kysely';
+
+export async function up(db: Kysely<any>): Promise<void> {
+  await db.schema
+    .createTable('page_views')
+    .ifNotExists()
+    .addColumn('id', 'uuid', (col) =>
+      col.primaryKey().defaultTo(sql`gen_uuid_v7()`),
+    )
+    .addColumn('workspace_id', 'uuid', (col) =>
+      col.references('workspaces.id').onDelete('cascade').notNull(),
+    )
+    .addColumn('page_id', 'uuid', (col) =>
+      col.references('pages.id').onDelete('cascade').notNull(),
+    )
+    .addColumn('space_id', 'uuid', (col) =>
+      col.references('spaces.id').onDelete('cascade'),
+    )
+    .addColumn('visitor_id', 'varchar', (col) => col.notNull())
+    .addColumn('view_date', 'varchar', (col) => col.notNull())
+    .addColumn('hits', 'int8', (col) => col.notNull().defaultTo(1))
+    .addColumn('last_viewed_at', 'timestamptz', (col) =>
+      col.notNull().defaultTo(sql`now()`),
+    )
+    .addColumn('created_at', 'timestamptz', (col) =>
+      col.notNull().defaultTo(sql`now()`),
+    )
+    .execute();
+
+  await db.schema
+    .createIndex('idx_page_views_workspace_page_date')
+    .ifNotExists()
+    .on('page_views')
+    .columns(['workspace_id', 'page_id', 'view_date'])
+    .execute();
+
+  await sql`
+    CREATE UNIQUE INDEX IF NOT EXISTS
+      uq_page_views_workspace_page_identity
+    ON page_views (
+      workspace_id,
+      page_id,
+      COALESCE(user_id::text, visitor_id)
+    )
+  `.execute(db);
+}
+
+export async function down(db: Kysely<any>): Promise<void> {
+  await db.schema.dropTable('page_views').ifExists().execute();
+}

apps/server/src/database/types/db.d.ts

@@ -544,6 +544,20 @@ export interface PagePermissions {
   updatedAt: Generated<Timestamp>;
 }
 
+export interface PageViews {
+  id: Generated<string>;
+  workspaceId: string;
+  pageId: string;
+  spaceId: string | null;
+  shareId: string | null;
+  userId: string | null;
+  visitorId: string;
+  viewDate: string;
+  hits: Generated<number>;
+  lastViewedAt: Generated<Timestamp>;
+  createdAt: Generated<Timestamp>;
+}
+
 export interface PageVerifications {
   id: Generated<string>;
   pageId: string;
@@ -662,6 +676,7 @@ export interface DB {
   pagePermissions: PagePermissions;
   pageHistory: PageHistory;
   pageLabels: PageLabels;
+  pageViews: PageViews;
   pageVerifications: PageVerifications;
   pageVerifiers: PageVerifiers;
   pages: Pages;

apps/server/src/database/types/entity.types.ts

@@ -1,6 +1,7 @@
 import { Insertable, Selectable, Updateable } from 'kysely';
 import {
   AiChats,
+  PageViews,
   AiChatMessages,
   Attachments,
   BaseProperties,
@@ -107,6 +108,10 @@ export type PageHistory = Selectable<History>;
 export type InsertablePageHistory = Insertable<History>;
 export type UpdatablePageHistory = Updateable<Omit<History, 'id'>>;
 
+export type PageView = Selectable<PageViews>;
+export type InsertablePageView = Insertable<PageViews>;
+export type UpdatablePageView = Updateable<Omit<PageViews, 'id'>>;
+
 // Comment
 export type Comment = Selectable<Comments>;
 export type InsertableComment = Insertable<Comments>;