## Core Principles for Odoo Development Focus on modular, readable code using Odoo's ORM, API tools, and view inheritance. Adhere to PEP 8 standards and Odoo's conventions for sustainable enterprise apps. Separate concerns across models, views, controllers, data files, and security. ## Building Odoo Models Inherit from `models.Model` and apply decorators like `@api.model` or `@api.depends` for efficient data handling. ```python from odoo import models, fields, api class SaleOrder(models.Model): _inherit = 'sale.order' custom_field = fields.Char(string='Custom Note') @api.depends('order_line.price_total') def _compute_total_discount(self): for record in self: record.total_discount = sum(line.discount for line in record.order_line) ``` ## Customizing Views with XML Extend existing views using `` for minimal changes and better maintainability. ```xml sale.order.form.inherit sale.order ``` ## Developing Web Controllers Use `@http.route` for API endpoints with JSON responses and input validation. ```python from odoo import http import json class CustomController(http.Controller): @http.route('/api/custom/data', type='json', auth='public', methods=['POST']) def get_custom_data(self, **kwargs): try: data = http.request.jsonrequest # Process data return {'status': 'success', 'data': data} except Exception as e: return {'status': 'error', 'message': str(e)} ``` ## Error Handling and Validation Raise `ValidationError` for user feedback, use `@api.constrains` for integrity checks, and log issues. ```python from odoo.exceptions import ValidationError import logging _logger = logging.getLogger(__name__) @api.constrains('custom_field') def _check_custom_field(self): for rec in self: if len(rec.custom_field) < 5: raise ValidationError('Field must be at least 5 characters.') # In methods: try: # logic except Exception as e: _logger.error('Error: %s', e) raise UserError('Operation failed.') ``` ## Security and Access Control Define groups and rules in XML for robust permissions. ```xml id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink access_custom_sale,sale.order.custom,model_sale_order,base.group_user,1,1,1,0 ``` ## Performance Tips Apply domains, contexts, and computed fields to minimize queries. Use cron for heavy tasks. ```python # Efficient search orders = self.env['sale.order'].search([('state', '=', 'draft')], limit=100) # Cron example class CronModel(models.Model): _inherit = 'ir.cron' @api.model def _run_heavy_task(self): # Background processing pass ``` ## Module Structure Organize with `__manifest__.py`, `models/`, `views/`, `controllers/`, `data/`, and `security/` folders. Enable i18n with `_()` and test thoroughly.

Rules

Python Odoo Cursor Rules: Best Practices for Models, Views, Controllers & Enterprise Development