@soulcraft/kits 1.0.0

package/kits/axe-house/kit.json

@@ -0,0 +1,931 @@
+{
+  "id": "axe-house",
+  "type": "soulcraft",
+  "role": "primary",
+  "status": "released",
+  "name": "The Axe House",
+  "description": "Axe throwing venue. Throw axes, drink beer, hit the bullseye, and forget about your week.",
+  "longDescription": "A full-featured platform for axe throwing venues managing lane bookings, coached sessions, league nights, and private events. Handles waivers, POS, leaderboards, and corporate team builds in one system.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Soulcraft Labs",
+    "email": "kits@soulcraft.com",
+    "url": "https://soulcraft.com"
+  },
+  "icon": "🪓",
+  "tags": [
+    "axe throwing",
+    "sport",
+    "party",
+    "team building",
+    "league",
+    "experience"
+  ],
+  "previewImageUrl": "https://images.unsplash.com/photo-1571019613454-1cb2f99b2d8b?w=800",
+  "variables": [
+    {
+      "key": "businessName",
+      "label": "Business Name",
+      "description": "The name of your business (e.g. \"The Axe House\")",
+      "type": "string",
+      "required": true,
+      "example": "The Axe House",
+      "default": "The Axe House"
+    },
+    {
+      "key": "tagline",
+      "label": "Tagline",
+      "description": "A short phrase shown under the logo (e.g. \"throw. score. repeat.\")",
+      "type": "string",
+      "required": false,
+      "example": "throw. score. repeat.",
+      "default": "throw. score. repeat."
+    },
+    {
+      "key": "locationName",
+      "label": "Location Name",
+      "description": "The display name for this specific location (e.g. \"The Axe House Denver\")",
+      "type": "string",
+      "required": true,
+      "example": "The Axe House Denver"
+    },
+    {
+      "key": "locationSlug",
+      "label": "Location URL Slug",
+      "description": "URL-safe identifier for this location used in booking links (e.g. \"denver-rino\")",
+      "type": "string",
+      "required": true,
+      "example": "denver-rino"
+    },
+    {
+      "key": "address",
+      "label": "Street Address",
+      "description": "Street address of your venue (e.g. \"3400 Walnut St, Unit B\")",
+      "type": "address",
+      "required": true,
+      "example": "3400 Walnut St, Unit B"
+    },
+    {
+      "key": "city",
+      "label": "City",
+      "description": "City where your venue is located",
+      "type": "string",
+      "required": true,
+      "example": "Denver"
+    },
+    {
+      "key": "state",
+      "label": "State / Province",
+      "description": "Two-letter state or province code",
+      "type": "string",
+      "required": true,
+      "example": "CO"
+    },
+    {
+      "key": "zip",
+      "label": "ZIP / Postal Code",
+      "type": "string",
+      "required": true,
+      "example": "80205"
+    },
+    {
+      "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": "(720) 555-0192"
+    },
+    {
+      "key": "email",
+      "label": "Contact Email",
+      "type": "email",
+      "required": true,
+      "example": "contact@theaxehouse.com"
+    },
+    {
+      "key": "instagram",
+      "label": "Instagram Handle",
+      "description": "Instagram username without the @",
+      "type": "string",
+      "required": false,
+      "example": "theaxehouse"
+    },
+    {
+      "key": "facebook",
+      "label": "Facebook Page",
+      "description": "Facebook page name or URL slug",
+      "type": "string",
+      "required": false,
+      "example": "theaxehouse"
+    },
+    {
+      "key": "tiktok",
+      "label": "TikTok Handle",
+      "description": "TikTok username without the @",
+      "type": "string",
+      "required": false,
+      "example": "theaxehouse"
+    },
+    {
+      "key": "laneCount",
+      "label": "Number of Throwing Lanes",
+      "description": "Total number of axe throwing lanes at this location",
+      "type": "number",
+      "required": false,
+      "example": "8",
+      "default": "8"
+    },
+    {
+      "key": "leagueNights",
+      "label": "League Night(s)",
+      "description": "Which night(s) league play runs (e.g., 'Thursday')",
+      "type": "string",
+      "required": false,
+      "example": "Thursday"
+    }
+  ],
+  "shared": {
+    "industry": "axe-throwing",
+    "category": "fitness",
+    "glossary": {
+      "hatchet": "A small single-bit axe used for standard throwing at shorter distances (12–15 ft)",
+      "big axe": "A full-size axe thrown with a two-handed grip at longer distances (18–20 ft)",
+      "bullseye": "The center scoring ring on a wooden target, worth the highest point value",
+      "lane": "A single throwing station with one or more targets and a throwing line",
+      "killing shot": "A blue dot target located outside the main rings, worth 5 points if landed on a specific call"
+    },
+    "aiExpertise": [
+      "axe throwing technique and coaching",
+      "venue operations and lane management",
+      "competitive league formats and scoring",
+      "team building event design",
+      "beverage service and bar operations"
+    ],
+    "dataModelHints": [
+      "booking",
+      "experience",
+      "time_slot",
+      "staff",
+      "customer",
+      "inventory_item"
+    ],
+    "dataModel": {
+      "entities": [
+        {
+          "domain": "location",
+          "type": "Location",
+          "description": "A physical Axe House venue location with throwing lanes, a bar, and its own operational settings.",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "📍"
+            },
+            "venue": {
+              "mapsTo": "LocationMeta",
+              "pos": false
+            }
+          }
+        },
+        {
+          "domain": "booking",
+          "type": "Event",
+          "description": "A lane reservation for an open throw session, league night, private party, or corporate team build.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "📅"
+            },
+            "venue": {
+              "mapsTo": "BookingMeta",
+              "pos": true
+            },
+            "academy": {
+              "mapsTo": "practice-session",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "time_slot",
+          "type": "Event",
+          "description": "An available lane session slot with assigned lanes, capacity, and start time.",
+          "products": {
+            "workshop": {
+              "view": "timeline",
+              "icon": "🕐"
+            },
+            "venue": {
+              "mapsTo": "TimeSlotMeta",
+              "pos": false
+            }
+          }
+        },
+        {
+          "domain": "experience",
+          "type": "Product",
+          "description": "A bookable experience type such as Open Throw, League Night, Private Party, Corporate Event, or Axe 101 Lesson.",
+          "products": {
+            "workshop": {
+              "view": "gallery",
+              "icon": "🪓"
+            },
+            "venue": {
+              "mapsTo": "ExperienceMeta",
+              "pos": true
+            },
+            "academy": {
+              "mapsTo": "skill-unit",
+              "assessable": true
+            }
+          }
+        },
+        {
+          "domain": "customer",
+          "type": "Person",
+          "description": "A guest thrower or returning customer, potentially a league member with a season history.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "👤"
+            },
+            "venue": {
+              "mapsTo": "CustomerMeta",
+              "pos": false
+            },
+            "academy": {
+              "mapsTo": "learner",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "staff",
+          "type": "Person",
+          "description": "An Axe Coach who runs throwing sessions and provides safety instruction, or a Bar Host.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "🧑‍🏫"
+            },
+            "venue": {
+              "mapsTo": "StaffMeta",
+              "pos": false
+            },
+            "academy": {
+              "mapsTo": "instructor",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "inventory_item",
+          "type": "Thing",
+          "description": "Equipment and supplies such as hatchets, big axes, targets, chalk, and bar beverages.",
+          "products": {
+            "workshop": {
+              "view": "graph",
+              "icon": "📦"
+            },
+            "venue": {
+              "mapsTo": "InventoryItemMeta",
+              "pos": false
+            },
+            "academy": {
+              "mapsTo": "material",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "waiver",
+          "type": "Document",
+          "description": "A digitally signed safety waiver required before any guest participates in a throwing session.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "📋"
+            },
+            "venue": {
+              "mapsTo": "WaiverMeta",
+              "pos": false
+            },
+            "academy": {
+              "mapsTo": "safety-acknowledgment",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "gift_card",
+          "type": "Thing",
+          "description": "A digital or physical gift card redeemable for lane sessions, lessons, or merchandise.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "🎁"
+            },
+            "venue": {
+              "mapsTo": "GiftCardMeta",
+              "pos": true
+            }
+          }
+        },
+        {
+          "domain": "loyalty_account",
+          "type": "Person",
+          "description": "A thrower loyalty account tracking visits and points earned, with tiers for regular league players.",
+          "products": {
+            "workshop": {
+              "view": "stats",
+              "icon": "⭐"
+            },
+            "venue": {
+              "mapsTo": "LoyaltyAccountMeta",
+              "pos": false
+            }
+          }
+        },
+        {
+          "domain": "transaction",
+          "type": "Measurement",
+          "description": "A revenue or refund record for a lane booking or bar purchase, always stored in cents.",
+          "products": {
+            "workshop": {
+              "view": "timeline",
+              "icon": "💳"
+            },
+            "venue": {
+              "mapsTo": "TransactionMeta",
+              "pos": false
+            }
+          }
+        },
+        {
+          "domain": "content_page",
+          "type": "Document",
+          "description": "A CMS-managed public page such as Safety Rules, League Info, or Private Events.",
+          "products": {
+            "workshop": {
+              "view": "board",
+              "icon": "📄"
+            },
+            "venue": {
+              "mapsTo": "ContentPageMeta",
+              "pos": false
+            },
+            "academy": {
+              "mapsTo": "learning-resource",
+              "assessable": false
+            }
+          }
+        },
+        {
+          "domain": "blog_post",
+          "type": "Document",
+          "description": "A published blog post covering league results, technique tips, or venue news.",
+          "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 books a lane session, league night slot, or private event."
+        },
+        {
+          "from": "booking",
+          "to": "experience",
+          "verb": "Contains",
+          "description": "Booking is for a specific experience type (Open Throw, League Night, Private Party, etc.)."
+        },
+        {
+          "from": "booking",
+          "to": "time_slot",
+          "verb": "ParticipatesIn",
+          "description": "Booking occupies a specific lane session slot."
+        },
+        {
+          "from": "experience",
+          "to": "time_slot",
+          "verb": "OccursAt",
+          "description": "An experience type is scheduled at available lane slots for guest booking."
+        },
+        {
+          "from": "experience",
+          "to": "inventory_item",
+          "verb": "Consumes",
+          "description": "Sessions consume hatchets, targets, and chalk — tracked for maintenance and reorder."
+        },
+        {
+          "from": "staff",
+          "to": "time_slot",
+          "verb": "ParticipatesIn",
+          "description": "An Axe Coach is assigned to a session slot to provide safety coaching and instruction."
+        },
+        {
+          "from": "transaction",
+          "to": "booking",
+          "verb": "References",
+          "description": "Payment or refund record links back to the lane booking it covers."
+        },
+        {
+          "from": "waiver",
+          "to": "booking",
+          "verb": "References",
+          "description": "Signed safety waiver is tied to the booking, required before any throwing begins."
+        }
+      ]
+    },
+    "suggestions": [
+      {
+        "label": "Lane utilization",
+        "prompt": "Show me lane utilization rates by day and time — where are we underbooked?"
+      },
+      {
+        "label": "League standings",
+        "prompt": "Pull up the current league standings and team scores for this season"
+      },
+      {
+        "label": "Revenue by event type",
+        "prompt": "Compare revenue across open throw, league night, private party, and corporate events"
+      },
+      {
+        "label": "Staff coaching load",
+        "prompt": "Show me how many coaching sessions each axe coach has run this month"
+      }
+    ]
+  },
+  "workshop": {
+    "aiPersona": {
+      "role": "You are the AI assistant for The Axe House — an axe throwing venue. You help managers optimize lane utilization, run competitive leagues, and deliver memorable private events. You know axe throwing operations inside and out.",
+      "expertise": [
+        "axe throwing venue operations and scheduling",
+        "competitive league management and scoring",
+        "private event and corporate team build logistics",
+        "beverage program and bar operations",
+        "safety protocol and waiver management"
+      ],
+      "tone": "collaborator"
+    },
+    "graphGuidance": {
+      "conceptCreation": {
+        "triggers": [
+          "booking or lane reservation mentioned",
+          "league team or season referenced",
+          "axe coach or staff member introduced",
+          "throwing style or technique discussed",
+          "inventory item or equipment referenced"
+        ],
+        "typeMapping": {
+          "booking": "event",
+          "lane session": "event",
+          "league night": "event",
+          "customer": "person",
+          "thrower": "person",
+          "coach": "person",
+          "axe": "thing",
+          "hatchet": "thing",
+          "target": "thing",
+          "experience": "product",
+          "transaction": "measurement"
+        }
+      },
+      "relationshipPatterns": [
+        {
+          "from": "customer",
+          "to": "booking",
+          "verb": "Creates",
+          "description": "Customer reserves a lane or event slot"
+        },
+        {
+          "from": "staff",
+          "to": "booking",
+          "verb": "ParticipatesIn",
+          "description": "Axe coach runs the session and provides instruction"
+        },
+        {
+          "from": "booking",
+          "to": "experience",
+          "verb": "Contains",
+          "description": "Booking is for a specific experience type (open throw, league, party)"
+        },
+        {
+          "from": "experience",
+          "to": "inventory_item",
+          "verb": "Consumes",
+          "description": "Axes, targets, and chalk consumed per session"
+        },
+        {
+          "from": "customer",
+          "to": "customer",
+          "verb": "ParticipatesIn",
+          "description": "League team members grouped together"
+        }
+      ],
+      "rules": [
+        "Every booking must be assigned to at least one lane",
+        "League bookings should track team name and season",
+        "Safety waivers must be signed before any throwing session"
+      ]
+    },
+    "workspaceConfig": {
+      "paradigm": "analyst",
+      "defaultTab": "explore",
+      "defaultView": "graph"
+    },
+    "qualityGates": {
+      "projectChecks": [
+        "All experience types have a waiver requirement set",
+        "Lane count is configured correctly for capacity planning",
+        "League night schedule is entered in the system"
+      ]
+    },
+    "remoteWorkspace": {
+      "connectedWorkbenches": [
+        {
+          "name": "Lane Schedule",
+          "view": "board",
+          "entityTypes": [
+            "time_slot",
+            "booking"
+          ],
+          "description": "View lane assignments and booking status across all sessions"
+        },
+        {
+          "name": "Revenue by Event Type",
+          "view": "stats",
+          "entityTypes": [
+            "transaction",
+            "booking"
+          ],
+          "description": "Compare revenue across open throw, league, private party, and corporate bookings"
+        },
+        {
+          "name": "Leaderboard",
+          "view": "gallery",
+          "entityTypes": [
+            "customer"
+          ],
+          "description": "Top throwers by score, visit frequency, and league standing"
+        },
+        {
+          "name": "Staff Roster",
+          "view": "board",
+          "entityTypes": [
+            "staff"
+          ],
+          "description": "Axe coaches and bar hosts with shift assignments"
+        },
+        {
+          "name": "Booking Trends",
+          "view": "timeline",
+          "entityTypes": [
+            "booking"
+          ],
+          "description": "Booking volume over time — spot seasonal peaks and slow periods"
+        }
+      ]
+    }
+  },
+  "academy": {
+    "skillPath": "axe-throwing",
+    "level": "beginner",
+    "learningObjectives": [
+      "Proper grip technique for hatchet and big axe",
+      "Stance, footwork, and body alignment for consistent throws",
+      "Release mechanics and rotation timing",
+      "Target reading and scoring strategy",
+      "Range safety protocols and responsible throwing"
+    ],
+    "assessmentTypes": [
+      "hands-on"
+    ],
+    "certificationSlug": "axe-thrower"
+  },
+  "venue": {
+    "bookingNumberPrefix": "AX",
+    "subdomainPrefix": "axe",
+    "features": {
+      "animals": false,
+      "adoption": false,
+      "memories": false,
+      "loyalty": true,
+      "giftCards": true,
+      "waivers": true,
+      "blog": true,
+      "pos": true,
+      "cms": true,
+      "partners": true,
+      "franchise": true,
+      "customerAccounts": true
+    },
+    "theme": {
+      "primary": "oklch(0.45 0.10 55)",
+      "bgBase": "oklch(0.15 0.04 45)",
+      "accent": "oklch(0.65 0.12 60)",
+      "textPrimary": "oklch(0.92 0.01 70)",
+      "displayFont": "Oswald",
+      "bodyFont": "Inter"
+    },
+    "experienceTypes": [
+      {
+        "slug": "open-throw",
+        "name": "Open Throw Session",
+        "description": "Reserve a lane, receive 20 minutes of safety coaching and technique instruction, then throw for the remaining time.",
+        "priceInCents": 2500,
+        "durationMinutes": 60,
+        "minGuests": 1,
+        "maxGuests": 6,
+        "requiresWaiver": true,
+        "isCombo": false,
+        "sortOrder": 0,
+        "color": "oklch(0.55 0.12 55)",
+        "sessionAttributeDefinitions": [
+          {
+            "key": "laneNumber",
+            "label": "Lane Number",
+            "type": "text",
+            "perGuest": false
+          },
+          {
+            "key": "throwStyle",
+            "label": "Throw Style",
+            "type": "select",
+            "options": [
+              "hatchet",
+              "big-axe"
+            ],
+            "perGuest": true
+          },
+          {
+            "key": "bestScore",
+            "label": "Best Score",
+            "type": "text",
+            "perGuest": true
+          }
+        ]
+      },
+      {
+        "slug": "league-night",
+        "name": "League Night",
+        "description": "Competitive league play with standings, playoffs, and trophies. Season runs 8 weeks.",
+        "priceInCents": 2000,
+        "durationMinutes": 120,
+        "minGuests": 4,
+        "maxGuests": 8,
+        "requiresWaiver": true,
+        "isCombo": false,
+        "sortOrder": 1,
+        "color": "oklch(0.50 0.14 35)",
+        "sessionAttributeDefinitions": [
+          {
+            "key": "laneNumber",
+            "label": "Lane Number",
+            "type": "text",
+            "perGuest": false
+          },
+          {
+            "key": "teamName",
+            "label": "Team Name",
+            "type": "text",
+            "perGuest": false
+          },
+          {
+            "key": "leagueSeason",
+            "label": "League Season",
+            "type": "text",
+            "perGuest": false
+          },
+          {
+            "key": "throwStyle",
+            "label": "Throw Style",
+            "type": "select",
+            "options": [
+              "hatchet",
+              "big-axe"
+            ],
+            "perGuest": true
+          }
+        ]
+      },
+      {
+        "slug": "private-party",
+        "name": "Private Party",
+        "description": "Reserve multiple lanes for your group. Competition formats, scoreboards, and a designated host.",
+        "priceInCents": 3500,
+        "durationMinutes": 120,
+        "minGuests": 8,
+        "maxGuests": 20,
+        "requiresWaiver": true,
+        "isCombo": false,
+        "sortOrder": 2,
+        "color": "oklch(0.48 0.13 48)",
+        "sessionAttributeDefinitions": [
+          {
+            "key": "laneCount",
+            "label": "Lanes Reserved",
+            "type": "text",
+            "perGuest": false
+          },
+          {
+            "key": "throwStyle",
+            "label": "Throw Style",
+            "type": "select",
+            "options": [
+              "hatchet",
+              "big-axe"
+            ],
+            "perGuest": true
+          },
+          {
+            "key": "competitionFormat",
+            "label": "Competition Format",
+            "type": "select",
+            "options": [
+              "freestyle",
+              "tournament",
+              "team-battle"
+            ],
+            "perGuest": false
+          }
+        ]
+      },
+      {
+        "slug": "corporate-event",
+        "name": "Corporate Event",
+        "description": "Full venue buyout or dedicated section. Competition, team scoring, and a performance debrief.",
+        "priceInCents": 4000,
+        "durationMinutes": 150,
+        "minGuests": 10,
+        "maxGuests": 30,
+        "requiresWaiver": true,
+        "isCombo": false,
+        "sortOrder": 3,
+        "color": "oklch(0.42 0.10 52)",
+        "sessionAttributeDefinitions": [
+          {
+            "key": "laneCount",
+            "label": "Lanes Reserved",
+            "type": "text",
+            "perGuest": false
+          },
+          {
+            "key": "companyName",
+            "label": "Company Name",
+            "type": "text",
+            "perGuest": false
+          },
+          {
+            "key": "competitionFormat",
+            "label": "Competition Format",
+            "type": "select",
+            "options": [
+              "freestyle",
+              "tournament",
+              "team-battle"
+            ],
+            "perGuest": false
+          }
+        ]
+      },
+      {
+        "slug": "axe-101",
+        "name": "Axe 101 Lesson",
+        "description": "Private technique session with an expert coach. Great for first-timers who want to get their form right before a party.",
+        "priceInCents": 3000,
+        "durationMinutes": 45,
+        "minGuests": 1,
+        "maxGuests": 4,
+        "requiresWaiver": true,
+        "isCombo": false,
+        "sortOrder": 4,
+        "color": "oklch(0.58 0.11 62)",
+        "sessionAttributeDefinitions": [
+          {
+            "key": "throwStyle",
+            "label": "Throw Style",
+            "type": "select",
+            "options": [
+              "hatchet",
+              "big-axe"
+            ],
+            "perGuest": true
+          },
+          {
+            "key": "coachNotes",
+            "label": "Coach Notes",
+            "type": "text",
+            "perGuest": false
+          }
+        ]
+      }
+    ],
+    "inventoryCategories": [
+      {
+        "id": "hatchet",
+        "label": "Hatchets",
+        "icon": "🪓"
+      },
+      {
+        "id": "big-axe",
+        "label": "Big Axes",
+        "icon": "⚔️"
+      },
+      {
+        "id": "targets",
+        "label": "Targets & Boards",
+        "icon": "🎯"
+      },
+      {
+        "id": "lane-supplies",
+        "label": "Lane Supplies & Chalk",
+        "icon": "🖊️"
+      },
+      {
+        "id": "safety",
+        "label": "Safety Equipment",
+        "icon": "🦺"
+      },
+      {
+        "id": "beverages",
+        "label": "Beverages & Bar",
+        "icon": "🍺"
+      },
+      {
+        "id": "retail",
+        "label": "Merchandise & Retail",
+        "icon": "🛍️"
+      },
+      {
+        "id": "maintenance",
+        "label": "Maintenance Supplies",
+        "icon": "🔧"
+      }
+    ],
+    "staffRoles": [
+      {
+        "id": "axe-coach",
+        "label": "Axe Coach",
+        "defaultCapabilities": [
+          "checkin",
+          "pos",
+          "session-log",
+          "inventory-view"
+        ]
+      },
+      {
+        "id": "bar-host",
+        "label": "Bar Host",
+        "defaultCapabilities": [
+          "pos"
+        ]
+      }
+    ],
+    "chatSuggestions": [
+      {
+        "label": "Book a lane",
+        "message": "I'd like to book a lane. What are my options?",
+        "emoji": "🪓"
+      },
+      {
+        "label": "League night info",
+        "message": "Tell me about league night. How does it work?",
+        "emoji": "🏆"
+      },
+      {
+        "label": "Private party for my group",
+        "message": "I'm planning a private party. How many people can you accommodate?",
+        "emoji": "🎉"
+      },
+      {
+        "label": "Gift cards",
+        "message": "I'm interested in buying a gift card. What options do you have?",
+        "emoji": "🎁"
+      }
+    ],
+    "inventoryLevelDetection": "manual"
+  }
+}