A systematic troubleshooting method

From the user's report to the root cause: reproduce, classify, isolate, fix, verify and prevent.

In this lesson

Facts and reproduction
Classify and isolate
Fix the root cause, verify and prevent

Key points

Who/what/when/which record/expected/actual/exact error
Reproduce on staging with the same rights
Classify, then isolate: standard vs custom, company, record, date
Fix root cause; escalate with clean reproduction; verify; prevent

Real-world example

One salesperson couldn't see a customer others could. Comparing users showed she was missing the company in 'allowed companies'; the customer belonged to the second company. Adding it fixed the 'bug'; the consultant added company access to the onboarding checklist.

Questions and answers

How do you test whether a custom module causes an issue?

Reproduce on a staging copy with the module uninstalled or on a fresh database with standard Odoo.

Name three evidence sources.

Logs, chatter/metadata, SQL (also the browser console and network tab).

Read the full lesson, worked example and quiz