@nextsparkjs/theme-crm 0.1.0-beta.19 → 0.1.0-beta.20

package/tests/cypress/e2e/ui/contacts/contacts-owner.cy.ts

@@ -0,0 +1,236 @@
+/// <reference types="cypress" />
+
+/**
+ * Contacts CRUD - Owner Role (Full Access)
+ *
+ * Uses CRM theme-specific POMs with Entity Testing Convention.
+ * Selectors follow the pattern: {slug}-{component}-{detail}
+ */
+
+import { ContactsPOM } from '../../../src/entities/ContactsPOM'
+import { loginAsCrmOwner } from '../../../src/session-helpers'
+
+describe('Contacts CRUD - Owner Role (Full Access)', () => {
+  const contacts = new ContactsPOM()
+
+  beforeEach(() => {
+    loginAsCrmOwner()
+    cy.visit('/dashboard/contacts')
+    contacts.list.validatePageVisible()
+  })
+
+  describe('CREATE - Owner can create contacts', () => {
+    it('OWNER_CONTACT_CREATE_001: should create new contact with required fields only', () => {
+      const firstName = `Roberto${Date.now()}`
+      const lastName = 'TestOwner'
+      const email = `roberto.owner.${Date.now()}@test.com`
+
+      contacts.list.clickCreate()
+      contacts.form.validateFormVisible()
+
+      contacts.fillContactForm({
+        firstName,
+        lastName,
+        email
+      })
+
+      contacts.submitForm()
+
+      cy.url().should('include', '/dashboard/contacts')
+      cy.contains(firstName).should('be.visible')
+      cy.contains(lastName).should('be.visible')
+    })
+
+    it('OWNER_CONTACT_CREATE_002: should create contact with all fields', () => {
+      const timestamp = Date.now()
+
+      contacts.list.clickCreate()
+      contacts.form.validateFormVisible()
+
+      contacts.fillContactForm({
+        firstName: `Carlos${timestamp}`,
+        lastName: 'Rodriguez',
+        email: `carlos.full.${timestamp}@test.com`,
+        phone: '+34 91 123 4567',
+        title: 'Sales Director'
+      })
+
+      contacts.submitForm()
+
+      cy.url().should('include', '/dashboard/contacts')
+      cy.contains(`Carlos${timestamp}`).should('be.visible')
+    })
+
+    it('OWNER_CONTACT_CREATE_003: should validate required fields', () => {
+      contacts.list.clickCreate()
+      contacts.form.validateFormVisible()
+
+      // Try to submit empty form
+      contacts.submitForm()
+
+      // Should show validation or stay on form
+      cy.get('body').then($body => {
+        const isOnCreatePage = window.location.pathname.includes('/create')
+        if (isOnCreatePage) {
+          cy.log('Form validation prevented submission')
+        }
+      })
+    })
+
+    it('OWNER_CONTACT_CREATE_004: should validate email format', () => {
+      const firstName = `Invalid${Date.now()}`
+      const lastName = 'Email'
+
+      contacts.list.clickCreate()
+      contacts.form.validateFormVisible()
+
+      contacts.fillContactForm({
+        firstName,
+        lastName,
+        email: 'not-an-email'
+      })
+
+      contacts.submitForm()
+
+      // Should show validation error
+      cy.get('body').then($body => {
+        const isOnCreatePage = window.location.pathname.includes('/create')
+        if (isOnCreatePage) {
+          cy.log('Email validation working')
+        }
+      })
+    })
+  })
+
+  describe('READ - Owner can read contacts', () => {
+    it('OWNER_CONTACT_READ_001: should view contact list', () => {
+      contacts.list.validatePageVisible()
+      contacts.list.validateTableVisible()
+    })
+
+    it('OWNER_CONTACT_READ_002: should view contact details', () => {
+      cy.get(contacts.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          contacts.list.clickRowByIndex(0)
+          cy.url().should('match', /\/dashboard\/contacts\/[a-z0-9-]+/)
+        }
+      })
+    })
+
+    it('OWNER_CONTACT_READ_003: should search contacts', () => {
+      contacts.list.search('test')
+      cy.wait(500)
+      contacts.list.clearSearch()
+    })
+  })
+
+  describe('UPDATE - Owner can update contacts', () => {
+    it('OWNER_CONTACT_UPDATE_001: should edit contact successfully', () => {
+      cy.get(contacts.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          contacts.list.clickRowByIndex(0)
+
+          cy.url().then(url => {
+            const contactId = url.split('/').pop()
+            contacts.form.visitEdit(contactId!)
+            contacts.form.validateFormVisible()
+
+            const updatedFirstName = `UpdatedOwner${Date.now()}`
+            contacts.form.typeInField('firstName', updatedFirstName)
+
+            contacts.submitForm()
+
+            cy.url().should('include', '/dashboard/contacts')
+            cy.contains(updatedFirstName).should('be.visible')
+          })
+        }
+      })
+    })
+
+    it('OWNER_CONTACT_UPDATE_002: should update all contact fields', () => {
+      const firstName = `FullUpdate${Date.now()}`
+      const lastName = 'Owner'
+      const email = `full.update.${Date.now()}@test.com`
+
+      contacts.list.clickCreate()
+      contacts.fillContactForm({ firstName, lastName, email })
+      contacts.submitForm()
+
+      cy.contains(firstName).should('be.visible')
+
+      // Edit the contact
+      cy.get(contacts.list.selectors.rowGeneric).first().within(() => {
+        cy.get('[data-cy*="edit"]').click()
+      })
+
+      contacts.form.validateFormVisible()
+
+      contacts.form.typeInField('firstName', `${firstName}_Updated`)
+      contacts.form.typeInField('phone', '+34 91 999 8888')
+      contacts.form.typeInField('title', 'CEO')
+
+      contacts.submitForm()
+
+      cy.url().should('include', '/dashboard/contacts')
+      cy.contains(`${firstName}_Updated`).should('be.visible')
+    })
+
+    it('OWNER_CONTACT_UPDATE_003: should cancel update without saving', () => {
+      cy.get(contacts.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          contacts.list.clickRowByIndex(0)
+
+          cy.url().then(url => {
+            const contactId = url.split('/').pop()
+            contacts.form.visitEdit(contactId!)
+            contacts.form.validateFormVisible()
+
+            contacts.form.typeInField('firstName', 'ShouldNotSave')
+
+            contacts.form.cancel()
+            cy.url().should('not.include', '/edit')
+          })
+        }
+      })
+    })
+  })
+
+  describe('DELETE - Owner can delete contacts', () => {
+    it('OWNER_CONTACT_DELETE_001: should delete contact successfully', () => {
+      const firstName = `DeleteTest${Date.now()}`
+      const lastName = 'Owner'
+      const email = `delete.owner.${Date.now()}@test.com`
+
+      contacts.list.clickCreate()
+      contacts.fillContactForm({ firstName, lastName, email })
+      contacts.submitForm()
+
+      cy.contains(firstName).should('be.visible')
+
+      contacts.list.search(firstName)
+
+      cy.get(contacts.list.selectors.rowGeneric).first().within(() => {
+        cy.get('[data-cy*="delete"]').click()
+      })
+
+      contacts.list.confirmDelete()
+
+      cy.wait(1000)
+      contacts.list.search(firstName)
+      cy.get(contacts.list.selectors.emptyState).should('be.visible')
+    })
+
+    it('OWNER_CONTACT_DELETE_002: should cancel contact deletion', () => {
+      cy.get(contacts.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          cy.get(contacts.list.selectors.rowGeneric).first().within(() => {
+            cy.get('[data-cy*="delete"]').click()
+          })
+
+          contacts.list.cancelDelete()
+          contacts.list.validateTableVisible()
+        }
+      })
+    })
+  })
+})

package/tests/cypress/e2e/ui/leads/leads-admin.cy.ts

@@ -0,0 +1,286 @@
+/// <reference types="cypress" />
+
+/**
+ * Leads CRUD - Admin Role (Full Access)
+ *
+ * Uses CRM theme-specific POMs with Entity Testing Convention.
+ * Selectors follow the pattern: {slug}-{component}-{detail}
+ */
+
+import { LeadsPOM } from '../../../../src/entities/LeadsPOM'
+import { loginAsCrmAdmin } from '../../../../src/session-helpers'
+
+describe('Leads CRUD - Admin Role (Full Access)', () => {
+  const leads = new LeadsPOM()
+
+  beforeEach(() => {
+    loginAsCrmAdmin()
+    cy.visit('/dashboard/leads')
+    leads.list.validatePageVisible()
+  })
+
+  describe('CREATE - Admin can create leads', () => {
+    it('ADMIN_LEAD_CREATE_001: should create new lead with required fields', () => {
+      const timestamp = Date.now()
+      const firstName = `Admin`
+      const lastName = `Lead ${timestamp}`
+      const email = `admin-lead${timestamp}@example.com`
+
+      // Click create button
+      leads.list.clickCreate()
+
+      // Validate form is visible
+      leads.form.validateFormVisible()
+
+      // Fill required lead fields using POM
+      leads.fillLeadForm({
+        firstName,
+        lastName,
+        email,
+        status: 'new'
+      })
+
+      // Submit form
+      leads.submitForm()
+
+      // Validate redirect to list
+      cy.url().should('include', '/dashboard/leads')
+
+      // Validate lead appears in list
+      cy.contains(lastName).should('be.visible')
+    })
+
+    it('ADMIN_LEAD_CREATE_002: should create qualified lead', () => {
+      const timestamp = Date.now()
+      const firstName = `Qualified`
+      const lastName = `Lead ${timestamp}`
+      const email = `qualified${timestamp}@example.com`
+
+      leads.list.clickCreate()
+      leads.form.validateFormVisible()
+
+      leads.fillLeadForm({
+        firstName,
+        lastName,
+        email,
+        status: 'qualified',
+        company: 'Enterprise Corp'
+      })
+
+      leads.submitForm()
+
+      cy.url().should('include', '/dashboard/leads')
+      cy.contains(lastName).should('be.visible')
+    })
+
+    it('ADMIN_LEAD_CREATE_003: should validate email format', () => {
+      const timestamp = Date.now()
+
+      leads.list.clickCreate()
+      leads.form.validateFormVisible()
+
+      leads.fillLeadForm({
+        firstName: 'Test',
+        lastName: `Lead ${timestamp}`,
+        email: 'invalid-email',
+        status: 'new'
+      })
+
+      leads.submitForm()
+
+      // Form should still be visible (validation failed)
+      leads.form.validateFormVisible()
+    })
+
+    it('ADMIN_LEAD_CREATE_004: should cancel lead creation', () => {
+      leads.list.clickCreate()
+      leads.form.validateFormVisible()
+
+      leads.fillLeadForm({
+        firstName: 'Cancel',
+        lastName: 'Test'
+      })
+
+      leads.form.cancel()
+
+      // Should return to list
+      leads.list.validatePageVisible()
+    })
+  })
+
+  describe('READ - Admin can read leads', () => {
+    it('ADMIN_LEAD_READ_001: should view lead list', () => {
+      leads.list.validatePageVisible()
+      leads.list.validateTableVisible()
+    })
+
+    it('ADMIN_LEAD_READ_002: should view lead details', () => {
+      // Check if there are leads to view
+      cy.get(leads.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          leads.list.clickRowByIndex(0)
+          cy.url().should('match', /\/dashboard\/leads\/[a-z0-9-]+/)
+        }
+      })
+    })
+
+    it('ADMIN_LEAD_READ_003: should search and filter leads', () => {
+      leads.list.search('Admin')
+      cy.wait(500)
+      leads.list.clearSearch()
+    })
+
+    it('ADMIN_LEAD_READ_004: should paginate through leads', () => {
+      leads.list.validatePageVisible()
+
+      cy.get(leads.list.selectors.pagination).then($pagination => {
+        if ($pagination.length > 0) {
+          leads.list.nextPage()
+        }
+      })
+    })
+  })
+
+  describe('UPDATE - Admin can update leads', () => {
+    it('ADMIN_LEAD_UPDATE_001: should edit lead information', () => {
+      cy.get(leads.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          // Click on first row to view details
+          leads.list.clickRowByIndex(0)
+
+          cy.url().then(url => {
+            const leadId = url.split('/').pop()
+
+            // Navigate to edit page
+            leads.form.visitEdit(leadId!)
+            leads.form.validateFormVisible()
+
+            // Update first name
+            const updatedFirstName = `UpdatedAdmin`
+            leads.form.typeInField('firstName', updatedFirstName)
+
+            leads.submitForm()
+
+            cy.url().should('include', '/dashboard/leads')
+            cy.contains(updatedFirstName).should('be.visible')
+          })
+        }
+      })
+    })
+
+    it('ADMIN_LEAD_UPDATE_002: should progress lead through sales pipeline', () => {
+      cy.get(leads.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          leads.list.clickRowByIndex(0)
+
+          cy.url().then(url => {
+            const leadId = url.split('/').pop()
+
+            leads.form.visitEdit(leadId!)
+            leads.form.validateFormVisible()
+
+            // Progress status
+            leads.form.selectOption('status', 'contacted')
+
+            leads.submitForm()
+            cy.url().should('include', '/dashboard/leads')
+          })
+        }
+      })
+    })
+
+    it('ADMIN_LEAD_UPDATE_003: should cancel update without saving', () => {
+      cy.get(leads.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          leads.list.clickRowByIndex(0)
+
+          cy.url().then(url => {
+            const leadId = url.split('/').pop()
+
+            leads.form.visitEdit(leadId!)
+            leads.form.validateFormVisible()
+
+            leads.form.typeInField('firstName', 'ShouldNotSave')
+
+            leads.form.cancel()
+            cy.url().should('not.include', '/edit')
+          })
+        }
+      })
+    })
+  })
+
+  describe('DELETE - Admin can delete leads', () => {
+    it('ADMIN_LEAD_DELETE_001: should delete lead', () => {
+      // First, create a lead to delete
+      const timestamp = Date.now()
+      const firstName = `AdminDelete`
+      const lastName = `Test ${timestamp}`
+      const email = `admin-delete${timestamp}@example.com`
+
+      leads.list.clickCreate()
+      leads.fillLeadForm({
+        firstName,
+        lastName,
+        email,
+        status: 'new'
+      })
+      leads.submitForm()
+
+      // Wait for lead to appear
+      cy.contains(lastName).should('be.visible')
+
+      // Search for the lead
+      leads.list.search(lastName)
+
+      // Delete it
+      cy.get(leads.list.selectors.rowGeneric).first().within(() => {
+        cy.get('[data-cy*="delete"]').click()
+      })
+
+      // Confirm deletion
+      leads.list.confirmDelete()
+
+      // Validate deletion
+      leads.list.search(lastName)
+      cy.get(leads.list.selectors.emptyState).should('be.visible')
+    })
+
+    it('ADMIN_LEAD_DELETE_002: should cancel deletion', () => {
+      cy.get(leads.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          cy.get(leads.list.selectors.rowGeneric).first().within(() => {
+            cy.get('[data-cy*="delete"]').click()
+          })
+
+          leads.list.cancelDelete()
+          leads.list.validateTableVisible()
+        }
+      })
+    })
+
+    it('ADMIN_LEAD_DELETE_003: should handle bulk delete', () => {
+      leads.list.selectAll()
+      leads.list.validateBulkActionsVisible()
+    })
+  })
+
+  describe('CONVERT - Admin can convert leads', () => {
+    it('ADMIN_LEAD_CONVERT_001: should convert lead to contact', () => {
+      cy.get(leads.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          leads.list.clickRowByIndex(0)
+
+          // Check if convert button exists
+          cy.get('[data-cy="lead-convert-btn"]').then($btn => {
+            if ($btn.length > 0) {
+              leads.convertToContact()
+              // Should navigate to contact or show success
+              cy.url().should('include', '/contacts')
+            }
+          })
+        }
+      })
+    })
+  })
+})

package/tests/cypress/e2e/ui/leads/leads-member.cy.ts

@@ -0,0 +1,193 @@
+/// <reference types="cypress" />
+
+/**
+ * Leads CRUD - Member Role (Create + Read + Update, No Delete)
+ *
+ * Uses CRM theme-specific POMs with Entity Testing Convention.
+ * Selectors follow the pattern: {slug}-{component}-{detail}
+ */
+
+import { LeadsPOM } from '../../../../src/entities/LeadsPOM'
+import { loginAsCrmMember } from '../../../../src/session-helpers'
+
+describe('Leads CRUD - Member Role (Create + Read + Update)', () => {
+  const leads = new LeadsPOM()
+
+  beforeEach(() => {
+    loginAsCrmMember()
+    cy.visit('/dashboard/leads')
+    leads.list.validatePageVisible()
+  })
+
+  describe('READ - Member CAN view leads', () => {
+    it('MEMBER_LEAD_READ_001: should view lead list', () => {
+      leads.list.validatePageVisible()
+      leads.list.validateTableVisible()
+    })
+
+    it('MEMBER_LEAD_READ_002: should view lead details', () => {
+      cy.get(leads.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          leads.list.clickRowByIndex(0)
+          cy.url().should('match', /\/dashboard\/leads\/[a-z0-9-]+/)
+        }
+      })
+    })
+
+    it('MEMBER_LEAD_READ_003: should search and filter leads', () => {
+      leads.list.search('test')
+      cy.wait(500)
+      leads.list.clearSearch()
+    })
+  })
+
+  describe('UPDATE - Member CAN edit leads', () => {
+    it('MEMBER_LEAD_UPDATE_001: should edit existing lead', () => {
+      cy.get(leads.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          leads.list.clickRowByIndex(0)
+
+          cy.url().then(url => {
+            const leadId = url.split('/').pop()
+            leads.form.visitEdit(leadId!)
+            leads.form.validateFormVisible()
+
+            // Verify fields are enabled (Member can edit)
+            cy.get(leads.form.selectors.field('firstName')).within(() => {
+              cy.get('input, textarea').should('not.be.disabled')
+            })
+          })
+        }
+      })
+    })
+
+    it('MEMBER_LEAD_UPDATE_002: should update lead status after contact', () => {
+      cy.get(leads.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          leads.list.clickRowByIndex(0)
+
+          cy.url().then(url => {
+            const leadId = url.split('/').pop()
+            leads.form.visitEdit(leadId!)
+            leads.form.validateFormVisible()
+
+            leads.form.selectOption('status', 'contacted')
+
+            leads.submitForm()
+            cy.url().should('include', '/dashboard/leads')
+          })
+        }
+      })
+    })
+
+    it('MEMBER_LEAD_UPDATE_003: should add notes to lead', () => {
+      cy.get(leads.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          leads.list.clickRowByIndex(0)
+
+          cy.url().then(url => {
+            const leadId = url.split('/').pop()
+            leads.form.visitEdit(leadId!)
+            leads.form.validateFormVisible()
+
+            // Add notes if field exists
+            cy.get('body').then($body => {
+              if ($body.find(leads.form.selectors.field('notes')).length > 0) {
+                const timestamp = new Date().toISOString()
+                leads.form.typeInTextarea('notes', `Member follow-up: Called on ${timestamp}`)
+
+                leads.submitForm()
+                cy.url().should('include', '/dashboard/leads')
+              }
+            })
+          })
+        }
+      })
+    })
+  })
+
+  describe('CREATE - Member CAN create leads', () => {
+    it('MEMBER_LEAD_CREATE_001: should show add button', () => {
+      cy.get(leads.list.selectors.createButton).should('be.visible')
+    })
+
+    it('MEMBER_LEAD_CREATE_002: should create new lead successfully', () => {
+      leads.list.clickCreate()
+      leads.form.validateFormVisible()
+
+      const timestamp = Date.now()
+
+      leads.fillLeadForm({
+        firstName: `MemberLead${timestamp}`,
+        lastName: 'Test',
+        email: `memberlead${timestamp}@test.com`,
+        phone: '+34 600 123 456',
+        source: 'website'
+      })
+
+      leads.submitForm()
+
+      cy.url().should('include', '/dashboard/leads')
+      cy.contains(`MemberLead${timestamp}`).should('be.visible')
+    })
+
+    it('MEMBER_LEAD_CREATE_003: should create lead with minimal required fields', () => {
+      leads.list.clickCreate()
+      leads.form.validateFormVisible()
+
+      const timestamp = Date.now()
+      leads.fillLeadForm({
+        firstName: `MinimalMember${timestamp}`,
+        email: `minimal${timestamp}@test.com`
+      })
+
+      leads.submitForm()
+      cy.url().should('include', '/dashboard/leads')
+    })
+  })
+
+  describe('DELETE - Member CANNOT delete leads', () => {
+    it('MEMBER_LEAD_DELETE_001: delete buttons should be hidden', () => {
+      cy.get('[data-cy*="delete"]').should('not.exist')
+    })
+
+    it('MEMBER_LEAD_DELETE_002: should not see delete action in list view', () => {
+      cy.get(leads.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          cy.get('[data-cy*="delete"]').should('not.exist')
+        }
+      })
+    })
+
+    it('MEMBER_LEAD_DELETE_003: should not see delete action in detail view', () => {
+      cy.get(leads.list.selectors.rowGeneric).then($rows => {
+        if ($rows.length > 0) {
+          leads.list.clickRowByIndex(0)
+          cy.url().should('match', /\/dashboard\/leads\/[a-z0-9-]+/)
+
+          cy.get('[data-cy="lead-delete-btn"]').should('not.exist')
+          cy.get('button:contains("Delete")').should('not.exist')
+        }
+      })
+    })
+  })
+
+  describe('PERMISSIONS - Member role capabilities', () => {
+    it('MEMBER_LEAD_PERM_001: should have create, read, and update permissions', () => {
+      leads.list.validatePageVisible()
+
+      // Verify create button exists (create permission)
+      cy.get(leads.list.selectors.createButton).should('be.visible')
+
+      // Verify no delete buttons (no delete permission)
+      cy.get('[data-cy*="delete"]').should('not.exist')
+    })
+
+    it('MEMBER_LEAD_PERM_002: should be able to create and work with leads', () => {
+      leads.list.validatePageVisible()
+
+      // Member can create leads
+      cy.get(leads.list.selectors.createButton).should('be.visible')
+    })
+  })
+})