@nextsparkjs/theme-crm 0.1.0-beta.1

package/entities/products/messages/en.json

@@ -0,0 +1,135 @@
+{
+  "entity": {
+    "name": "Product",
+    "plural": "Products",
+    "description": "Manage products and services"
+  },
+  "fields": {
+    "name": {
+      "label": "Product Name",
+      "description": "Product or service name",
+      "placeholder": "Enter product name..."
+    },
+    "sku": {
+      "label": "SKU",
+      "description": "Stock keeping unit identifier",
+      "placeholder": "Enter SKU..."
+    },
+    "description": {
+      "label": "Description",
+      "description": "Product description",
+      "placeholder": "Enter description..."
+    },
+    "category": {
+      "label": "Category",
+      "description": "Product category",
+      "placeholder": "Enter category..."
+    },
+    "type": {
+      "label": "Product Type",
+      "description": "Type of product or service",
+      "placeholder": "Select type..."
+    },
+    "status": {
+      "label": "Status",
+      "description": "Product status",
+      "placeholder": "Select status..."
+    },
+    "price": {
+      "label": "Unit Price",
+      "description": "Price per unit",
+      "placeholder": "0.00"
+    },
+    "cost": {
+      "label": "Unit Cost",
+      "description": "Cost per unit",
+      "placeholder": "0.00"
+    },
+    "currency": {
+      "label": "Currency",
+      "description": "Currency code",
+      "placeholder": "Select currency..."
+    },
+    "stockQuantity": {
+      "label": "Stock Quantity",
+      "description": "Available stock quantity",
+      "placeholder": "0"
+    },
+    "minStockLevel": {
+      "label": "Minimum Stock Level",
+      "description": "Minimum stock level threshold",
+      "placeholder": "0"
+    },
+    "features": {
+      "label": "Features",
+      "description": "Product features list"
+    },
+    "specifications": {
+      "label": "Specifications",
+      "description": "Technical specifications"
+    },
+    "images": {
+      "label": "Images",
+      "description": "Product images"
+    },
+    "isActive": {
+      "label": "Active",
+      "description": "Whether product is active"
+    },
+    "weight": {
+      "label": "Weight",
+      "description": "Product weight",
+      "placeholder": "0.00"
+    },
+    "dimensions": {
+      "label": "Dimensions",
+      "description": "Product dimensions",
+      "placeholder": "L x W x H"
+    },
+    "vendor": {
+      "label": "Vendor",
+      "description": "Product vendor or supplier",
+      "placeholder": "Enter vendor..."
+    }
+  },
+  "options": {
+    "type": {
+      "physical": "Physical Product",
+      "digital": "Digital Product",
+      "service": "Service",
+      "subscription": "Subscription",
+      "bundle": "Product Bundle",
+      "variant": "Product Variant"
+    },
+    "status": {
+      "active": "Active",
+      "inactive": "Inactive",
+      "discontinued": "Discontinued",
+      "out_of_stock": "Out of Stock",
+      "coming_soon": "Coming Soon"
+    }
+  },
+  "actions": {
+    "create": "Create Product",
+    "edit": "Edit Product",
+    "delete": "Delete Product",
+    "view": "View Product",
+    "list": "List Products",
+    "duplicate": "Duplicate Product",
+    "activate": "Activate Product",
+    "deactivate": "Deactivate Product",
+    "restock": "Restock Product"
+  },
+  "messages": {
+    "created": "Product created successfully",
+    "updated": "Product updated successfully",
+    "deleted": "Product deleted successfully",
+    "activated": "Product activated successfully",
+    "deactivated": "Product deactivated successfully",
+    "restocked": "Product restocked successfully",
+    "lowStock": "Product stock is running low",
+    "outOfStock": "Product is out of stock",
+    "notFound": "Product not found",
+    "error": "An error occurred while processing the product"
+  }
+}

package/entities/products/messages/es.json

@@ -0,0 +1,135 @@
+{
+  "entity": {
+    "name": "Producto",
+    "plural": "Productos",
+    "description": "Gestiona productos y servicios"
+  },
+  "fields": {
+    "name": {
+      "label": "Nombre del Producto",
+      "description": "Nombre del producto o servicio",
+      "placeholder": "Ingrese nombre..."
+    },
+    "sku": {
+      "label": "SKU",
+      "description": "Código de producto",
+      "placeholder": "Ingrese SKU..."
+    },
+    "description": {
+      "label": "Descripción",
+      "description": "Descripción del producto",
+      "placeholder": "Ingrese descripción..."
+    },
+    "category": {
+      "label": "Categoría",
+      "description": "Categoría del producto",
+      "placeholder": "Ingrese categoría..."
+    },
+    "type": {
+      "label": "Tipo",
+      "description": "Tipo de producto o servicio",
+      "placeholder": "Seleccionar tipo..."
+    },
+    "status": {
+      "label": "Estado",
+      "description": "Estado del producto",
+      "placeholder": "Seleccionar estado..."
+    },
+    "price": {
+      "label": "Precio Unitario",
+      "description": "Precio por unidad",
+      "placeholder": "0.00"
+    },
+    "cost": {
+      "label": "Costo Unitario",
+      "description": "Costo por unidad",
+      "placeholder": "0.00"
+    },
+    "currency": {
+      "label": "Moneda",
+      "description": "Código de moneda",
+      "placeholder": "Seleccionar moneda..."
+    },
+    "stockQuantity": {
+      "label": "Cantidad en Stock",
+      "description": "Cantidad disponible",
+      "placeholder": "0"
+    },
+    "minStockLevel": {
+      "label": "Nivel Mínimo",
+      "description": "Nivel mínimo de stock",
+      "placeholder": "0"
+    },
+    "features": {
+      "label": "Características",
+      "description": "Lista de características"
+    },
+    "specifications": {
+      "label": "Especificaciones",
+      "description": "Especificaciones técnicas"
+    },
+    "images": {
+      "label": "Imágenes",
+      "description": "Imágenes del producto"
+    },
+    "isActive": {
+      "label": "Activo",
+      "description": "Si el producto está activo"
+    },
+    "weight": {
+      "label": "Peso",
+      "description": "Peso del producto",
+      "placeholder": "0.00"
+    },
+    "dimensions": {
+      "label": "Dimensiones",
+      "description": "Dimensiones del producto",
+      "placeholder": "L x A x P"
+    },
+    "vendor": {
+      "label": "Proveedor",
+      "description": "Proveedor del producto",
+      "placeholder": "Ingrese proveedor..."
+    }
+  },
+  "options": {
+    "type": {
+      "physical": "Producto Físico",
+      "digital": "Producto Digital",
+      "service": "Servicio",
+      "subscription": "Suscripción",
+      "bundle": "Paquete",
+      "variant": "Variante"
+    },
+    "status": {
+      "active": "Activo",
+      "inactive": "Inactivo",
+      "discontinued": "Descontinuado",
+      "out_of_stock": "Sin Stock",
+      "coming_soon": "Próximamente"
+    }
+  },
+  "actions": {
+    "create": "Crear Producto",
+    "edit": "Editar Producto",
+    "delete": "Eliminar Producto",
+    "view": "Ver Producto",
+    "list": "Listar Productos",
+    "duplicate": "Duplicar Producto",
+    "activate": "Activar Producto",
+    "deactivate": "Desactivar Producto",
+    "restock": "Reabastecer"
+  },
+  "messages": {
+    "created": "Producto creado exitosamente",
+    "updated": "Producto actualizado exitosamente",
+    "deleted": "Producto eliminado exitosamente",
+    "activated": "Producto activado exitosamente",
+    "deactivated": "Producto desactivado exitosamente",
+    "restocked": "Producto reabastecido exitosamente",
+    "lowStock": "Stock bajo del producto",
+    "outOfStock": "Producto sin stock",
+    "notFound": "Producto no encontrado",
+    "error": "Error al procesar el producto"
+  }
+}

package/entities/products/migrations/001_products_table.sql

@@ -0,0 +1,117 @@
+-- ============================================================================
+-- Products Table Migration
+-- CRM theme: Products and services catalog
+-- Updated with team support and RLS
+-- ============================================================================
+
+-- ============================================
+-- ENUM TYPES
+-- ============================================
+DO $$ BEGIN
+  CREATE TYPE product_type AS ENUM ('product', 'service', 'subscription');
+EXCEPTION
+  WHEN duplicate_object THEN null;
+END $$;
+
+DO $$ BEGIN
+  CREATE TYPE product_unit AS ENUM ('piece', 'hour', 'day', 'month', 'year', 'user', 'license');
+EXCEPTION
+  WHEN duplicate_object THEN null;
+END $$;
+
+-- ============================================
+-- TABLE
+-- ============================================
+CREATE TABLE IF NOT EXISTS "products" (
+  "id" TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+  
+  -- Product info
+  "code" VARCHAR(50),
+  "name" VARCHAR(255) NOT NULL,
+  "category" VARCHAR(100),
+  "type" product_type DEFAULT 'product',
+  "description" TEXT,
+
+  -- Pricing
+  "price" DECIMAL(15,2) NOT NULL DEFAULT 0,
+  "cost" DECIMAL(15,2) DEFAULT 0,
+  "currency" VARCHAR(3) DEFAULT 'USD',
+  "unit" product_unit DEFAULT 'piece',
+  
+  -- Status
+  "isActive" BOOLEAN DEFAULT true,
+  
+  -- Media
+  "image" VARCHAR(500),
+  "brochureUrl" VARCHAR(500),
+  
+  -- Sales config
+  "minimumQuantity" INTEGER DEFAULT 1,
+  "commissionRate" DECIMAL(5,2) DEFAULT 0,
+  
+  -- Ownership
+  "userId" TEXT NOT NULL REFERENCES "users"("id") ON DELETE CASCADE,
+  "teamId" TEXT NOT NULL REFERENCES "teams"("id") ON DELETE CASCADE,
+  
+  -- Timestamps
+  "createdAt" TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  "updatedAt" TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- ============================================
+-- INDEXES
+-- ============================================
+CREATE INDEX IF NOT EXISTS "products_teamId_idx" ON "products" ("teamId");
+CREATE INDEX IF NOT EXISTS "products_userId_idx" ON "products" ("userId");
+CREATE INDEX IF NOT EXISTS "products_code_idx" ON "products" ("code");
+CREATE INDEX IF NOT EXISTS "products_name_idx" ON "products" ("name");
+CREATE INDEX IF NOT EXISTS "products_category_idx" ON "products" ("category");
+CREATE INDEX IF NOT EXISTS "products_type_idx" ON "products" ("type");
+CREATE INDEX IF NOT EXISTS "products_isActive_idx" ON "products" ("isActive") WHERE "isActive" = true;
+CREATE INDEX IF NOT EXISTS "products_price_idx" ON "products" ("price");
+
+-- ============================================
+-- RLS
+-- ============================================
+ALTER TABLE "products" ENABLE ROW LEVEL SECURITY;
+
+DROP POLICY IF EXISTS "products_select_policy" ON "products";
+DROP POLICY IF EXISTS "products_insert_policy" ON "products";
+DROP POLICY IF EXISTS "products_update_policy" ON "products";
+DROP POLICY IF EXISTS "products_delete_policy" ON "products";
+
+CREATE POLICY "products_select_policy" ON "products"
+  FOR SELECT
+  USING ("teamId" = ANY(public.get_user_team_ids()) OR public.is_superadmin());
+
+CREATE POLICY "products_insert_policy" ON "products"
+  FOR INSERT
+  WITH CHECK ("teamId" = ANY(public.get_user_team_ids()));
+
+CREATE POLICY "products_update_policy" ON "products"
+  FOR UPDATE
+  USING ("teamId" = ANY(public.get_user_team_ids()) OR public.is_superadmin());
+
+CREATE POLICY "products_delete_policy" ON "products"
+  FOR DELETE
+  USING ("teamId" = ANY(public.get_user_team_ids()) OR public.is_superadmin());
+
+-- ============================================
+-- TRIGGER updatedAt
+-- ============================================
+CREATE OR REPLACE FUNCTION update_products_updated_at()
+RETURNS TRIGGER AS $$
+BEGIN
+  NEW."updatedAt" = NOW();
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;
+
+DROP TRIGGER IF EXISTS products_updated_at_trigger ON "products";
+CREATE TRIGGER products_updated_at_trigger
+  BEFORE UPDATE ON "products"
+  FOR EACH ROW
+  EXECUTE FUNCTION update_products_updated_at();
+
+COMMENT ON TABLE "products" IS 'Products and services catalog';
+COMMENT ON COLUMN "products"."commissionRate" IS 'Sales commission percentage';

package/entities/products/migrations/002_products_metas.sql

@@ -0,0 +1,114 @@
+-- Migration: 002_products_metas.sql
+-- Description: Contacts metas (table, indexes, RLS)
+-- Date: 2025-09-27
+
+-- ============================================
+-- TABLE
+-- ============================================
+-- No DROP needed - removed automatically by parent table CASCADE
+CREATE TABLE IF NOT EXISTS public."products_metas" (
+  id             TEXT PRIMARY KEY DEFAULT gen_random_uuid()::text,
+  "entityId"     TEXT NOT NULL REFERENCES public."products"(id) ON DELETE CASCADE,
+  "metaKey"      TEXT NOT NULL,
+  "metaValue"    JSONB NOT NULL DEFAULT '{}'::jsonb,
+  "dataType"     TEXT DEFAULT 'json',
+  "isPublic"     BOOLEAN NOT NULL DEFAULT false,
+  "isSearchable" BOOLEAN NOT NULL DEFAULT false,
+  "createdAt"    TIMESTAMPTZ NOT NULL DEFAULT now(),
+  "updatedAt"    TIMESTAMPTZ NOT NULL DEFAULT now(),
+  CONSTRAINT products_metas_unique_key UNIQUE ("entityId", "metaKey")
+);
+
+COMMENT ON TABLE  public."products_metas"                   IS 'Contacts metadata table - stores additional key-value pairs for products';
+COMMENT ON COLUMN public."products_metas"."entityId"        IS 'Generic foreign key to parent product entity';
+COMMENT ON COLUMN public."products_metas"."metaKey"         IS 'Metadata key name';
+COMMENT ON COLUMN public."products_metas"."metaValue"       IS 'Metadata value as JSONB';
+COMMENT ON COLUMN public."products_metas"."dataType"        IS 'Type hint for the value: json, string, number, boolean';
+COMMENT ON COLUMN public."products_metas"."isPublic"        IS 'Whether this metadata is publicly readable';
+COMMENT ON COLUMN public."products_metas"."isSearchable"    IS 'Whether this metadata is searchable';
+
+-- ============================================
+-- TRIGGER updatedAt (uses Better Auth function)
+-- ============================================
+DROP TRIGGER IF EXISTS products_metas_set_updated_at ON public."products_metas";
+CREATE TRIGGER products_metas_set_updated_at
+BEFORE UPDATE ON public."products_metas"
+FOR EACH ROW EXECUTE FUNCTION public.set_updated_at();
+
+-- ============================================
+-- INDEXES
+-- ============================================
+CREATE INDEX IF NOT EXISTS idx_products_metas_entity_id         ON public."products_metas"("entityId");
+CREATE INDEX IF NOT EXISTS idx_products_metas_key               ON public."products_metas"("metaKey");
+CREATE INDEX IF NOT EXISTS idx_products_metas_composite         ON public."products_metas"("entityId", "metaKey", "isPublic");
+CREATE INDEX IF NOT EXISTS idx_products_metas_is_public         ON public."products_metas"("isPublic") WHERE "isPublic" = true;
+CREATE INDEX IF NOT EXISTS idx_products_metas_is_searchable     ON public."products_metas"("isSearchable") WHERE "isSearchable" = true;
+CREATE INDEX IF NOT EXISTS idx_products_metas_searchable_key    ON public."products_metas"("metaKey") WHERE "isSearchable" = true;
+CREATE INDEX IF NOT EXISTS idx_products_metas_value_gin         ON public."products_metas" USING GIN ("metaValue");
+CREATE INDEX IF NOT EXISTS idx_products_metas_value_ops         ON public."products_metas" USING GIN ("metaValue" jsonb_path_ops);
+
+-- ============================================
+-- RLS
+-- ============================================
+ALTER TABLE public."products_metas" ENABLE ROW LEVEL SECURITY;
+
+-- Cleanup existing policies
+DROP POLICY IF EXISTS "Users can view product metas"     ON public."products_metas";
+DROP POLICY IF EXISTS "Users can create product metas"   ON public."products_metas";
+DROP POLICY IF EXISTS "Users can update product metas"   ON public."products_metas";
+DROP POLICY IF EXISTS "Users can delete product metas"   ON public."products_metas";
+
+-- ============================
+-- AUTHENTICATED USER POLICIES
+-- ============================
+-- Inherit permissions from parent entity
+CREATE POLICY "Users can view product metas"
+ON public."products_metas"
+FOR SELECT TO authenticated
+USING (
+  EXISTS (
+    SELECT 1 FROM public."products" c
+    WHERE c.id = "entityId"
+      AND c."userId" = public.get_auth_user_id()
+  )
+);
+
+CREATE POLICY "Users can create product metas"
+ON public."products_metas"
+FOR INSERT TO authenticated
+WITH CHECK (
+  EXISTS (
+    SELECT 1 FROM public."products" c
+    WHERE c.id = "entityId"
+      AND c."userId" = public.get_auth_user_id()
+  )
+);
+
+CREATE POLICY "Users can update product metas"
+ON public."products_metas"
+FOR UPDATE TO authenticated
+USING (
+  EXISTS (
+    SELECT 1 FROM public."products" c
+    WHERE c.id = "entityId"
+      AND c."userId" = public.get_auth_user_id()
+  )
+)
+WITH CHECK (
+  EXISTS (
+    SELECT 1 FROM public."products" c
+    WHERE c.id = "entityId"
+      AND c."userId" = public.get_auth_user_id()
+  )
+);
+
+CREATE POLICY "Users can delete product metas"
+ON public."products_metas"
+FOR DELETE TO authenticated
+USING (
+  EXISTS (
+    SELECT 1 FROM public."products" c
+    WHERE c.id = "entityId"
+      AND c."userId" = public.get_auth_user_id()
+  )
+);