- ` |
+| Dynamic attributes | `attrs="{'invisible': [...]}"` | `invisible="..."` |
+| Delete validation | Override `unlink()` | `@api.ondelete(at_uninstall=False)` |
+| Field aggregation | `group_operator=` | `aggregator=` |
+| SQL queries | `cr.execute()` | `SQL` class with `execute_query_dict()` |
+
+---
+
+## Repository
+
+**URL**: `git@github.com:unclecatvn/agent-skills.git`
+**Branch**: `19.0`
+**License**: MIT
diff --git a/.agents/skills/odoo-19/CLAUDE.md b/.agents/skills/odoo-19/CLAUDE.md
new file mode 100644
index 00000000..3177c529
--- /dev/null
+++ b/.agents/skills/odoo-19/CLAUDE.md
@@ -0,0 +1,192 @@
+# Odoo 19 Development Guide
+
+This file provides guidance to AI agents when working with Odoo 19 code in this repository.
+
+> **For setup instructions with different AI IDEs, see [AGENTS.md](./AGENTS.md)**
+
+## Documentation Structure
+
+The `skills/odoo-19.0/references/` directory contains modular guides for Odoo 19 development:
+
+```
+skills/odoo-19.0/
+├── SKILL.md # Master index
+├── references/ # Development guides (18 files)
+│ ├── odoo-19-actions-guide.md # ir.actions.*, cron, bindings
+│ ├── odoo-19-controller-guide.md # HTTP, routing, controllers
+│ ├── odoo-19-data-guide.md # XML/CSV data files, records
+│ ├── odoo-19-decorator-guide.md # @api decorators
+│ ├── odoo-19-development-guide.md # Manifest, wizards (overview)
+│ ├── odoo-19-field-guide.md # Field types, parameters
+│ ├── odoo-19-manifest-guide.md # __manifest__.py reference
+│ ├── odoo-19-mixins-guide.md # mail.thread, activities, etc.
+│ ├── odoo-19-model-guide.md # ORM, CRUD, search, domain
+│ ├── odoo-19-migration-guide.md # Migration scripts, hooks
+│ ├── odoo-19-owl-guide.md # OWL components, services
+│ ├── odoo-19-performance-guide.md # N+1 prevention, optimization
+│ ├── odoo-19-reports-guide.md # QWeb reports, PDF/HTML
+│ ├── odoo-19-security-guide.md # ACL, record rules, security
+│ ├── odoo-19-testing-guide.md # Test classes, decorators
+│ ├── odoo-19-transaction-guide.md # Savepoints, errors
+│ ├── odoo-19-translation-guide.md # Translations, i18n
+│ └── odoo-19-view-guide.md # XML views, QWeb
+├── CLAUDE.md # This file
+└── AGENTS.md # AI agents setup
+```
+
+## Which Guide to Use
+
+| Task | Guide |
+| ------------------------------------- | ----------------------------------------- |
+| Creating actions, menus, cron jobs | `references/odoo-19-actions-guide.md` |
+| Creating a new module | `references/odoo-19-development-guide.md` |
+| Configuring **manifest**.py | `references/odoo-19-manifest-guide.md` |
+| Creating XML/CSV data files | `references/odoo-19-data-guide.md` |
+| Writing ORM queries/search | `references/odoo-19-model-guide.md` |
+| Defining model fields | `references/odoo-19-field-guide.md` |
+| Using @api decorators | `references/odoo-19-decorator-guide.md` |
+| Writing XML views | `references/odoo-19-view-guide.md` |
+| Fixing slow code/N+1 queries | `references/odoo-19-performance-guide.md` |
+| Handling database errors | `references/odoo-19-transaction-guide.md` |
+| Creating HTTP endpoints | `references/odoo-19-controller-guide.md` |
+| Building OWL components | `references/odoo-19-owl-guide.md` |
+| Upgrading modules/migrating data | `references/odoo-19-migration-guide.md` |
+| Using mail.thread, activities, mixins | `references/odoo-19-mixins-guide.md` |
+| Creating QWeb reports | `references/odoo-19-reports-guide.md` |
+| Configuring security (ACL, rules) | `references/odoo-19-security-guide.md` |
+| Writing tests | `references/odoo-19-testing-guide.md` |
+| Adding translations/localization | `references/odoo-19-translation-guide.md` |
+
+## Key Odoo 19 Changes
+
+| Change | Old (Odoo 17-) | New (Odoo 19) |
+| ------------------ | ------------------------------ | ------------------------------------------ |
+| List view tag | `
- ` |
+| Dynamic attributes | `attrs="{'invisible': [...]}"` | `invisible="..."` (direct) |
+| Delete validation | Override `unlink()` | `@api.ondelete(at_uninstall=False)` |
+| Field aggregation | `group_operator=` | `aggregator=` |
+| SQL queries | `cr.execute()` | `SQL` class with `execute_query_dict()` |
+| Batch create | Single dict | List of dicts (`create([{...}, {...}])`) |
+| SQL constraints | `_sql_constraints = [...]` | `models.Constraint(...)` |
+| DB indexes | `index=True` only | `models.Index(...)` declarative |
+| Kanban template | `t-name="kanban-box"` | `t-name="card"` |
+| QWeb output | `t-esc` | `t-out` (t-esc deprecated) |
+| Security groups | `category_id` on `res.groups` | `privilege_id` + `res.groups.privilege` |
+| Private methods | `_` prefix convention | `@api.private` decorator (enforced) |
+| Model naming | `_name = 'res.users'` required | CamelCase class → auto-derive `_name` |
+| read_group | `read_group()` | `_read_group()` / `formatted_read_group()` |
+
+## Critical Anti-Patterns
+
+| Anti-Pattern | Why Bad | Correct Approach |
+| -------------------------------------------------------------- | ---------------------------- | -------------------------------------------------- |
+| `attrs="{'invisible': [...]}"` | Deprecated in Odoo 18 | Use `invisible="..."` direct attribute |
+| `@api.depends('partner_id')` then accessing `partner_id.email` | N queries per record | Add `@api.depends('partner_id.email')` |
+| `search()` inside loop | N+1 queries | Use `search()` with `IN` domain or `_read_group()` |
+| `create()` in loop | N INSERT statements | Batch: `create([{...}, {...}])` |
+| Overriding `unlink()` for validation | Breaks module uninstall | Use `@api.ondelete(at_uninstall=False)` |
+| Using `
- ` instead |
+| Using `_sql_constraints` | **Not supported in Odoo 19** | Use `models.Constraint(...)` |
+| Using `t-esc` in templates | Deprecated directive | Use `t-out` instead |
+| Using `category_id` in `res.groups` | Removed in Odoo 19 | Use `privilege_id` + `res.groups.privilege` |
+| Using `read_group()` | Deprecated | Use `_read_group()` or `formatted_read_group()` |
+
+## @api Decorator Decision Tree
+
+```
+Need to define field behavior?
+├── Field computed from other fields → @api.depends
+│ └── CAN use dotted paths: `@api.depends('partner_id.email')`
+├── Validate data → @api.constrains
+│ └── CANNOT use dotted paths: only simple field names
+├── Prevent record deletion → @api.ondelete (Odoo 18+)
+└── Update form UI → @api.onchange
+ └── NO CRUD operations allowed
+
+Need to define method behavior?
+├── Method-level, doesn't depend on self → @api.model
+├── Mark method as non-RPC callable → @api.private
+└── Normal record method → no decorator needed
+```
+
+## Common Patterns Reference
+
+### N+1 Query Prevention
+
+```python
+# BAD: search in loop
+for order in orders:
+ payments = self.env['payment'].search([('order_id', '=', order.id)])
+
+# GOOD: single query
+payments = self.env['payment'].search_read([('order_id', 'in', orders.ids)])
+```
+
+### List View (Odoo 19)
+
+```xml
+
-
+
Hello
" + +# JSON response +@http.route('/json', auth='public', type='json') +def json_response(self): + return {'key': 'value'} +``` + +### Redirect + +```python +from odoo.http import redirect + +@http.route('/old-url', auth='public') +def old_url(self): + return redirect('/new-url') +``` + +### File Response + +```python +@http.route('/download', auth='user') +def download_file(self): + file_content = b'file data' + headers = [ + ('Content-Type', 'application/pdf'), + ('Content-Disposition', 'attachment; filename="file.pdf"'), + ] + return request.make_response( + file_content, + headers + ) +``` + +--- + +## JSON-RPC + +### JSON Controller + +```python +@http.route('/api/search', auth='user', type='json', methods=['POST']) +def json_search(self, model, domain, fields=None): + Model = http.request.env[model] + records = Model.search(domain) + if fields: + records = records.read(fields) + else: + records = records.read() + return {'result': records} +``` + +### Call from JavaScript + +```javascript +rpc("/api/search", { + model: "res.partner", + domain: [["is_company", "=", true]], + fields: ["name", "email"], +}).then(function (result) { + console.log(result); +}); +``` + +--- + +## Website Routes + +### Website Page + +```python +class WebsiteController(http.Controller): + @http.route('/my-page', auth='public', website=True) + def my_page(self): + return http.request.render('my_module.my_page_template', { + 'title': 'My Page', + }) +``` + +### Template + +```xml + +
+
+
+
+
+ Hello
+
+ My Content
+-
+
+ Create your first my.model! +
+- ` instead of `
- ` instead of `
-
+
- `
+- [ ] Replace `attrs` with direct attributes
+- [ ] Replace `unlink()` override with `@api.ondelete`
+- [ ] Update field aggregators
+- [ ] Update SQL queries to use `odoo.tools.SQL`
+- [ ] Run migration scripts
+- [ ] Test all functionality
+- [ ] Update documentation
+
+---
+
+## Testing Migrations
+
+### Test Migration Script
+
+```python
+from odoo.tests import TransactionCase
+
+class TestMigration(TransactionCase):
+ def test_migration(self):
+ # Test migration script
+ pass
+```
+
+### Manual Testing
+
+1. Install previous version with sample data
+2. Update to Odoo 19
+3. Verify all data migrated correctly
+4. Test all features
+
+---
+
+## References
+
+- Odoo 19 changelog
+- Odoo 18 changelog
diff --git a/.agents/skills/odoo-19/references/odoo-19-mixins-guide.md b/.agents/skills/odoo-19/references/odoo-19-mixins-guide.md
new file mode 100644
index 00000000..56ea7d4a
--- /dev/null
+++ b/.agents/skills/odoo-19/references/odoo-19-mixins-guide.md
@@ -0,0 +1,384 @@
+# Odoo 19 Mixins Guide
+
+Guide for using Odoo 19 mixins: mail.thread, activities, email aliases, and other useful mixins.
+
+## Table of Contents
+- [Messaging Features](#messaging-features)
+- [Activities](#activities)
+- [Email Aliases](#email-aliases)
+- [UTM Mixin](#utm-mixin)
+- [Website Mixins](#website-mixins)
+- [Rating Mixin](#rating-mixin)
+
+---
+
+## Messaging Features
+
+### Basic Messaging Integration
+
+Add `mail.thread` mixin to your model:
+
+```python
+class BusinessTrip(models.Model):
+ _name = 'business.trip'
+ _inherit = ['mail.thread']
+ _description = 'Business Trip'
+
+ name = fields.Char()
+ partner_id = fields.Many2one('res.partner', 'Responsible')
+ guest_ids = fields.Many2many('res.partner', 'Participants')
+```
+
+Add chatter to form view:
+
+```xml
+
+```
+
+### Chatter Options
+
+| Option | Description |
+|--------|-------------|
+| `open_attachments` | Shows attachment section expanded |
+| `reload_on_attachment` | Reload form on attachment change |
+| `reload_on_follower` | Reload form on follower update |
+| `reload_on_post` | Reload form on message post |
+
+---
+
+### Posting Messages
+
+#### message_post
+
+Post a new message in an existing thread:
+
+```python
+record.message_post(
+ body='This is a message',
+ subject='Subject',
+ message_type='notification',
+ subtype_xmlid='mail.mt_comment',
+)
+```
+
+**Parameters**:
+- `body` (str | Markup): Message body (escaped if str, use Markup for HTML)
+- `subject` (str): Message subject
+- `message_type` (str): `notification`, `comment`, `email`
+- `subtype` (str/xmlid): Message subtype
+- `parent_id` (int): Reply to message
+- `attachments` (list): List of `(name, content)` tuples
+- `**kwargs`: Extra mail.message field values
+
+#### message_post_with_view
+
+Send message using a QWeb template:
+
+```python
+record.message_post_with_view(
+ 'my_module.my_template',
+ additional_context={'val': value},
+)
+```
+
+#### message_post_with_template
+
+Send message using an email template:
+
+```python
+record.message_post_with_template(
+ template_id,
+ composition_mode='comment',
+)
+```
+
+---
+
+### Receiving Messages
+
+#### message_new
+
+Called when new email arrives for an alias:
+
+```python
+def message_new(self, msg_dict, custom_values=None):
+ # Extract data from email
+ name = msg_dict.get('subject', 'New')
+ # Create record
+ return super().message_new(msg_dict, {
+ 'name': name,
+ **(custom_values or {}),
+ })
+```
+
+#### message_update
+
+Called when email reply arrives:
+
+```python
+def message_update(self, msg_dict, update_vals=None):
+ # Update record from email
+ return super().message_update(msg_dict, {
+ 'description': msg_dict.get('body'),
+ **(update_vals or {}),
+ })
+```
+
+---
+
+### Followers Management
+
+#### message_subscribe
+
+Add partners/channels as followers:
+
+```python
+# Subscribe partners
+record.message_subscribe(partner_ids=[pid1, pid2])
+
+# Subscribe channels
+record.message_subscribe(channel_ids=[cid1])
+
+# With specific subtypes
+record.message_subscribe(
+ partner_ids=[pid1],
+ subtype_ids=[subtype_id],
+)
+```
+
+#### message_unsubscribe
+
+Remove followers:
+
+```python
+# Unsubscribe partners
+record.message_unsubscribe(partner_ids=[pid1, pid2])
+
+# Unsubscribe current user
+record.message_unsubscribe_users()
+```
+
+---
+
+### Logging Changes (Tracking)
+
+Enable field tracking in `mail.thread`:
+
+```python
+class MyModel(models.Model):
+ _name = 'my.model'
+ _inherit = ['mail.thread']
+
+ name = fields.Char(tracking=True)
+ state = fields.Selection([
+ ('draft', 'Draft'),
+ ('done', 'Done'),
+ ], tracking=True)
+
+ # Track changes in relational field
+ partner_id = fields.Many2one('res.partner', tracking=1)
+```
+
+Track changes in specific subfields:
+
+```python
+# Track all partner_id subfields
+partner_id = fields.Many2one('res.partner', tracking=True)
+
+# Track only name
+partner_id = fields.Many2one('res.partner', tracking='name')
+```
+
+---
+
+## Activities
+
+### mail.activity.mixin
+
+Add activity support:
+
+```python
+class MyModel(models.Model):
+ _name = 'my.model'
+ _inherit = ['mail.activity.mixin']
+
+ name = fields.Char()
+```
+
+### Activity Methods
+
+```python
+# Schedule activity
+record.activity_schedule(
+ 'mail.mail_activity_data_todo',
+ user_id=user.id,
+ summary='Review this',
+)
+
+# Mark as done
+activities = record.activity_ids
+activities.action_done()
+
+# Feedback
+activities.action_feedback(feedback='Completed')
+```
+
+---
+
+## Email Aliases
+
+### mail.alias.mixin
+
+Add email alias support:
+
+```python
+class MyModel(models.Model):
+ _name = 'my.model'
+ _inherit = ['mail.alias.mixin', 'mail.thread']
+
+ name = fields.Char()
+ alias_id = fields.Many2one(
+ 'mail.alias',
+ string='Alias',
+ ondelete="cascade",
+ required=True,
+ )
+
+ def get_alias_model_name(self, vals):
+ return self._name
+
+ def get_alias_values(self):
+ values = super().get_alias_values()
+ values.update({
+ 'alias_defaults': 'name',
+ })
+ return values
+```
+
+Create alias in data file:
+
+```xml
+
+
+
+
+
+
+
+
+
+Visible when true
+Visible when false
+```
+
+---
+
+## Translations
+
+### Translate in JavaScript
+
+```javascript
+import { _t } from "@web/core/l10n/translation";
+
+this.message = _t("Hello World");
+```
+
+### Translate with Parameters
+
+```javascript
+this.message = _t("Hello %(name)s", { name: "John" });
+```
+
+### Translate in Template
+
+```xml
+
+```
+
+---
+
+## Examples
+
+### Counter Component
+
+```javascript
+import { Component, useState } from "@odoo/owl";
+import { _t } from "@web/core/l10n/translation";
+
+export class Counter extends Component {
+ static template = "my_module.Counter";
+
+ setup() {
+ this.state = useState({ count: 0 });
+ }
+
+ increment() {
+ this.state.count++;
+ }
+
+ decrement() {
+ this.state.count--;
+ }
+}
+```
+
+```xml
+
+
+
+
+
+
+
+ Invoice
+Customer:
+Total:
+
+
+
+
+
+ My Report
+Total:
+
+
+
+
+
+ Invoice address:
+
+
+
+ ![Barcode]()
+
+```
+
+---
+
+## QWeb Tips
+
+### Directives
+
+| Directive | Description |
+| ----------- | ----------------------------------------------------- |
+| `t-out` | Escape and output value (replaces deprecated `t-esc`) |
+| `t-field` | Output field value (formatted) |
+| `t-if` | Conditional display |
+| `t-elif` | Else if condition |
+| `t-else` | Else condition |
+| `t-foreach` | Loop over collection |
+| `t-as` | Variable name for foreach |
+| `t-set` | Set variable |
+| `t-call` | Call another template |
+| `t-lang` | Set language for template |
+
+### t-field Options
+
+```xml
+
+
+
+```
+
+---
+
+## References
+
+- Source: Odoo 19 documentation `/doc/developer/reference/backend/reports.rst`
diff --git a/.agents/skills/odoo-19/references/odoo-19-security-guide.md b/.agents/skills/odoo-19/references/odoo-19-security-guide.md
new file mode 100644
index 00000000..9d3e006f
--- /dev/null
+++ b/.agents/skills/odoo-19/references/odoo-19-security-guide.md
@@ -0,0 +1,381 @@
+# Odoo 19 Security Guide
+
+Guide for Odoo 19 security: access rights, record rules, field permissions, and security pitfalls.
+
+## Table of Contents
+
+- [Security Overview](#security-overview)
+- [Groups](#groups)
+- [Access Rights (ACL)](#access-rights-acl)
+- [Record Rules](#record-rules)
+- [Field Access](#field-access)
+- [Security Pitfalls](#security-pitfalls)
+
+---
+
+## Security Overview
+
+Odoo provides two main data-driven mechanisms to manage access:
+
+1. **Access Rights (ACL)** - Grants access to an entire model for operations
+2. **Record Rules** - Conditions that must be satisfied for operations
+
+Both are linked to users through **groups**.
+
+---
+
+## Groups
+
+`res.groups` - Users belong to groups, security mechanisms are associated to groups.
+
+> **Odoo 19 Breaking Change**: `category_id` has been **removed** from `res.groups`. Replaced by a new **privilege-based system** using `res.groups.privilege`.
+
+### Key Attributes
+
+| Attribute | Description |
+| -------------- | ------------------------------------------------------------------------- |
+| `name` | User-readable identification (role/purpose) |
+| `privilege_id` | **Odoo 19**: Reference to `res.groups.privilege` (replaces `category_id`) |
+| `implied_ids` | Other groups to set on the user alongside this one |
+| `comment` | Additional notes |
+
+### 3-Tier Security Architecture (Odoo 19)
+
+```
+ir.module.category → res.groups.privilege → res.groups → res.users
+```
+
+### Example
+
+```xml
+
+Product:
+
+
+```
+
+#### Good XML
+
+```xml
+
+
+```
+
+### Escaping vs Sanitizing
+
+**Escaping** (always mandatory) converts TEXT to CODE.
+
+```python
+from markupsafe import Markup
+
+# data is TEXT
+code = html_escape(data) # Convert to CODE
+self.website_description = Markup("%s") % code
+```
+
+**Sanitizing** converts CODE to SAFER CODE (but not necessarily safe).
+
+```python
+from odoo.tools import html_sanitize
+
+code = Markup("Important
") +html_sanitize(code, strip_classes=True) # => Markup('Important
') +``` + +### Evaluating Content + +Avoid `eval()` - use `ast.literal_eval()` for parsing. + +```python +# BAD: very bad +domain = eval(self.filter_domain) + +# BETTER: still not recommended +from odoo.tools import safe_eval +domain = safe_eval(self.filter_domain) + +# GOOD: use literal_eval +from ast import literal_eval +domain = literal_eval(self.filter_domain) +``` + +### Accessing Object Attributes + +Use `__getitem__` instead of `getattr()` for dynamic field access. + +```python +# BAD: unsafe, can access any attribute +def _get_state_value(self, res_id, state_field): + record = self.sudo().browse(res_id) + return getattr(record, state_field, False) + +# GOOD: safer +def _get_state_value(self, res_id, state_field): + record = self.sudo().browse(res_id) + return record[state_field] +``` + +--- + +## References + +- Source: Odoo 19 documentation `/doc/developer/reference/backend/security.rst` diff --git a/.agents/skills/odoo-19/references/odoo-19-testing-guide.md b/.agents/skills/odoo-19/references/odoo-19-testing-guide.md new file mode 100644 index 00000000..6aa47494 --- /dev/null +++ b/.agents/skills/odoo-19/references/odoo-19-testing-guide.md @@ -0,0 +1,481 @@ +# Odoo 19 Testing Guide + +Guide for testing Odoo 19: Python unit tests, JS tests, and tours (integration tests). + +## Table of Contents +- [Test Types](#test-types) +- [Python Tests](#python-tests) +- [Test Classes](#test-classes) +- [Test Decorators](#test-decorators) +- [Test Selection](#test-selection) +- [JS Tests](#js-tests) +- [Integration Tests (Tours)](#integration-tests-tours) +- [Performance Testing](#performance-testing) + +--- + +## Test Types + +Odoo has three kinds of tests: + +| Type | Purpose | +|------|---------| +| **Python unit tests** | Test model business logic | +| **JS unit tests** | Test JavaScript code in isolation | +| **Tours** | Integration testing (Python + JS together) | + +--- + +## Python Tests + +### Test Structure + +Create a `tests` sub-package in your module: + +``` +your_module/ +├── ... +├── tests/ +│ ├── __init__.py +│ ├── test_bar.py +│ └── test_foo.py +``` + +**Important**: Import test modules from `tests/__init__.py` + +```python +# tests/__init__.py +from . import test_foo, test_bar +``` + +### Test Methods + +Test methods must start with `test_`: + +```python +class TestModelA(TransactionCase): + def test_some_action(self): + record = self.env['model.a'].create({'field': 'value'}) + record.some_action() + self.assertEqual(record.field, expected_value) +``` + +--- + +## Test Classes + +### TransactionCase + +Most common test class. Each test runs in its own transaction, rolled back at the end. + +```python +from odoo.tests import TransactionCase + +class TestMyModel(TransactionCase): + def test_create_record(self): + record = self.env['my.model'].create({'name': 'Test'}) + self.assertTrue(record.id) + self.assertEqual(record.name, 'Test') +``` + +### SingleTransactionCase + +Runs all tests in a single transaction (not rolled back). Faster, but tests can affect each other. + +```python +from odoo.tests import SingleTransactionCase + +class TestMyModel(SingleTransactionCase): + def test_1_first(self): + # Creates data + pass + + def test_2_second(self): + # Can use data from test_1_first + pass +``` + +### HttpCase + +For web-related tests. Starts a browser (headless Chrome by default). + +```python +from odoo.tests import HttpCase + +class TestWebsite(HttpCase): + def test_homepage(self): + self.url_open('/hello') +``` + +--- + +## Test Decorators + +### tagged + +Add or remove tags from test classes. + +```python +from odoo.tests import TransactionCase, tagged + +@tagged('-standard', 'nice') +class NiceTest(TransactionCase): + pass +``` + +### Default Tags + +- `standard` - Default tag (selected by `--test-tags`) +- `at_install` - Run after module installation (default) +- `post_install` - Run after all modules installed + +```python +@tagged('-at_install', 'post_install') +class WebsiteVisitorTests(HttpCase): + def test_create_visitor(self): + pass +``` + +--- + +## Test Selection + +### By Tag + +```bash +# Run only nice tests +odoo-bin --test-tags nice + +# Run nice and standard tests +odoo-bin --test-tags nice,standard + +# Run standard except slow +odoo-bin --test-tags standard,-slow +``` + +### By Module + +```bash +# Run only sale module tests +odoo-bin --test-tags /sale + +# Run sale module but not slow tests +odoo-bin --test-tags '/sale,-slow' + +# Run stock or slow tests +odoo-bin --test-tags '-standard, slow, /stock' +``` + +### By Specific Test + +```bash +# Run specific test function +odoo-bin --test-tags .test_supplier_invoice + +# Equivalent (full path) +odoo-bin --test-tags /account:TestAccount.test_supplier_invoice +``` + +### Tag Format + +``` +[-][tag][/module][:class][.method] +``` + +| Prefix | Meaning | +|--------|---------| +| `-` | Deselect/remove tag | +| `+` | Select/add tag (implicit, optional) | +| `/module` | Specific module | +| `:class` | Specific class | +| `.method` | Specific method | + +--- + +## Test Utilities + +### browse_ref + +Browse an external ID: + +```python +record = self.browse_ref('base.user_admin') +self.assertEqual(record.login, 'admin') +``` + +### ref + +Get database ID from external ID: + +```python +user_id = self.ref('base.user_admin') +``` + +### Form + +Helper for testing form views: + +```python +from odoo.tests import Form + +with Form(self.env['sale.order']) as form: + form.partner_id = self.partner + form.date_order = '2023-01-01' + with form.order_line.new() as line: + line.product_id = self.product + line.product_uom_qty = 10 + +order = form.save() +``` + +--- + +## JS Tests + +Odoo uses Hoot for JS unit testing. See the frontend testing documentation. + +Test files go in `static/tests/`: + +``` +your_module/ +└── static/ + └── tests/ + └── my_test.js +``` + +```javascript +import { start } from '@mail/utils/test_utils'; + +QUnit.module('My Module', { + beforeEach() { + this.data = { + records: { + 'my.model': [{id: 1, name: 'Test'}], + }, + }; + }, +}, function () { + QUnit.test('my test', async function (assert) { + // Test code here + }); +}); +``` + +--- + +## Integration Tests (Tours) + +Tours simulate real user scenarios in the browser. + +### Tour Structure + +``` +your_module/ +├── static/ +│ └── tests/ +│ └── tours/ +│ └── my_tour.js +├── tests/ +│ ├── __init__.py +│ └── test_my_tour.py +└── __manifest__.py +``` + +### Register Tour (JavaScript) + +```javascript +import tour from 'web_tour.tour'; + +tour.register('my_tour', { + url: '/web', +}, [ + // Step 1: Show apps menu + tour.stepUtils.showAppsMenuItem(), + // Step 2: Click on app + { + trigger: '.o_app[data-menu-xmlid="my_module.menu_root"]', + run: "click", + }, + // Step 3: Fill form + { + trigger: 'input[name="name"]', + run: "text", + }, + // Step 4: Verify + { + trigger: '.o_data_row:first', + run: function () { + // Assertions here + }, + }, +]); +``` + +### Add to Manifest + +```python +'assets': { + 'web.assets_tests': [ + 'your_module/static/tests/tours/my_tour.js', + ], +}, +``` + +### Start Tour (Python) + +```python +from odoo.tests import HttpCase + +class TestMyTour(HttpCase): + def test_my_tour(self): + self.start_tour("/web", "my_tour", login="admin") +``` + +### Tour Step Options + +| Option | Description | +|--------|-------------| +| `trigger` | Selector/element to run action on | +| `run` | Action to perform (see helpers below) | +| `isActive` | Array of conditions (mobile, enterprise, auto/manual) | +| `content` | Tooltip content | +| `tooltipPosition` | `top`, `right`, `bottom`, or `left` | +| `timeout` | Wait time in ms (default: 10000) | + +### Run Actions + +| Action | Description | +|--------|-------------| +| `click` | Clicks the element | +| `dblclick` | Double-clicks the element | +| `drag_and_drop {target}` | Drags to target | +| `edit {content}` | Clears and fills | +| `editor {content}` | WYSIWYG editor fill | +| `fill {content}` | Fills the element | +| `hover` | Hovers over element | +| `press {content}` | Keyboard input | +| `range {content}` | Range slider value | +| `select {value}` | Select by value | +| `selectByIndex {index}` | Select by index | +| `selectByLabel {label}` | Select by label | +| `check` | Checks checkbox | +| `uncheck` | Unchecks checkbox | +| `clear` | Clears input | + +### Run Tour from Browser + +```javascript +odoo.startTour("tour_name"); +``` + +Or use `?debug=tests` URL parameter. + +### Debug Tours + +```python +# Watch mode (opens Chrome window) +self.start_tour("/web", "my_tour", watch=True) + +# Debug mode (opens devtools) +self.start_tour("/web", "my_tour", debug=True) +``` + +### Onboarding Tours + +Onboarding tours are interactive guides for users. + +Create `web_tour.tour` record: + +```xml +Hello World
+ +``` + +### Translate in Code + +```xml + +
+
+
+```
+
+---
+
+## Translated Fields
+
+### Define Translated Field
+
+```python
+name = fields.Char(translate=True)
+description = fields.Text(translate=True)
+```
+
+### Translation Options
+
+```python
+# Enable translation
+name = fields.Char(translate=True)
+
+# Translation with context (Odoo 19+)
+notes = fields.Text(translate=True, translation_modifiable=True)
+```
+
+### Read Translated Field
+
+```python
+# Record is fetched in user's language
+record = self.env['my.model'].browse(record_id)
+print(record.name) # Translated name
+```
+
+### Read in Specific Language
+
+```python
+# Read in French
+record_fr = record.with_context(lang='fr_FR')
+print(record_fr.name) # French name
+```
+
+---
+
+## Export/Import
+
+### Export Translations
+
+**Via CLI**:
+
+```bash
+odoo-bin -d mydb -l fr --i18n-export=fr --stop-after-init
+```
+
+**Via UI**:
+
+1. Settings → Translations → Export Translations
+2. Select language
+3. Choose file format (PO)
+4. Export
+
+### Import Translations
+
+**Via CLI**:
+
+```bash
+odoo-bin -d mydb -l fr --i18n-import=/path/to/fr.po --stop-after-init
+```
+
+**Via UI**:
+
+1. Settings → Translations → Import Translations
+2. Select language
+3. Upload PO file
+4. Import
+
+### Update Translations
+
+**Via CLI**:
+
+```bash
+odoo-bin -d mydb -l fr --i18n-overwrite --stop-after-init
+```
+
+---
+
+## Languages
+
+### Install Language
+
+```python
+# Load language
+language = self.env['res.lang'].load_lang(self.env.cr, self._uid, 'fr_FR')
+```
+
+### Available Languages
+
+```python
+languages = self.env['res.lang'].search([])
+for lang in languages:
+ print(lang.code, lang.name)
+```
+
+### Get User Language
+
+```python
+user_lang = self.env.user.lang
+context_lang = self.env.context.get('lang', 'en_US')
+```
+
+---
+
+## Translation Best Practices
+
+### Always Use Translation Functions
+
+```python
+# GOOD
+message = _("Hello World")
+
+# BAD
+message = "Hello World"
+```
+
+### Use Parameters for Dynamic Content
+
+```python
+# GOOD
+message = _("Hello %(name)s") % {'name': name}
+
+# BAD
+message = _("Hello ") + name
+```
+
+### Provide Context When Needed
+
+```python
+# GOOD (with context)
+message = _("Cancel", default_code="refund_cancel")
+
+# BAD (ambiguous)
+message = _("Cancel")
+```
+
+### Don't Concatenate Translations
+
+```python
+# BAD
+message = _("Hello ") + name + _("!")
+
+# GOOD
+message = _("Hello %(name)s!") % {'name': name}
+```
+
+---
+
+## Common Translation Terms
+
+| English | French | German | Spanish |
+| ------- | ----------- | ---------- | -------- |
+| Save | Enregistrer | Speichern | Guardar |
+| Cancel | Annuler | Abbrechen | Cancelar |
+| Delete | Supprimer | Löschen | Eliminar |
+| Edit | Modifier | Bearbeiten | Editar |
+| Create | Créer | Erstellen | Crear |
+| Search | Rechercher | Suchen | Buscar |
+
+---
+
+## References
+
+- Odoo 19 translation documentation
+- GNU gettext documentation
diff --git a/.agents/skills/odoo-19/references/odoo-19-view-guide.md b/.agents/skills/odoo-19/references/odoo-19-view-guide.md
new file mode 100644
index 00000000..9e44aaaa
--- /dev/null
+++ b/.agents/skills/odoo-19/references/odoo-19-view-guide.md
@@ -0,0 +1,454 @@
+# Odoo 19 View Guide
+
+Guide for creating views in Odoo 19: list, form, search, kanban, calendar, graph, pivot, and QWeb templates.
+
+## Table of Contents
+
+- [View Types](#view-types)
+- [List Views](#list-views)
+- [Form Views](#form-views)
+- [Search Views](#search-views)
+- [Kanban Views](#kanban-views)
+- [Calendar Views](#calendar-views)
+- [Graph Views](#graph-views)
+- [Pivot Views](#pivot-views)
+- [View Inheritance](#view-inheritance)
+- [QWeb Templates](#qweb-templates)
+
+---
+
+## View Types
+
+| Type | Tag | Description |
+| -------- | ------------ | ------------------------------ |
+| List | `This content is translatable
+- ` | Table view (formerly `