การพัฒนาโมดูล¶

{
    "name": "Roots HEMMS — Your Module",
    "version": "18.0.1.0.0",
    "category": "Maintenance",
    "summary": "One-sentence description — what it adds, not how.",
    "author": "Trinity Roots Co., Ltd.",
    "website": "https://roots.tech",
    "license": "LGPL-3",
    "development_status": "Alpha",
    "maintainers": ["yourname"],
    "depends": [
        # Depend on the most specific HEMMS module that gives you what
        # you need, NOT on `maintenance` directly. See "Dependency hygiene"
        # below.
        "roots_hemms_pm",
    ],
    "data": [
        "security/ir.model.access.csv",
        "views/yourmodel_views.xml",
    ],
    "installable": True,
    "application": False,
}

class MaintenanceEquipment(models.Model):
    _inherit = "maintenance.equipment"

    roots_floor_number = fields.Integer()        # ✅ prefixed
    roots_room_code = fields.Char()              # ✅ prefixed

class HemmsCalibrationCert(models.Model):
    _name = "hemms.calibration.cert"             # ✅ hemms. prefix
    _description = "Equipment Calibration Certificate"

    name = fields.Char()                          # ✅ no redundant prefix
    expiry_date = fields.Date()                   # ✅ no redundant prefix
    equipment_id = fields.Many2one("maintenance.equipment")   # ✅ standard Odoo suffix

class HemmsExample(models.Model):
    # 1. Model attributes (_name, _description, _inherit, _order, _rec_name)
    _name = "hemms.example"
    _description = "Example Model"
    _inherit = ["mail.thread"]
    _order = "name"

    # 2. SQL constraints
    _sql_constraints = [
        ("name_uniq", "unique(name)", "Name must be unique."),
    ]

    # 3. Fields, grouped by type with a comment header
    # ── Char / Text ──────────────────────────────────────────────────
    name = fields.Char(required=True)

    # ── Many2one ─────────────────────────────────────────────────────
    partner_id = fields.Many2one("res.partner")

    # 4. Compute methods (in field-declaration order)
    @api.depends("name")
    def _compute_display_name(self):
        ...

    # 5. CRUD lifecycle (create / write / unlink) overrides
    @api.model_create_multi
    def create(self, vals_list):
        ...

    # 6. Constraints
    @api.constrains("name")
    def _check_name(self):
        ...

    # 7. Public action methods (button handlers, named `action_*`)
    def action_do_the_thing(self):
        ...

    # 8. Private helpers (named `_helper_*` or just `_*`)
    def _helper_internal(self):
        ...

from odoo.tests import TransactionCase, tagged


@tagged("post_install", "-at_install")
class TestYourFeature(TransactionCase):
    """Unit tests for roots_hemms_yourmodule.YourFeature."""

    @classmethod
    def setUpClass(cls):
        super().setUpClass()
        cls.equipment = cls.env["maintenance.equipment"].create({
            "name": "Test Equipment",
            "roots_value_tier": "high",
            "roots_risk_tier": "high",
        })

    def test_u01_red_criticality_propagates(self):
        """U1: high value + high risk → criticality_color == 'red'."""
        self.assertEqual(self.equipment.roots_criticality_color, "red")

{
    "name": "Roots HEMMS — Calibration Certificates",
    "version": "18.0.1.0.0",
    "category": "Maintenance",
    "summary": "Track calibration certificates per equipment with vendor sign-off.",
    "author": "Trinity Roots Co., Ltd.",
    "website": "https://roots.tech",
    "license": "LGPL-3",
    "development_status": "Alpha",
    "maintainers": ["yourname"],
    "depends": [
        "roots_hemms_asset_master",       # depend on the specific HEMMS module
        "roots_hemms_signature",          # for sign_oca bridge later
    ],
    "data": [
        "security/ir.model.access.csv",
        "views/hemms_calibration_cert_views.xml",
    ],
    "installable": True,
    "application": False,
}

from odoo import fields, models


class HemmsCalibrationCert(models.Model):
    _name = "hemms.calibration.cert"
    _description = "Equipment Calibration Certificate"
    _order = "expiry_date asc, id desc"

    # ── Char / Text ──────────────────────────────────────────────────
    name = fields.Char(required=True)

    # ── Date ─────────────────────────────────────────────────────────
    issued_date = fields.Date(required=True)
    expiry_date = fields.Date(required=True)

    # ── Many2one ─────────────────────────────────────────────────────
    equipment_id = fields.Many2one(
        "maintenance.equipment",
        required=True,
        ondelete="cascade",
        index=True,
    )
    calibration_body_id = fields.Many2one("res.partner")

    # ── Binary ───────────────────────────────────────────────────────
    pdf_file = fields.Binary(attachment=True)
    pdf_filename = fields.Char()

from odoo.tests import TransactionCase, tagged


@tagged("post_install", "-at_install")
class TestCalibration(TransactionCase):
    def test_u01_create_minimal_cert(self):
        equipment = self.env["maintenance.equipment"].create({"name": "Eq"})
        cert = self.env["hemms.calibration.cert"].create({
            "name": "CAL-001",
            "issued_date": "2026-01-01",
            "expiry_date": "2027-01-01",
            "equipment_id": equipment.id,
        })
        self.assertEqual(cert.equipment_id, equipment)