@controleonline/ui-customers 1.0.81

package/src/react/components/tabs/franchiseLinksTab.helpers.js

@@ -0,0 +1,247 @@
+/**
+ * Pure helpers for Franchise/Filial (PJ→PJ) people_link management.
+ * Administrative CRUD is gated by APP_TYPE === MANAGER.
+ *
+ * task-485: extractEntityId must accept object | IRI string | scalar id so
+ * GET /people_links?company=… rows are not filtered out when company/people
+ * are not fully expanded in the payload.
+ */
+
+/**
+ * Types in people_link.link_type MySQL SET (api-platform-people PeopleLink).
+ * Entity SET includes both franchisee and filial — query both.
+ * (Older comment about filial not in SET is outdated vs current columnDefinition.)
+ */
+export const FRANCHISE_LINK_TYPES = ['franchisee'];
+
+/** Labels / residual payloads. */
+export const FRANCHISE_LINK_TYPES_UI = ['franchisee', 'filial'];
+
+export const buildFranchiseLinkReadParams = (companyId, itemsPerPage = 100) => {
+  const id = extractEntityId(companyId);
+  const company = id || companyId;
+  // Scope the response on the server. Boolean enable=true empties the
+  // collection on the deployed API; linkType must be an array.
+  return {
+    company,
+    linkType: [...FRANCHISE_LINK_TYPES],
+    itemsPerPage,
+  };
+};
+
+export const extractEntityId = value => {
+  if (value == null || value === '') {
+    return '';
+  }
+  if (typeof value === 'object') {
+    return extractEntityId(value.id || value['@id'] || '');
+  }
+  return String(value)
+    .replace(/\D/g, '')
+    .trim();
+};
+
+export const toPeopleIri = value => {
+  const directIri = String(value?.['@id'] || value || '').trim();
+  if (directIri.startsWith('/people/')) {
+    return directIri;
+  }
+
+  const id = extractEntityId(value?.id || value?.['@id'] || value);
+  return id ? `/people/${id}` : '';
+};
+
+export const normalizeAppType = value =>
+  String(value || '')
+    .trim()
+    .toUpperCase();
+
+/** Administrative link/edit/remove only in MANAGER app type. */
+export const canManageFranchiseLinks = appType =>
+  normalizeAppType(appType) === 'MANAGER';
+
+export const normalizeFranchiseLinkType = value => {
+  const normalized = String(value || '')
+    .trim()
+    .toLowerCase();
+  // Accept UI residual `filial` for display; API read uses FRANCHISE_LINK_TYPES only.
+  return FRANCHISE_LINK_TYPES_UI.includes(normalized) ? normalized : '';
+};
+
+export const franchiseLinkTypeLabel = (linkType, t) => {
+  const type = normalizeFranchiseLinkType(linkType);
+  if (type === 'franchisee') {
+    return t?.t?.('people', 'title', 'franchise') || 'Franquia';
+  }
+  if (type === 'filial') {
+    return t?.t?.('people', 'title', 'branch') || 'Filial';
+  }
+  return type || '-';
+};
+
+export const normalizeFranchiseCandidate = item => {
+  // Accept full People object, IRI string or numeric id
+  const peopleId = extractEntityId(item);
+  const peopleIri = toPeopleIri(item);
+  const peopleName = String(
+    (typeof item === 'object' && item
+      ? item.name || item.alias
+      : '') || '',
+  ).trim();
+  const peopleAlias = String(
+    (typeof item === 'object' && item ? item.alias : '') || '',
+  ).trim();
+  const peopleType = String(
+    (typeof item === 'object' && item ? item.peopleType : '') || '',
+  ).toUpperCase();
+
+  if (!peopleId || !peopleIri) {
+    return null;
+  }
+
+  // Only PJ (legal entity) when type is known; allow missing type (partial embed)
+  if (peopleType && peopleType !== 'J') {
+    return null;
+  }
+
+  return {
+    id: peopleId,
+    iri: peopleIri,
+    name: peopleName || `ID ${peopleId}`,
+    alias: peopleAlias,
+    peopleType: peopleType || 'J',
+  };
+};
+
+export const normalizeFranchiseLink = item => {
+  // Linked PJ is in `people` when company is the current client (parent)
+  const linked = normalizeFranchiseCandidate(
+    item?.people ?? item?.people_id ?? null,
+  );
+  if (!linked) {
+    return null;
+  }
+
+  const linkType = normalizeFranchiseLinkType(item?.linkType);
+  if (!linkType) {
+    return null;
+  }
+
+  return {
+    id:
+      extractEntityId(item?.id || item?.['@id']) ||
+      String(item?.id || item?.['@id'] || ''),
+    linkedId: linked.id,
+    linkedIri: linked.iri,
+    linkedName: linked.name,
+    linkedAlias: linked.alias,
+    linkType,
+    comission: item?.comission ?? item?.commission ?? 0,
+    minimumComission:
+      item?.minimum_comission ?? item?.minimumComission ?? 0,
+  };
+};
+
+export const buildAvailableFranchiseOptions = ({
+  candidates,
+  linkedItems,
+  editingLink,
+}) => {
+  const currentLinkedId = extractEntityId(editingLink?.linkedId);
+  const linkedIds = new Set(
+    (Array.isArray(linkedItems) ? linkedItems : [])
+      .map(item => extractEntityId(item?.linkedId))
+      .filter(id => id && id !== currentLinkedId),
+  );
+
+  return (Array.isArray(candidates) ? candidates : [])
+    .map(normalizeFranchiseCandidate)
+    .filter(Boolean)
+    .filter(item => !linkedIds.has(item.id));
+};
+
+export const buildFranchiseSavePayload = ({
+  editingLink,
+  formData,
+  companyIri,
+}) => {
+  if (!companyIri || !formData?.linkedIri) {
+    return null;
+  }
+
+  const linkType = normalizeFranchiseLinkType(formData.linkType);
+  if (!linkType) {
+    return null;
+  }
+
+  return {
+    ...(editingLink?.id ? { id: editingLink.id } : {}),
+    company: companyIri,
+    people: formData.linkedIri,
+    linkType,
+    comission: Number(String(formData.comission ?? 0).replace(',', '.')) || 0,
+    minimum_comission:
+      Number(String(formData.minimumComission ?? 0).replace(',', '.')) || 0,
+    enable: true,
+  };
+};
+
+export const buildFranchiseLinksFromPeopleLinks = (
+  payload,
+  { companyId = '' } = {},
+) => {
+  const extractItems = data => {
+    if (Array.isArray(data)) return data;
+    if (Array.isArray(data?.member)) return data.member;
+    if (Array.isArray(data?.['hydra:member'])) return data['hydra:member'];
+    if (Array.isArray(data?.items)) return data.items;
+    return [];
+  };
+
+  const normalizedCompanyId = extractEntityId(companyId);
+
+  return extractItems(payload)
+    .filter(link => {
+      // company/people may be object, IRI string or scalar (task-485)
+      const linkCompanyId = extractEntityId(
+        link?.company ?? link?.company_id,
+      );
+      const linkType = normalizeFranchiseLinkType(link?.linkType);
+      const linkedPeopleId = extractEntityId(
+        link?.people ?? link?.people_id,
+      );
+      const peopleType = String(
+        (typeof link?.people === 'object' && link?.people
+          ? link.people.peopleType
+          : '') || '',
+      ).toUpperCase();
+
+      if (!linkType || !linkedPeopleId) {
+        return false;
+      }
+      if (normalizedCompanyId && linkCompanyId && linkCompanyId !== normalizedCompanyId) {
+        return false;
+      }
+      // When company filter was requested but row has no company id, keep if people exists
+      // (API already filtered by company query param).
+      // PJ only when type known
+      if (peopleType && peopleType !== 'J') {
+        return false;
+      }
+      return true;
+    })
+    .map(link => {
+      const peopleRaw = link?.people;
+      let people = peopleRaw;
+      if (typeof peopleRaw !== 'object' || peopleRaw == null) {
+        const id = extractEntityId(peopleRaw ?? link?.people_id);
+        people = id
+          ? { id, '@id': `/people/${id}`, name: `ID ${id}`, peopleType: 'J' }
+          : {};
+      }
+      return {
+        ...link,
+        people,
+      };
+    });
+};

package/src/react/components/tabs/generalTabHelpers.js

@@ -0,0 +1,120 @@
+/**
+ * Pure helpers for GeneralTab (registration form, dates, link types).
+ * Extracted to keep GeneralTab.js under the absolute 500-line limit.
+ */
+
+const normalizeText = value => String(value || '').replace(/\s+/g, ' ').trim();
+const normalizeIdentityValue = value => normalizeText(value);
+const extractId = value => String(value || '').replace(/\D/g, '');
+
+const normalizeEnable = value => {
+  if (typeof value === 'boolean') {
+    return value;
+  }
+
+  if (typeof value === 'number') {
+    return value === 1;
+  }
+
+  if (typeof value === 'string') {
+    const normalized = value.trim().toLowerCase();
+    return normalized === '1' || normalized === 'true';
+  }
+
+  return false;
+};
+
+const formatYmdToBr = value => {
+  if (!value) {
+    return '';
+  }
+
+  const normalized = String(value).split('T')[0];
+  const parts = normalized.split('-');
+  if (parts.length !== 3) {
+    return '';
+  }
+
+  return `${parts[2]}/${parts[1]}/${parts[0]}`;
+};
+
+const formatDateInput = text => {
+  const numbers = String(text || '').replace(/\D/g, '').slice(0, 8);
+  if (!numbers) {
+    return '';
+  }
+
+  if (numbers.length <= 2) {
+    return numbers;
+  }
+
+  if (numbers.length <= 4) {
+    return `${numbers.slice(0, 2)}/${numbers.slice(2)}`;
+  }
+
+  return `${numbers.slice(0, 2)}/${numbers.slice(2, 4)}/${numbers.slice(4)}`;
+};
+
+const parseBrDateToYmd = value => {
+  const formatted = formatDateInput(value);
+  if (formatted.length !== 10) {
+    return null;
+  }
+
+  const [day, month, year] = formatted.split('/').map(v => parseInt(v, 10));
+  if (!day || !month || !year) {
+    return null;
+  }
+
+  const candidate = new Date(year, month - 1, day);
+  const isValid =
+    candidate.getFullYear() === year &&
+    candidate.getMonth() === month - 1 &&
+    candidate.getDate() === day;
+
+  if (!isValid) {
+    return null;
+  }
+
+  return `${year.toString().padStart(4, '0')}-${month
+    .toString()
+    .padStart(2, '0')}-${day.toString().padStart(2, '0')}`;
+};
+
+const LINK_TYPE_OPTIONS = [
+  { value: 'employee', translationKey: 'employee' },
+  { value: 'owner', translationKey: 'owner' },
+  { value: 'director', translationKey: 'director' },
+  { value: 'manager', translationKey: 'manager' },
+  { value: 'courier', translationKey: 'courier' },
+];
+
+const normalizeLinkType = value => {
+  const normalized = String(value || '').trim().toLowerCase();
+  return ['employee', 'owner', 'director', 'manager', 'courier'].includes(normalized)
+    ? normalized
+    : 'employee';
+};
+
+const toPeopleIri = value => {
+  const directIri = String(value?.['@id'] || '').trim();
+  if (directIri.startsWith('/people/')) {
+    return directIri;
+  }
+
+  const id = String(value?.id || '').replace(/\D/g, '');
+  return id ? `/people/${id}` : '';
+};
+
+export {
+  normalizeText,
+  normalizeIdentityValue,
+  extractId,
+  normalizeEnable,
+  formatYmdToBr,
+  formatDateInput,
+  parseBrDateToYmd,
+  LINK_TYPE_OPTIONS,
+  normalizeLinkType,
+  toPeopleIri,
+};

package/src/react/components/tabs/salesmanTab.helpers.js

@@ -0,0 +1,114 @@
+/**
+ * Pure helpers for SalesmanTab management (MANAGER) and commission labels.
+ * Administrative CRUD is gated by APP_TYPE === MANAGER (see AGENTS.md / wiki).
+ */
+
+export const extractEntityId = value =>
+  String(value || '')
+    .replace(/\D/g, '')
+    .trim();
+
+export const toPeopleIri = value => {
+  const directIri = String(value?.['@id'] || value || '').trim();
+  if (directIri.startsWith('/people/')) {
+    return directIri;
+  }
+
+  const id = extractEntityId(value?.id || value?.['@id'] || value);
+  return id ? `/people/${id}` : '';
+};
+
+export const normalizeAppType = value =>
+  String(value || '')
+    .trim()
+    .toUpperCase();
+
+/** Administrative link/edit/remove only in MANAGER app type. */
+export const canManageSalesmen = appType => normalizeAppType(appType) === 'MANAGER';
+
+export const normalizeCommissionValue = value => {
+  const normalized = String(value ?? '')
+    .replace(',', '.')
+    .trim();
+  const parsed = Number.parseFloat(normalized);
+
+  return Number.isFinite(parsed) ? parsed : 0;
+};
+
+export const formatCommissionLabel = value =>
+  `${normalizeCommissionValue(value).toFixed(2).replace('.', ',')}%`;
+
+export const normalizeSalesmanCandidate = item => {
+  const sellerId = extractEntityId(item?.id || item?.['@id']);
+  const sellerIri = toPeopleIri(item);
+  const sellerName = String(item?.name || item?.alias || '').trim();
+  const sellerAlias = String(item?.alias || '').trim();
+
+  if (!sellerId || !sellerIri || !sellerName) {
+    return null;
+  }
+
+  return {
+    id: sellerId,
+    iri: sellerIri,
+    name: sellerName,
+    alias: sellerAlias,
+  };
+};
+
+export const normalizeSalesmanLink = item => {
+  const seller = normalizeSalesmanCandidate(item?.company || {});
+  if (!seller) {
+    return null;
+  }
+
+  return {
+    id: extractEntityId(item?.id || item?.['@id']) || String(item?.id || item?.['@id'] || ''),
+    sellerId: seller.id,
+    sellerIri: seller.iri,
+    sellerName: seller.name,
+    sellerAlias: seller.alias,
+    commission: normalizeCommissionValue(item?.comission),
+    minimumCommission: normalizeCommissionValue(
+      item?.minimum_comission ?? item?.minimumComission,
+    ),
+  };
+};
+
+export const buildAvailableSalesmanOptions = ({
+  salesmen,
+  linkedSalesmen,
+  editingLink,
+}) => {
+  const currentSellerId = extractEntityId(editingLink?.sellerId);
+  const linkedSellerIds = new Set(
+    (Array.isArray(linkedSalesmen) ? linkedSalesmen : [])
+      .map(item => extractEntityId(item?.sellerId))
+      .filter(id => id && id !== currentSellerId),
+  );
+
+  return (Array.isArray(salesmen) ? salesmen : [])
+    .map(normalizeSalesmanCandidate)
+    .filter(Boolean)
+    .filter(item => !linkedSellerIds.has(item.id));
+};
+
+export const buildSalesmanSavePayload = ({
+  editingLink,
+  formData,
+  clientIri,
+  linkType,
+}) => {
+  if (!clientIri || !formData?.sellerIri) {
+    return null;
+  }
+
+  return {
+    ...(editingLink?.id ? { id: editingLink.id } : {}),
+    company: formData.sellerIri,
+    people: clientIri,
+    linkType,
+    comission: normalizeCommissionValue(formData.commission),
+    minimum_comission: normalizeCommissionValue(formData.minimumCommission),
+  };
+};

package/src/react/components/tabs/salesmanTabHelpers.js

@@ -0,0 +1,173 @@
+/**
+ * Pure helpers for SalesmanTab commission display, override precedence and edit permission.
+ *
+ * Business rules (see docs/technical/Cliente-Vendedor-Vinculo-e-Permissoes.md):
+ * - franchisee link: franchisee pays franchisor
+ * - salesman / sellers-client: company pays salesman (salesman receives)
+ * - Precedence: client↔salesman commission (if filled) overrides salesman↔company default
+ */
+
+const extractId = value => String(value || '').replace(/\D/g, '');
+
+const EDITABLE_COMMISSION_ROLES = ['ROLE_SUPER', 'ROLE_OWNER'];
+
+/**
+ * A commission field is "filled" when it is present (including 0).
+ * null / undefined / '' are treated as absent (fall through to default).
+ */
+export const isCommissionFilled = value => {
+  if (value === null || value === undefined) {
+    return false;
+  }
+  if (typeof value === 'string' && value.trim() === '') {
+    return false;
+  }
+  return true;
+};
+
+export const toCommissionNumber = value => {
+  if (!isCommissionFilled(value)) {
+    return null;
+  }
+  const numeric = Number(value);
+  return Number.isFinite(numeric) ? numeric : null;
+};
+
+/**
+ * Resolve effective commission for a client↔salesman link.
+ *
+ * @param {object|null} clientLink - people_link sellers-client (company=salesman, people=client)
+ * @param {object|null} defaultLink - people_link salesman (company=empresa, people=salesman)
+ * @returns {{
+ *   comission: number|null,
+ *   minimumComission: number|null,
+ *   isOverride: boolean,
+ *   source: 'client'|'default'|'none'
+ * }}
+ */
+export const resolveEffectiveCommission = (clientLink, defaultLink = null) => {
+  const clientComission = toCommissionNumber(clientLink?.comission);
+  const clientMinimum = toCommissionNumber(
+    clientLink?.minimum_comission ?? clientLink?.minimumComission,
+  );
+  const defaultComission = toCommissionNumber(defaultLink?.comission);
+  const defaultMinimum = toCommissionNumber(
+    defaultLink?.minimum_comission ?? defaultLink?.minimumComission,
+  );
+
+  const clientHasComission = isCommissionFilled(clientLink?.comission);
+  const clientHasMinimum = isCommissionFilled(
+    clientLink?.minimum_comission ?? clientLink?.minimumComission,
+  );
+
+  const hasClientOverride = clientHasComission || clientHasMinimum;
+
+  return {
+    comission: clientHasComission ? clientComission : defaultComission,
+    minimumComission: clientHasMinimum ? clientMinimum : defaultMinimum,
+    isOverride: hasClientOverride,
+    source: hasClientOverride
+      ? 'client'
+      : defaultComission !== null || defaultMinimum !== null
+        ? 'default'
+        : 'none',
+  };
+};
+
+/**
+ * Format a commission percentage for display (pt-BR friendly).
+ */
+export const formatCommissionPercent = value => {
+  const numeric = toCommissionNumber(value);
+  if (numeric === null) {
+    return '—';
+  }
+  const fixed = Number.isInteger(numeric) ? String(numeric) : numeric.toFixed(2);
+  return `${fixed}%`;
+};
+
+/**
+ * Build a short subtitle describing effective commission + override/default.
+ */
+export const formatCommissionSubtitle = effective => {
+  if (!effective || effective.source === 'none') {
+    return 'Comissão: —';
+  }
+
+  const main = formatCommissionPercent(effective.comission);
+  const min =
+    effective.minimumComission !== null
+      ? ` (mín. ${formatCommissionPercent(effective.minimumComission)})`
+      : '';
+  const tag = effective.isOverride ? 'override' : 'padrão';
+
+  return `Comissão: ${main}${min} · ${tag}`;
+};
+
+/**
+ * Edit permission for commission fields on client SalesmanTab.
+ * Same criterion as franchisee commission (#10): ROLE_SUPER or ROLE_OWNER.
+ */
+export const canEditSalesmanCommission = (user = null, currentCompany = null) => {
+  const roles = Array.isArray(user?.roles)
+    ? user.roles
+    : Array.isArray(user?.role)
+      ? user.role
+      : [];
+
+  return (
+    roles.some(role => EDITABLE_COMMISSION_ROLES.includes(String(role))) ||
+    Boolean(currentCompany?.user?.owner_enabled)
+  );
+};
+
+/**
+ * Commission fields are only shown in MANAGER (and ADMIN) app types.
+ * CRM and other views must not expose commission values.
+ */
+export const shouldDisplayCommission = (appType = '') => {
+  const normalized = String(appType || '')
+    .trim()
+    .toUpperCase();
+  return normalized === 'MANAGER' || normalized === 'ADMIN';
+};
+
+/**
+ * Map of salesman people id → default people_link (linkType=salesman).
+ */
+export const indexDefaultSalesmanLinksByPeopleId = (payload = []) => {
+  const items = Array.isArray(payload)
+    ? payload
+    : Array.isArray(payload?.member)
+      ? payload.member
+      : Array.isArray(payload?.['hydra:member'])
+        ? payload['hydra:member']
+        : [];
+
+  return items.reduce((acc, link) => {
+    const peopleId = extractId(link?.people?.id || link?.people?.['@id'] || link?.people);
+    if (!peopleId) {
+      return acc;
+    }
+    acc[peopleId] = link;
+    return acc;
+  }, {});
+};
+
+/**
+ * Build save payload for people_link commission update.
+ */
+export const buildCommissionSavePayload = (link, {comission, minimumComission}) => {
+  const id = extractId(link?.id || link?.['@id']);
+  if (!id) {
+    return null;
+  }
+
+  return {
+    id,
+    comission: toCommissionNumber(comission) ?? 0,
+    minimum_comission: toCommissionNumber(minimumComission) ?? 0,
+  };
+};
+
+export {extractId, EDITABLE_COMMISSION_ROLES};

package/src/react/components/tabs/salesmanTabMedia.js

@@ -0,0 +1,55 @@
+import { resolveFileImageUrl } from '@controleonline/ui-common/src/react/utils/fileUrl';
+import { extractId } from './salesmanTabHelpers';
+
+const normalizeCollection = payload => {
+  if (Array.isArray(payload)) return payload;
+  if (!payload || typeof payload !== 'object') return [];
+  if (Array.isArray(payload.member)) return payload.member;
+  if (Array.isArray(payload['hydra:member'])) return payload['hydra:member'];
+  if (Array.isArray(payload.items)) return payload.items;
+  return [];
+};
+
+const COMPANY_ICON_MEDIA_TYPES = ['icon'];
+
+const fetchPeopleMediaUrl = async ({ peopleActions, peopleId, mediaType }) => {
+  const response = await peopleActions.getPeopleMedia({
+    people: `/people/${peopleId}`,
+    'mediaType.type': mediaType,
+    itemsPerPage: 1,
+  });
+  const media = normalizeCollection(response)[0];
+
+  return resolveFileImageUrl(media?.file);
+};
+
+const fetchPeopleMediaUrls = async ({ peopleActions, mediaTypes, peopleIds }) => {
+  const uniqueIds = [...new Set((peopleIds || []).map(extractId).filter(Boolean))];
+  const entries = await Promise.all(
+    uniqueIds.map(async peopleId => {
+      for (const mediaType of mediaTypes) {
+        const imageUrl = await fetchPeopleMediaUrl({
+          peopleActions,
+          peopleId,
+          mediaType,
+        }).catch(() => '');
+
+        if (imageUrl) {
+          return [peopleId, imageUrl];
+        }
+      }
+
+      return null;
+    }),
+  );
+
+  return entries
+    .filter(Boolean)
+    .reduce((accumulator, [peopleId, imageUrl]) => {
+      accumulator[peopleId] = imageUrl;
+      return accumulator;
+    }, {});
+};
+
+
+export { normalizeCollection, fetchPeopleMediaUrl, fetchPeopleMediaUrls, COMPANY_ICON_MEDIA_TYPES };