bemade-addons/bemade_fsm/migration18.md

# Improved Field Service Management - Migration vers Odoo 18.0

## Description
Ce module étend les fonctionnalités de gestion des services sur site (Field Service Management) avec des fonctionnalités spécifiques à Durpro.

## Fonctionnalités Ajoutées
### Gestion améliorée des services sur site
- **Existe dans Odoo 18.0 ?** : Partiellement
- **Différences avec la version native** :
  - Gestion avancée des équipements et des contacts
  - Système de modèles de tâches personnalisé
  - Intégration approfondie avec les commandes de vente
  - Gestion des visites FSM
  - Propagation des affectations et des contacts
- **Alternatives** :
  - Utiliser le module FSM standard d'Odoo
  - Implémenter des fonctionnalités spécifiques via des modules personnalisés

## Modèles et Champs Modifiés
### Modèles impactés
- **project.task** :
  - **Champs ajoutés** :
    - work_order_contacts : Contacts liés au bon de travail
    - site_contacts : Contacts sur site
    - visit_id : Lien vers la visite FSM
    - relevant_order_lines : Lignes de commande pertinentes
    - work_order_number : Numéro de bon de travail
    - propagate_assignment : Propagation des affectations
    - is_closed : Indicateur de tâche fermée
    - root_ancestor : Tâche racine de la hiérarchie
  - **Méthodes modifiées** :
    - create() : Gestion des contacts et numéros de bon de travail
    - write() : Propagation des modifications aux sous-tâches
    - _compute_allow_billable() : Calcul de la facturabilité
    - _fsm_create_sale_order_line() : Création de lignes de commande
    - action_fsm_validate() : Validation des tâches FSM
    - synchronize_name_fsm() : Synchronisation des noms des tâches
  - **Recommandations de migration** :
    - Vérifier la compatibilité avec le nouveau système de tâches Odoo 18
    - Tester la propagation des modifications
    - Adapter les calculs de facturabilité
    - Vérifier la gestion des noms des tâches

- **task.template** :
  - **Nouveau modèle** : project.task.template
  - **Champs principaux** :
    - name : Nom du modèle
    - description : Description HTML
    - assignees : Utilisateurs assignés par défaut
    - customer : Client par défaut
    - project : Projet par défaut
    - tags : Tags par défaut
    - parent : Modèle parent
    - subtasks : Sous-tâches
    - sequence : Ordre d'affichage
    - company_id : Société
    - planned_hours : Heures planifiées
    - equipment_ids : Équipements à entretenir
  - **Méthodes principales** :
    - _prepare_new_task_values_from_self() : Prépare les valeurs pour une nouvelle tâche
    - create_task_from_self() : Crée une tâche à partir du modèle
  - **Recommandations de migration** :
    - Vérifier la compatibilité avec le nouveau système de modèles de tâches Odoo 18
    - Tester la création de tâches à partir des modèles
    - Adapter la gestion des équipements et des heures planifiées
- **product.template** :
  - **Champs ajoutés** :
    - task_template_id : Modèle de tâche associé
    - is_field_service : Indicateur de service sur site
  - **Recommandations de migration** :
    - Vérifier la compatibilité avec le nouveau système de produits Odoo 18
    - Tester la gestion des modèles de tâches
    - Adapter l'indicateur de service sur site
- **res.partner** :
  - **Champs ajoutés** :
    - is_site_contact : Indicateur de contact sur site
    - is_service_site : Indicateur de site de service
    - site_ids : Sites de travail liés
    - site_contacts : Contacts sur site
    - work_order_contacts : Destinataires des bons de travail
  - **Méthodes modifiées** :
    - _compute_is_site_contact() : Calcul de l'état de contact sur site
    - _search_is_site_contact() : Recherche des contacts sur site
    - _compute_is_service_site() : Calcul de l'état de site de service
  - **Recommandations de migration** :
    - Vérifier la compatibilité avec le nouveau système de partenaires Odoo 18
    - Tester les calculs des indicateurs
    - Adapter la gestion des relations entre sites et contacts
- **sale.order** :
  - **Champs ajoutés** :
    - valid_equipment_ids : Équipements valides
    - default_equipment_ids : Équipements par défaut à entretenir
    - summary_equipment_ids : Équipements en cours de maintenance
    - site_contacts : Contacts sur site
    - work_order_contacts : Destinataires du bon de travail
    - visit_ids : Visites FSM liées
    - is_fsm : Indicateur de commande FSM
  - **Méthodes modifiées** :
    - get_relevant_order_lines() : Récupère les lignes pertinentes pour une tâche
    - _compute_summary_equipment_ids() : Calcule les équipements en maintenance
    - _onchange_partner_shipping_id() : Gère les changements de partenaire
    - _compute_default_contacts() : Calcule les contacts par défaut
    - _compute_default_equipment() : Calcule les équipements par défaut
    - copy() : Gère la copie des visites
    - _create_default_visit() : Crée une visite par défaut
    - _create_or_organize_visits_if_needed() : Organise les visites FSM
    - action_confirm() : Confirmation de commande avec gestion FSM
    - write() : Gère les mises à jour des partenaires
  - **Recommandations de migration** :
    - Vérifier la compatibilité avec le nouveau système de commandes Odoo 18
    - Tester la gestion des équipements
    - Adapter la gestion des visites FSM
    - Vérifier les calculs de contacts et d'équipements

## Vues à modifier
- **Vues existantes** :
  - Formulaire de tâche :
    - Ajout d'une page "Equipment and Contacts"
    - Modification des boutons de validation
    - Ajout du champ propagate_assignment
  - Vue liste :
    - Ajout du champ work_order_number
    - Masquage de certains champs optionnels
  - Vue calendrier :
    - Personnalisation des couleurs par utilisateur
    - Suppression du champ worksheet_template_id
  - Vue de recherche :
    - Modification des filtres de planification
    - Ajout du filtre "Parent Task"
- **Nouvelles vues** :
  - Aucune nouvelle vue créée, uniquement des modifications des vues existantes
- **Recommandations pour Odoo 18** :
  - Vérifier la compatibilité avec les nouvelles vues Odoo 18
  - Adapter les modifications de vues aux nouveaux designs
  - Tester les fonctionnalités de recherche et de filtrage
  - Vérifier la gestion des couleurs dans le calendrier

## Rapports
- **Rapports personnalisés** :
  - **Nouveaux blocs de rapport** :
    - Tableau des matériaux
    - Tableau des temps et matériaux avec tarification
    - Liste des sous-tâches
    - Bloc d'informations sur la commande
    - Résumé des équipements
    - Entrées de feuille de temps
    - Bloc de signature
  - **Modifications principales** :
    - Intégration des contacts et informations client
    - Affichage des dates planifiées
    - Gestion des signatures numériques
    - Personnalisation de la mise en page
  - **Recommandations pour Odoo 18** :
    - Vérifier la compatibilité avec le nouveau système de rapports Odoo 18
    - Adapter les modèles de rapport aux nouvelles fonctionnalités
    - Tester l'affichage des différents blocs
    - Vérifier la gestion des signatures numériques

## Assistants (Wizards)
- **Nouveaux assistants** : À documenter

## Analyse des Alternatives Natives Odoo 18.0

### Fonctionnalités Natives à Explorer
1. **Gestion des Services** :
   - Module Industry FSM d'Odoo Enterprise
   - Nouvelles fonctionnalités de planification
   - Système de rapports amélioré

2. **Gestion des Équipements** :
   - Module Maintenance d'Odoo
   - Intégration avec FSM
   - Système de suivi des équipements

3. **Gestion des Contacts** :
   - Système de contacts hiérarchiques
   - Gestion des rôles des contacts
   - Système d'adresses de livraison

### Approche "Vanilla First"

1. **Fonctionnalités à Conserver en Custom** :
   - Gestion spécifique des visites FSM
   - Propagation des affectations
   - Modèles de tâches personnalisés
   - Gestion avancée des contacts sur site

2. **Fonctionnalités à Migrer vers Native** :
   - Utiliser le système de planification natif
   - Adopter le système de rapports standard
   - Utiliser la gestion des équipements native
   - Intégrer avec le système de contacts standard

## Plan de Migration

### Phase 1 : Analyse et Préparation
1. **Audit des Fonctionnalités** :
   - [ ] Identifier les fonctionnalités disponibles nativement
   - [ ] Lister les gaps fonctionnels
   - [ ] Évaluer l'impact sur les processus existants

2. **Planification** :
   - [ ] Définir la stratégie de migration
   - [ ] Établir un calendrier
   - [ ] Identifier les risques

### Phase 2 : Migration Technique
1. **Adaptation du Code** :
   - [ ] Mettre à jour les vues (tree -> list)
   - [ ] Supprimer les attrs obsolètes
   - [ ] Adapter les méthodes aux nouvelles API

2. **Intégration Native** :
   - [ ] Intégrer avec Industry FSM
   - [ ] Connecter avec le module Maintenance
   - [ ] Adapter le système de contacts

### Phase 3 : Tests et Validation
1. **Tests Fonctionnels** :
   - [ ] Validation des workflows
   - [ ] Tests des rapports
   - [ ] Vérification des intégrations

2. **Tests de Performance** :
   - [ ] Analyse des requêtes SQL
   - [ ] Tests de charge
   - [ ] Optimisation si nécessaire

## Recommandations Spécifiques

### Modèles et Champs
1. **project.task** :
   - Utiliser les champs natifs quand possible
   - Conserver uniquement les champs spécifiques
   - Adapter les méthodes aux nouvelles API

2. **task.template** :
   - Évaluer le système de modèles natif
   - Simplifier la structure si possible
   - Optimiser la création de tâches

3. **sale.order** :
   - Utiliser les fonctionnalités FSM natives
   - Optimiser la gestion des visites
   - Simplifier les calculs

### Vues et Interface
1. **Modifications Prioritaires** :
   - Remplacer tree par list
   - Supprimer les attrs obsolètes
   - Adapter aux nouveaux standards UI

2. **Améliorations Suggérées** :
   - Utiliser les nouveaux widgets
   - Simplifier les vues
   - Améliorer l'expérience utilisateur

### Rapports
1. **Stratégie de Migration** :
   - Utiliser le nouveau système de rapports
   - Adapter les modèles existants
   - Optimiser le rendu

## État de la Migration
⚪ En analyse préliminaire

## Notes Importantes
- Module complexe nécessitant une approche progressive
- Forte dépendance avec d'autres modules
- Impact important sur les processus métier
- Nécessité de formation des utilisateurs

## Prochaines Étapes
1. Valider l'approche avec les parties prenantes
2. Créer un environnement de test
3. Commencer par les fonctionnalités critiques
4. Planifier la formation des utilisateurs

## Analyse Technique

### Fonctionnalités Natives dans Odoo 18.0

Le module `industry_fsm` d'Odoo Enterprise 18.0 inclut déjà plusieurs fonctionnalités avancées :

1. **Gestion des Tâches FSM**
   - Champ `is_fsm` sur les projets pour identifier les projets FSM
   - Champ `fsm_done` sur les tâches pour marquer leur complétion
   - Gestion des signatures sur les rapports de travail
   - Gestion des coordonnées client (téléphone, adresse, etc.)
   - Planification avec dates de début/fin

2. **Fonctionnalités de Base**
   - Vue spécifique pour les travailleurs sur le terrain
   - Rapports sur les tâches
   - Intégration avec les feuilles de temps
   - Géolocalisation des clients
   - Gestion des produits sur les tâches

3. **Sécurité et Contraintes**
   - Règles de sécurité spécifiques FSM
   - Contraintes sur les projets FSM (company_id requis)
   - Restrictions sur les dépendances de tâches et les jalons

### Différences avec Notre Module

1. **Fonctionnalités à Migrer**
   - [ ] Fonctionnalités spécifiques de gestion d'équipement
   - [ ] Workflows personnalisés
   - [ ] Rapports et analyses spécifiques
   - [ ] Intégrations avec d'autres modules custom

2. **Fonctionnalités à Adapter**
   - [ ] Utiliser les champs natifs plutôt que nos champs customs
   - [ ] Adapter nos vues aux nouvelles conventions Odoo 18.0
   - [ ] Intégrer nos processus avec le système natif

## Plan de Migration

### Phase 1 : Préparation
1. **Analyse des Données**
   - [ ] Identifier les données spécifiques à notre module
   - [ ] Mapper les champs actuels vers les champs natifs
   - [ ] Lister les fonctionnalités uniques à préserver

2. **Configuration**
   - [ ] Activer et configurer le module `industry_fsm`
   - [ ] Vérifier les dépendances et les conflits
   - [ ] Préparer les scripts de migration des données

### Phase 2 : Migration
1. **Migration des Données**
   - [ ] Transférer les données vers les structures natives
   - [ ] Adapter les configurations existantes
   - [ ] Mettre à jour les vues et rapports

2. **Développement**
   - [ ] Adapter le code pour utiliser l'API Odoo 18.0
   - [ ] Implémenter les fonctionnalités manquantes
   - [ ] Mettre à jour les vues XML (plus d'attrs, list au lieu de tree)

### Phase 3 : Tests
1. **Validation Fonctionnelle**
   - [ ] Tester les fonctionnalités de base FSM
   - [ ] Vérifier nos fonctionnalités spécifiques
   - [ ] Valider les workflows

2. **Tests d'Intégration**
   - [ ] Tester avec les autres modules
   - [ ] Vérifier la compatibilité mobile
   - [ ] Valider les performances

## État de la Migration
🟡 En cours d'analyse - Utilisation maximale des fonctionnalités natives

## Notes Importantes
- Le module `industry_fsm` d'Odoo Enterprise offre une base solide
- Plusieurs de nos fonctionnalités peuvent être remplacées par des fonctionnalités natives
- Certaines personnalisations spécifiques devront être maintenues
- La nouvelle interface utilisateur nécessitera une formation des utilisateurs

## Prochaines Étapes
1. Valider l'approche avec l'équipe
2. Créer les scripts de migration des données
3. Développer les fonctionnalités manquantes
4. Planifier la formation des utilisateurs

## Notes de Version
- Version originale: 17.0.1.0.0
- Dernière analyse: 26/01/2025