Key concepts

// Workspace schema from lib/db/schema.ts
{
  id: string,
  name: string,               // "Acme Real Estate"
  slug: string,               // "acme-real-estate"
  
  // Company details (collected during onboarding)
  organizationNumber: string, // Norwegian org number
  contactEmail: string,
  contactPerson: string,
  
  // White-label branding
  logo: string | null,
  primaryColor: string | null,
  secondaryColor: string | null,
  
  // Status and billing
  status: "active" | "suspended" | "trial",
  plan: "free" | "pro" | "enterprise",
  onboardingCompleted: boolean
}

// Branding options:
{
  logo: "https://storage.example.com/workspace-123/logo.png",
  primaryColor: "#FF6B6B",   // Header, buttons, accents
  secondaryColor: "#4ECDC4"  // Secondary UI elements
}

// Image generation metadata example:
{
  metadata: {
    falRunId: "fal-run-12345",
    processingTime: 45.2,        // seconds
    modelVersion: "flux-pro/v1.1",
    originalSize: { width: 2048, height: 1536 },
    enhancedSize: { width: 2048, height: 1536 },
    costUSD: 0.055               // AI API cost
  }
}

// Style template definition (lib/style-templates.ts):
{
  id: "scandinavian",
  name: "Scandinavian",
  description: "Light, airy spaces with natural wood and minimal decor",
  category: "staging",
  thumbnail: "https://images.unsplash.com/.../",
  prompt: `Transform into a Scandinavian-style interior. Add light wooden 
           furniture, white and neutral tones, natural textures like linen 
           and wool, minimalist decor with clean lines. Include plants for 
           freshness. The space should feel bright, calm, and inviting with 
           excellent natural lighting.`,
  comingSoon: false
}

// Prompt generation (lib/style-templates.ts):
function generatePrompt(template: StyleTemplate, roomType: string | null) {
  const preserveStructure = 
    "Do not move, remove, or modify windows, walls, doors, or any " +
    "architectural elements. Keep the room layout exactly as shown.";
  
  let prompt = template.prompt;
  
  if (roomType) {
    const roomLabel = roomType.replace(/-/g, " ");
    prompt = `This is a ${roomLabel}. ${prompt}`;
  }
  
  return `${prompt} ${preserveStructure}`;
}

// Example output:
"This is a living room. Transform into a Scandinavian-style interior. 
Add light wooden furniture, white and neutral tones... Do not move, 
remove, or modify windows, walls, doors..."

// Planned feature:
{
  id: "custom-coastal",
  name: "Coastal Retreat",
  description: "Beach house vibes with blues and whites",
  category: "staging",
  prompt: "Your custom prompt here...",
  workspaceId: "workspace-123",  // Only visible to your workspace
  isPublic: false
}

{
  id: string,
  workspaceId: string,
  userId: string,
  projectId: string,
  
  // Image URLs
  originalImageUrl: string,      // Uploaded to Supabase
  resultImageUrl: string | null, // AI-enhanced result
  prompt: string,                // Full generated prompt
  
  // Version tracking
  version: number,               // 1, 2, 3...
  parentId: string | null,       // Links to previous version
  
  // Status
  status: "pending" | "processing" | "completed" | "failed",
  errorMessage: string | null,
  
  // Metadata
  metadata: jsonb,               // Fal.ai response, timings, costs
  
  createdAt: Date,
  updatedAt: Date
}

// Original enhancement:
{
  id: "img-v1",
  version: 1,
  parentId: null,
  styleTemplateId: "scandinavian",
  resultImageUrl: "https://.../scandinavian-result.jpg"
}

// Re-edited with different style:
{
  id: "img-v2",
  version: 2,
  parentId: "img-v1",
  styleTemplateId: "modern-minimalist",
  resultImageUrl: "https://.../modern-result.jpg"
}

{
  id: string,
  videoProjectId: string,
  
  // Source images
  sourceImageUrl: string,              // Start frame
  imageGenerationId: string | null,
  endImageUrl: string | null,          // End frame (optional)
  endImageGenerationId: string | null,
  
  // Room context
  roomType: string,                    // "living-room", "kitchen", etc.
  roomLabel: string | null,            // "Master Bedroom", "Front Yard"
  sequenceOrder: number,               // 1, 2, 3... (playback order)
  
  // AI generation
  motionPrompt: string | null,         // "Slow pan left to right"
  clipUrl: string | null,              // Kling AI output
  durationSeconds: number,             // Default: 5
  
  // Transitions
  transitionType: "cut" | "seamless",
  transitionClipUrl: string | null,    // Generated transition
  
  status: "pending" | "processing" | "completed" | "failed",
  metadata: jsonb
}

// Example video with 4 clips:
[
  { sequenceOrder: 1, roomType: "exterior",    roomLabel: "Front Facade" },
  { sequenceOrder: 2, roomType: "living-room", roomLabel: "Living Room" },
  { sequenceOrder: 3, roomType: "kitchen",     roomLabel: "Kitchen" },
  { sequenceOrder: 4, roomType: "bedroom",     roomLabel: "Master Suite" }
]

// User can drag-drop to reorder in the video editor

// Motion prompt examples:
"Slow pan from left to right, showcasing the entire space"
"Gentle zoom in towards the center, emphasizing the focal point"
"Steady dolly forward, moving deeper into the room"
"Static shot with subtle ambient movement"

// From lib/db/schema.ts:
type RoomType =
  // Interior
  | "living-room" | "kitchen" | "bedroom" | "bathroom" | "toilet"
  | "hallway" | "office" | "laundry-room" | "storage-room"
  | "walk-in-closet" | "sauna" | "gym" | "childrens-room"
  | "pool-area" | "dining-room" | "tv-room" | "library"
  | "hobby-room" | "utility-room" | "pantry" | "conservatory"
  // Exterior
  | "garage" | "terrace" | "garden" | "landscape" | "exterior"
  | "other";

// User-facing labels (lib/style-templates.ts):
const ROOM_TYPES = [
  {
    id: "living-room",
    label: "Living Room",
    icon: "IconSofa",
    description: "Living spaces, family rooms, lounges"
  },
  {
    id: "bedroom",
    label: "Bedroom",
    icon: "IconBed",
    description: "Bedrooms, master suites, guest rooms"
  },
  // ... etc
];

{
  id: string,
  workspaceId: string,
  projectId: string | null,
  videoProjectId: string | null,
  description: "AI Photo Enhancement - 5 images",
  amountOre: 100000,              // 1000 NOK (stored in ore, smallest unit)
  quantity: 1,
  status: "pending" | "invoiced" | "cancelled",
  invoiceId: string | null        // Linked when invoice is generated
}