Skip to content

[16.0][ADD] web_diagram_builder: build interactive dependency diagrams from any many2one field#3539

Draft
mmaanneell wants to merge 22 commits into
OCA:16.0from
mmaanneell:16.0_add_web_diagram_builder
Draft

[16.0][ADD] web_diagram_builder: build interactive dependency diagrams from any many2one field#3539
mmaanneell wants to merge 22 commits into
OCA:16.0from
mmaanneell:16.0_add_web_diagram_builder

Conversation

@mmaanneell
Copy link
Copy Markdown

@mmaanneell mmaanneell commented May 8, 2026

Summary

  • Adds a new module web_diagram_builder that generates interactive hierarchy diagrams from any Odoo model with a recursive many2one field (e.g. parent_id)
  • Uses Cytoscape.js with dagre layout for automatic hierarchical rendering
  • Includes CSV import/export, path-finding between nodes (LCA algorithm), in-app tutorial, fr_CA translations, Python unit tests, and predefined templates
  • Migrates web_diagram renderer from Raphael.js to Cytoscape.js for Odoo 16

Related PR

Odoo 18 version: #3538

Test plan

  • Install web_diagram_builder on a fresh Odoo 16 database
  • Create a diagram using res.partner + parent_id
  • Click Generate Diagram and verify the Cytoscape layout renders correctly
  • Export PNG and verify the download
  • Use Find Path Between Two Nodes and verify shortest path is highlighted
  • Run Python unit tests: pytest addons/web_diagram_builder/tests/

🤖 Generated with Claude Code

mathben and others added 22 commits March 26, 2026 18:00
@mathben
[MIG] web_diagram: move from odoo
c20cb81 
- apply OCA script migration with OpenUpgrade
@mathben
[FIX] web_diagram: fix qunit test asset injection for Odoo 14
a7e0669 
In Odoo 14, the test bundle was renamed from web.qunit_suite to
web.qunit_suite_tests. The old xpath also referenced kanban_tests.js
which no longer exists at the expected path, causing an install
error. Use expr="." position="inside" for a stable injection.

Generated by Claude Code 2.1.84 model claude-sonnet-4-6

Co-Authored-By: Mathieu Benoit <mathben@technolibre.ca>
@mathben
[FIX] web_diagram: register diagram as valid ir.ui.view type
61d2ff2 
Odoo 14 validates the type field of ir.ui.view against a selection
list. Without extending the model to add ("diagram", "Diagram"),
installing any module with a diagram view raises:
"Wrong value for ir.ui.view.type: 'diagram'".
Follows the same pattern as OCA web_timeline.

Generated by Claude Code 2.1.84 model claude-sonnet-4-6

Co-Authored-By: Mathieu Benoit <mathben@technolibre.ca>
@mathben
[FIX] web_diagram: validate node/arrow fields against their own model
17855c2 
Odoo 14's view postprocessor validates all <field> elements against
the main diagram model via NameManager. Since <node> and <arrow>
each declare their own 'object' model, their child fields must be
validated against that model instead. Without this, installing any
module with a diagram view raises a field-not-found error on the
connector's source/destination fields.

Generated by Claude Code 2.1.84 model claude-sonnet-4-6

Co-Authored-By: Mathieu Benoit <mathben@technolibre.ca>
@mathben
[FIX] web_diagram: fix BasicView field processing for Odoo 14
1efee67 
BasicView._processNode traverses all <field> elements in the arch
and looks them up in fv.viewFields (the main model's fields). For
diagram views, <node> and <arrow> fields belong to their own object
models, causing field to be undefined and crashing _getFieldWidgetClass
at field.type. Stop traversal into those tags and guard field lookups
in init against undefined.

Generated by Claude Code 2.1.84 model claude-sonnet-4-6

Co-Authored-By: Mathieu Benoit <mathben@technolibre.ca>
@mathben
[FIX] web_diagram: restore graph_get removed in Odoo 14
b4557ea 
ir.ui.view.graph_get() was dropped from Odoo core when the diagram
view was removed in v14. The diagram controller still calls it to
compute node positions and transitions. Port the Odoo 13 implementation
into the module's own ir.ui.view override so the method is available.

Generated by Claude Code 2.1.84 model claude-sonnet-4-6

Co-Authored-By: Mathieu Benoit <mathben@technolibre.ca>
@mathben
[FIX] web_diagram: bundle graph layout class removed from odoo.tools
92480c0 
odoo.tools.graph was dropped in Odoo 14 along with the diagram view.
Port the Odoo 13 implementation into the module under tools/graph.py
and update the import to use the local copy.

Generated by Claude Code 2.1.84 model claude-sonnet-4-6

Co-Authored-By: Mathieu Benoit <mathben@technolibre.ca>
@mathben
[MIG] web_diagram: migrate asset declarations to Odoo 15
f571639 
Odoo 15 dropped the `qweb` manifest key and the XML template
inheritance pattern for assets. Assets must now be declared under
the `assets` key in __manifest__.py using named bundles
(web.assets_backend, web.assets_qweb, web.qunit_suite_tests).
Remove the now-obsolete views/web_diagram_templates.xml.

Generated by Claude Code 2.1.84 model claude-sonnet-4-6

Co-Authored-By: Mathieu Benoit <mathben@technolibre.ca>
@mathben
[FIX] web_diagram: adapt view postprocessing for Odoo 15
ba72df6 
In Odoo 15, NameManager.__init__ no longer accepts a validate flag,
postprocess() was removed in favour of a stack loop inside
_postprocess_view(), and check_view_fields() was renamed to check().
Replace the manual NameManager/postprocess pattern with a wrapper
element passed to _postprocess_view() against the node/arrow object
model, which handles the full processing pipeline correctly.

Generated by Claude Code 2.1.84 model claude-sonnet-4-6

Co-Authored-By: Mathieu Benoit <mathben@technolibre.ca>
@mathben
[FIX] web_diagram: javascript change parameter to get id object
e90dede
@mathben
[MIG] web_diagram: migrate JS and assets to Odoo 16
178654b 
The legacy web framework (BasicView, AbstractModel, AbstractController,
AbstractRenderer) was removed in Odoo 16. Rewrite all JS files as OWL
components and ES6 classes. Replace web.assets_qweb (dropped in v16)
by including the XML template directly in web.assets_backend. Replace
the deprecated name_get() call with display_name. Bump version to
16.0.1.0.0.

Generated by Claude Code 2.1.84 model claude-sonnet-4-6

Co-Authored-By: Mathieu Benoit <mathben@technolibre.ca>
@mathben
[ADD] web_diagram: add readme documentation
7738d57 
Provides developer and user reference for the diagram view module:
architecture overview, arch attribute reference, Odoo 16 migration
notes, view switcher limitation with recommended workaround, and
JSON-RPC endpoint signature.

Generated by Claude Code 2.1.85 model claude-sonnet-4-6

Co-Authored-By: Mathieu Benoit <mathben@technolibre.ca>
@mmaanneell
[ADD] web_diagram_builder: initial module
a25af16 
Recursive dependency diagram builder for any many2one field.
Includes node/link generation, template system, diagram and form views,
adapted for Odoo 16 (attrs= syntax, post_init_hook(cr, registry)).

Co-Authored-By: Manel Guechetouli <manelguechetouli@gmail.com>
Generated by Claude Code claude-sonnet-4-6
@mmaanneell
[ADD] web_diagram_builder: CSV import/export and node/link detail views
f969f6d 
Add CSV import with validation report and result models, plus dedicated
form and list views for nodes and links.

Co-Authored-By: Manel Guechetouli <manelguechetouli@gmail.com>
Generated by Claude Code claude-sonnet-4-6
@mmaanneell
[ADD] web_diagram_builder: French (fr_CA) translations
521f513 
Co-Authored-By: Manel Guechetouli <manelguechetouli@gmail.com>
Generated by Claude Code claude-sonnet-4-6
@mmaanneell
[ADD] web_diagram_builder: in-app tutorial (help wizard + Quick Guide…
ae2471b 
… menu)

Add step-by-step help wizard and cron-based Quick Guide data.
JS widget adapted for Odoo 16: owl="1" on template, class-only
registry.add (not {component: Class}).

Co-Authored-By: Manel Guechetouli <manelguechetouli@gmail.com>
Generated by Claude Code claude-sonnet-4-6
@mmaanneell
[ADD] web_diagram_builder: find path between two nodes
8ebc4ae 
Add wizard and BFS algorithm to find the shortest path between
any two nodes in the dependency graph.

Co-Authored-By: Manel Guechetouli <manelguechetouli@gmail.com>
Generated by Claude Code claude-sonnet-4-6
@mmaanneell
[ADD] web_diagram_builder: add Python unit tests
eae31ef 
Co-Authored-By: Manel Guechetouli <manelguechetouli@gmail.com>
Generated by Claude Code claude-sonnet-4-6
@mmaanneell
[MIG] web_diagram: migrate Cytoscape-based diagram view to Odoo 16
ed4c335 
Port Cytoscape.js renderer from Odoo 17. Key Odoo 16 adaptations:
- post_init_hook(cr, registry) signature instead of (env)
- rpc injected via useService("rpc") instead of bare jsonrpc import
- usePager hook replaces inline Pager slot in control panel
- layout-buttons slot instead of control-panel-create-button
- web.qunit_suite_tests instead of web.assets_unit_tests
- _validate_tag_label traverses parent nodes (node_info has no view_type)

Co-Authored-By: Manel Guechetouli <manelguechetouli@gmail.com>
Generated by Claude Code claude-sonnet-4-6
@mmaanneell
[ADD] web_diagram: add navigation help popup with bilingual support
5a29329 
Add web.diagram.nav.help transient model with bilingual HTML content
(fr/en), action and form view, and French translations in fr.po.

Co-Authored-By: Manel Guechetouli <manelguechetouli@gmail.com>
Generated by Claude Code claude-sonnet-4-6
@mmaanneell
[ADD] web_diagram: add Python unit tests for view validation
b77dc2f 
Co-Authored-By: Manel Guechetouli <manelguechetouli@gmail.com>
Generated by Claude Code claude-sonnet-4-6
@mmaanneell
[IMP] web_diagram_builder: OCA compliance metadata and readme
f87ca39 
Mise à jour des métadonnées : author OCA, website github.com/OCA/web,
development_status Beta, maintainers mmaanneell, version 16.0.1.0.0.
Ajout de pyproject.toml et des fragments readme/ (DESCRIPTION, USAGE, CONTRIBUTORS).

Co-Authored-By: Manel Guechetouli <manelguechetouli@gmail.com>
Generated by Claude Code claude-sonnet-4-6
@OCA-git-bot OCA-git-bot added series:16.0 mod:web_diagram_builder Module web_diagram_builder mod:web_diagram Module web_diagram labels May 8, 2026
This was referenced May 8, 2026
Open
Draft
@legalsylvain legalsylvain marked this pull request as draft May 9, 2026 13:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

mod:web_diagram_builder Module web_diagram_builder mod:web_diagram Module web_diagram series:16.0

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@mmaanneell @OCA-git-bot @mathben