VIBN Frontend for Coolify deployment

lib/types/logs.ts

@@ -0,0 +1,102 @@
+/**
+ * Logging types for monitoring and debugging
+ */
+
+import type { ChatMode } from '@/lib/ai/chat-modes';
+
+/**
+ * Log entry for project-related events
+ * 
+ * Stored in Firestore `project_logs` collection for monitoring,
+ * debugging, and prompt iteration.
+ */
+export interface ProjectLogEntry {
+  /** Firestore document ID */
+  id: string;
+
+  /** Project this log belongs to */
+  projectId: string;
+
+  /** User who triggered the event (if available) */
+  userId: string | null;
+
+  /** Event type for filtering */
+  eventType:
+    | 'chat_interaction'
+    | 'extraction'
+    | 'vision_generation'
+    | 'mvp_generation'
+    | 'marketing_generation'
+    | 'knowledge_import'
+    | 'batch_extraction'
+    | 'mode_transition'
+    | 'error';
+
+  /** Chat mode (if applicable) */
+  mode: ChatMode | null;
+
+  /** Project phase (if applicable) */
+  phase: string | null;
+
+  /** Which artifacts were used in this interaction */
+  artifactsUsed: string[];
+
+  /** Whether vector search was used */
+  usedVectorSearch: boolean;
+
+  /** Number of vector chunks retrieved (if applicable) */
+  vectorChunkCount?: number;
+
+  /** Prompt version identifier (for A/B testing) */
+  promptVersion: string | null;
+
+  /** Model used (e.g., 'gemini-2.0-flash-exp') */
+  modelUsed: string | null;
+
+  /** Whether the operation succeeded */
+  success: boolean;
+
+  /** Error message (if failed) */
+  errorMessage: string | null;
+
+  /** Additional metadata (flexible for future use) */
+  metadata?: Record<string, any>;
+
+  /** When this log was created */
+  createdAt: Date | string;
+}
+
+/**
+ * Input for creating a new log entry
+ * (id and createdAt are auto-generated)
+ */
+export type CreateProjectLogInput = Omit<ProjectLogEntry, 'id' | 'createdAt'>;
+
+/**
+ * Filters for querying logs
+ */
+export interface ProjectLogFilters {
+  projectId?: string;
+  userId?: string;
+  eventType?: ProjectLogEntry['eventType'];
+  mode?: ChatMode;
+  phase?: string;
+  success?: boolean;
+  startDate?: Date;
+  endDate?: Date;
+  limit?: number;
+}
+
+/**
+ * Aggregated log stats for monitoring
+ */
+export interface ProjectLogStats {
+  totalLogs: number;
+  successCount: number;
+  errorCount: number;
+  byEventType: Record<string, number>;
+  byMode: Record<string, number>;
+  avgVectorChunks: number;
+  vectorSearchUsageRate: number;
+}
+