skytab_sandbox_simulator 0.1.0

data/lib/skytab_sandbox_simulator/data/bar_nightclub/items.json

@@ -0,0 +1,28 @@
+{
+  "items": [
+    { "name": "House Lager", "price": 599, "category": "Draft Beer", "sku": "BAR-DRF-001" },
+    { "name": "IPA", "price": 699, "category": "Draft Beer", "sku": "BAR-DRF-002" },
+    { "name": "Stout", "price": 749, "category": "Draft Beer", "sku": "BAR-DRF-003" },
+    { "name": "Wheat Beer", "price": 649, "category": "Draft Beer", "sku": "BAR-DRF-004" },
+
+    { "name": "Margarita", "price": 1199, "category": "Cocktails", "sku": "BAR-COC-001" },
+    { "name": "Old Fashioned", "price": 1399, "category": "Cocktails", "sku": "BAR-COC-002" },
+    { "name": "Mojito", "price": 1199, "category": "Cocktails", "sku": "BAR-COC-003" },
+    { "name": "Espresso Martini", "price": 1499, "category": "Cocktails", "sku": "BAR-COC-004" },
+
+    { "name": "Whiskey Neat", "price": 1099, "category": "Spirits", "sku": "BAR-SPI-001" },
+    { "name": "Vodka Soda", "price": 899, "category": "Spirits", "sku": "BAR-SPI-002" },
+    { "name": "Tequila Shot", "price": 799, "category": "Spirits", "sku": "BAR-SPI-003" },
+    { "name": "Rum and Coke", "price": 899, "category": "Spirits", "sku": "BAR-SPI-004" },
+
+    { "name": "House Red", "price": 899, "category": "Wine", "sku": "BAR-WIN-001" },
+    { "name": "House White", "price": 899, "category": "Wine", "sku": "BAR-WIN-002" },
+    { "name": "Prosecco", "price": 999, "category": "Wine", "sku": "BAR-WIN-003" },
+    { "name": "Rose", "price": 999, "category": "Wine", "sku": "BAR-WIN-004" },
+
+    { "name": "Loaded Fries", "price": 899, "category": "Bar Snacks", "sku": "BAR-SNK-001" },
+    { "name": "Sliders", "price": 1199, "category": "Bar Snacks", "sku": "BAR-SNK-002" },
+    { "name": "Wings", "price": 1099, "category": "Bar Snacks", "sku": "BAR-SNK-003" },
+    { "name": "Pretzel Bites", "price": 799, "category": "Bar Snacks", "sku": "BAR-SNK-004" }
+  ]
+}

data/lib/skytab_sandbox_simulator/data/bar_nightclub/tenders.json

@@ -0,0 +1,19 @@
+{
+  "tenders": [
+    { "label": "Cash", "pos_ref": "CASH", "weight": 10 },
+    { "label": "Visa", "pos_ref": "VISA", "weight": 30 },
+    { "label": "Mastercard", "pos_ref": "MASTERCARD", "weight": 25 },
+    { "label": "Amex", "pos_ref": "AMEX", "weight": 15 },
+    { "label": "Discover", "pos_ref": "DISCOVER", "weight": 5 },
+    { "label": "House Account", "pos_ref": "HOUSE_ACCOUNT", "weight": 15 }
+  ],
+  "revenue_classes": [
+    { "label": "Bar", "pos_ref": "BAR" },
+    { "label": "Dine-In", "pos_ref": "DINE_IN" },
+    { "label": "Takeout", "pos_ref": "TAKEOUT" }
+  ],
+  "tax_rates": [
+    { "name": "Sales Tax", "rate": 82500, "note": "8.25%" },
+    { "name": "Alcohol Tax", "rate": 100000, "note": "10.0%" }
+  ]
+}

data/lib/skytab_sandbox_simulator/data/cafe_bakery/categories.json

@@ -0,0 +1,9 @@
+{
+  "categories": [
+    { "name": "Coffee & Espresso", "sort_order": 1, "description": "Hot and cold coffee drinks" },
+    { "name": "Pastries", "sort_order": 2, "description": "Fresh-baked goods" },
+    { "name": "Breakfast", "sort_order": 3, "description": "Morning favorites" },
+    { "name": "Sandwiches & Wraps", "sort_order": 4, "description": "Lunch fare" },
+    { "name": "Smoothies & Juice", "sort_order": 5, "description": "Fresh blended drinks" }
+  ]
+}

data/lib/skytab_sandbox_simulator/data/cafe_bakery/items.json

@@ -0,0 +1,30 @@
+{
+  "items": [
+    { "name": "House Drip Coffee", "price": 299, "category": "Coffee & Espresso", "sku": "CAFE-COF-001" },
+    { "name": "Espresso", "price": 350, "category": "Coffee & Espresso", "sku": "CAFE-COF-002" },
+    { "name": "Cappuccino", "price": 499, "category": "Coffee & Espresso", "sku": "CAFE-COF-003" },
+    { "name": "Latte", "price": 549, "category": "Coffee & Espresso", "sku": "CAFE-COF-004" },
+    { "name": "Cold Brew", "price": 499, "category": "Coffee & Espresso", "sku": "CAFE-COF-005" },
+
+    { "name": "Croissant", "price": 399, "category": "Pastries", "sku": "CAFE-PAS-001" },
+    { "name": "Blueberry Muffin", "price": 399, "category": "Pastries", "sku": "CAFE-PAS-002" },
+    { "name": "Cinnamon Roll", "price": 449, "category": "Pastries", "sku": "CAFE-PAS-003" },
+    { "name": "Chocolate Chip Cookie", "price": 299, "category": "Pastries", "sku": "CAFE-PAS-004" },
+    { "name": "Almond Croissant", "price": 449, "category": "Pastries", "sku": "CAFE-PAS-005" },
+
+    { "name": "Avocado Toast", "price": 1099, "category": "Breakfast", "sku": "CAFE-BRK-001" },
+    { "name": "Breakfast Burrito", "price": 999, "category": "Breakfast", "sku": "CAFE-BRK-002" },
+    { "name": "Acai Bowl", "price": 1199, "category": "Breakfast", "sku": "CAFE-BRK-003" },
+    { "name": "Yogurt Parfait", "price": 699, "category": "Breakfast", "sku": "CAFE-BRK-004" },
+
+    { "name": "Turkey Club", "price": 1199, "category": "Sandwiches & Wraps", "sku": "CAFE-SAN-001" },
+    { "name": "Caprese Panini", "price": 1099, "category": "Sandwiches & Wraps", "sku": "CAFE-SAN-002" },
+    { "name": "Chicken Caesar Wrap", "price": 1099, "category": "Sandwiches & Wraps", "sku": "CAFE-SAN-003" },
+    { "name": "BLT", "price": 999, "category": "Sandwiches & Wraps", "sku": "CAFE-SAN-004" },
+
+    { "name": "Berry Blast Smoothie", "price": 699, "category": "Smoothies & Juice", "sku": "CAFE-SMO-001" },
+    { "name": "Green Detox Juice", "price": 799, "category": "Smoothies & Juice", "sku": "CAFE-SMO-002" },
+    { "name": "Mango Tango Smoothie", "price": 699, "category": "Smoothies & Juice", "sku": "CAFE-SMO-003" },
+    { "name": "Fresh Orange Juice", "price": 499, "category": "Smoothies & Juice", "sku": "CAFE-SMO-004" }
+  ]
+}

data/lib/skytab_sandbox_simulator/data/cafe_bakery/tenders.json

@@ -0,0 +1,17 @@
+{
+  "tenders": [
+    { "label": "Cash", "pos_ref": "CASH", "weight": 20 },
+    { "label": "Visa", "pos_ref": "VISA", "weight": 30 },
+    { "label": "Mastercard", "pos_ref": "MASTERCARD", "weight": 20 },
+    { "label": "Amex", "pos_ref": "AMEX", "weight": 10 },
+    { "label": "Discover", "pos_ref": "DISCOVER", "weight": 5 },
+    { "label": "Gift Card", "pos_ref": "GIFT_CARD", "weight": 15 }
+  ],
+  "revenue_classes": [
+    { "label": "Dine-In", "pos_ref": "DINE_IN" },
+    { "label": "Takeout", "pos_ref": "TAKEOUT" }
+  ],
+  "tax_rates": [
+    { "name": "Sales Tax", "rate": 82500, "note": "8.25%" }
+  ]
+}

data/lib/skytab_sandbox_simulator/data/fine_dining/categories.json

@@ -0,0 +1,9 @@
+{
+  "categories": [
+    { "name": "First Course", "sort_order": 1, "description": "Opening courses" },
+    { "name": "Main Course", "sort_order": 2, "description": "Principal courses" },
+    { "name": "Desserts", "sort_order": 3, "description": "Artisan desserts" },
+    { "name": "Wine List", "sort_order": 4, "description": "Curated wine selection" },
+    { "name": "Cocktails", "sort_order": 5, "description": "Signature cocktails" }
+  ]
+}

data/lib/skytab_sandbox_simulator/data/fine_dining/items.json

@@ -0,0 +1,30 @@
+{
+  "items": [
+    { "name": "Seared Foie Gras", "price": 3200, "category": "First Course", "sku": "FIN-FST-001" },
+    { "name": "Lobster Bisque", "price": 1800, "category": "First Course", "sku": "FIN-FST-002" },
+    { "name": "Tuna Tartare", "price": 2400, "category": "First Course", "sku": "FIN-FST-003" },
+    { "name": "Burrata Salad", "price": 1900, "category": "First Course", "sku": "FIN-FST-004" },
+    { "name": "Oysters Half Dozen", "price": 2800, "category": "First Course", "sku": "FIN-FST-005" },
+
+    { "name": "Wagyu Ribeye", "price": 8500, "category": "Main Course", "sku": "FIN-MAN-001" },
+    { "name": "Chilean Sea Bass", "price": 4200, "category": "Main Course", "sku": "FIN-MAN-002" },
+    { "name": "Rack of Lamb", "price": 5200, "category": "Main Course", "sku": "FIN-MAN-003" },
+    { "name": "Duck Breast", "price": 3800, "category": "Main Course", "sku": "FIN-MAN-004" },
+    { "name": "Truffle Risotto", "price": 3200, "category": "Main Course", "sku": "FIN-MAN-005" },
+
+    { "name": "Creme Brulee", "price": 1600, "category": "Desserts", "sku": "FIN-DES-001" },
+    { "name": "Chocolate Souffle", "price": 1800, "category": "Desserts", "sku": "FIN-DES-002" },
+    { "name": "Dessert Tasting Plate", "price": 2200, "category": "Desserts", "sku": "FIN-DES-003" },
+    { "name": "Artisan Cheese Board", "price": 2600, "category": "Desserts", "sku": "FIN-DES-004" },
+    { "name": "Tiramisu", "price": 1500, "category": "Desserts", "sku": "FIN-DES-005" },
+
+    { "name": "Champagne", "price": 2200, "category": "Wine List", "sku": "FIN-WIN-001" },
+    { "name": "Cabernet Sauvignon", "price": 1800, "category": "Wine List", "sku": "FIN-WIN-002" },
+    { "name": "Pinot Noir", "price": 1600, "category": "Wine List", "sku": "FIN-WIN-003" },
+    { "name": "Chardonnay", "price": 1500, "category": "Wine List", "sku": "FIN-WIN-004" },
+
+    { "name": "Negroni", "price": 1800, "category": "Cocktails", "sku": "FIN-COC-001" },
+    { "name": "Manhattan", "price": 1900, "category": "Cocktails", "sku": "FIN-COC-002" },
+    { "name": "French 75", "price": 1700, "category": "Cocktails", "sku": "FIN-COC-003" }
+  ]
+}

data/lib/skytab_sandbox_simulator/data/fine_dining/tenders.json

@@ -0,0 +1,18 @@
+{
+  "tenders": [
+    { "label": "Visa", "pos_ref": "VISA", "weight": 30 },
+    { "label": "Mastercard", "pos_ref": "MASTERCARD", "weight": 20 },
+    { "label": "Amex", "pos_ref": "AMEX", "weight": 25 },
+    { "label": "Discover", "pos_ref": "DISCOVER", "weight": 5 },
+    { "label": "Cash", "pos_ref": "CASH", "weight": 5 },
+    { "label": "House Account", "pos_ref": "HOUSE_ACCOUNT", "weight": 15 }
+  ],
+  "revenue_classes": [
+    { "label": "Dine-In", "pos_ref": "DINE_IN" },
+    { "label": "Bar", "pos_ref": "BAR" }
+  ],
+  "tax_rates": [
+    { "name": "Sales Tax", "rate": 82500, "note": "8.25%" },
+    { "name": "Alcohol Tax", "rate": 100000, "note": "10.0%" }
+  ]
+}

data/lib/skytab_sandbox_simulator/data/pizzeria/categories.json

@@ -0,0 +1,9 @@
+{
+  "categories": [
+    { "name": "Pizzas", "sort_order": 1, "description": "Hand-tossed pizzas" },
+    { "name": "Calzones", "sort_order": 2, "description": "Folded and baked" },
+    { "name": "Sides", "sort_order": 3, "description": "Perfect with pizza" },
+    { "name": "Drinks", "sort_order": 4, "description": "Beverages" },
+    { "name": "Desserts", "sort_order": 5, "description": "Sweet endings" }
+  ]
+}

data/lib/skytab_sandbox_simulator/data/pizzeria/items.json

@@ -0,0 +1,28 @@
+{
+  "items": [
+    { "name": "Margherita", "price": 1499, "category": "Pizzas", "sku": "PIZ-PIZ-001" },
+    { "name": "Pepperoni", "price": 1599, "category": "Pizzas", "sku": "PIZ-PIZ-002" },
+    { "name": "Supreme", "price": 1899, "category": "Pizzas", "sku": "PIZ-PIZ-003" },
+    { "name": "Hawaiian", "price": 1599, "category": "Pizzas", "sku": "PIZ-PIZ-004" },
+    { "name": "BBQ Chicken Pizza", "price": 1799, "category": "Pizzas", "sku": "PIZ-PIZ-005" },
+    { "name": "Meat Lovers", "price": 1899, "category": "Pizzas", "sku": "PIZ-PIZ-006" },
+
+    { "name": "Classic Calzone", "price": 1299, "category": "Calzones", "sku": "PIZ-CAL-001" },
+    { "name": "Meat Calzone", "price": 1499, "category": "Calzones", "sku": "PIZ-CAL-002" },
+    { "name": "Stromboli", "price": 1399, "category": "Calzones", "sku": "PIZ-CAL-003" },
+    { "name": "Spinach Calzone", "price": 1299, "category": "Calzones", "sku": "PIZ-CAL-004" },
+
+    { "name": "Garlic Bread", "price": 499, "category": "Sides", "sku": "PIZ-SID-001" },
+    { "name": "Garden Salad", "price": 699, "category": "Sides", "sku": "PIZ-SID-002" },
+    { "name": "Caesar Salad", "price": 799, "category": "Sides", "sku": "PIZ-SID-003" },
+    { "name": "Garlic Knots", "price": 499, "category": "Sides", "sku": "PIZ-SID-004" },
+
+    { "name": "Fountain Drink", "price": 299, "category": "Drinks", "sku": "PIZ-DRK-001" },
+    { "name": "Iced Tea", "price": 299, "category": "Drinks", "sku": "PIZ-DRK-002" },
+    { "name": "Lemonade", "price": 349, "category": "Drinks", "sku": "PIZ-DRK-003" },
+
+    { "name": "Cannoli", "price": 599, "category": "Desserts", "sku": "PIZ-DES-001" },
+    { "name": "Chocolate Brownie", "price": 499, "category": "Desserts", "sku": "PIZ-DES-002" },
+    { "name": "Cheesecake", "price": 699, "category": "Desserts", "sku": "PIZ-DES-003" }
+  ]
+}

data/lib/skytab_sandbox_simulator/data/pizzeria/tenders.json

@@ -0,0 +1,18 @@
+{
+  "tenders": [
+    { "label": "Cash", "pos_ref": "CASH", "weight": 20 },
+    { "label": "Visa", "pos_ref": "VISA", "weight": 30 },
+    { "label": "Mastercard", "pos_ref": "MASTERCARD", "weight": 20 },
+    { "label": "Amex", "pos_ref": "AMEX", "weight": 10 },
+    { "label": "Discover", "pos_ref": "DISCOVER", "weight": 5 },
+    { "label": "Gift Card", "pos_ref": "GIFT_CARD", "weight": 15 }
+  ],
+  "revenue_classes": [
+    { "label": "Dine-In", "pos_ref": "DINE_IN" },
+    { "label": "Takeout", "pos_ref": "TAKEOUT" },
+    { "label": "Delivery", "pos_ref": "DELIVERY" }
+  ],
+  "tax_rates": [
+    { "name": "Sales Tax", "rate": 82500, "note": "8.25%" }
+  ]
+}

data/lib/skytab_sandbox_simulator/data/restaurant/categories.json

@@ -0,0 +1,44 @@
+{
+  "categories": [
+    {
+      "name": "Appetizers",
+      "sort_order": 1,
+      "description": "Starters and shareables"
+    },
+    {
+      "name": "Entrees",
+      "sort_order": 2,
+      "description": "Main courses"
+    },
+    {
+      "name": "Sides",
+      "sort_order": 3,
+      "description": "Side dishes"
+    },
+    {
+      "name": "Desserts",
+      "sort_order": 4,
+      "description": "Sweet finishes"
+    },
+    {
+      "name": "Beverages",
+      "sort_order": 5,
+      "description": "Non-alcoholic drinks"
+    },
+    {
+      "name": "Alcohol",
+      "sort_order": 6,
+      "description": "Beer, wine, and cocktails"
+    },
+    {
+      "name": "Kids Menu",
+      "sort_order": 7,
+      "description": "For our younger guests"
+    },
+    {
+      "name": "Specials",
+      "sort_order": 8,
+      "description": "Chef's daily specials"
+    }
+  ]
+}

data/lib/skytab_sandbox_simulator/data/restaurant/items.json

@@ -0,0 +1,59 @@
+{
+  "items": [
+    { "name": "Buffalo Wings", "price": 1299, "category": "Appetizers", "sku": "REST-APP-001" },
+    { "name": "Mozzarella Sticks", "price": 999, "category": "Appetizers", "sku": "REST-APP-002" },
+    { "name": "Loaded Nachos", "price": 1199, "category": "Appetizers", "sku": "REST-APP-003" },
+    { "name": "Spinach Artichoke Dip", "price": 1099, "category": "Appetizers", "sku": "REST-APP-004" },
+    { "name": "Calamari", "price": 1399, "category": "Appetizers", "sku": "REST-APP-005" },
+    { "name": "Bruschetta", "price": 999, "category": "Appetizers", "sku": "REST-APP-006" },
+    { "name": "Shrimp Cocktail", "price": 1599, "category": "Appetizers", "sku": "REST-APP-007" },
+
+    { "name": "Classic Burger", "price": 1499, "category": "Entrees", "sku": "REST-ENT-001" },
+    { "name": "Grilled Salmon", "price": 2199, "category": "Entrees", "sku": "REST-ENT-002" },
+    { "name": "NY Strip Steak", "price": 2899, "category": "Entrees", "sku": "REST-ENT-003" },
+    { "name": "Chicken Parmesan", "price": 1899, "category": "Entrees", "sku": "REST-ENT-004" },
+    { "name": "Fettuccine Alfredo", "price": 1599, "category": "Entrees", "sku": "REST-ENT-005" },
+    { "name": "Fish and Chips", "price": 1699, "category": "Entrees", "sku": "REST-ENT-006" },
+    { "name": "BBQ Ribs", "price": 2399, "category": "Entrees", "sku": "REST-ENT-007" },
+    { "name": "Mushroom Risotto", "price": 1799, "category": "Entrees", "sku": "REST-ENT-008" },
+    { "name": "Shrimp Scampi", "price": 2099, "category": "Entrees", "sku": "REST-ENT-009" },
+
+    { "name": "French Fries", "price": 499, "category": "Sides", "sku": "REST-SID-001" },
+    { "name": "Sweet Potato Fries", "price": 599, "category": "Sides", "sku": "REST-SID-002" },
+    { "name": "Onion Rings", "price": 549, "category": "Sides", "sku": "REST-SID-003" },
+    { "name": "Coleslaw", "price": 399, "category": "Sides", "sku": "REST-SID-004" },
+    { "name": "Mashed Potatoes", "price": 499, "category": "Sides", "sku": "REST-SID-005" },
+    { "name": "Steamed Vegetables", "price": 449, "category": "Sides", "sku": "REST-SID-006" },
+    { "name": "Garlic Bread", "price": 449, "category": "Sides", "sku": "REST-SID-007" },
+
+    { "name": "Chocolate Brownie", "price": 699, "category": "Desserts", "sku": "REST-DES-001" },
+    { "name": "New York Cheesecake", "price": 799, "category": "Desserts", "sku": "REST-DES-002" },
+    { "name": "Apple Pie", "price": 749, "category": "Desserts", "sku": "REST-DES-003" },
+    { "name": "Tiramisu", "price": 899, "category": "Desserts", "sku": "REST-DES-004" },
+    { "name": "Creme Brulee", "price": 949, "category": "Desserts", "sku": "REST-DES-005" },
+
+    { "name": "Soft Drink", "price": 299, "category": "Beverages", "sku": "REST-BEV-001" },
+    { "name": "Iced Tea", "price": 299, "category": "Beverages", "sku": "REST-BEV-002" },
+    { "name": "Lemonade", "price": 349, "category": "Beverages", "sku": "REST-BEV-003" },
+    { "name": "Coffee", "price": 349, "category": "Beverages", "sku": "REST-BEV-004" },
+    { "name": "Hot Tea", "price": 299, "category": "Beverages", "sku": "REST-BEV-005" },
+    { "name": "Sparkling Water", "price": 349, "category": "Beverages", "sku": "REST-BEV-006" },
+    { "name": "Fresh Juice", "price": 499, "category": "Beverages", "sku": "REST-BEV-007" },
+
+    { "name": "Draft Beer", "price": 599, "category": "Alcohol", "sku": "REST-ALC-001" },
+    { "name": "Domestic Beer", "price": 499, "category": "Alcohol", "sku": "REST-ALC-002" },
+    { "name": "Import Beer", "price": 649, "category": "Alcohol", "sku": "REST-ALC-003" },
+    { "name": "House Wine", "price": 799, "category": "Alcohol", "sku": "REST-ALC-004" },
+    { "name": "Margarita", "price": 999, "category": "Alcohol", "sku": "REST-ALC-005" },
+    { "name": "Old Fashioned", "price": 1299, "category": "Alcohol", "sku": "REST-ALC-006" },
+
+    { "name": "Chicken Tenders", "price": 799, "category": "Kids Menu", "sku": "REST-KID-001" },
+    { "name": "Kids Mac and Cheese", "price": 649, "category": "Kids Menu", "sku": "REST-KID-002" },
+    { "name": "Mini Burger", "price": 699, "category": "Kids Menu", "sku": "REST-KID-003" },
+    { "name": "Grilled Cheese", "price": 599, "category": "Kids Menu", "sku": "REST-KID-004" },
+    { "name": "Kids Quesadilla", "price": 649, "category": "Kids Menu", "sku": "REST-KID-005" },
+
+    { "name": "Chef's Special", "price": 2499, "category": "Specials", "sku": "REST-SPE-001" },
+    { "name": "Soup of the Day", "price": 599, "category": "Specials", "sku": "REST-SPE-002" }
+  ]
+}

data/lib/skytab_sandbox_simulator/data/restaurant/tenders.json

@@ -0,0 +1,22 @@
+{
+  "tenders": [
+    { "label": "Cash", "pos_ref": "CASH", "weight": 15 },
+    { "label": "Visa", "pos_ref": "VISA", "weight": 30 },
+    { "label": "Mastercard", "pos_ref": "MASTERCARD", "weight": 20 },
+    { "label": "Amex", "pos_ref": "AMEX", "weight": 10 },
+    { "label": "Discover", "pos_ref": "DISCOVER", "weight": 5 },
+    { "label": "Gift Card", "pos_ref": "GIFT_CARD", "weight": 10 },
+    { "label": "House Account", "pos_ref": "HOUSE_ACCOUNT", "weight": 10 }
+  ],
+  "revenue_classes": [
+    { "label": "Dine-In", "pos_ref": "DINE_IN" },
+    { "label": "Takeout", "pos_ref": "TAKEOUT" },
+    { "label": "Delivery", "pos_ref": "DELIVERY" },
+    { "label": "Bar", "pos_ref": "BAR" },
+    { "label": "Catering", "pos_ref": "CATERING" }
+  ],
+  "tax_rates": [
+    { "name": "Sales Tax", "rate": 82500, "note": "8.25% — divide by 10,000 for percentage" },
+    { "name": "Alcohol Tax", "rate": 100000, "note": "10.0% — divide by 10,000 for percentage" }
+  ]
+}

data/lib/skytab_sandbox_simulator/database.rb

@@ -0,0 +1,192 @@
+# frozen_string_literal: true
+
+require "active_record"
+require "logger"
+
+module SkytabSandboxSimulator
+  # Standalone ActiveRecord connection manager for PostgreSQL.
+  #
+  # Provides database connectivity without requiring Rails.
+  # Used for persisting SkyTab sandbox data (locations, orders, etc.)
+  # alongside the existing JSON-file and API-based workflows.
+  #
+  # @example Connect and run migrations
+  #   SkytabSandboxSimulator::Database.connect!("postgres://localhost:5432/skytab_simulator_development")
+  #   SkytabSandboxSimulator::Database.migrate!
+  module Database
+    # Directory containing ActiveRecord migration files
+    MIGRATIONS_PATH = File.expand_path("db/migrate", __dir__).freeze
+
+    # Default test database name
+    TEST_DATABASE = "skytab_simulator_test"
+
+    class << self
+      # Create the database specified in the connection URL.
+      #
+      # @param url [String] PostgreSQL connection URL
+      # @return [void]
+      def create!(url)
+        db_name = URI.parse(url).path.delete_prefix("/")
+        maintenance_url = url.sub(%r{/[^/]+\z}, "/postgres")
+
+        ActiveRecord::Base.establish_connection(maintenance_url)
+        ActiveRecord::Base.connection.create_database(db_name)
+        SkytabSandboxSimulator.logger.info("Database created: #{db_name}")
+      rescue ActiveRecord::DatabaseAlreadyExists, ActiveRecord::StatementInvalid => e
+        if e.message.include?("already exists")
+          SkytabSandboxSimulator.logger.info("Database already exists: #{db_name}")
+        else
+          raise
+        end
+      ensure
+        ActiveRecord::Base.connection_pool.disconnect!
+      end
+
+      # Drop the database specified in the connection URL.
+      #
+      # @param url [String] PostgreSQL connection URL
+      # @return [void]
+      def drop!(url)
+        db_name = URI.parse(url).path.delete_prefix("/")
+        maintenance_url = url.sub(%r{/[^/]+\z}, "/postgres")
+
+        ActiveRecord::Base.establish_connection(maintenance_url)
+        ActiveRecord::Base.connection.drop_database(db_name)
+        SkytabSandboxSimulator.logger.info("Database dropped: #{db_name}")
+      rescue ActiveRecord::StatementInvalid => e
+        if e.message.include?("does not exist")
+          SkytabSandboxSimulator.logger.info("Database does not exist: #{db_name}")
+        else
+          raise
+        end
+      ensure
+        ActiveRecord::Base.connection_pool.disconnect!
+      end
+
+      # Return the configured database URL from .env.json.
+      #
+      # @return [String] PostgreSQL URL
+      # @raise [Error] if no DATABASE_URL is configured
+      def database_url
+        url = Configuration.database_url_from_file
+        raise Error, "No DATABASE_URL found in .env.json" unless url
+
+        url
+      end
+
+      # Establish a standalone ActiveRecord connection to PostgreSQL.
+      #
+      # @param url [String] A PostgreSQL connection URL
+      # @return [void]
+      def connect!(url)
+        unless url.match?(%r{\Apostgres(ql)?://}i)
+          raise ArgumentError, "Expected a PostgreSQL URL (postgres:// or postgresql://), got: #{url.split('://').first}://"
+        end
+
+        ActiveRecord::Base.establish_connection(url)
+
+        # Verify the connection is actually usable
+        ActiveRecord::Base.connection.execute("SELECT 1")
+
+        ActiveRecord::Base.logger = SkytabSandboxSimulator.logger
+
+        SkytabSandboxSimulator.logger.info("Database connected: #{sanitize_url(url)}")
+      end
+
+      # Run pending migrations from lib/skytab_sandbox_simulator/db/migrate/.
+      #
+      # @return [void]
+      def migrate!
+        ensure_connected!
+
+        SkytabSandboxSimulator.logger.info("Running migrations from #{MIGRATIONS_PATH}")
+
+        context = ActiveRecord::MigrationContext.new(MIGRATIONS_PATH)
+        context.migrate
+
+        SkytabSandboxSimulator.logger.info("Migrations complete")
+      end
+
+      # Seed the database with realistic SkyTab data using FactoryBot.
+      #
+      # @param business_type [Symbol, String, nil] Optional business type.
+      #   Seeds all types if nil.
+      # @return [Hash] Summary counts
+      def seed!(business_type: nil)
+        ensure_connected!
+        load_factories!
+
+        business_type ||= SkytabSandboxSimulator.configuration.business_type
+        Seeder.seed!(business_type: business_type)
+      end
+
+      # Check whether a database connection is established and usable.
+      #
+      # @return [Boolean]
+      def connected?
+        ActiveRecord::Base.connection_pool.with_connection do |conn|
+          conn.active?
+        end
+      rescue StandardError
+        false
+      end
+
+      # Disconnect from the database and clean up the connection pool.
+      #
+      # @return [void]
+      def disconnect!
+        ActiveRecord::Base.connection_pool.disconnect!
+        SkytabSandboxSimulator.logger.info("Database disconnected")
+      end
+
+      # Build the test database URL.
+      #
+      # @param base_url [String, nil] Base URL to derive test URL from.
+      # @return [String] PostgreSQL URL pointing to the test database
+      def test_database_url(base_url: nil)
+        url = base_url || Configuration.database_url_from_file
+        return "postgres://localhost:5432/#{TEST_DATABASE}" if url.nil?
+
+        uri = URI.parse(url)
+        uri.path = "/#{TEST_DATABASE}"
+        uri.to_s
+      rescue URI::InvalidURIError
+        "postgres://localhost:5432/#{TEST_DATABASE}"
+      end
+
+      private
+
+      # Raise if no database connection has been established yet.
+      def ensure_connected!
+        return if connected?
+
+        raise SkytabSandboxSimulator::Error,
+              "Database not connected. Call Database.connect!(url) first."
+      end
+
+      # Load FactoryBot factory definitions from the factories directory.
+      def load_factories!
+        return if @factories_loaded
+
+        require "factory_bot"
+
+        factories_path = File.expand_path("db/factories", __dir__)
+        FactoryBot.definition_file_paths = [factories_path] if Dir.exist?(factories_path)
+        FactoryBot.find_definitions
+        @factories_loaded = true
+      rescue StandardError => e
+        SkytabSandboxSimulator.logger.warn("Could not load factories: #{e.message}")
+      end
+
+      # Strip credentials from a database URL for safe logging.
+      def sanitize_url(url)
+        uri = URI.parse(url)
+        uri.user = "***" if uri.user
+        uri.password = "***" if uri.password
+        uri.to_s
+      rescue URI::InvalidURIError
+        url.gsub(%r{://[^@]+@}, "://***:***@")
+      end
+    end
+  end
+end