1. Pourquoi modéliser une hiérarchie ?

Jusqu'à T13, une catégorie de ticket est un enregistrement plat : Matériel, Logiciel, Réseau. Mais dans un support réel, tu as besoin de sous-catégories : Matériel > Imprimante > Bourrage papier.

Deux approches :

• Table séparée par niveau (category, subcategory, subsubcategory) — rigide, limité en profondeur, duplication de code.
• Auto-relation avec arbre — un seul modèle, profondeur illimitée, c'est le pattern Odoo.

Odoo utilise ce pattern partout : res.partner (parent company), account.account (plan comptable hiérarchique), product.category, hr.department, stock.location… La mécanique est toujours la même : parent_id + child_ids + index MPTT.

3. _parent_store — l'index MPTT d'Odoo

MPTT (Modified Preorder Tree Traversal) est un algorithme classique pour stocker des arbres en base relationnelle. Odoo en offre une variante simplifiée à base de chemin matérialisé : chaque nœud stocke sa position sous forme de chaîne "1/2/5/" dans la colonne parent_path.

L'activation tient en trois attributs de classe :

class HelpdeskTicketCategory(models.Model):
    _name = 'helpdesk.ticket.category'
    _parent_name = 'parent_id'   # par défaut, mais explicite vaut mieux
    _parent_store = True         # ← active l'index MPTT

    parent_id = fields.Many2one('helpdesk.ticket.category', ondelete='cascade', index=True)
    parent_path = fields.Char(index=True)   # ← OBLIGATOIRE avec _parent_store

Odoo maintient automatiquement la colonne parent_path à chaque create / write qui modifie parent_id. Résultat :

5. Protection anti-récursion

Rien n'empêche un utilisateur malicieux (ou maladroit) de définir Matériel comme parent de Support, qui est déjà son ancêtre. Tu obtiens un cycle, parent_path part en boucle infinie, le serveur tombe.

La parade est fournie clé-en-main par l'ORM : _check_recursion().

from odoo import api, models
from odoo.exceptions import ValidationError


class HelpdeskTicketCategory(models.Model):
    _name = 'helpdesk.ticket.category'
    _parent_store = True

    @api.constrains('parent_id')
    def _check_category_recursion(self):
        if not self._check_recursion():
            raise ValidationError(
                "Vous ne pouvez pas créer de catégories récursives."
            )

self._check_recursion() renvoie True si aucun enregistrement du recordset n'est son propre ancêtre, False sinon. À déclencher sur @api.constrains('parent_id') pour couvrir create et write.

Récapitulatif — fichier complet T14

models/helpdesk_ticket_category.py

from odoo import models, fields, api
from odoo.exceptions import ValidationError


class HelpdeskTicketCategory(models.Model):
    """Catégorie de ticket — modèle hiérarchique (arbre parent/enfants)."""
    _name = 'helpdesk.ticket.category'
    _description = 'Catégorie de ticket helpdesk'
    _order = 'sequence, name'
    _rec_name = 'name'
    _parent_name = 'parent_id'
    _parent_store = True

    _unique_name_parent = models.Constraint(
        'UNIQUE (name, parent_id)',
        "Le nom de la catégorie doit être unique au sein d'un même parent.",
    )

    name = fields.Char(string='Nom', required=True)
    sequence = fields.Integer(string='Séquence', default=10)
    color = fields.Integer(string='Couleur')

    parent_id = fields.Many2one(
        'helpdesk.ticket.category',
        string='Catégorie parente',
        ondelete='cascade',
        index=True,
    )
    parent_path = fields.Char(index=True)
    child_ids = fields.One2many(
        'helpdesk.ticket.category',
        'parent_id',
        string='Sous-catégories',
    )
    complete_name = fields.Char(
        string='Nom complet',
        compute='_compute_complete_name',
        store=True,
        recursive=True,
    )

    @api.depends('name', 'parent_id.complete_name')
    def _compute_complete_name(self):
        for category in self:
            if category.parent_id:
                category.complete_name = f"{category.parent_id.complete_name} / {category.name}"
            else:
                category.complete_name = category.name

    @api.constrains('parent_id')
    def _check_category_recursion(self):
        if not self._check_recursion():
            raise ValidationError(
                "Vous ne pouvez pas créer de catégories récursives."
            )

Requêtes ORM qui tirent parti de la hiérarchie

# Tous les descendants (directs + indirects) d'une catégorie
Category = self.env['helpdesk.ticket.category']
descendants = Category.search([('id', 'child_of', materiel.id)])

# Tous les ancêtres d'une catégorie
ancestors = Category.search([('id', 'parent_of', imprimante.id)])

# Seulement les racines
roots = Category.search([('parent_id', '=', False)])

# Tickets ouverts pour toute la branche "Matériel"
self.env['helpdesk.ticket'].search([
    ('category_id', 'child_of', materiel.id),
    ('state', '=', 'open'),
])