Skip to Content

Cockpit

by ,
Odoo
v 19.0 Third Party
Download for v 19.0 Deploy on Odoo.sh
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Community Apps Dependencies
• Base
• Shell
Lines of code 9122
Technical Name praetorx_cockpit
LicenseLGPL-3
Websitehttps://praetorx.net
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Community Apps Dependencies
• Base
• Shell
Lines of code 9122
Technical Name praetorx_cockpit
LicenseLGPL-3
Websitehttps://praetorx.net

PraetorX Cockpit

Role-Based Tile Workspace with Real-Time Updates for Odoo 19

v19.0.1.0.1 Community Enterprise Odoo.sh 7 Tile Types Free

Give every team its own dashboard. PraetorX Cockpit delivers a configurable tile workspace where different roles see different live data — counters, queues, charts, action buttons, barcode scanners, work queues, and report tiles — all updated in real-time via Odoo’s bus system.

praetorx.net | Syntax & Sabotage

Workspace

Role-Based Dashboards

Assign tiles to roles via Many2many. Each role sees its own set of tiles. Tiles without a role assignment are visible to all users. Role filtering happens server-side.

Real-Time Updates

Tile data refreshes via Odoo’s built-in bus.bus longpolling. No Redis, no websockets, no external infrastructure. Uses the same channel as Odoo chat notifications.

Admin-Configurable

Create tiles from any Odoo model. Set domain filters, group-by fields, click actions, and JSON context directly in the backend — no code required.

Mobile Support

Per-tile show_mobile toggle and mobile_priority setting. Mobile breakpoint at 768px. Hide low-priority tiles on small screens.

PraetorX Shell Integration

Cockpit depends on PraetorX Shell. When installed, Cockpit becomes an available workspace within the branded Shell interface.

16 Default Tiles

Ships with ready-to-use tiles: contact counters, activity queues, country charts, quick-create actions, barcode scan, overdue crons, failed mails, system stats (DB size, active sessions, error log).

7 Tile Types

Counter

Single KPI metric — count of records matching a domain. Optional delta badge showing new records since last login.

Queue

Total count plus live preview of up to 5 recent records with name, state, and “new” badge. Click navigates to filtered list view.

Chart

Doughnut chart grouped by any field (Many2one or selection). Rendered with Chart.js. Clickable segments. Custom data via method_name.

Action

CTA button that opens a form view for quick record creation. Supports JSON context to pre-populate field values.

Scan

Inline text input for barcode or reference lookup. Submits on Enter, navigates to matching record. Works with USB/Bluetooth barcode scanners via HID input.

Workqueue

Prioritized item list with a claim button. Claimed items trigger a bus notification to update other connected clients. Default tiles: overdue crons, failed mails.

Report

Renders HTML content returned by a model method. Use for revenue summaries, operational KPIs, or custom tabular data.

Technical Reference

ComponentDetails
praetorx.cockpit.tileTile definition — name (translatable), technical_name (unique), tile_type, section, model_name, domain, method_name, chart_group_field, action_xmlid, action_context, icon, color, role_ids, show_mobile, mobile_priority, sequence
Controller4 JSON-RPC endpoints: /praetorx/cockpit/roles, /tiles, /data, /tile_action
Bus Channelpraetorx_cockpit/workqueue_update — pushes claim events with tile name, item ID, action, user
OWL ComponentsMain cockpit + 7 tile components (counter, queue, workqueue, chart, action, scan, report). Chart uses Chart.js.
System StatsBuilt-in methods: _count_active_sessions (bus.presence), _get_db_size_mb (pg_database_size), _count_errors_24h (ir.logging)

Use Cases

Warehouse Operations

Counter tiles for open pickings, a Workqueue for pick lists, and a Scan tile for product barcode lookup.

Finance & Accounting

Open invoice counter with delta badge, payment queue with 5-item preview, and a doughnut chart of invoice states.

IT Administration

Built-in system stat tiles: database size, error log count (24h), overdue crons, active sessions — all on one screen.

Sales & CRM

New lead counter, an Action tile for “Create Contact”, a Queue of today’s follow-up activities, and a Chart showing contacts by country.

Screenshots

Screenshots coming soon. Install the module to see the full experience.

Setup Guide

  • Odoo 19.0 (Community or Enterprise)
  • Python 3.10+
  • Required modules: bus, web
  • PraetorX modules: praetorx_base, praetorx_shell
  • No external Python dependencies

No Enterprise dependency. Works on Community, Enterprise, and Odoo.sh.

Install from the Odoo Apps menu. Search for “PraetorX Cockpit” or “Cockpit”.

Cockpit requires praetorx_base and praetorx_shell — these will be installed automatically as dependencies.

Navigate to PraetorX → Cockpit. Your tiles appear immediately. The 16 default tiles are pre-configured and visible to all users.

  1. Navigate to PraetorX → Configuration → Cockpit Tiles
  2. Click New, choose a tile type, set the target model and domain filter
  3. Optionally assign roles to control visibility
  4. Set icon (Font Awesome), color (hex), and sequence for ordering

Cockpit User: View tiles and tile data (read-only).

Cockpit Manager: Create, edit, and delete tiles. Manage tile configuration. Implies User. Admin assigned by default.

Set the Method Name field on a tile to any method on the target model. Counter, Chart, and Report tiles support custom methods that return structured data. This allows integration with any business logic in your custom modules.

FAQ

No. Works on Community, Enterprise, and Odoo.sh. Depends on bus, web (both in Community), praetorx_base, and praetorx_shell.
Yes. Enter the technical model name (e.g., sale.order, stock.picking) and a domain filter. The tile respects Odoo’s standard record rules and access rights.
Cockpit uses Odoo’s built-in bus.bus longpolling. No additional infrastructure required. Workqueue claim events push updates to all connected clients via the praetorx_cockpit/workqueue_update channel.
Cockpit does not have a hard dependency on PraetorX Roles. It depends on praetorx_base and praetorx_shell. However, role-based tile filtering uses praetorx.role records — if PraetorX Roles is installed, tiles can be assigned to specific roles. Without it, all tiles are visible to all users.
Yes. Set the Method Name field on a tile to any method on the target model. Counter, Chart, and Report tiles support custom methods that return structured data dictionaries.
Tile data is computed server-side only when the Cockpit view is open. Tile definitions load in a single query. Each tile’s data computation is isolated — errors in individual tiles are caught and logged without crashing the workspace.
Yes. The tile name field has translate=True, so tile labels can be translated per language via Odoo’s standard translation mechanism.

Release History

v19.0.1.0.1 — April 2026

Current Release

  • i18n: all source strings converted from German to English
  • German translations provided via i18n/de.po

v19.0.1.0.0 — March 2026

Initial Release

  • 7 tile types: Counter, Queue, Workqueue, Chart, Action, Scan, Report
  • Role-based tile visibility via Many2many assignment
  • Real-time updates via bus.bus longpolling
  • 16 default tiles including system stat tiles
  • Admin-configurable: model, domain, method, action, context, icon, color
  • Mobile support with per-tile visibility and priority
  • Chart.js integration for doughnut charts
  • Workqueue claim with bus notification to other clients
  • Barcode/text scan tile with Enter-key submission
  • Delta badges (new records since last login)
  • Translatable tile names
  • 20 automated tests

You May Also Like

PraetorX Shell Required

Branded backend theme with sidebar, home tiles, activity dashboard, and per-role color theming. Cockpit runs inside Shell.

Free
PraetorX Roles Recommended

Role-based user group management. Install to enable per-role tile visibility in Cockpit.

39 EUR
PraetorX Base Required

Shared security groups, menus, queue jobs, and technical patterns. Required dependency.

Free
MCP Security

Model Context Protocol security — API access control and audit logging.

79 EUR

Made with ♥ by Syntax & Sabotage

© 2026 Syntax & Sabotage, Lars Weiler. All rights reserved. LGPL-3.

Impressum · support@syntaxandsabotage.io

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.