@soulcraft/kits 1.0.0

package/kits/canvas-and-corks/kit.json

@@ -0,0 +1,910 @@
+{
+  "id": "canvas-and-corks",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "Canvas & Corks",
+  "description": "Paint & sip studio. Guests follow a guided artist through a featured painting while enjoying wine, cocktails, or mocktails. Classes for all skill levels — no experience required.",
+  "longDescription": "A paint-and-sip studio platform covering guided class bookings, private paint parties, instructor scheduling, and supply inventory. Supports memories, loyalty, and gift cards for repeat guests and occasion-driven groups.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "🎨",
+  "tags": [
+    "paint",
+    "sip",
+    "wine",
+    "art",
+    "class",
+    "experience",
+    "party"
+  ],
+  "previewImageUrl": "https://images.unsplash.com/photo-1516321318423-f06f85e504b3?w=800",
+  "variables": [
+    {
+      "key": "businessName",
+      "label": "Business Name",
+      "description": "The name of your studio (e.g. \"Canvas & Corks\")",
+      "type": "string",
+      "required": true,
+      "example": "Canvas & Corks",
+      "default": "Canvas & Corks"
+    },
+    {
+      "key": "tagline",
+      "label": "Tagline",
+      "description": "A short phrase describing your studio (shown under the logo)",
+      "type": "string",
+      "required": false,
+      "example": "paint. sip. create.",
+      "default": "paint. sip. create."
+    },
+    {
+      "key": "locationName",
+      "label": "Location Name",
+      "description": "The display name for this specific location (e.g. \"Canvas & Corks Midtown\")",
+      "type": "string",
+      "required": true,
+      "example": "Canvas & Corks Midtown"
+    },
+    {
+      "key": "locationSlug",
+      "label": "Location URL Slug",
+      "description": "URL-safe identifier for this location used in booking links (e.g. \"midtown\")",
+      "type": "string",
+      "required": true,
+      "example": "midtown"
+    },
+    {
+      "key": "address",
+      "label": "Street Address",
+      "description": "Street address of your studio",
+      "type": "address",
+      "required": true,
+      "example": "450 Park Ave S"
+    },
+    {
+      "key": "city",
+      "label": "City",
+      "description": "City where your studio is located",
+      "type": "string",
+      "required": true,
+      "example": "New York"
+    },
+    {
+      "key": "state",
+      "label": "State / Province",
+      "description": "Two-letter state or province code",
+      "type": "string",
+      "required": true,
+      "example": "NY"
+    },
+    {
+      "key": "zip",
+      "label": "ZIP / Postal Code",
+      "type": "string",
+      "required": true,
+      "example": "10016"
+    },
+    {
+      "key": "timezone",
+      "label": "Timezone",
+      "description": "IANA timezone for this location (used for scheduling)",
+      "type": "timezone",
+      "required": true,
+      "example": "America/New_York",
+      "default": "America/New_York"
+    },
+    {
+      "key": "phone",
+      "label": "Phone Number",
+      "type": "phone",
+      "required": true,
+      "example": "(212) 555-0194"
+    },
+    {
+      "key": "email",
+      "label": "Contact Email",
+      "type": "email",
+      "required": true,
+      "example": "hello@canvasandcorks.com"
+    },
+    {
+      "key": "instagram",
+      "label": "Instagram Handle",
+      "description": "Instagram username without the @",
+      "type": "string",
+      "required": false,
+      "example": "canvasandcorks"
+    },
+    {
+      "key": "facebook",
+      "label": "Facebook Page",
+      "description": "Facebook page name or URL slug",
+      "type": "string",
+      "required": false,
+      "example": "CanvasAndCorks"
+    },
+    {
+      "key": "tiktok",
+      "label": "TikTok Handle",
+      "description": "TikTok username without the @",
+      "type": "string",
+      "required": false,
+      "example": "canvasandcorks"
+    },
+    {
+      "key": "maxCapacity",
+      "label": "Studio Capacity",
+      "description": "Maximum number of painters at easels at one time",
+      "type": "number",
+      "required": false,
+      "example": "20",
+      "default": "20"
+    },
+    {
+      "key": "featuredArtist",
+      "label": "Featured Artist / Instructor Name",
+      "description": "Name of the lead instructor or resident artist (shown on About page)",
+      "type": "string",
+      "required": false,
+      "example": "Sofia Reyes"
+    }
+  ],
+  "shared": {
+    "industry": "paint-and-sip",
+    "category": "creative",
+    "glossary": {
+      "easel": "An adjustable stand holding a canvas upright at the painter's workstation",
+      "medium": "The type of paint used — acrylic, watercolor, oil, or mixed media",
+      "palette": "A flat surface for mixing paints before applying to canvas",
+      "featured painting": "The specific artwork guests reproduce during a guided class session",
+      "BYOB": "Bring Your Own Bottle — a class format where guests supply their own wine or beverages"
+    },
+    "aiExpertise": [
+      "painting instruction and art technique guidance",
+      "studio scheduling and class capacity management",
+      "beverage service and alcohol licensing",
+      "private event and birthday party planning",
+      "art supply inventory and COGS tracking"
+    ],
+    "dataModelHints": [
+      "booking",
+      "experience",
+      "time_slot",
+      "staff",
+      "customer",
+      "inventory_item"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "location",
+          "type": "Location",
+          "description": "A physical Canvas & Corks paint studio location with easel stations and beverage service.",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "📍"
+            },
+            "venue": {
+              "mapsTo": "LocationMeta",
+              "pos": false
+            }
+          }
+        },
+        {
+          "domain": "booking",
+          "type": "Event",
+          "description": "A guest reservation for a guided paint class, private paint party, kids class, or BYOB date night.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "📅"
+            },
+            "venue": {
+              "mapsTo": "BookingMeta",
+              "pos": true
+            },
+            "academy": {
+              "mapsTo": "practice-session",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "time_slot",
+          "type": "Event",
+          "description": "A scheduled class session with a featured painting, instructor assignment, and remaining easel capacity.",
+          "products": {
+            "workshop": {
+              "view": "timeline",
+              "icon": "🕐"
+            },
+            "venue": {
+              "mapsTo": "TimeSlotMeta",
+              "pos": false
+            }
+          }
+        },
+        {
+          "domain": "experience",
+          "type": "Product",
+          "description": "A class format such as Guided Paint Class, Private Paint Party, Kids Paint Class, or BYOB Date Night.",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "🎨"
+            },
+            "venue": {
+              "mapsTo": "ExperienceMeta",
+              "pos": true
+            },
+            "academy": {
+              "mapsTo": "skill-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "customer",
+          "type": "Person",
+          "description": "A guest painter or returning student, potentially part of a group booking or private party.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "👤"
+            },
+            "venue": {
+              "mapsTo": "CustomerMeta",
+              "pos": false
+            },
+            "academy": {
+              "mapsTo": "learner",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "staff",
+          "type": "Person",
+          "description": "A Paint Instructor who leads guided class sessions, or a Studio Host who handles check-in and service.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "🧑‍🎨"
+            },
+            "venue": {
+              "mapsTo": "StaffMeta",
+              "pos": false
+            },
+            "academy": {
+              "mapsTo": "instructor",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "inventory_item",
+          "type": "Thing",
+          "description": "An art supply item such as canvases, acrylic paints, brushes, palettes, aprons, or wine and beverages.",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "📦"
+            },
+            "venue": {
+              "mapsTo": "InventoryItemMeta",
+              "pos": false
+            },
+            "academy": {
+              "mapsTo": "material",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "gift_card",
+          "type": "Thing",
+          "description": "A digital or physical gift card redeemable for any paint class or private party booking.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "🎁"
+            },
+            "venue": {
+              "mapsTo": "GiftCardMeta",
+              "pos": true
+            }
+          }
+        },
+        {
+          "domain": "loyalty_account",
+          "type": "Person",
+          "description": "A returning painter's loyalty account tracking class attendance points and tier benefits.",
+          "products": {
+            "workshop": {
+              "view": "stats",
+              "icon": "⭐"
+            },
+            "venue": {
+              "mapsTo": "LoyaltyAccountMeta",
+              "pos": false
+            }
+          }
+        },
+        {
+          "domain": "transaction",
+          "type": "Measurement",
+          "description": "A revenue or refund record for a class booking or add-on purchase, always stored in cents.",
+          "products": {
+            "workshop": {
+              "view": "timeline",
+              "icon": "💳"
+            },
+            "venue": {
+              "mapsTo": "TransactionMeta",
+              "pos": false
+            }
+          }
+        },
+        {
+          "domain": "content_page",
+          "type": "Document",
+          "description": "A CMS-managed page such as About Our Studio, FAQ, or Private Party Information.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "📄"
+            },
+            "venue": {
+              "mapsTo": "ContentPageMeta",
+              "pos": false
+            },
+            "academy": {
+              "mapsTo": "learning-resource",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "blog_post",
+          "type": "Document",
+          "description": "A published post featuring featured paintings, artist spotlights, or studio event recaps.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "✍️"
+            },
+            "venue": {
+              "mapsTo": "BlogPostMeta",
+              "pos": false
+            },
+            "academy": {
+              "mapsTo": "learning-resource",
+              "assessable": false
+            }
+          }
+        }
+      ],
+      "relationships": [
+        {
+          "from": "customer",
+          "to": "booking",
+          "verb": "Creates",
+          "description": "Guest registers for a paint class or books a private paint party."
+        },
+        {
+          "from": "booking",
+          "to": "experience",
+          "verb": "Contains",
+          "description": "Booking is for a specific class format with a featured painting to recreate."
+        },
+        {
+          "from": "booking",
+          "to": "time_slot",
+          "verb": "ParticipatesIn",
+          "description": "Booking occupies seats in a specific class session slot."
+        },
+        {
+          "from": "experience",
+          "to": "time_slot",
+          "verb": "OccursAt",
+          "description": "A class format is scheduled at session slots available for guest enrollment."
+        },
+        {
+          "from": "experience",
+          "to": "inventory_item",
+          "verb": "Consumes",
+          "description": "Each class consumes canvases, paints, and brushes per guest for COGS tracking.",
+          "products": {
+            "venue": {
+              "triggers": "inventoryDeduction"
+            }
+          }
+        },
+        {
+          "from": "staff",
+          "to": "time_slot",
+          "verb": "ParticipatesIn",
+          "description": "A Paint Instructor is assigned to lead a specific class session."
+        },
+        {
+          "from": "transaction",
+          "to": "booking",
+          "verb": "References",
+          "description": "Payment or refund record links back to the class booking it covers."
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Upcoming class schedule",
+        "prompt": "Show me upcoming classes with current enrollment and remaining capacity"
+      },
+      {
+        "label": "Top paintings by bookings",
+        "prompt": "Which featured paintings have driven the most bookings this quarter?"
+      },
+      {
+        "label": "Private party pipeline",
+        "prompt": "Show me all upcoming private paint parties and their deposit status"
+      },
+      {
+        "label": "Supply reorder check",
+        "prompt": "Which paints, canvases, or brushes are running low and need reordering?"
+      }
+    ]
+  },
+  "workshop": {
+    "aiPersona": {
+      "role": "You are the AI assistant for Canvas & Corks — a paint and sip studio. You help studio managers fill classes, run private events, and keep supplies stocked. You understand the creative hospitality business inside and out.",
+      "expertise": [
+        "paint and sip class management and scheduling",
+        "art instruction and featured painting selection",
+        "private event coordination and upsells",
+        "beverage program and supply inventory",
+        "customer retention and loyalty programs"
+      ],
+      "tone": "collaborator"
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "class or painting session mentioned",
+          "instructor or artist referenced",
+          "painting name or featured artwork discussed",
+          "supply or paint color referenced",
+          "private party or group booking introduced"
+        ],
+        "typeMapping": {
+          "booking": "event",
+          "class": "event",
+          "painting session": "event",
+          "instructor": "person",
+          "customer": "person",
+          "guest": "person",
+          "canvas": "thing",
+          "paint": "thing",
+          "brush": "thing",
+          "experience": "product",
+          "transaction": "measurement"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "customer",
+          "to": "booking",
+          "verb": "Creates",
+          "description": "Customer registers for a class or books a private party"
+        },
+        {
+          "from": "staff",
+          "to": "booking",
+          "verb": "ParticipatesIn",
+          "description": "Paint instructor leads the class session"
+        },
+        {
+          "from": "booking",
+          "to": "experience",
+          "verb": "Contains",
+          "description": "Booking is for a specific class type with a featured painting"
+        },
+        {
+          "from": "experience",
+          "to": "inventory_item",
+          "verb": "Consumes",
+          "description": "Paints, canvases, and brushes consumed per class"
+        }
+      ],
+      "rules": [
+        "Every class booking must have a featured painting name recorded",
+        "Skill level should be collected per guest where possible",
+        "Private party bookings should capture color palette preference"
+      ]
+    },
+    "workspaceConfig": {
+      "paradigm": "analyst",
+      "defaultTab": "explore",
+      "defaultView": "graph"
+    },
+    "qualityGates": {
+      "projectChecks": [
+        "Each class experience type has a featured painting and medium defined",
+        "Instructor schedule is populated for the next 4 weeks",
+        "Canvas and paint inventory is linked to consuming experiences"
+      ]
+    },
+    "remoteWorkspace": {
+      "connectedWorkbenches": [
+        {
+          "name": "Class Schedule",
+          "view": "board",
+          "entityTypes": [
+            "time_slot",
+            "booking"
+          ],
+          "description": "Upcoming classes with enrollment counts and capacity"
+        },
+        {
+          "name": "Painting Gallery",
+          "view": "gallery",
+          "entityTypes": [
+            "event"
+          ],
+          "description": "Browse featured paintings by class with booking history"
+        },
+        {
+          "name": "Revenue Timeline",
+          "view": "timeline",
+          "entityTypes": [
+            "transaction"
+          ],
+          "description": "Revenue trends across class types and private events"
+        },
+        {
+          "name": "Instructor Schedule",
+          "view": "board",
+          "entityTypes": [
+            "staff",
+            "time_slot"
+          ],
+          "description": "Instructor assignments across upcoming class sessions"
+        },
+        {
+          "name": "Supply Network",
+          "view": "graph",
+          "entityTypes": [
+            "inventory_item",
+            "experience"
+          ],
+          "description": "Graph of art supplies consumed by each experience type"
+        }
+      ]
+    }
+  },
+  "academy": {
+    "skillPath": "painting-fundamentals",
+    "level": "beginner",
+    "learningObjectives": [
+      "Brush technique, pressure control, and stroke variation",
+      "Color mixing theory and achieving desired hues from primaries",
+      "Composition principles and layout on canvas",
+      "Acrylic layering, drying, and blending techniques"
+    ],
+    "assessmentTypes": [
+      "hands-on",
+      "portfolio"
+    ],
+    "certificationSlug": "canvas-painter"
+  },
+  "venue": {
+    "bookingNumberPrefix": "CC",
+    "subdomainPrefix": "canvas",
+    "features": {
+      "animals": false,
+      "adoption": false,
+      "memories": true,
+      "loyalty": true,
+      "giftCards": true,
+      "waivers": false,
+      "blog": true,
+      "pos": true,
+      "cms": true,
+      "partners": true,
+      "franchise": true,
+      "customerAccounts": true
+    },
+    "theme": {
+      "primary": "oklch(0.45 0.12 10)",
+      "bgBase": "oklch(0.97 0.01 75)",
+      "accent": "oklch(0.70 0.08 55)",
+      "textPrimary": "oklch(0.25 0.03 30)",
+      "displayFont": "Playfair Display",
+      "bodyFont": "Inter"
+    },
+    "experienceTypes": [
+      {
+        "slug": "guided-paint-class",
+        "name": "Guided Paint Class",
+        "description": "Follow our artist step-by-step through a featured painting while enjoying your favorite drink. All skill levels welcome — we provide everything you need.",
+        "priceInCents": 4500,
+        "durationMinutes": 120,
+        "minGuests": 1,
+        "maxGuests": 20,
+        "requiresWaiver": false,
+        "isCombo": false,
+        "sortOrder": 0,
+        "color": "oklch(0.65 0.10 10)",
+        "imageUrl": "https://images.unsplash.com/photo-1541753236788-b0ac1fc5009d?w=800",
+        "sessionAttributeDefinitions": [
+          {
+            "key": "paintingName",
+            "label": "Painting Name",
+            "type": "text",
+            "perGuest": false,
+            "required": true
+          },
+          {
+            "key": "skillLevel",
+            "label": "Skill Level",
+            "type": "select",
+            "perGuest": true,
+            "options": [
+              "First timer",
+              "Beginner",
+              "Intermediate",
+              "Advanced"
+            ],
+            "required": false
+          },
+          {
+            "key": "medium",
+            "label": "Medium",
+            "type": "select",
+            "perGuest": false,
+            "options": [
+              "Acrylic",
+              "Watercolor",
+              "Oil",
+              "Mixed media"
+            ],
+            "required": false
+          }
+        ]
+      },
+      {
+        "slug": "private-paint-party",
+        "name": "Private Paint Party",
+        "description": "Reserve the whole studio for your group! Choose any painting from our catalog, bring your own food, and we handle the rest. Perfect for birthdays, bachelorettes, and team building.",
+        "priceInCents": 5500,
+        "durationMinutes": 150,
+        "minGuests": 8,
+        "maxGuests": 20,
+        "requiresWaiver": false,
+        "isCombo": false,
+        "sortOrder": 1,
+        "color": "oklch(0.55 0.12 350)",
+        "imageUrl": "https://images.unsplash.com/photo-1517697471339-4aa32003c11a?w=800",
+        "pricingTiers": [
+          {
+            "minGuests": 8,
+            "maxGuests": 12,
+            "pricePerPersonInCents": 5500
+          },
+          {
+            "minGuests": 13,
+            "maxGuests": 16,
+            "pricePerPersonInCents": 5000
+          },
+          {
+            "minGuests": 17,
+            "maxGuests": 20,
+            "pricePerPersonInCents": 4500
+          }
+        ],
+        "sessionAttributeDefinitions": [
+          {
+            "key": "paintingName",
+            "label": "Painting Name",
+            "type": "text",
+            "perGuest": false,
+            "required": true
+          },
+          {
+            "key": "skillLevel",
+            "label": "Skill Level",
+            "type": "select",
+            "perGuest": true,
+            "options": [
+              "First timer",
+              "Beginner",
+              "Intermediate",
+              "Advanced"
+            ],
+            "required": false
+          },
+          {
+            "key": "colorPalette",
+            "label": "Color Palette",
+            "type": "select",
+            "perGuest": false,
+            "options": [
+              "Warm tones",
+              "Cool tones",
+              "Earth tones",
+              "Bright & bold",
+              "Monochrome",
+              "Pastel"
+            ],
+            "required": false
+          }
+        ]
+      },
+      {
+        "slug": "kids-paint-class",
+        "name": "Kids Paint Class",
+        "description": "A fun, age-appropriate painting session for little artists (ages 5–12). All supplies provided. Parents are welcome to join — just book an adult ticket too!",
+        "priceInCents": 2800,
+        "durationMinutes": 90,
+        "minGuests": 1,
+        "maxGuests": 16,
+        "requiresWaiver": false,
+        "isCombo": false,
+        "sortOrder": 2,
+        "color": "oklch(0.72 0.12 55)",
+        "imageUrl": "https://images.unsplash.com/photo-1555009393-f20bdb245c4d?w=800",
+        "sessionAttributeDefinitions": [
+          {
+            "key": "paintingName",
+            "label": "Painting Name",
+            "type": "text",
+            "perGuest": false,
+            "required": true
+          },
+          {
+            "key": "ageRange",
+            "label": "Age Range",
+            "type": "select",
+            "perGuest": false,
+            "options": [
+              "5–7",
+              "8–10",
+              "11–12",
+              "Mixed ages"
+            ],
+            "required": false
+          }
+        ]
+      },
+      {
+        "slug": "byob-date-night",
+        "name": "BYOB Date Night",
+        "description": "Bring your own bottle and paint side-by-side with your partner. Two coordinating paintings that look stunning displayed together. Perfect for anniversaries and date nights.",
+        "priceInCents": 4000,
+        "durationMinutes": 120,
+        "minGuests": 2,
+        "maxGuests": 2,
+        "requiresWaiver": false,
+        "isCombo": false,
+        "sortOrder": 3,
+        "color": "oklch(0.60 0.10 350)",
+        "imageUrl": "https://images.unsplash.com/photo-1522543558187-768b6df7c25c?w=800",
+        "sessionAttributeDefinitions": [
+          {
+            "key": "paintingName",
+            "label": "Painting Set Name",
+            "type": "text",
+            "perGuest": false,
+            "required": true
+          },
+          {
+            "key": "medium",
+            "label": "Medium",
+            "type": "select",
+            "perGuest": false,
+            "options": [
+              "Acrylic",
+              "Watercolor",
+              "Oil"
+            ],
+            "required": false
+          }
+        ]
+      }
+    ],
+    "inventoryCategories": [
+      {
+        "id": "canvas",
+        "label": "Canvases",
+        "icon": "🖼️"
+      },
+      {
+        "id": "paint",
+        "label": "Acrylic Paints",
+        "icon": "🎨"
+      },
+      {
+        "id": "brush",
+        "label": "Brushes",
+        "icon": "🖌️"
+      },
+      {
+        "id": "easel",
+        "label": "Easels & Boards",
+        "icon": "🪵"
+      },
+      {
+        "id": "apron",
+        "label": "Aprons",
+        "icon": "👘"
+      },
+      {
+        "id": "palette",
+        "label": "Palettes & Trays",
+        "icon": "🎭"
+      },
+      {
+        "id": "beverage",
+        "label": "Wine & Beverages",
+        "icon": "🍷"
+      },
+      {
+        "id": "supplies",
+        "label": "Supplies & Finishing",
+        "icon": "📦"
+      },
+      {
+        "id": "retail",
+        "label": "Retail Products",
+        "icon": "🛍️"
+      }
+    ],
+    "staffRoles": [
+      {
+        "id": "paint-instructor",
+        "label": "Paint Instructor",
+        "defaultCapabilities": [
+          "checkin",
+          "pos",
+          "inventory-view",
+          "session-log"
+        ]
+      },
+      {
+        "id": "studio-host",
+        "label": "Studio Host",
+        "defaultCapabilities": [
+          "checkin",
+          "pos"
+        ]
+      }
+    ],
+    "chatSuggestions": [
+      {
+        "label": "Book a class",
+        "message": "I'd like to book a painting class. What options do you have?",
+        "emoji": "🎨"
+      },
+      {
+        "label": "Private party info",
+        "message": "Tell me about booking a private paint party for my group.",
+        "emoji": "🥂"
+      },
+      {
+        "label": "What should I wear?",
+        "message": "What should I wear to a paint class? Will I get messy?",
+        "emoji": "👘"
+      },
+      {
+        "label": "Gift cards",
+        "message": "I'd like to buy a gift card. What are my options?",
+        "emoji": "🎁"
+      }
+    ],
+    "inventoryLevelDetection": "vision"
+  }
+}