Molino App (source of truth)          Spaces App (standalone)
├── Trips                              ├── Spaces DB
├── Experiences                        ├── SpaceSections DB
├── Offers                             ├── Profiles / Categories
├── Orders                             ├── Public rendering
├── Documents                          └── Discovery
└── Skills
            │
            │  POST /api/spaces  (Bearer token)
            ▼
    Spaces creates/returns spaceId, slug, publicUrl
            │
            ▼
    Molino stores ExternalSpace reference only

Rule: Spaces DB = source of truth for Spaces. Molino only stores external refs. No cross-DB writes.

Add to Molino's schema.prisma:

model ExternalSpace {
  id              String   @id @default(cuid())
  entityType      String
  entityId        String
  externalSpaceId String   @unique
  slug            String?
  publicUrl       String?
  status          String   @default("draft")
  provider        String   @default("spaces")
  createdAt       DateTime @default(now())
  updatedAt       DateTime @updatedAt

  @@index([entityType, entityId])
  @@index([provider])
}

// app/(spaces)/actions/createExternalSpaceFromEntity.ts
"use server"

import { prisma } from "@/lib/prisma"

type EntityType = "trip" | "experience" | "offer" | "product" | "skill" | "studio_service" | "platform_service"

export async function createExternalSpaceFromEntity(input: {
  entityType: EntityType
  entityId: string
  payload: {
    title: string
    summary?: string
    categorySlug?: string
    visibility?: "private" | "unlisted" | "public" | "local_public"
    geo?: {
      mode: "none" | "city" | "region" | "country" | "global"
      city?: string
      region?: string
      country?: string
      lat?: number
      lon?: number
      radiusKm?: number
    }
    sections: Array<{ key: string; order: number; content: unknown }>
    cta?: { label: string; href: string }
  }
}) {
  const apiUrl = process.env.SPACES_API_URL
  const apiKey = process.env.SPACES_API_KEY
  if (!apiUrl || !apiKey) throw new Error("Spaces API not configured")

  const response = await fetch(`${apiUrl}/api/spaces`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${apiKey}`,
    },
    body: JSON.stringify({
      sourceApp: "molino",
      sourceEntityType: input.entityType,
      sourceEntityId: input.entityId,
      ...input.payload,
    }),
  })

  if (!response.ok) {
    const message = await response.text()
    throw new Error(`Spaces API failed: ${message}`)
  }

  const result = await response.json()

  await prisma.externalSpace.upsert({
    where: { externalSpaceId: result.space.id },
    create: {
      entityType: input.entityType,
      entityId: input.entityId,
      externalSpaceId: result.space.id,
      slug: result.space.slug,
      publicUrl: `${process.env.SPACES_PUBLIC_BASE_URL}/spaces/${result.space.slug}`,
      status: result.space.status,
    },
    update: {
      slug: result.space.slug,
      publicUrl: `${process.env.SPACES_PUBLIC_BASE_URL}/spaces/${result.space.slug}`,
      status: result.space.status,
    },
  })

  return result
}

The existing route already handles POST with sections. It needs minor updates to accept external source fields. Add these fields to the Space model in Spaces' Prisma:

model Space {
  // ... existing fields ...
  sourceApp        String?
  sourceEntityType String?
  sourceEntityId   String?
  categorySlug     String?
  geoMode          String   @default("none")
  city             String?
  region           String?
  country          String?
  latitude         Float?
  longitude        Float?
  radiusKm         Float?
}

The API already creates spaces with sections. The body shape it accepts:

{
  title: string,
  slug: string,
  path: string,
  status?: "draft" | "published" | "scheduled" | "archived" | "broken",
  visibility?: "private" | "unlisted" | "public",
  sourceApp?: string,
  sourceEntityType?: string,
  sourceEntityId?: string,
  categorySlug?: string,
  sections: Array<{ type: string; content: object }>
}

Molino:

SPACES_API_URL=https://spaces-next-app-3kui34kvnq-ew.a.run.app
SPACES_API_KEY=<shared-secret>
SPACES_PUBLIC_BASE_URL=https://spaces-next-app-3kui34kvnq-ew.a.run.app

Spaces:

SPACES_API_KEY=<same-shared-secret>

1. Spaces: Verify /api/spaces POST route works with Bearer token auth (already exists)
2. Spaces: Add geo + source fields to Space model (optional, for Layer 4)
3. Molino: Add ExternalSpace model to Prisma schema
4. Molino: Add createExternalSpaceFromEntity server action
5. Molino: Build entity→space section mappers (computeTripSpaceSections, etc.)
6. Molino: Add "Publish to Spaces" buttons to admin pages
7. Both: Test end-to-end with one trip entity

Complete POST body to create a fully populated space:

{
  "title": "Al-Andalus Experience",
  "slug": "al-andalus-experience",
  "path": "/al-andalus-experience",
  "status": "published",
  "visibility": "public",
  "sections": [
    {
      "type": "poster",
      "content": {
        "title": "AL-ANDALUS",
        "subtitle": "EXPERIENCE",
        "date": "2026",
        "time": "GRANADA",
        "location": "AUTHENTIC SPANISH CULTURE",
        "image": "https://picsum.photos/seed/alandalus/800/600",
        "theme": "yellow",
        "badgeText": "EXCLUSIVE"
      }
    },
    {
      "type": "mission_statement",
      "content": {
        "title": "Our Mission",
        "content": "To deliver authentic Andalusian experiences through immersive cultural journeys."
      }
    },
    {
      "type": "hero",
      "content": {
        "title": "Discover Andalusia",
        "subtitle": "7 days of authentic Spanish culture, history and cuisine",
        "backgroundImage": "https://picsum.photos/seed/andalusia-hero/800/600",
        "ctaText": "Book Now",
        "ctaLink": "/book"
      }
    },
    {
      "type": "itinerary",
      "content": {
        "title": "Your Journey",
        "days": [
          { "day": "1", "title": "Arrival in Seville", "activities": ["Airport pickup", "Welcome dinner"] },
          { "day": "2", "title": "Seville Explorer", "activities": ["Real Alcázar", "Cathedral tour", "Tapas crawl"] },
          { "day": "3", "title": "Córdoba Day", "activities": ["Great Mosque", "Jewish Quarter", "Flamenco show"] }
        ]
      }
    },
    {
      "type": "destination_grid",
      "content": {
        "title": "Destinations",
        "items": [
          { "name": "Seville", "image": "https://picsum.photos/seed/seville/400/300", "description": "Capital of Andalusia" },
          { "name": "Córdoba", "image": "https://picsum.photos/seed/cordoba/400/300", "description": "Great Mosque & patios" },
          { "name": "Granada", "image": "https://picsum.photos/seed/granada/400/300", "description": "Alhambra Palace" }
        ]
      }
    },
    {
      "type": "tour_cards",
      "content": {
        "items": [
          { "title": "City Explorer", "description": "Seville & Córdoba", "image": "https://picsum.photos/seed/city-tour/400/300", "duration": "3 days", "price": "€349" },
          { "title": "Complete Tour", "description": "All highlights included", "image": "https://picsum.photos/seed/complete/400/300", "duration": "7 days", "price": "€899" }
        ]
      }
    },
    {
      "type": "pricing",
      "content": {
        "title": "Tour Packages",
        "subtitle": "Choose your adventure",
        "plans": [
          { "name": "Essential", "price": "€349", "period": "per person", "description": "Core experience", "features": ["3-day tour", "Hotel included", "Expert guide"], "buttonText": "Book", "buttonLink": "/book/essential" },
          { "name": "Complete", "price": "€899", "period": "per person", "description": "Full immersion", "features": ["7-day tour", "Boutique hotels", "All meals", "Private transport"], "buttonText": "Book", "buttonLink": "/book/complete", "isPopular": true }
        ]
      }
    },
    {
      "type": "faq",
      "content": {
        "subtitle": "Common Questions",
        "faqs": [
          { "question": "What is included?", "answer": "All tours include accommodation, guided visits, and entry tickets." },
          { "question": "Is this suitable for families?", "answer": "Yes! Children under 12 receive a 30% discount." }
        ]
      }
    },
    {
      "type": "cta",
      "content": {
        "subtitle": "Ready for Adventure?",
        "content": "Book your Andalusian journey today.",
        "ctaText": "Reserve Now",
        "ctaLink": "/book"
      }
    },
    {
      "type": "footer",
      "content": {
        "text": "© 2026 Al-Andalus Experience. All rights reserved."
      }
    }
  ]
}