@nextsparkjs/theme-crm 0.1.0-beta.1

package/config/permissions.config.ts

@@ -0,0 +1,297 @@
+/**
+ * CRM Theme - Permissions Configuration
+ *
+ * SINGLE SOURCE OF TRUTH for all permissions and roles in this theme.
+ *
+ * This file defines:
+ * - teams: Team-level permissions (team.view, team.edit, etc.)
+ * - entities: Entity CRUD permissions (leads, contacts, companies, etc.)
+ * - features: Theme-specific feature permissions (reports, bulk ops, lead conversion)
+ *
+ * All sections use unified format: { action: '...', roles: [...] }
+ *
+ * Single-tenant mode with differentiated permissions:
+ * - Owner: CRM Administrator (full control)
+ * - Admin: Sales/Marketing Manager (team management + reports)
+ * - Member: Sales/Marketing Rep (daily operations)
+ * - Viewer: Read-only access
+ *
+ * Use PermissionService.canDoAction(role, action) to check any permission.
+ */
+
+import type { ThemePermissionsConfig } from '@nextsparkjs/core/lib/permissions/types'
+
+export const PERMISSIONS_CONFIG_OVERRIDES: ThemePermissionsConfig = {
+  // ==========================================
+  // TEAM PERMISSIONS
+  // ==========================================
+  // Unified format: { action, label, description, roles, dangerous? }
+  teams: [
+    // View permissions
+    { action: 'team.view', label: 'View Team', description: 'Can view team details', roles: ['owner', 'admin', 'member', 'viewer'] },
+    { action: 'team.members.view', label: 'View Members', description: 'Can see team member list', roles: ['owner', 'admin', 'member', 'viewer'] },
+    { action: 'team.settings.view', label: 'View Settings', description: 'Can view team settings', roles: ['owner', 'admin'] },
+    { action: 'team.billing.view', label: 'View Billing', description: 'Can view billing information', roles: ['owner'] },
+
+    // Edit permissions
+    { action: 'team.edit', label: 'Edit Team', description: 'Can modify team name and details', roles: ['owner'] },
+    { action: 'team.settings.edit', label: 'Edit Settings', description: 'Can modify team settings', roles: ['owner'] },
+    { action: 'team.billing.manage', label: 'Manage Billing', description: 'Can manage subscriptions and payments', roles: ['owner'] },
+
+    // Member management - Owner and Admin can invite in CRM
+    { action: 'team.members.invite', label: 'Invite Members', description: 'Invite new team members to the CRM', roles: ['owner', 'admin'] },
+    { action: 'team.members.remove', label: 'Remove Members', description: 'Can remove team members', roles: ['owner', 'admin'] },
+    { action: 'team.members.update_role', label: 'Update Roles', description: 'Only CRM admins can change user roles', roles: ['owner'] },
+
+    // Dangerous - Disabled in single-tenant
+    { action: 'team.delete', label: 'Delete Team', description: 'Cannot delete organization in single-tenant mode', roles: [], dangerous: true },
+  ],
+
+  // ==========================================
+  // ENTITY PERMISSIONS
+  // ==========================================
+  entities: {
+    // ------------------------------------------
+    // LEADS
+    // ------------------------------------------
+    leads: [
+      { action: 'create', label: 'Create leads', description: 'Can create new leads', roles: ['owner', 'admin', 'member'] },
+      { action: 'read', label: 'View leads', description: 'Can view lead details', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'list', label: 'List leads', description: 'Can see the leads list', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'update', label: 'Edit leads', description: 'Can modify lead information', roles: ['owner', 'admin', 'member'] },
+      { action: 'delete', label: 'Delete leads', description: 'Can delete leads', roles: ['owner', 'admin'], dangerous: true },
+      { action: 'assign', label: 'Assign leads', description: 'Can assign leads to team members', roles: ['owner', 'admin'] },
+    ],
+
+    // ------------------------------------------
+    // CONTACTS
+    // ------------------------------------------
+    contacts: [
+      { action: 'create', label: 'Create contacts', description: 'Can create new contacts', roles: ['owner', 'admin', 'member'] },
+      { action: 'read', label: 'View contacts', description: 'Can view contact details', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'list', label: 'List contacts', description: 'Can see the contacts list', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'update', label: 'Edit contacts', description: 'Can modify contact information', roles: ['owner', 'admin', 'member'] },
+      { action: 'delete', label: 'Delete contacts', description: 'Can delete contacts', roles: ['owner', 'admin'], dangerous: true },
+    ],
+
+    // ------------------------------------------
+    // COMPANIES
+    // ------------------------------------------
+    companies: [
+      { action: 'create', label: 'Create companies', description: 'Can create new companies', roles: ['owner', 'admin', 'member'] },
+      { action: 'read', label: 'View companies', description: 'Can view company details', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'list', label: 'List companies', description: 'Can see the companies list', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'update', label: 'Edit companies', description: 'Can modify company information', roles: ['owner', 'admin', 'member'] },
+      { action: 'delete', label: 'Delete companies', description: 'Can delete companies', roles: ['owner', 'admin'], dangerous: true },
+    ],
+
+    // ------------------------------------------
+    // OPPORTUNITIES
+    // ------------------------------------------
+    opportunities: [
+      { action: 'create', label: 'Create opportunities', description: 'Can create new opportunities', roles: ['owner', 'admin', 'member'] },
+      { action: 'read', label: 'View opportunities', description: 'Can view opportunity details', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'list', label: 'List opportunities', description: 'Can see the opportunities list', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'update', label: 'Edit opportunities', description: 'Can modify opportunity information', roles: ['owner', 'admin', 'member'] },
+      { action: 'delete', label: 'Delete opportunities', description: 'Can delete opportunities', roles: ['owner', 'admin'], dangerous: true },
+      { action: 'assign', label: 'Assign opportunities', description: 'Can assign opportunities to team members', roles: ['owner', 'admin'] },
+    ],
+
+    // ------------------------------------------
+    // ACTIVITIES
+    // ------------------------------------------
+    activities: [
+      { action: 'create', label: 'Create activities', description: 'Can schedule activities', roles: ['owner', 'admin', 'member'] },
+      { action: 'read', label: 'View activities', description: 'Can view activity details', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'list', label: 'List activities', description: 'Can see the activities list', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'update', label: 'Edit activities', description: 'Can modify activity information', roles: ['owner', 'admin', 'member'] },
+      { action: 'delete', label: 'Delete activities', description: 'Can delete activities', roles: ['owner', 'admin', 'member'], dangerous: true },
+    ],
+
+    // ------------------------------------------
+    // NOTES
+    // ------------------------------------------
+    notes: [
+      { action: 'create', label: 'Create notes', description: 'Can create notes', roles: ['owner', 'admin', 'member'] },
+      { action: 'read', label: 'View notes', description: 'Can view notes', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'list', label: 'List notes', description: 'Can see notes list', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'update', label: 'Edit notes', description: 'Can modify notes', roles: ['owner', 'admin', 'member'] },
+      { action: 'delete', label: 'Delete notes', description: 'Can delete notes', roles: ['owner', 'admin', 'member'], dangerous: true },
+    ],
+
+    // ------------------------------------------
+    // CAMPAIGNS
+    // ------------------------------------------
+    campaigns: [
+      { action: 'create', label: 'Create campaigns', description: 'Can create marketing campaigns', roles: ['owner', 'admin'] },
+      { action: 'read', label: 'View campaigns', description: 'Can view campaign details', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'list', label: 'List campaigns', description: 'Can see the campaigns list', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'update', label: 'Edit campaigns', description: 'Can modify campaign information', roles: ['owner', 'admin'] },
+      { action: 'delete', label: 'Delete campaigns', description: 'Can delete campaigns', roles: ['owner'], dangerous: true },
+    ],
+
+    // ------------------------------------------
+    // PRODUCTS
+    // ------------------------------------------
+    products: [
+      { action: 'create', label: 'Create products', description: 'Can add products to catalog', roles: ['owner'] },
+      { action: 'read', label: 'View products', description: 'Can view product details', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'list', label: 'List products', description: 'Can see the products catalog', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'update', label: 'Edit products', description: 'Can modify product information', roles: ['owner'] },
+      { action: 'delete', label: 'Delete products', description: 'Can delete products', roles: ['owner'], dangerous: true },
+    ],
+
+    // ------------------------------------------
+    // PIPELINES
+    // ------------------------------------------
+    pipelines: [
+      { action: 'create', label: 'Create pipelines', description: 'Can create sales pipelines', roles: ['owner'] },
+      { action: 'read', label: 'View pipelines', description: 'Can view pipeline details', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'list', label: 'List pipelines', description: 'Can see the pipelines list', roles: ['owner', 'admin', 'member', 'viewer'] },
+      { action: 'update', label: 'Edit pipelines', description: 'Can modify pipeline stages', roles: ['owner'] },
+      { action: 'delete', label: 'Delete pipelines', description: 'Can delete pipelines', roles: ['owner'], dangerous: true },
+    ],
+  },
+
+  // ==========================================
+  // FEATURE PERMISSIONS
+  // ==========================================
+  // Unified format: uses 'action' instead of 'id'
+  features: [
+    // ===========================================
+    // REPORTS & ANALYTICS
+    // ===========================================
+    {
+      action: 'reports.sales',
+      label: 'Sales Reports',
+      description: 'Access to sales performance reports and analytics',
+      category: 'Reports',
+      roles: ['owner', 'admin'],
+    },
+    {
+      action: 'reports.marketing',
+      label: 'Marketing Reports',
+      description: 'Access to marketing campaign reports and ROI analysis',
+      category: 'Reports',
+      roles: ['owner', 'admin'],
+    },
+    {
+      action: 'reports.pipeline',
+      label: 'Pipeline Reports',
+      description: 'Access to pipeline analysis and forecasting reports',
+      category: 'Reports',
+      roles: ['owner', 'admin'],
+    },
+    {
+      action: 'reports.export',
+      label: 'Export Reports',
+      description: 'Can export reports to PDF, Excel, or CSV',
+      category: 'Reports',
+      roles: ['owner', 'admin'],
+    },
+
+    // ===========================================
+    // DASHBOARD FEATURES
+    // ===========================================
+    {
+      action: 'dashboard.forecasting',
+      label: 'Sales Forecasting',
+      description: 'Access to sales forecasting and projections',
+      category: 'Dashboard',
+      roles: ['owner', 'admin'],
+    },
+    {
+      action: 'dashboard.team_metrics',
+      label: 'Team Metrics',
+      description: 'View team performance metrics and KPIs',
+      category: 'Dashboard',
+      roles: ['owner', 'admin'],
+    },
+
+    // ===========================================
+    // BULK OPERATIONS
+    // ===========================================
+    {
+      action: 'bulk.import',
+      label: 'Bulk Import',
+      description: 'Can import data from CSV/Excel files',
+      category: 'Bulk Operations',
+      roles: ['owner', 'admin'],
+    },
+    {
+      action: 'bulk.export',
+      label: 'Bulk Export',
+      description: 'Can export data to CSV/Excel files',
+      category: 'Bulk Operations',
+      roles: ['owner', 'admin'],
+    },
+
+    // ===========================================
+    // LEAD MANAGEMENT
+    // ===========================================
+    {
+      action: 'leads.convert',
+      label: 'Convert Leads',
+      description: 'Can convert leads to contacts and companies',
+      category: 'Leads',
+      roles: ['owner', 'admin', 'member'],
+    },
+
+    // ===========================================
+    // CONFIGURATION
+    // ===========================================
+    {
+      action: 'settings.pipelines',
+      label: 'Pipeline Configuration',
+      description: 'Can create and modify sales pipelines',
+      category: 'Configuration',
+      roles: ['owner'],
+    },
+    {
+      action: 'settings.products',
+      label: 'Product Catalog',
+      description: 'Can manage the product catalog',
+      category: 'Configuration',
+      roles: ['owner'],
+    },
+  ],
+
+  // ==========================================
+  // DISABLED FEATURES
+  // ==========================================
+  disabled: [
+    'teams.delete', // Cannot delete organization in single-tenant
+  ],
+
+  // ==========================================
+  // UI SECTIONS
+  // ==========================================
+  uiSections: [
+    {
+      id: 'reports',
+      label: 'Reports & Analytics',
+      description: 'Permissions for accessing reports and analytics',
+      categories: ['Reports', 'Dashboard'],
+    },
+    {
+      id: 'bulk-operations',
+      label: 'Bulk Operations',
+      description: 'Permissions for bulk data operations',
+      categories: ['Bulk Operations'],
+    },
+    {
+      id: 'lead-management',
+      label: 'Lead Management',
+      description: 'Permissions specific to lead handling',
+      categories: ['Leads'],
+    },
+    {
+      id: 'configuration',
+      label: 'System Configuration',
+      description: 'Permissions for system configuration',
+      categories: ['Configuration'],
+    },
+  ],
+}
+
+export default PERMISSIONS_CONFIG_OVERRIDES

package/config/theme.config.ts

@@ -0,0 +1,111 @@
+/**
+ * CRM Theme Configuration
+ *
+ * Enterprise CRM for sales and marketing teams.
+ * Single-tenant mode with differentiated permissions.
+ */
+
+import type { ThemeConfig } from '@nextsparkjs/core/types/theme'
+
+export const crmThemeConfig: ThemeConfig = {
+  name: 'crm',
+  displayName: 'CRM Enterprise',
+  version: '2.0.0',
+  description: 'Complete CRM solution for sales and marketing teams',
+  author: 'NextSpark Team',
+
+  plugins: [],
+
+  styles: {
+    globals: 'globals.css',
+    components: 'components.css',
+    variables: {
+      '--spacing-xs': '0.125rem',
+      '--spacing-sm': '0.25rem',
+      '--spacing-md': '0.5rem',
+      '--spacing-lg': '1rem',
+      '--spacing-xl': '1.5rem',
+      '--spacing-2xl': '2rem'
+    }
+  },
+
+  // Professional CRM aesthetic - Purple/Violet theme with modern typography
+  config: {
+    colors: {
+      // Core colors - Purple/Violet Theme
+      background: 'oklch(0.9940 0 0)',
+      foreground: 'oklch(0 0 0)',
+      card: 'oklch(0.9940 0 0)',
+      'card-foreground': 'oklch(0 0 0)',
+      popover: 'oklch(0.9911 0 0)',
+      'popover-foreground': 'oklch(0 0 0)',
+      // Purple/Violet primary for modern professional look
+      primary: 'oklch(0.5393 0.2713 286.7462)',
+      'primary-foreground': 'oklch(1.0000 0 0)',
+      secondary: 'oklch(0.9540 0.0063 255.4755)',
+      'secondary-foreground': 'oklch(0.1344 0 0)',
+      muted: 'oklch(0.9702 0 0)',
+      'muted-foreground': 'oklch(0.4386 0 0)',
+      accent: 'oklch(0.9393 0.0288 266.3680)',
+      'accent-foreground': 'oklch(0.5445 0.1903 259.4848)',
+      destructive: 'oklch(0.6290 0.1902 23.0704)',
+      'destructive-foreground': 'oklch(1.0000 0 0)',
+      border: 'oklch(0.9300 0.0094 286.2156)',
+      input: 'oklch(0.9401 0 0)',
+      ring: 'oklch(0 0 0)',
+
+      // Chart colors for analytics
+      'chart-1': 'oklch(0.7459 0.1483 156.4499)',
+      'chart-2': 'oklch(0.5393 0.2713 286.7462)',
+      'chart-3': 'oklch(0.7336 0.1758 50.5517)',
+      'chart-4': 'oklch(0.5828 0.1809 259.7276)',
+      'chart-5': 'oklch(0.5590 0 0)',
+
+      // Sidebar - light with subtle violet tint
+      sidebar: 'oklch(0.9777 0.0051 247.8763)',
+      'sidebar-foreground': 'oklch(0 0 0)',
+      'sidebar-primary': 'oklch(0 0 0)',
+      'sidebar-primary-foreground': 'oklch(1.0000 0 0)',
+      'sidebar-accent': 'oklch(0.9401 0 0)',
+      'sidebar-accent-foreground': 'oklch(0 0 0)',
+      'sidebar-border': 'oklch(0.9401 0 0)',
+      'sidebar-ring': 'oklch(0 0 0)'
+    },
+
+    fonts: {
+      sans: "'Plus Jakarta Sans', system-ui, sans-serif",
+      serif: "'Lora', Georgia, serif",
+      mono: "'IBM Plex Mono', monospace"
+    },
+
+    spacing: {
+      radius: '1.4rem',
+      'radius-sm': 'calc(1.4rem - 4px)',
+      'radius-md': 'calc(1.4rem - 2px)',
+      'radius-lg': '1.4rem',
+      'radius-xl': 'calc(1.4rem + 4px)'
+    },
+
+    shadows: {
+      'shadow-2xs': '0px 2px 3px 0px hsl(0 0% 0% / 0.08)',
+      'shadow-xs': '0px 2px 3px 0px hsl(0 0% 0% / 0.08)',
+      'shadow-sm': '0px 2px 3px 0px hsl(0 0% 0% / 0.16), 0px 1px 2px -1px hsl(0 0% 0% / 0.16)',
+      shadow: '0px 2px 3px 0px hsl(0 0% 0% / 0.16), 0px 1px 2px -1px hsl(0 0% 0% / 0.16)',
+      'shadow-md': '0px 2px 3px 0px hsl(0 0% 0% / 0.16), 0px 2px 4px -1px hsl(0 0% 0% / 0.16)',
+      'shadow-lg': '0px 2px 3px 0px hsl(0 0% 0% / 0.16), 0px 4px 6px -1px hsl(0 0% 0% / 0.16)',
+      'shadow-xl': '0px 2px 3px 0px hsl(0 0% 0% / 0.16), 0px 8px 10px -1px hsl(0 0% 0% / 0.16)',
+      'shadow-2xl': '0px 2px 3px 0px hsl(0 0% 0% / 0.40)'
+    },
+
+    tracking: {
+      normal: '-0.025em'
+    }
+  },
+
+  components: {
+    overrides: {},
+    custom: {}
+  }
+}
+
+export default crmThemeConfig

package/entities/activities/activities.config.ts

@@ -0,0 +1,61 @@
+/**
+ * Activities Entity Configuration - CRM
+ *
+ * Tasks and activities related to CRM records.
+ * Updated with team support and granular permissions.
+ */
+
+import { Calendar } from 'lucide-react'
+import type { EntityConfig } from '@nextsparkjs/core/lib/entities/types'
+import { activitiesFields } from './activities.fields'
+
+export const activitiesEntityConfig: EntityConfig = {
+  // ==========================================
+  // 1. BASIC IDENTIFICATION
+  // ==========================================
+  slug: 'activities',
+  enabled: true,
+  names: {
+    singular: 'activity',
+    plural: 'Activities'
+  },
+  icon: Calendar,
+
+  // ==========================================
+  // 2. ACCESS AND SCOPE CONFIGURATION
+  // ==========================================
+  access: {
+    public: false,
+    api: true,
+    metadata: true,
+    shared: true
+  },
+
+  // ==========================================
+  // 3. UI/UX FEATURES
+  // ==========================================
+  ui: {
+    dashboard: {
+      showInMenu: true,
+      showInTopbar: true
+    },
+    public: {
+      hasArchivePage: false,
+      hasSinglePage: false
+    },
+    features: {
+      searchable: true,
+      sortable: true,
+      filterable: true,
+      bulkOperations: true,
+      importExport: false
+    }
+  },
+
+  // ==========================================
+  // FIELDS
+  // ==========================================
+  fields: activitiesFields,
+}
+
+export default activitiesEntityConfig