1. บทสรุปผู้บริหาร (Executive Summary)

2. หลักฐานจากหน้าจอจริง (Annotated Evidence Analysis)

ภาพที่ 1: หน้าจอจริง Accounting > Reporting > Management > Invoices Analysis และเมนูย่อย Add Custom Group ที่ขาดฟิลด์ Project Name และ Department

3. สถาปัตยกรรม Odoo: ทำไมฟิลด์ใน account.move จึงไม่โผล่ใน Invoice Analysis?

ความเข้าใจผิดที่พบบ่อยคือคิดว่าหน้า Invoice Analysis คือหน้าเดียวกับหน้า Invoices (account.move) แต่ในทางสถาปัตยกรรมของ Odoo นั้นแยกจากกันโดยสิ้นเชิง:

แหล่งที่มาของข้อมูลฟิลด์ Department ในระบบ Yell

ในการดึงฟิลด์ Department เข้ามารายงาน สามารถเชื่อมโยงได้ 2 รูปแบบตามโครงสร้างธุรกิจของบริษัท:

4. การจำลองผลลัพธ์หน้าจอ (Step-by-Step UI Visual Mockup)

5. แนวทางการแก้ไขทางเทคนิคอย่างละเอียด (Step-by-Step Developer Implementation)

ในการนำฟิลด์เข้าสู่ระบบรายงานอย่างถูกต้องตามมาตรฐาน Odoo 16 ให้ดำเนินการผ่าน Custom Addon (เช่น โมดูล yell_account_ext) ทั้งหมด 3 ขั้นตอน:

1. สถาปัตยกรรม Python Model (`models/account_invoice_report.py`)

ประกาศฟิลด์ project_id, project_name และ department_id บนโมเดล account.invoice.report และขยายคำสั่ง SQL ใน _select(), _from(), และ _group_by():

# -*- coding: utf-8 -*-
# File: yell_account_ext/models/account_invoice_report.py

from odoo import fields, models


class AccountInvoiceReport(models.Model):
    _inherit = 'account.invoice.report'

    # 1. ประกาศฟิลด์บนโมเดลรายงานเพื่อให้ Odoo Web Client มองเห็นใน Add Custom Group
    project_id = fields.Many2one(
        comodel_name='project.project',
        string='Project',
        readonly=True,
    )
    project_name = fields.Char(
        string='Project Name',
        readonly=True,
    )
    department_id = fields.Many2one(
        comodel_name='hr.department',
        string='Department',
        readonly=True,
    )

    # 2. ขยายคำสั่ง SELECT เพื่อดึงคอลัมน์จากตาราง account_move และ hr_department
    def _select(self):
        select_str = super()._select()
        select_str += """,
            move.project_id AS project_id,
            move.project_name AS project_name,
            dept.id AS department_id
        """
        return select_str

    # 3. ขยายคำสั่ง FROM เพื่อ LEFT JOIN ไปยัง hr_employee และ hr_department
    def _from(self):
        from_str = super()._from()
        from_str += """
            LEFT JOIN hr_employee emp ON emp.user_id = move.invoice_user_id AND emp.company_id = move.company_id
            LEFT JOIN hr_department dept ON dept.id = emp.department_id
        """
        return from_str

    # 4. ขยายคำสั่ง GROUP BY เพื่อให้ SQL View จัดกลุ่มข้อมูลได้อย่างถูกต้อง
    def _group_by(self):
        group_by_str = super()._group_by()
        group_by_str += """,
            move.project_id,
            move.project_name,
            dept.id
        """
        return group_by_str

2. การขยาย Search View XML (`views/account_invoice_report_views.xml`)

สร้าง Shortcut Filter ในแถบ Group By เพื่อให้ผู้ใช้สามารถคลิกจัดกลุ่มได้ทันทีโดยไม่ต้องเปิดเมนูย่อย Add Custom Group:

<!-- File: yell_account_ext/views/account_invoice_report_views.xml -->
<?xml version="1.0" encoding="utf-8"?>
<odoo>
    <record id="view_account_invoice_report_search_inherit_project" model="ir.ui.view">
        <field name="name">account.invoice.report.search.inherit.project</field>
        <field name="model">account.invoice.report</field>
        <field name="inherit_id" ref="account.view_account_invoice_report_search"/>
        <field name="arch" type="xml">
            <xpath expr="//search//group" position="inside">
                <!-- เพิ่มปุ่มลัด Group By ในเมนูหลัก -->
                <filter string="Project" name="groupby_project" context="{'group_by': 'project_id'}"/>
                <filter string="Project Name" name="groupby_project_name" context="{'group_by': 'project_name'}"/>
                <filter string="Department" name="groupby_department" context="{'group_by': 'department_id'}"/>
            </xpath>
        </field>
    </record>
</odoo>

3. การอัปเกรดโมดูลเพื่อสร้าง SQL View ใหม่ใน PostgreSQL

เมื่อมีการแก้ไขเมธอดของ SQL View ใน Odoo จะต้องทำการ Upgrade Module เพื่อให้ Odoo ดรอป View เดิมและรันคำสั่ง CREATE OR REPLACE VIEW account_invoice_report AS ... ในฐานข้อมูล:

# คำสั่งอัปเกรดโมดูลบนเซิร์ฟเวอร์ทดสอบ (Staging / yell.3roots.live)
$env:PYTHONIOENCODING="utf-8"
python odoo-bin -c odoo.conf -d yell-dev -u yell_account_ext --stop-after-init

6. ตารางวิเคราะห์ผลกระทบต่อระบบส่วนอื่นๆ (Impact Assessment Matrix)

การวิเคราะห์ผลกระทบอย่างละเอียดในทุกมิติของระบบ เพื่อให้ทีมพัฒนาและผู้บริหารมั่นใจก่อนเริ่มดำเนินงาน:

7. ข้อเสนอแนะเชิงสถาปัตยกรรม (Senior Developer Best Practices)

8. แผนการตรวจรับงาน (QA & Deployment Checklist)