@nextsparkjs/theme-crm 0.1.0-beta.1

package/entities/products/migrations/003_products_sample_data.sql

@@ -0,0 +1,247 @@
+-- ============================================================================
+-- Sample data for products table - CRM Theme
+-- Aligned with schema in 001_products_table.sql
+-- Uses users from 999_theme_sample_data.sql
+-- ============================================================================
+
+-- Clean existing products data
+DELETE FROM "products" WHERE "teamId" = 'team-crm-company';
+
+INSERT INTO "products" (
+  id,
+  code,
+  name,
+  category,
+  type,
+  description,
+  price,
+  cost,
+  currency,
+  unit,
+  "isActive",
+  image,
+  "brochureUrl",
+  "minimumQuantity",
+  "commissionRate",
+  "userId",
+  "teamId",
+  "createdAt",
+  "updatedAt"
+) VALUES
+-- Software Products (Subscriptions)
+(
+  'prod-crm-001',
+  'CRM-PRO-001',
+  'CRM Pro License',
+  'Software',
+  'subscription',
+  'Professional CRM software license with advanced features for growing teams',
+  299.00,
+  50.00,
+  'USD',
+  'user',
+  true,
+  'https://example.com/crm-pro-screenshot1.png',
+  'https://example.com/crm-pro-brochure.pdf',
+  1,
+  10.00,
+  'usr-crm-ceo',
+  'team-crm-company',
+  NOW() - INTERVAL '180 days',
+  NOW() - INTERVAL '30 days'
+),
+(
+  'prod-crm-002',
+  'CRM-ENT-001',
+  'CRM Enterprise License',
+  'Software',
+  'subscription',
+  'Enterprise CRM solution with unlimited users and advanced customization capabilities',
+  899.00,
+  150.00,
+  'USD',
+  'license',
+  true,
+  'https://example.com/crm-ent-screenshot1.png',
+  'https://example.com/crm-enterprise-brochure.pdf',
+  1,
+  12.00,
+  'usr-crm-ceo',
+  'team-crm-company',
+  NOW() - INTERVAL '180 days',
+  NOW() - INTERVAL '25 days'
+),
+(
+  'prod-crm-003',
+  'MOD-ANA-001',
+  'Advanced Analytics Module',
+  'Add-ons',
+  'subscription',
+  'Advanced analytics and reporting module for enhanced CRM insights',
+  149.00,
+  25.00,
+  'USD',
+  'user',
+  true,
+  'https://example.com/analytics-module.png',
+  'https://example.com/analytics-brochure.pdf',
+  1,
+  8.00,
+  'usr-crm-ceo',
+  'team-crm-company',
+  NOW() - INTERVAL '90 days',
+  NOW() - INTERVAL '5 days'
+),
+(
+  'prod-crm-004',
+  'MOD-MKT-001',
+  'Marketing Automation Module',
+  'Add-ons',
+  'subscription',
+  'Marketing automation module with campaign management and lead scoring',
+  199.00,
+  35.00,
+  'USD',
+  'user',
+  true,
+  'https://example.com/marketing-module.png',
+  'https://example.com/marketing-brochure.pdf',
+  1,
+  8.00,
+  'usr-crm-ceo',
+  'team-crm-company',
+  NOW() - INTERVAL '120 days',
+  NOW() - INTERVAL '15 days'
+),
+
+-- Service Products
+(
+  'prod-crm-005',
+  'SRV-IMP-001',
+  'CRM Implementation Service',
+  'Services',
+  'service',
+  'Professional CRM implementation and setup service with data migration',
+  2500.00,
+  800.00,
+  'USD',
+  'piece',
+  true,
+  'https://example.com/implementation-process.png',
+  'https://example.com/implementation-brochure.pdf',
+  1,
+  15.00,
+  'usr-crm-sales-mgr',
+  'team-crm-company',
+  NOW() - INTERVAL '180 days',
+  NOW() - INTERVAL '20 days'
+),
+(
+  'prod-crm-006',
+  'SRV-TRN-001',
+  'CRM Training Workshop',
+  'Services',
+  'service',
+  'Comprehensive CRM training workshop for teams with hands-on practice',
+  1200.00,
+  300.00,
+  'USD',
+  'day',
+  true,
+  'https://example.com/training-workshop.png',
+  'https://example.com/training-brochure.pdf',
+  1,
+  12.00,
+  'usr-crm-sales-mgr',
+  'team-crm-company',
+  NOW() - INTERVAL '150 days',
+  NOW() - INTERVAL '15 days'
+),
+(
+  'prod-crm-007',
+  'SRV-INT-001',
+  'Custom Integration Development',
+  'Services',
+  'service',
+  'Custom integration development service for connecting CRM with third-party systems',
+  5000.00,
+  2000.00,
+  'USD',
+  'piece',
+  true,
+  'https://example.com/integration-service.png',
+  'https://example.com/integration-brochure.pdf',
+  1,
+  15.00,
+  'usr-crm-sales-mgr',
+  'team-crm-company',
+  NOW() - INTERVAL '120 days',
+  NOW() - INTERVAL '10 days'
+),
+
+-- Support Packages
+(
+  'prod-crm-008',
+  'SUP-PRI-001',
+  'Priority Support Package',
+  'Support',
+  'subscription',
+  'Priority support package with dedicated support representative',
+  499.00,
+  100.00,
+  'USD',
+  'month',
+  true,
+  'https://example.com/priority-support.png',
+  'https://example.com/support-brochure.pdf',
+  12,
+  10.00,
+  'usr-crm-sales-mgr',
+  'team-crm-company',
+  NOW() - INTERVAL '150 days',
+  NOW() - INTERVAL '8 days'
+),
+(
+  'prod-crm-009',
+  'SUP-ENT-001',
+  'Enterprise Support Package',
+  'Support',
+  'subscription',
+  'Enterprise-grade support with dedicated team and custom SLAs',
+  999.00,
+  250.00,
+  'USD',
+  'month',
+  true,
+  'https://example.com/enterprise-support.png',
+  'https://example.com/enterprise-support-brochure.pdf',
+  12,
+  12.00,
+  'usr-crm-sales-mgr',
+  'team-crm-company',
+  NOW() - INTERVAL '150 days',
+  NOW() - INTERVAL '5 days'
+),
+
+-- Hardware/Infrastructure (for on-premise)
+(
+  'prod-crm-010',
+  'HW-SRV-001',
+  'Enterprise Server Package',
+  'Infrastructure',
+  'product',
+  'Complete server package for on-premise CRM deployment with high availability',
+  8500.00,
+  5200.00,
+  'USD',
+  'piece',
+  true,
+  'https://example.com/server-package.png',
+  'https://example.com/server-brochure.pdf',
+  1,
+  5.00,
+  'usr-crm-ceo',
+  'team-crm-company',
+  NOW() - INTERVAL '120 days',
+  NOW() - INTERVAL '10 days'
+);

package/entities/products/products.config.ts

@@ -0,0 +1,62 @@
+/**
+ * Products Entity Configuration - CRM
+ *
+ * Products and services catalog.
+ * Updated with team support and granular permissions.
+ * Only owner can manage products.
+ */
+
+import { Package } from 'lucide-react'
+import type { EntityConfig } from '@nextsparkjs/core/lib/entities/types'
+import { productsFields } from './products.fields'
+
+export const productsEntityConfig: EntityConfig = {
+  // ==========================================
+  // 1. BASIC IDENTIFICATION
+  // ==========================================
+  slug: 'products',
+  enabled: true,
+  names: {
+    singular: 'product',
+    plural: 'Products'
+  },
+  icon: Package,
+
+  // ==========================================
+  // 2. ACCESS AND SCOPE CONFIGURATION
+  // ==========================================
+  access: {
+    public: false,
+    api: true,
+    metadata: true,
+    shared: true
+  },
+
+  // ==========================================
+  // 3. UI/UX FEATURES
+  // ==========================================
+  ui: {
+    dashboard: {
+      showInMenu: false,  // Accessed via settings
+      showInTopbar: false
+    },
+    public: {
+      hasArchivePage: false,
+      hasSinglePage: false
+    },
+    features: {
+      searchable: true,
+      sortable: true,
+      filterable: true,
+      bulkOperations: false,
+      importExport: false
+    }
+  },
+
+  // ==========================================
+  // FIELDS
+  // ==========================================
+  fields: productsFields,
+}
+
+export default productsEntityConfig

package/entities/products/products.fields.ts

@@ -0,0 +1,361 @@
+/**
+ * Products Entity Fields Configuration
+ *
+ * Separated from main config according to new refactoring plan.
+ * Contains all field definitions for the products entity.
+ */
+
+import type { EntityField } from '@nextsparkjs/core/lib/entities/types'
+
+export const productsFields: EntityField[] = [
+  {
+    name: 'code',
+    type: 'text',
+    required: true,
+    display: {
+      label: 'Product Code',
+      description: 'Product code or SKU',
+      placeholder: 'Enter product code...',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 1,
+      columnWidth: 4,
+    },
+    api: {
+      searchable: true,
+      sortable: true,
+      readOnly: false,
+    },
+  },
+  {
+    name: 'name',
+    type: 'text',
+    required: true,
+    display: {
+      label: 'Product Name',
+      description: 'Product name',
+      placeholder: 'Enter product name...',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 2,
+      columnWidth: 8,
+    },
+    api: {
+      searchable: true,
+      sortable: true,
+      readOnly: false,
+    },
+  },
+  {
+    name: 'category',
+    type: 'text',
+    required: false,
+    display: {
+      label: 'Category',
+      description: 'Product category',
+      placeholder: 'Enter category...',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 3,
+      columnWidth: 4,
+    },
+    api: {
+      searchable: true,
+      sortable: true,
+      readOnly: false,
+    },
+  },
+  {
+    name: 'type',
+    type: 'select',
+    required: false,
+    options: [
+      { value: 'product', label: 'Product' },
+      { value: 'service', label: 'Service' },
+      { value: 'subscription', label: 'Subscription' },
+      { value: 'bundle', label: 'Bundle' },
+      { value: 'addon', label: 'Add-on' },
+    ],
+    display: {
+      label: 'Product Type',
+      description: 'Type of product',
+      placeholder: 'Select type...',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 4,
+      columnWidth: 4,
+    },
+    api: {
+      searchable: false,
+      sortable: true,
+      readOnly: false,
+    },
+  },
+  {
+    name: 'description',
+    type: 'textarea',
+    required: false,
+    display: {
+      label: 'Description',
+      description: 'Product description',
+      placeholder: 'Enter description...',
+      showInList: false,
+      showInDetail: true,
+      showInForm: true,
+      order: 5,
+      columnWidth: 12,
+    },
+    api: {
+      searchable: true,
+      sortable: false,
+      readOnly: false,
+    },
+  },
+  {
+    name: 'price',
+    type: 'number',
+    required: true,
+    display: {
+      label: 'Price',
+      description: 'Standard selling price',
+      placeholder: '0.00',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 7,
+      columnWidth: 4,
+    },
+    api: {
+      searchable: false,
+      sortable: true,
+      readOnly: false,
+    },
+  },
+  {
+    name: 'cost',
+    type: 'number',
+    required: false,
+    display: {
+      label: 'Cost',
+      description: 'Product cost',
+      placeholder: '0.00',
+      showInList: false,
+      showInDetail: true,
+      showInForm: true,
+      order: 8,
+      columnWidth: 4,
+    },
+    api: {
+      searchable: false,
+      sortable: true,
+      readOnly: false,
+    },
+  },
+  {
+    name: 'currency',
+    type: 'select',
+    required: false,
+    options: [
+      { value: 'USD', label: 'US Dollar' },
+      { value: 'EUR', label: 'Euro' },
+      { value: 'GBP', label: 'British Pound' },
+      { value: 'MXN', label: 'Mexican Peso' },
+      { value: 'CAD', label: 'Canadian Dollar' },
+      { value: 'AUD', label: 'Australian Dollar' },
+      { value: 'JPY', label: 'Japanese Yen' },
+      { value: 'CNY', label: 'Chinese Yuan' },
+      { value: 'INR', label: 'Indian Rupee' },
+      { value: 'BRL', label: 'Brazilian Real' },
+    ],
+    display: {
+      label: 'Currency',
+      description: 'Currency code',
+      placeholder: 'Select currency...',
+      showInList: false,
+      showInDetail: true,
+      showInForm: true,
+      order: 9,
+      columnWidth: 4,
+    },
+    api: {
+      searchable: false,
+      sortable: true,
+      readOnly: false,
+    },
+  },
+  {
+    name: 'unit',
+    type: 'select',
+    required: false,
+    options: [
+      { value: 'piece', label: 'Piece' },
+      { value: 'hour', label: 'Hour' },
+      { value: 'day', label: 'Day' },
+      { value: 'week', label: 'Week' },
+      { value: 'month', label: 'Month' },
+      { value: 'year', label: 'Year' },
+      { value: 'kg', label: 'Kilogram' },
+      { value: 'lb', label: 'Pound' },
+      { value: 'meter', label: 'Meter' },
+      { value: 'foot', label: 'Foot' },
+      { value: 'license', label: 'License' },
+      { value: 'user', label: 'User' },
+    ],
+    display: {
+      label: 'Unit of Measure',
+      description: 'Unit of measure',
+      placeholder: 'Select unit...',
+      showInList: false,
+      showInDetail: true,
+      showInForm: true,
+      order: 10,
+      columnWidth: 4,
+    },
+    api: {
+      searchable: false,
+      sortable: true,
+      readOnly: false,
+    },
+  },
+  {
+    name: 'isActive',
+    type: 'boolean',
+    required: false,
+    display: {
+      label: 'Active',
+      description: 'Is product currently active',
+      showInList: true,
+      showInDetail: true,
+      showInForm: true,
+      order: 11,
+      columnWidth: 4,
+    },
+    api: {
+      searchable: false,
+      sortable: true,
+      readOnly: false,
+    },
+  },
+  {
+    name: 'minimumQuantity',
+    type: 'number',
+    required: false,
+    display: {
+      label: 'Minimum Quantity',
+      description: 'Minimum order quantity',
+      placeholder: '1',
+      showInList: false,
+      showInDetail: true,
+      showInForm: true,
+      order: 12,
+      columnWidth: 4,
+    },
+    api: {
+      searchable: false,
+      sortable: true,
+      readOnly: false,
+    },
+  },
+  {
+    name: 'image',
+    type: 'url',
+    required: false,
+    display: {
+      label: 'Image',
+      description: 'Product image URL',
+      placeholder: 'https://example.com/image.png',
+      showInList: false,
+      showInDetail: true,
+      showInForm: true,
+      order: 13,
+      columnWidth: 6,
+    },
+    api: {
+      searchable: false,
+      sortable: false,
+      readOnly: false,
+    },
+  },
+  {
+    name: 'brochureUrl',
+    type: 'url',
+    required: false,
+    display: {
+      label: 'Brochure URL',
+      description: 'Product brochure URL',
+      placeholder: 'https://example.com/brochure.pdf',
+      showInList: false,
+      showInDetail: true,
+      showInForm: true,
+      order: 14,
+      columnWidth: 6,
+    },
+    api: {
+      searchable: false,
+      sortable: false,
+      readOnly: false,
+    },
+  },
+  {
+    name: 'commissionRate',
+    type: 'number',
+    required: false,
+    display: {
+      label: 'Commission Rate (%)',
+      description: 'Sales commission percentage',
+      placeholder: '0.00',
+      showInList: false,
+      showInDetail: true,
+      showInForm: true,
+      order: 15,
+      columnWidth: 4,
+    },
+    api: {
+      searchable: false,
+      sortable: true,
+      readOnly: false,
+    },
+  },
+  {
+    name: 'createdAt',
+    type: 'datetime',
+    required: false,
+    display: {
+      label: 'Created At',
+      description: 'When the product was created',
+      showInList: true,
+      showInDetail: true,
+      showInForm: false,
+      order: 98,
+      columnWidth: 4,
+    },
+    api: {
+      searchable: false,
+      sortable: true,
+      readOnly: true,
+    },
+  },
+  {
+    name: 'updatedAt',
+    type: 'datetime',
+    required: false,
+    display: {
+      label: 'Updated At',
+      description: 'When the product was last updated',
+      showInList: false,
+      showInDetail: true,
+      showInForm: false,
+      order: 99,
+      columnWidth: 4,
+    },
+    api: {
+      searchable: false,
+      sortable: true,
+      readOnly: true,
+    },
+  },
+]