Vue d'ensemble de l'architecture

Ce document fournit une description technique détaillée de la solution Flexible Team Share, incluant l’architecture système, le flux de données et les couches de traitement.

Architecture système

flowchart TB
    subgraph UI["UI LAYER"]
        direction LR
        LWC1["objectTeamMember<br/>Team member list & management"]
        LWC2["objectTeamMemberWizard<br/>Admin configuration"]
        LWC3["ftsLabels<br/>Custom labels utility"]
    end

    subgraph CTRL["CONTROLLER LAYER"]
        direction LR
        C1["ObjectTeamMemberController<br/>CRUD operations for team members"]
        C2["TeamMemberWizardController<br/>Configuration wizard operations"]
    end

    subgraph DATA["DATA LAYER"]
        direction LR
        D1["ObjectTeamMember__c<br/>Team member assignments"]
        D2["Team_Sharing_Config__c<br/>Per-object sharing config"]
        D3["FlexiTeamShare_Config__mdt<br/>App configuration"]
        D4["Triggers:<br/>ObjectTeamMemberTrigger"]
    end

    subgraph ASYNC["ASYNC PROCESSING LAYER"]
        direction LR
        A1["ShareRecordQueueable<br/>Create/update/delete shares"]
        A2["SharingRecalculationBatch<br/>Bulk recalculation"]
        A3["ExpiredTeamMemberCleanupBatch<br/>Daily cleanup of expired members"]
    end

    subgraph SHARE["SALESFORCE SHARING MODEL"]
        direction LR
        S1["Standard Share Objects<br/>AccountShare, ContactShare,<br/>CaseShare, LeadShare,<br/>OpportunityShare, etc."]
        S2["Custom Object Shares<br/>[CustomObject]__Share"]
        S3["ObjectTeamMember__Share<br/>Team member visibility"]
    end

    UI --> CTRL
    CTRL --> DATA
    DATA --> ASYNC
    ASYNC --> SHARE

Couches

Couche UI

Trois Lightning Web Components :

Composant	Objectif
objectTeamMember	Affiche les membres d’équipe sur les pages d’enregistrement. Prend en charge l’ajout/modification/suppression, la liste réductible et la limite d’affichage configurable.
objectTeamMemberWizard	Interface administrateur pour configurer les objets, gérer les paramètres et planifier les tâches.
ftsLabels	Composant utilitaire fournissant des Custom Labels pour la prise en charge i18n (35 langues).

Couche contrôleur

Contrôleur	Méthodes
ObjectTeamMemberController	getTeamMembers(), addTeamMember(), updateTeamMember(), removeTeamMember(), isCurrentUserManager(), isSharingConfigured(), getAccessLevelOptions()
TeamMemberWizardController	getExistingConfigs(), getAvailableObjects(), createConfig(), toggleConfigStatus(), deleteConfig(), getScheduledJobInfo(), scheduleCleanupJob()
SyncOwnerInvocable	syncOwners() — Invocable Action pour synchroniser le membre d’équipe Owner lorsque le propriétaire parent change. Appelable depuis Flow ou Apex, entièrement bulkifié.

Couche de données

Objets personnalisés et un déclencheur qui se déclenche lors des changements de membre d’équipe :

• ObjectTeamMember__c — stocke les affectations de membres d’équipe
• Team_Sharing_Config__c — configuration de partage par objet
• FlexiTeamShare_Config__mdt — configuration au niveau de l’application (Custom Metadata)
• ObjectTeamMemberTrigger → ObjectTeamMemberTriggerHandler — gère Before Insert, Before Update, Before Delete

Couche de traitement asynchrone

Composant	Type	Objectif
ShareRecordQueueable	Queueable	Crée, met à jour et supprime des enregistrements de partage pour les objets parents et les membres d’équipe
SharingRecalculationBatch	Batchable	Recalcule en masse tous les partages lorsque la configuration change
ExpiredTeamMemberCleanupBatch	Batchable	Supprime les membres d’équipe expirés (tâche planifiée quotidienne)
ExpiredTeamMemberCleanupScheduler	Schedulable	Planifie le batch de nettoyage (s’exécute à 2h00 du matin quotidiennement)

Flux de données : Ajout d’un membre d’équipe

sequenceDiagram
    actor User
    participant LWC as objectTeamMember LWC
    participant Ctrl as ObjectTeamMemberController
    participant DB as Database
    participant Queue as ShareRecordQueueable

    User->>LWC: Click "Add Team Member"
    LWC->>LWC: Collect input (User, Access Level, Role, End Date)
    LWC->>Ctrl: addTeamMember(recordId, userId, accessLevel, role, endDate)

    Ctrl->>Ctrl: Check for duplicates
    Ctrl->>Ctrl: Verify CRUD permissions

    Ctrl->>DB: INSERT ObjectTeamMember__c
    DB-->>Ctrl: Success

    Note over Ctrl,Queue: Trigger fires after insert
    Ctrl->>Queue: System.enqueueJob()

    Ctrl-->>LWC: Return success
    LWC-->>User: Refresh team member list

    Note over Queue: Async processing
    Queue->>DB: INSERT [Object]Share
    Queue->>DB: INSERT ObjectTeamMember__Share

Flux de données : Synchronisation du changement de propriétaire

sequenceDiagram
    actor Admin
    participant Flow as Record-Triggered Flow
    participant Inv as SyncOwnerInvocable
    participant DB as Database
    participant Queue as ShareRecordQueueable

    Note over Admin: Changes record owner

    Admin->>DB: UPDATE Account SET OwnerId = :newOwner
    DB-->>Flow: Trigger: OwnerId changed

    Flow->>Inv: syncOwners([recordId])

    Inv->>DB: SELECT FROM ObjectTeamMember__c WHERE Role__c = 'Owner'
    DB-->>Inv: Owner team member

    Inv->>DB: SELECT OwnerId FROM Account
    DB-->>Inv: New owner ID

    alt Owner changed
        Inv->>DB: UPDATE ObjectTeamMember__c SET User_Id__c = :newOwner
        DB-->>Inv: Success

        Inv->>Queue: System.enqueueJob()

        Note over Queue: Async processing
        Queue->>DB: DELETE old AccountShare (if not member)
        Queue->>DB: INSERT new AccountShare
    else Owner unchanged
        Inv-->>Flow: success=true, "Owner unchanged"
    end

    Inv-->>Flow: SyncOwnerResult

Flux de données : Nettoyage des membres expirés

flowchart TB
    A["Salesforce Scheduler<br/>(2:00 AM daily)"] --> B["ExpiredTeamMemberCleanupScheduler"]
    B --> C["ExpiredTeamMemberCleanupBatch"]
    C --> D["Query:<br/>SELECT FROM ObjectTeamMember__c<br/>WHERE End_Date__c < TODAY()"]
    D --> E["DELETE expired records<br/>(triggers remove shares)"]

Gestion des erreurs

Couche contrôleur

• Toutes les méthodes publiques enveloppées dans try-catch
• Messages d’erreur conviviaux via Custom Labels
• AuraHandledException pour l’affichage des erreurs LWC

Traitement asynchrone

• Database.insert/update/delete(records, false) — succès partiel
• Les erreurs individuelles sont enregistrées, n’échouent pas tout le batch
• Statistiques d’erreur suivies dans les tâches batch

Couche déclencheur

• Le modèle de gestionnaire de déclencheur prévient la récursion
• Les erreurs remontent à l’appelant de l’opération DML

Considérations de performance

Traitement asynchrone

• Les opérations d’enregistrement de partage utilisent Queueable (non bloquant)
• Les opérations en masse utilisent Batchable avec une taille de batch configurable
• Aucun DML synchrone sur les enregistrements de partage dans les déclencheurs

Optimisation des requêtes

• Champs indexés utilisés dans les clauses WHERE
• Le format Record_Id__c permet des requêtes LIKE efficaces
• Ensembles de résultats limités avec des clauses LIMIT

Mise en cache

• @AuraEnabled(cacheable=true) pour les opérations de lecture
• Configuration de l’application mise en cache dans la transaction

Architecture d’intégration

Aucune intégration externe — ce package fonctionne entièrement dans Salesforce :

• Aucun HTTP callout
• Aucune API externe
• Aucun Named Credentials
• Aucun External Objects
• Aucune Connected Apps

Dépendances de plateforme

Composant	Utilisation
Apex Sharing	Crée/gère les enregistrements de partage
Queueable Apex	Opérations asynchrones d’enregistrement de partage
Batchable Apex	Recalcul en masse du partage, nettoyage
Schedulable Apex	Tâche de nettoyage quotidienne
Custom Metadata	Configuration de l’application
Lightning Web Components	Interface utilisateur
Custom Labels	Internationalisation