@nextsparkjs/theme-crm 0.1.0-beta.1

package/config/billing.config.ts

@@ -0,0 +1,187 @@
+/**
+ * Billing Configuration - CRM Theme
+ *
+ * Defines plans, features, limits, and action mappings for the CRM theme.
+ * Customized for sales and customer relationship management.
+ */
+
+import type { BillingConfig } from '@nextsparkjs/core/lib/billing/config-types'
+
+export const billingConfig: BillingConfig = {
+  provider: 'stripe',
+  currency: 'usd',
+  defaultPlan: 'free',
+
+  // ===========================================
+  // FEATURE DEFINITIONS (CRM-specific)
+  // ===========================================
+  features: {
+    basic_analytics: {
+      name: 'billing.features.basic_analytics',
+      description: 'billing.features.basic_analytics_description',
+    },
+    advanced_analytics: {
+      name: 'billing.features.advanced_analytics',
+      description: 'billing.features.advanced_analytics_description',
+    },
+    api_access: {
+      name: 'billing.features.api_access',
+      description: 'billing.features.api_access_description',
+    },
+    custom_branding: {
+      name: 'billing.features.custom_branding',
+      description: 'billing.features.custom_branding_description',
+    },
+    pipeline_automation: {
+      name: 'billing.features.pipeline_automation',
+      description: 'billing.features.pipeline_automation_description',
+    },
+    email_templates: {
+      name: 'billing.features.email_templates',
+      description: 'billing.features.email_templates_description',
+    },
+    priority_support: {
+      name: 'billing.features.priority_support',
+      description: 'billing.features.priority_support_description',
+    },
+  },
+
+  // ===========================================
+  // LIMIT DEFINITIONS (CRM-specific)
+  // ===========================================
+  limits: {
+    team_members: {
+      name: 'billing.limits.team_members',
+      unit: 'count',
+      resetPeriod: 'never',
+    },
+    contacts: {
+      name: 'billing.limits.contacts',
+      unit: 'count',
+      resetPeriod: 'never',
+    },
+    deals: {
+      name: 'billing.limits.deals',
+      unit: 'count',
+      resetPeriod: 'never',
+    },
+    pipelines: {
+      name: 'billing.limits.pipelines',
+      unit: 'count',
+      resetPeriod: 'never',
+    },
+    api_calls: {
+      name: 'billing.limits.api_calls',
+      unit: 'calls',
+      resetPeriod: 'monthly',
+    },
+    storage_gb: {
+      name: 'billing.limits.storage',
+      unit: 'bytes',
+      resetPeriod: 'never',
+    },
+  },
+
+  // ===========================================
+  // PLAN DEFINITIONS (CRM-optimized)
+  // ===========================================
+  plans: [
+    {
+      slug: 'free',
+      name: 'billing.plans.free.name',
+      description: 'billing.plans.free.description',
+      type: 'free',
+      visibility: 'public',
+      price: { monthly: 0, yearly: 0 },
+      trialDays: 0,
+      features: ['basic_analytics'],
+      limits: {
+        team_members: 2,
+        contacts: 100,
+        deals: 25,
+        pipelines: 1,
+        api_calls: 1000,
+        storage_gb: 1,
+      },
+      stripePriceIdMonthly: null,
+      stripePriceIdYearly: null,
+    },
+    {
+      slug: 'pro',
+      name: 'billing.plans.pro.name',
+      description: 'billing.plans.pro.description',
+      type: 'paid',
+      visibility: 'public',
+      price: {
+        monthly: 4900,  // $49.00 - CRM typically higher priced
+        yearly: 49000,  // $490.00 (16% savings)
+      },
+      trialDays: 14,
+      features: [
+        'basic_analytics',
+        'advanced_analytics',
+        'api_access',
+        'email_templates',
+        'pipeline_automation',
+      ],
+      limits: {
+        team_members: 10,
+        contacts: 10000,
+        deals: 1000,
+        pipelines: 5,
+        api_calls: 100000,
+        storage_gb: 25,
+      },
+      // Configure these in Stripe Dashboard
+      stripePriceIdMonthly: 'price_crm_pro_monthly',
+      stripePriceIdYearly: 'price_crm_pro_yearly',
+    },
+    {
+      slug: 'enterprise',
+      name: 'billing.plans.enterprise.name',
+      description: 'billing.plans.enterprise.description',
+      type: 'enterprise',
+      visibility: 'hidden',
+      trialDays: 30,
+      features: ['*'],  // All features
+      limits: {
+        team_members: -1,  // Unlimited
+        contacts: -1,
+        deals: -1,
+        pipelines: -1,
+        api_calls: -1,
+        storage_gb: -1,
+      },
+      stripePriceIdMonthly: null,
+      stripePriceIdYearly: null,
+    },
+  ],
+
+  // ===========================================
+  // ACTION MAPPINGS (CRM-specific)
+  // ===========================================
+  actionMappings: {
+    permissions: {
+      'team.members.invite': 'team.members.invite',
+      'team.settings.edit': 'team.settings.edit',
+      'team.billing.manage': 'team.billing.manage',
+    },
+
+    features: {
+      'analytics.view_advanced': 'advanced_analytics',
+      'api.generate_key': 'api_access',
+      'pipeline.automate': 'pipeline_automation',
+      'email.use_templates': 'email_templates',
+      'support.priority_access': 'priority_support',
+    },
+
+    limits: {
+      'team.members.invite': 'team_members',
+      'contacts.create': 'contacts',
+      'deals.create': 'deals',
+      'pipelines.create': 'pipelines',
+      'api.call': 'api_calls',
+      'files.upload': 'storage_gb',
+    },
+  },
+}

package/config/dashboard.config.ts

@@ -0,0 +1,372 @@
+/**
+ * CRM Theme - Dashboard Configuration
+ *
+ * Data-centric dashboard for sales and marketing teams.
+ */
+
+export const DASHBOARD_CONFIG = {
+  // =============================================================================
+  // TOPBAR CONFIGURATION
+  // =============================================================================
+  topbar: {
+    search: {
+      enabled: true,
+      placeholder: 'dashboard.search.placeholder',
+      maxResults: 15,
+    },
+    notifications: {
+      enabled: true,
+    },
+    themeToggle: {
+      enabled: true,
+    },
+    support: {
+      enabled: true,
+      type: 'dropdown',
+      links: [
+        {
+          label: 'common.help.documentation',
+          url: '/docs',
+          icon: 'book-open',
+          external: false,
+        },
+        {
+          label: 'common.help.keyboard',
+          action: 'showKeyboardShortcuts',
+          icon: 'keyboard',
+        }
+      ],
+    },
+    quickCreate: {
+      enabled: true,
+    },
+    /**
+     * Admin access button (Super Admin area)
+     */
+    adminAccess: {
+      enabled: true,
+      showToDevelopers: true,
+    },
+    /**
+     * Dev Zone access button (Developer area)
+     */
+    devtoolsAccess: {
+      enabled: true,
+    },
+    userMenu: {
+      enabled: true,
+      showAvatar: true,
+      showEmail: true,
+      showRole: true, // Show role in CRM
+      items: [
+        { type: 'link', label: 'navigation.profile', href: '/dashboard/settings/profile', icon: 'user' },
+        { type: 'link', label: 'navigation.team', href: '/dashboard/settings/teams', icon: 'users' },
+        { type: 'link', label: 'navigation.settings', href: '/dashboard/settings', icon: 'settings' },
+        { type: 'divider' },
+        { type: 'action', label: 'buttons.signOut', action: 'signOut', icon: 'log-out' },
+      ],
+    },
+  },
+
+  // =============================================================================
+  // SIDEBAR CONFIGURATION
+  // =============================================================================
+  sidebar: {
+    defaultCollapsed: false,
+    rememberState: true,
+    collapsedWidth: '60px',
+    expandedWidth: '260px',
+    toggle: {
+      enabled: true,
+      showInTopbar: true,
+      hideOnMobile: false,
+    },
+    navigation: {
+      showEntityCounts: true,
+      groupEntities: true,
+      showRecents: true,
+      maxRecents: 5,
+    },
+  },
+
+  // =============================================================================
+  // SETTINGS PAGES
+  // =============================================================================
+  settings: {
+    pages: {
+      profile: {
+        enabled: true,
+        label: 'settings.pages.profile',
+        description: 'settings.pages.profileDescription',
+        icon: 'user',
+        order: 1,
+        features: {
+          avatarUpload: true,
+          nameChange: true,
+          emailChange: true,
+          localeChange: true,
+          timezoneChange: true,
+        },
+      },
+      security: {
+        enabled: true,
+        label: 'settings.pages.security',
+        description: 'settings.pages.securityDescription',
+        icon: 'shield',
+        order: 2,
+        features: {
+          twoFactorAuth: true,
+          sessionManagement: true,
+          loginHistory: true,
+          securityQuestions: false,
+        },
+      },
+      password: {
+        enabled: true,
+        label: 'settings.pages.password',
+        description: 'settings.pages.passwordDescription',
+        icon: 'key',
+        order: 3,
+        features: {
+          passwordChange: true,
+          passwordStrength: true,
+          passwordHistory: false,
+        },
+      },
+      notifications: {
+        enabled: true,
+        label: 'settings.pages.notifications',
+        description: 'settings.pages.notificationsDescription',
+        icon: 'bell',
+        order: 4,
+        features: {
+          emailNotifications: true,
+          pushNotifications: true,
+          smsNotifications: false,
+          notificationCategories: true,
+        },
+      },
+      'api-keys': {
+        enabled: true,
+        label: 'settings.pages.apiKeys',
+        description: 'settings.pages.apiKeysDescription',
+        icon: 'key',
+        order: 5,
+        features: {},
+      },
+      billing: {
+        enabled: true,
+        label: 'settings.pages.billing',
+        description: 'settings.pages.billingDescription',
+        icon: 'credit-card',
+        order: 6,
+        features: {},
+      },
+      teams: {
+        enabled: true,
+        label: 'settings.pages.teams',
+        description: 'settings.pages.teamsDescription',
+        icon: 'users',
+        order: 7,
+        features: {
+          createTeams: false, // Single-tenant mode
+          manageMembers: true,
+          inviteMembers: true,
+          teamSettings: true,
+        },
+      },
+      plans: {
+        enabled: true,
+        label: 'settings.pages.plans',
+        description: 'settings.pages.plansDescription',
+        icon: 'credit-card',
+        order: 8,
+        features: {
+          planComparison: true,
+          planSelection: true,
+        },
+      },
+    },
+    layout: {
+      showDescription: true,
+      showIcons: true,
+      groupByCategory: false,
+      enableSearch: true,
+    },
+  },
+
+  // =============================================================================
+  // ENTITY PAGES
+  // =============================================================================
+  entities: {
+    defaultListView: {
+      pagination: {
+        defaultPageSize: 25,
+        allowedPageSizes: [10, 25, 50, 100],
+        showSizeSelector: true,
+      },
+      sorting: {
+        enabled: true,
+        defaultSort: { field: 'createdAt', direction: 'desc' },
+        rememberSort: true,
+      },
+      filtering: {
+        enabled: true,
+        quickFilters: true,
+        advancedFilters: true,
+        rememberFilters: true,
+      },
+      search: {
+        enabled: true,
+        placeholder: 'dashboard.entities.searchPlaceholder',
+        searchableFields: ['name', 'email', 'company', 'phone'],
+        instantSearch: true,
+        debounceMs: 200,
+      },
+    },
+    defaultFormView: {
+      validation: {
+        validateOnBlur: true,
+        validateOnChange: false,
+        showFieldErrors: true,
+        showFormErrors: true,
+      },
+      autosave: {
+        enabled: false,
+        intervalMs: 30000,
+        showIndicator: true,
+      },
+      confirmation: {
+        showOnCreate: false,
+        showOnUpdate: false,
+        showOnDelete: true,
+      },
+    },
+    customizations: {
+      leads: {
+        listView: {
+          defaultSort: { field: 'score', direction: 'desc' },
+          quickFilters: ['status', 'source', 'assignedTo'],
+        },
+      },
+      opportunities: {
+        listView: {
+          defaultSort: { field: 'closeDate', direction: 'asc' },
+          quickFilters: ['status', 'pipelineId', 'assignedTo'],
+        },
+      },
+      contacts: {
+        listView: {
+          quickFilters: ['companyId', 'isPrimary'],
+        },
+      },
+      activities: {
+        listView: {
+          defaultSort: { field: 'dueDate', direction: 'asc' },
+          quickFilters: ['type', 'status', 'assignedTo'],
+        },
+      },
+    },
+  },
+
+  // =============================================================================
+  // DASHBOARD HOMEPAGE
+  // =============================================================================
+  homepage: {
+    widgets: {
+      welcome: {
+        enabled: true,
+        showUserName: true,
+        showLastLogin: true,
+        showQuickActions: true,
+      },
+      stats: {
+        enabled: true,
+        entities: ['leads', 'opportunities', 'contacts', 'companies'],
+        timeframe: '30days',
+        showTrends: true,
+      },
+      recentActivity: {
+        enabled: true,
+        maxItems: 15,
+        entities: ['leads', 'opportunities', 'activities'],
+        showTimestamps: true,
+      },
+      quickActions: {
+        enabled: true,
+        actions: [
+          { entity: 'leads', action: 'create', label: 'crm.quickActions.newLead' },
+          { entity: 'contacts', action: 'create', label: 'crm.quickActions.newContact' },
+          { entity: 'opportunities', action: 'create', label: 'crm.quickActions.newOpportunity' },
+          { entity: 'activities', action: 'create', label: 'crm.quickActions.scheduleActivity' },
+        ],
+      },
+      pipeline: {
+        enabled: true,
+        showValue: true,
+        showCount: true,
+      },
+    },
+    layout: {
+      columns: 4,
+      gutter: 'medium',
+      responsive: true,
+    },
+  },
+
+  // =============================================================================
+  // PERFORMANCE
+  // =============================================================================
+  performance: {
+    cache: {
+      entityConfigs: { enabled: true, duration: 5 * 60 * 1000 },
+      entityData: { enabled: true, duration: 2 * 60 * 1000 },
+    },
+    loading: {
+      showSkeletons: true,
+      showProgressBars: true,
+      minimumLoadingTime: 150,
+    },
+    errors: {
+      showErrorBoundaries: true,
+      logErrors: true,
+      enableRetry: true,
+      maxRetries: 3,
+    },
+  },
+
+  // =============================================================================
+  // ACCESSIBILITY
+  // =============================================================================
+  accessibility: {
+    keyboard: {
+      enabled: true,
+      showShortcuts: true,
+      customShortcuts: {
+        'Ctrl+K': 'openSearch',
+        'Ctrl+Shift+N': 'quickCreate',
+        'Ctrl+B': 'toggleSidebar',
+        'Esc': 'closeModals',
+        'L': 'newLead',
+        'O': 'newOpportunity',
+        'C': 'newContact',
+      },
+    },
+    screenReader: {
+      announceNavigation: true,
+      announceActions: true,
+      announceErrors: true,
+    },
+    visual: {
+      showFocusOutlines: true,
+      highContrastMode: false,
+      reducedMotion: false,
+    },
+  },
+} as const
+
+export const TOPBAR_CONFIG = DASHBOARD_CONFIG.topbar
+export const SIDEBAR_CONFIG = DASHBOARD_CONFIG.sidebar
+export const SETTINGS_CONFIG = DASHBOARD_CONFIG.settings
+export const ENTITIES_CONFIG = DASHBOARD_CONFIG.entities
+export const HOMEPAGE_CONFIG = DASHBOARD_CONFIG.homepage

package/config/dev.config.ts

@@ -0,0 +1,55 @@
+/**
+ * CRM Theme - Development Configuration
+ *
+ * This file contains development-only settings that should never affect production.
+ * Settings like DevKeyring are only rendered in non-production environments.
+ *
+ * @see core/lib/config/types.ts for DevConfig interface
+ */
+
+import type { DevConfig } from '@nextsparkjs/core/lib/config/types'
+
+export const DEV_CONFIG_OVERRIDES: DevConfig = {
+  // =============================================================================
+  // DEV KEYRING (Development/QA Only)
+  // =============================================================================
+  /**
+   * DevKeyring - Quick login for CRM theme (single-tenant mode)
+   * Test different department roles in one organization
+   */
+  devKeyring: {
+    enabled: true,
+    users: [
+      {
+        id: 'roberto',
+        email: 'crm_owner_roberto@nextspark.dev',
+        name: 'Roberto Martinez',
+        password: 'Test1234',
+        teamRoles: 'Ventas Pro S.A. (owner) - CEO',
+      },
+      {
+        id: 'sofia',
+        email: 'crm_admin_sofia@nextspark.dev',
+        name: 'Sofia Gomez',
+        password: 'Test1234',
+        teamRoles: 'Ventas Pro S.A. (admin) - Sales Manager',
+      },
+      {
+        id: 'miguel',
+        email: 'crm_member_miguel@nextspark.dev',
+        name: 'Miguel Castro',
+        password: 'Test1234',
+        teamRoles: 'Ventas Pro S.A. (member) - Sales Rep',
+      },
+      {
+        id: 'laura',
+        email: 'crm_member_laura@nextspark.dev',
+        name: 'Laura Vega',
+        password: 'Test1234',
+        teamRoles: 'Ventas Pro S.A. (member) - Marketing',
+      },
+    ],
+  },
+}
+
+export default DEV_CONFIG_OVERRIDES