Odoo 19 modül geliştirme: yapı, kod örnekleri ve sessiz hatalar.

Klasör ağacı

Python tarafı models/, ekranlar views/, erişim hakları security/ altında durur. İç içe ikinci bir modül klasörü açılmaz; manifest doğrudan modül kökündedir.

servis_talep/
├── __init__.py              from . import models
├── __manifest__.py          modülün kimliği ve dosya listesi
├── models/
│   ├── __init__.py          from . import servis_talep, res_partner
│   ├── servis_talep.py      yeni model
│   └── res_partner.py       mevcut modeli genişletme (_inherit)
├── views/
│   ├── servis_talep_views.xml   list, form, arama, action
│   └── menus.xml                menüler
└── security/
    └── ir.model.access.csv  kim okur, kim yazar

__manifest__.py

Modülün adı, sürümü, hangi modüllere bağlı olduğu ve hangi veri dosyalarını yükleyeceği burada yazar. data listesinde olmayan bir XML dosyasını Odoo hiç okumaz ve hata da vermez.

# __manifest__.py
{
    'name': 'Servis Talepleri',
    'author': 'NaviCore',
    'version': '19.0.1.0.0',
    'category': 'Services',
    'summary': 'Müşteri servis taleplerinin takibi',
    'depends': ['base', 'mail'],
    # Sıra önemli: önce güvenlik, sonra view'lar, en son menüler
    'data': [
        'security/ir.model.access.csv',
        'views/servis_talep_views.xml',
        'views/menus.xml',
    ],
    'application': True,
    'license': 'Other proprietary',
}

1. Model: alanlar, hesaplama ve kurallar

Model, veritabanında bir tablo demektir: servis.talep adı servis_talep tablosuna dönüşür. @api.depends hesaplamanın neye bağlı olduğunu, @api.constrains kayıt yazılırken denetlenecek kuralı söyler.

# models/servis_talep.py
from odoo import api, fields, models
from odoo.exceptions import ValidationError


class ServisTalep(models.Model):
    _name = 'servis.talep'
    _description = 'Servis Talebi'
    _inherit = ['mail.thread']          # değişiklik geçmişi ve mesajlaşma
    _order = 'tarih desc, id desc'

    name = fields.Char(string='Konu', required=True, tracking=True)
    partner_id = fields.Many2one('res.partner', string='Müşteri', required=True)
    tarih = fields.Date(string='Tarih', default=fields.Date.context_today)
    state = fields.Selection([
        ('yeni', 'Yeni'),
        ('islemde', 'İşlemde'),
        ('bitti', 'Tamamlandı'),
    ], string='Durum', default='yeni', required=True, tracking=True)
    sure_saat = fields.Float(string='Süre (saat)')
    currency_id = fields.Many2one(
        'res.currency', default=lambda self: self.env.company.currency_id)
    saat_ucreti = fields.Monetary(string='Saat Ücreti', currency_field='currency_id')
    tutar = fields.Monetary(
        string='Tutar', currency_field='currency_id',
        compute='_compute_tutar', store=True)

    # Odoo 19: _sql_constraints yerine models.Constraint
    _sure_pozitif = models.Constraint(
        'CHECK(sure_saat >= 0)',
        'Süre negatif olamaz.',
    )

    @api.depends('sure_saat', 'saat_ucreti')
    def _compute_tutar(self):
        for talep in self:
            talep.tutar = talep.sure_saat * talep.saat_ucreti

    @api.constrains('state', 'sure_saat')
    def _check_bitti_sure(self):
        for talep in self:
            if talep.state == 'bitti' and not talep.sure_saat:
                raise ValidationError('Tamamlanan talepte süre girilmelidir.')

    def action_baslat(self):
        self.write({'state': 'islemde'})

    def action_bitir(self):
        self.write({'state': 'bitti'})

2. Mevcut modeli genişletmek: _inherit

Odoo'nun kendi kodunu değiştirmek yerine, ayrı bir modülde _inherit ile mevcut modele alan ve davranış eklenir. Odoo güncellendiğinde özelleştirme kaybolmaz.

# models/res_partner.py
from odoo import fields, models


class ResPartner(models.Model):
    _inherit = 'res.partner'            # yeni model değil: mevcut modele ekleme

    servis_talep_ids = fields.One2many(
        'servis.talep', 'partner_id', string='Servis Talepleri')
    servis_talep_count = fields.Integer(compute='_compute_servis_talep_count')

    def _compute_servis_talep_count(self):
        # Tek sorguda tüm müşterilerin sayısı (döngüde search_count yerine)
        data = self.env['servis.talep']._read_group(
            [('partner_id', 'in', self.ids)], ['partner_id'], ['__count'])
        sayilar = {partner.id: count for partner, count in data}
        for partner in self:
            partner.servis_talep_count = sayilar.get(partner.id, 0)

3. Erişim hakları

Yeni her model için en az bir erişim satırı gerekir. Satır yoksa model kurulur ama menüye tıklayan kullanıcı erişim hatası alır; Odoo kurulumda yalnız uyarı basar.

id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
access_servis_talep_user,servis.talep.user,model_servis_talep,base.group_user,1,1,1,0

4. Menü

Menü, action'a ref ile bağlanır. Bu yüzden menü dosyası manifest'te view dosyasından sonra gelir.

<!-- views/menus.xml -->
<odoo>
    <menuitem id="servis_talep_menu_root" name="Servis"/>
    <menuitem id="servis_talep_menu" name="Talepler"
              parent="servis_talep_menu_root" action="servis_talep_action"/>
</odoo>