feat(receiving): fp.receiving model with state machine and views
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
gsinghpal
@@ -2,4 +2,149 @@
|
|||||||
# Copyright 2026 Nexa Systems Inc.
|
# Copyright 2026 Nexa Systems Inc.
|
||||||
# License OPL-1 (Odoo Proprietary License v1.0)
|
# License OPL-1 (Odoo Proprietary License v1.0)
|
||||||
# Part of the Fusion Plating product family.
|
# Part of the Fusion Plating product family.
|
||||||
# Placeholder — implemented in a later task.
|
|
||||||
|
from odoo import api, fields, models, _
|
||||||
|
from odoo.exceptions import UserError
|
||||||
|
|
||||||
|
|
||||||
|
class FpReceiving(models.Model):
|
||||||
|
"""Parts receiving record.
|
||||||
|
|
||||||
|
Created automatically when a sale order is confirmed. Tracks
|
||||||
|
quantity verification, condition inspection, and damage logging
|
||||||
|
for customer parts arriving at the shop.
|
||||||
|
"""
|
||||||
|
_name = 'fp.receiving'
|
||||||
|
_description = 'Fusion Plating — Receiving'
|
||||||
|
_inherit = ['mail.thread', 'mail.activity.mixin']
|
||||||
|
_order = 'received_date desc, id desc'
|
||||||
|
|
||||||
|
name = fields.Char(string='Reference', readonly=True, copy=False, default='New')
|
||||||
|
sale_order_id = fields.Many2one(
|
||||||
|
'sale.order', string='Sale Order', required=True, ondelete='restrict',
|
||||||
|
tracking=True,
|
||||||
|
)
|
||||||
|
partner_id = fields.Many2one(
|
||||||
|
'res.partner', string='Customer', related='sale_order_id.partner_id',
|
||||||
|
store=True, readonly=True,
|
||||||
|
)
|
||||||
|
po_number = fields.Char(
|
||||||
|
string='Customer PO #', related='sale_order_id.x_fc_po_number',
|
||||||
|
store=True, readonly=True,
|
||||||
|
)
|
||||||
|
received_by_id = fields.Many2one(
|
||||||
|
'res.users', string='Received By', default=lambda self: self.env.user,
|
||||||
|
tracking=True,
|
||||||
|
)
|
||||||
|
received_date = fields.Datetime(
|
||||||
|
string='Received Date', default=fields.Datetime.now, tracking=True,
|
||||||
|
)
|
||||||
|
state = fields.Selection(
|
||||||
|
[
|
||||||
|
('draft', 'Awaiting Parts'),
|
||||||
|
('inspecting', 'Inspecting'),
|
||||||
|
('accepted', 'Accepted'),
|
||||||
|
('discrepancy', 'Discrepancy'),
|
||||||
|
('resolved', 'Resolved'),
|
||||||
|
],
|
||||||
|
string='Status', default='draft', tracking=True, required=True,
|
||||||
|
)
|
||||||
|
expected_qty = fields.Integer(string='Expected Qty', help='Total quantity expected from the sale order.')
|
||||||
|
received_qty = fields.Integer(string='Received Qty', help='Total quantity actually received.')
|
||||||
|
qty_match = fields.Boolean(
|
||||||
|
string='Qty Match', compute='_compute_qty_match', store=True,
|
||||||
|
)
|
||||||
|
carrier_name = fields.Char(string='Carrier', help='Who delivered the parts (Purolator, customer drop-off, etc.).')
|
||||||
|
carrier_tracking = fields.Char(string='Inbound Tracking #')
|
||||||
|
notes = fields.Html(string='Notes')
|
||||||
|
|
||||||
|
line_ids = fields.One2many('fp.receiving.line', 'receiving_id', string='Receiving Lines')
|
||||||
|
damage_ids = fields.One2many('fp.receiving.damage', 'receiving_id', string='Damage Log')
|
||||||
|
damage_count = fields.Integer(string='Damage Count', compute='_compute_damage_count')
|
||||||
|
unresolved_damage_count = fields.Integer(
|
||||||
|
string='Unresolved Damage', compute='_compute_damage_count',
|
||||||
|
)
|
||||||
|
attachment_ids = fields.Many2many(
|
||||||
|
'ir.attachment', 'fp_receiving_attachment_rel', 'receiving_id', 'attachment_id',
|
||||||
|
string='Photos / Documents',
|
||||||
|
)
|
||||||
|
|
||||||
|
@api.depends('expected_qty', 'received_qty')
|
||||||
|
def _compute_qty_match(self):
|
||||||
|
for rec in self:
|
||||||
|
rec.qty_match = rec.expected_qty > 0 and rec.received_qty == rec.expected_qty
|
||||||
|
|
||||||
|
@api.depends('damage_ids', 'damage_ids.resolved')
|
||||||
|
def _compute_damage_count(self):
|
||||||
|
for rec in self:
|
||||||
|
rec.damage_count = len(rec.damage_ids)
|
||||||
|
rec.unresolved_damage_count = len(rec.damage_ids.filtered(lambda d: not d.resolved))
|
||||||
|
|
||||||
|
# -------------------------------------------------------------------------
|
||||||
|
# Sequence
|
||||||
|
# -------------------------------------------------------------------------
|
||||||
|
@api.model_create_multi
|
||||||
|
def create(self, vals_list):
|
||||||
|
for vals in vals_list:
|
||||||
|
if vals.get('name', 'New') == 'New':
|
||||||
|
vals['name'] = self.env['ir.sequence'].next_by_code('fp.receiving') or 'New'
|
||||||
|
return super().create(vals_list)
|
||||||
|
|
||||||
|
# -------------------------------------------------------------------------
|
||||||
|
# State actions
|
||||||
|
# -------------------------------------------------------------------------
|
||||||
|
def action_start_inspection(self):
|
||||||
|
"""Move from draft to inspecting."""
|
||||||
|
for rec in self:
|
||||||
|
if rec.state != 'draft':
|
||||||
|
raise UserError(_('Only draft records can start inspection.'))
|
||||||
|
rec.state = 'inspecting'
|
||||||
|
rec.received_by_id = self.env.user
|
||||||
|
rec.received_date = fields.Datetime.now()
|
||||||
|
|
||||||
|
def action_accept(self):
|
||||||
|
"""Accept the receiving — parts match and condition is OK."""
|
||||||
|
for rec in self:
|
||||||
|
if rec.state not in ('inspecting', 'resolved'):
|
||||||
|
raise UserError(_('Can only accept from Inspecting or Resolved state.'))
|
||||||
|
if rec.unresolved_damage_count > 0:
|
||||||
|
raise UserError(_('Cannot accept — there are %d unresolved damage entries.') % rec.unresolved_damage_count)
|
||||||
|
rec.state = 'accepted'
|
||||||
|
rec._update_so_receiving_status()
|
||||||
|
rec.message_post(body=_('Parts accepted — quantity: %d, all checks passed.') % rec.received_qty)
|
||||||
|
|
||||||
|
def action_flag_discrepancy(self):
|
||||||
|
"""Flag a discrepancy — qty mismatch or damage found."""
|
||||||
|
for rec in self:
|
||||||
|
if rec.state != 'inspecting':
|
||||||
|
raise UserError(_('Can only flag discrepancy from Inspecting state.'))
|
||||||
|
rec.state = 'discrepancy'
|
||||||
|
rec._update_so_receiving_status()
|
||||||
|
# Create follow-up activity for the sales team
|
||||||
|
rec.activity_schedule(
|
||||||
|
'mail.mail_activity_data_todo',
|
||||||
|
summary=_('Receiving discrepancy — %s') % rec.name,
|
||||||
|
note=_('Qty expected: %d, received: %d. Check damage log for details.') % (
|
||||||
|
rec.expected_qty, rec.received_qty),
|
||||||
|
)
|
||||||
|
rec.message_post(body=_('Discrepancy flagged — follow-up required.'))
|
||||||
|
|
||||||
|
def action_resolve(self):
|
||||||
|
"""Resolve a discrepancy after customer follow-up."""
|
||||||
|
for rec in self:
|
||||||
|
if rec.state != 'discrepancy':
|
||||||
|
raise UserError(_('Can only resolve from Discrepancy state.'))
|
||||||
|
rec.state = 'resolved'
|
||||||
|
rec._update_so_receiving_status()
|
||||||
|
rec.message_post(body=_('Discrepancy resolved.'))
|
||||||
|
|
||||||
|
def _update_so_receiving_status(self):
|
||||||
|
"""Update the linked sale order's receiving status."""
|
||||||
|
for rec in self:
|
||||||
|
if rec.sale_order_id:
|
||||||
|
if rec.state in ('accepted', 'resolved'):
|
||||||
|
rec.sale_order_id.x_fc_receiving_status = 'received'
|
||||||
|
elif rec.state == 'discrepancy':
|
||||||
|
rec.sale_order_id.x_fc_receiving_status = 'partial'
|
||||||
|
elif rec.state == 'inspecting':
|
||||||
|
rec.sale_order_id.x_fc_receiving_status = 'partial'
|
||||||
|
|||||||
@@ -1,2 +1,178 @@
|
|||||||
<?xml version="1.0" encoding="utf-8"?>
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
<odoo></odoo>
|
<!--
|
||||||
|
Copyright 2026 Nexa Systems Inc.
|
||||||
|
License OPL-1 (Odoo Proprietary License v1.0)
|
||||||
|
Part of the Fusion Plating product family.
|
||||||
|
-->
|
||||||
|
<odoo>
|
||||||
|
|
||||||
|
<!-- ===== Receiving List View ===== -->
|
||||||
|
<record id="view_fp_receiving_list" model="ir.ui.view">
|
||||||
|
<field name="name">fp.receiving.list</field>
|
||||||
|
<field name="model">fp.receiving</field>
|
||||||
|
<field name="arch" type="xml">
|
||||||
|
<list string="Receiving"
|
||||||
|
decoration-warning="state == 'discrepancy'"
|
||||||
|
decoration-success="state == 'accepted'"
|
||||||
|
decoration-muted="state == 'resolved'"
|
||||||
|
default_order="received_date desc">
|
||||||
|
<field name="received_date"/>
|
||||||
|
<field name="name"/>
|
||||||
|
<field name="sale_order_id"/>
|
||||||
|
<field name="partner_id"/>
|
||||||
|
<field name="po_number"/>
|
||||||
|
<field name="expected_qty"/>
|
||||||
|
<field name="received_qty"/>
|
||||||
|
<field name="qty_match" widget="boolean"/>
|
||||||
|
<field name="state" widget="badge"
|
||||||
|
decoration-info="state == 'draft'"
|
||||||
|
decoration-warning="state in ('inspecting', 'discrepancy')"
|
||||||
|
decoration-success="state == 'accepted'"
|
||||||
|
decoration-muted="state == 'resolved'"/>
|
||||||
|
</list>
|
||||||
|
</field>
|
||||||
|
</record>
|
||||||
|
|
||||||
|
<!-- ===== Receiving Form View ===== -->
|
||||||
|
<record id="view_fp_receiving_form" model="ir.ui.view">
|
||||||
|
<field name="name">fp.receiving.form</field>
|
||||||
|
<field name="model">fp.receiving</field>
|
||||||
|
<field name="arch" type="xml">
|
||||||
|
<form string="Receiving">
|
||||||
|
<header>
|
||||||
|
<button name="action_start_inspection"
|
||||||
|
string="Start Inspection"
|
||||||
|
type="object"
|
||||||
|
invisible="state != 'draft'"/>
|
||||||
|
<button name="action_accept"
|
||||||
|
string="Accept"
|
||||||
|
type="object"
|
||||||
|
class="btn-primary"
|
||||||
|
invisible="state not in ('inspecting', 'resolved')"/>
|
||||||
|
<button name="action_flag_discrepancy"
|
||||||
|
string="Flag Discrepancy"
|
||||||
|
type="object"
|
||||||
|
class="btn-danger"
|
||||||
|
invisible="state != 'inspecting'"/>
|
||||||
|
<button name="action_resolve"
|
||||||
|
string="Resolve"
|
||||||
|
type="object"
|
||||||
|
invisible="state != 'discrepancy'"/>
|
||||||
|
<field name="state" widget="statusbar"
|
||||||
|
statusbar_visible="draft,inspecting,accepted"/>
|
||||||
|
</header>
|
||||||
|
<sheet>
|
||||||
|
<div class="oe_title">
|
||||||
|
<h1>
|
||||||
|
<field name="name" readonly="1"/>
|
||||||
|
</h1>
|
||||||
|
</div>
|
||||||
|
<group>
|
||||||
|
<group>
|
||||||
|
<field name="sale_order_id"/>
|
||||||
|
<field name="partner_id"/>
|
||||||
|
<field name="po_number"/>
|
||||||
|
</group>
|
||||||
|
</group>
|
||||||
|
<group>
|
||||||
|
<group string="Reception">
|
||||||
|
<field name="received_by_id"/>
|
||||||
|
<field name="received_date"/>
|
||||||
|
<field name="carrier_name"/>
|
||||||
|
<field name="carrier_tracking"/>
|
||||||
|
</group>
|
||||||
|
<group string="Quantities">
|
||||||
|
<field name="expected_qty"/>
|
||||||
|
<field name="received_qty"/>
|
||||||
|
<field name="qty_match" widget="boolean_toggle" readonly="1"/>
|
||||||
|
</group>
|
||||||
|
</group>
|
||||||
|
<notebook>
|
||||||
|
<page string="Receiving Lines" name="lines">
|
||||||
|
<field name="line_ids">
|
||||||
|
<list editable="bottom">
|
||||||
|
<field name="part_number"/>
|
||||||
|
<field name="description"/>
|
||||||
|
<field name="expected_qty"/>
|
||||||
|
<field name="received_qty"/>
|
||||||
|
<field name="condition"/>
|
||||||
|
<field name="notes"/>
|
||||||
|
</list>
|
||||||
|
</field>
|
||||||
|
</page>
|
||||||
|
<page string="Damage Log" name="damage">
|
||||||
|
<field name="damage_ids">
|
||||||
|
<list editable="bottom">
|
||||||
|
<field name="description"/>
|
||||||
|
<field name="severity" widget="badge"
|
||||||
|
decoration-info="severity == 'cosmetic'"
|
||||||
|
decoration-warning="severity == 'functional'"
|
||||||
|
decoration-danger="severity == 'rejected'"/>
|
||||||
|
<field name="action_required"/>
|
||||||
|
<field name="customer_notified"/>
|
||||||
|
<field name="resolved"/>
|
||||||
|
</list>
|
||||||
|
</field>
|
||||||
|
</page>
|
||||||
|
<page string="Photos" name="photos">
|
||||||
|
<field name="attachment_ids" widget="many2many_binary"/>
|
||||||
|
</page>
|
||||||
|
<page string="Notes" name="notes">
|
||||||
|
<field name="notes"
|
||||||
|
placeholder="Internal notes about this receiving..."/>
|
||||||
|
</page>
|
||||||
|
</notebook>
|
||||||
|
</sheet>
|
||||||
|
<div class="oe_chatter">
|
||||||
|
<field name="message_follower_ids"/>
|
||||||
|
<field name="activity_ids"/>
|
||||||
|
<field name="message_ids"/>
|
||||||
|
</div>
|
||||||
|
</form>
|
||||||
|
</field>
|
||||||
|
</record>
|
||||||
|
|
||||||
|
<!-- ===== Receiving Search View ===== -->
|
||||||
|
<record id="view_fp_receiving_search" model="ir.ui.view">
|
||||||
|
<field name="name">fp.receiving.search</field>
|
||||||
|
<field name="model">fp.receiving</field>
|
||||||
|
<field name="arch" type="xml">
|
||||||
|
<search>
|
||||||
|
<field name="name"/>
|
||||||
|
<field name="sale_order_id"/>
|
||||||
|
<field name="partner_id"/>
|
||||||
|
<field name="po_number"/>
|
||||||
|
<separator/>
|
||||||
|
<filter string="Awaiting Parts" name="draft" domain="[('state', '=', 'draft')]"/>
|
||||||
|
<filter string="Inspecting" name="inspecting" domain="[('state', '=', 'inspecting')]"/>
|
||||||
|
<filter string="Discrepancy" name="discrepancy" domain="[('state', '=', 'discrepancy')]"/>
|
||||||
|
<filter string="Accepted" name="accepted" domain="[('state', '=', 'accepted')]"/>
|
||||||
|
<group>
|
||||||
|
<filter string="Customer" name="group_customer" context="{'group_by': 'partner_id'}"/>
|
||||||
|
<filter string="Status" name="group_state" context="{'group_by': 'state'}"/>
|
||||||
|
<filter string="Received Date" name="group_received_date" context="{'group_by': 'received_date:month'}"/>
|
||||||
|
</group>
|
||||||
|
</search>
|
||||||
|
</field>
|
||||||
|
</record>
|
||||||
|
|
||||||
|
<!-- ===== Window Action ===== -->
|
||||||
|
<record id="action_fp_receiving" model="ir.actions.act_window">
|
||||||
|
<field name="name">Receiving</field>
|
||||||
|
<field name="res_model">fp.receiving</field>
|
||||||
|
<field name="view_mode">list,form</field>
|
||||||
|
<field name="search_view_id" ref="view_fp_receiving_search"/>
|
||||||
|
<field name="context">{'search_default_draft': 1}</field>
|
||||||
|
<field name="help" type="html">
|
||||||
|
<p class="o_view_nocontent_smiling_face">
|
||||||
|
No receiving records yet
|
||||||
|
</p>
|
||||||
|
<p>
|
||||||
|
Receiving records are created automatically when a sale order is
|
||||||
|
confirmed. They track quantity verification, condition inspection,
|
||||||
|
and damage logging for customer parts arriving at the shop.
|
||||||
|
</p>
|
||||||
|
</field>
|
||||||
|
</record>
|
||||||
|
|
||||||
|
</odoo>
|
||||||
|
|||||||
Reference in New Issue
Block a user