Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[IMP] Manufacturing: update MO costs #11422

Open
wants to merge 1 commit into
base: 18.0
Choose a base branch
from

Conversation

hojo-odoo
Copy link
Contributor

This PR updates the Manufacturing Order Costs doc to better explain the differences between the cost for a specific employee, and the employee cost set on a work center form.

@robodoo
Copy link
Collaborator

robodoo commented Nov 19, 2024

Pull request status dashboard

@C3POdoo C3POdoo requested a review from a team November 19, 2024 20:01
@hojo-odoo
Copy link
Contributor Author

Hey @benderliz,

This is ready for the first round of review.

Thanks,
John

Copy link
Contributor

@benderliz benderliz left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@hojo-odoo John, excellent work on this PR!!! I left a few relatively minor suggestions. The overall structure and writing of this doc is very easy to follow. Great job! :)

Comment on lines 31 to +34
Odoo computes |MO| costs based on the configuration of the |BoM| used to manufacture a product. This
includes the cost and quantity of components and operations listed on the |BoM|, in addition to the
operating costs of the work centers where those operations are carried out.
operating costs of the work centers where those operations are carried out, and the amount paid to
each employee who works on an operation.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This paragraph repeats a lot of the 'important' admonition block above.

Comment on lines 31 to 32
Odoo computes |MO| costs based on the configuration of the |BoM| used to manufacture a product. This
includes the cost and quantity of components and operations listed on the |BoM|, in addition to the
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
Odoo computes |MO| costs based on the configuration of the |BoM| used to manufacture a product. This
includes the cost and quantity of components and operations listed on the |BoM|, in addition to the
Odoo computes |MO| costs based on the configuration of the |BoM| used to manufacture a product. This
calculation includes the cost and quantity of components and operations listed on the |BoM|, in addition to the

@@ -46,40 +46,57 @@ the component's product form, and entering a value. However, any future |POs| fo
override a value entered manually, resetting the :guilabel:`Cost` field back to an automatically
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Super small nitpick - it's not letting me comment on line 45, but I would personally not put a comma before "entering a value", since it's not an independent clause or an aside.

@@ -46,40 +46,57 @@ the component's product form, and entering a value. However, any future |POs| fo
override a value entered manually, resetting the :guilabel:`Cost` field back to an automatically
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
override a value entered manually, resetting the :guilabel:`Cost` field back to an automatically
override a manually-entered value entered, resetting the :guilabel:`Cost` field back to an automatically

used than was listed on the |MO|, or if the duration of a work order is different than expected.
used than was listed on the |MO|, the duration of a work order is different than expected, or the
hourly cost of the employee performing a work order differs from the employee cost set on the work
center.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great call out!


|BoM| cost
----------
|BoM| configuration
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would consider moving this section, BoM configuration, to be above component cost, work center cost, and employee cost! Since it's sort of the basis of the MO cost.

|BoM| cost
----------
|BoM| configuration
-------------------

Configuring a |BoM| so Odoo can accurately calculate the cost of |MOs| that use it requires two
steps. First, components **must** be added, and the required quantity specified. Second, operations
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe it could be nice for the steps to be enumerated (1) and (2), and then the steps for configuration can be listed after each of the 2 steps?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In lines 123-124, should 'default duration` be capitalized and stylized as :guilabel:?

per hour` section on the work center's :guilabel:`General Information` tab. For example, if `25.00`
is entered in the :guilabel:`per employee` field, it costs $25.00 per hour for *each* employee
working at the work center.
:guilabel:`General Information` tab.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's not letting me edit these lines directly because there is a deleted line contained therein, but I think, instead of lines 57 - 63, it should say:

[ To set the cost of operating the work center for one hour, locate the :guilabel:Cost per hour field on the work center's :guilabel:General Information tab. The hourly cost can be set two different ways: :guilabel:per workcenter and :guilabelper employee. ]

...then continue with the examples :)

used than was listed on the |MO|, or if the duration of a work order is different than expected.
used than was listed on the |MO|, the duration of a work order is different than expected, or the
hourly cost of the employee performing a work order differs from the employee cost set on the work
center.

Once the |MO| has been completed by clicking :guilabel:`Produce All`, the values in the
:guilabel:`MO Cost` column update to match those displayed in the :guilabel:`Real Cost` column.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's not letting me comment on the individual lines below, but the example you walk through is awesome! Very clearly explained, and I am not left with any questions.

A couple minor suggestions/questions:

  • I notice in the bullet points that single digit numbers (e.g. seven) are spelled out, while two+ digit numbers (e.g. 15) use numbers. I am familiar with this practice as a journalistic/academic writing convention, but I feel like for something like Odoo, it is kind of awkward. Personally I would prefer to see all numbers, like 1, 15, 300, etc., instead of written out. But is it an Odoo style convention we have to adhere to?
  • Fairway Fields is italicized at the beginning of the example, but not when mentioned later. Is that intentional? Same with the putting green.

.. important::
As detailed in the :ref:`section above <manufacturing/mo-costs/work-center-cost>`, the value
entered in the :guilabel:`Hourly Cost` field on the employee's form is used to calculate the real
cost of an MO. The estimated cost of an MO, referred to as the MO cost, uses the per employee
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
cost of an MO. The estimated cost of an MO, referred to as the MO cost, uses the per employee
cost of an MO. The estimated cost of an MO, referred to as the MO cost, uses the :guilabel:`per employee`

@hojo-odoo hojo-odoo added the 3 label Nov 22, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants