Módulo Item - Histórico de revisão

Rodrigogml: /* Fator de Conversão na Prática */

2025-11-20T13:42:53Z

Fator de Conversão na Prática

← Edição anterior		Edição das 13h42min de 20 de novembro de 2025
Linha 243:		Linha 243:


	{{stop\|Convenção do qcFactor\|A definição do fator de conversão entre os objetos <code>ItemVO</code> e <code>ItemCodeVO</code> foi criada desde o príncio do sistema, e comumente chamada de '''divider'''. No entanto nunca foi respeitado a "direção" desse fator, em partes do código divider = qcFactor e em outras divider = 1/qcFactor.		{{stop\|Convenção do qcFactor\|
			A definição do fator de conversão entre os objetos <code>ItemVO</code> e <code>ItemCodeVO</code> foi criada desde o príncio do sistema, e comumente chamada de '''divider'''. No entanto nunca foi respeitado a "direção" desse fator, em
			partes do código '''divider = qcFactor''', e, em outras, '''divider = 1/qcFactor'''.


	A criação da nomenclatura e definição dessa "direção" do fator tente a resolver essa confusão, facilitar a implementação e erros causados por essa misturança do cálculo em diferentes partes do sistema.		A criação da nomenclatura e definição dessa "direção" do fator tente a resolver essa confusão, facilitar a implementação e erros causados por essa misturança do cálculo em diferentes partes do sistema.


	"Divider" continua presente em partes do código pois ele não foi compeltamente revisado. Mas a medida que novos códigos sejam criados ou revisados, é esperado que a nomenclatura 'divider' deixe de ser utilizada.}}		"Divider" continua presente em partes do código pois ele não foi compeltamente revisado. Mas a medida que novos códigos sejam criados ou revisados, é esperado que a nomenclatura 'divider' deixe de ser utilizada.

			}}

	== Definição do Preço de Venda ==		== Definição do Preço de Venda ==

Rodrigogml: /* Fator de Conversão de Custo */

2025-11-20T13:39:26Z

Fator de Conversão de Custo

← Edição anterior		Edição das 13h39min de 20 de novembro de 2025
Linha 224:		Linha 224:


	=== Fator de Conversão ~~de Custo~~ ===		=== Fator de Conversão na Prática ===


Linha 238:		Linha 238:
	* ItemVO.cost = ItemCodeVO.cost / qcFactor		* ItemVO.cost = ItemCodeVO.cost / qcFactor
	* ItemVO.quantity = ItemCodeVO.quantity * qcFactor		* ItemVO.quantity = ItemCodeVO.quantity * qcFactor


			{{nota\|Métodos Utilitários\|A classe <code>ItemUtils</code> contém métodos para autilizar na criação da régua, conversões e cálculo do '''qcFactor'''.}}


			{{stop\|Convenção do qcFactor\|A definição do fator de conversão entre os objetos <code>ItemVO</code> e <code>ItemCodeVO</code> foi criada desde o príncio do sistema, e comumente chamada de '''divider'''. No entanto nunca foi respeitado a "direção" desse fator, em partes do código divider = qcFactor e em outras divider = 1/qcFactor.

			A criação da nomenclatura e definição dessa "direção" do fator tente a resolver essa confusão, facilitar a implementação e erros causados por essa misturança do cálculo em diferentes partes do sistema.


			"Divider" continua presente em partes do código pois ele não foi compeltamente revisado. Mas a medida que novos códigos sejam criados ou revisados, é esperado que a nomenclatura 'divider' deixe de ser utilizada.}}

	== Definição do Preço de Venda ==		== Definição do Preço de Venda ==

Rodrigogml: /* Fator de Conversão de Custo */

2025-11-20T13:22:54Z

Fator de Conversão de Custo

← Edição anterior		Edição das 13h22min de 20 de novembro de 2025
Linha 225:		Linha 225:

	=== Fator de Conversão de Custo ===		=== Fator de Conversão de Custo ===


			Para calcular o custo do <code>ItemCodeVO</code> a partir do custo de <code>ItemVO</code>, precisamos considerar as definições de pacote e unidade de medida como visto no cálculo do '''Fator de Conversão de Quantidade''' acima. Devemos considerar que o '''custo por unidade de medida''' de <code>ItemVO</code> e de <code>ItemCodeVO</code> são os mesmos, apenas proporcionais às suas unidades de medida e quantidades de pacote, podemos utilizar o mesmo '''qcFactor'''.


			A única questão é que são grandezas proporcionalmente invertidas, ou seja, '''quando maior a quantidade menor o custo''''' e vice-versa. No exemplo acima da Mini Coxinha, imaginemos que o o custo do Kilo seja de R$ 10,00. A unidade, que pesa 30g, teria um custo por unidade de R$ 0,30. Estabelecemos acima que o '''qcFactor''' da unidade é '''0.0300003000'''. Ao multiplicar a quantidade de <code>ItemCodeVO</code> pelo '''qcFactor''' chegamos na quantidade equivalente do <code>ItemVO</code>, neste caso, se temos o custo de <code>ItemCodeVO</code> teriamos que dividí-lo pelo mesmo '''qcFactor''' para chegar no custo de <code>ItemVO</code>. E na operação inversa, podemos multiplicar o custo de <code>ItemVO</code> para chegar o custo de <code>ItemCodeVO</code>. O que podemos resumir na seguinte tabela de conversão:

			* ItemCodeVO.cost = ItemVO.cost * qcFactor
			* ItemCodeVO.quantity = ItemVO.quantity / qcFactor

			E sua inversão:
			* ItemVO.cost = ItemCodeVO.cost / qcFactor
			* ItemVO.quantity = ItemCodeVO.quantity * qcFactor

	== Definição do Preço de Venda ==		== Definição do Preço de Venda ==

Rodrigogml: /* Fator de Conversão */

2025-11-20T13:07:31Z

Fator de Conversão

← Edição anterior		Edição das 13h07min de 20 de novembro de 2025
Linha 104:		Linha 104:


	=== Fator de Conversão ===		=== Fator de Conversão de Quantidade ===

	Um conceito presa ser definido neste ponto: para efeitos de cálculo, criamos o '''Fator de Conversão de Quantidade''' ('''Quantity Conversion Factor''') ou '''qcFactor'''. Esse fator representa o multiplicador necessário para transformar a quantidade de um código (<code>ItemCodeVO</code>) na quantidade equivalente do item (<code>ItemCodeVO</code>), considerando suas unidades de medida e quantidade do pacote.		Um conceito presa ser definido neste ponto: para efeitos de cálculo, criamos o '''Fator de Conversão de Quantidade''' ('''Quantity Conversion Factor''') ou '''qcFactor'''. Esse fator representa o multiplicador necessário para transformar a quantidade de um código (<code>ItemCodeVO</code>) na quantidade equivalente do item (<code>ItemCodeVO</code>), considerando suas unidades de medida e quantidade do pacote.
Linha 222:		Linha 222:

	</syntaxhighlight>}}		</syntaxhighlight>}}


			=== Fator de Conversão de Custo ===

	== Definição do Preço de Venda ==		== Definição do Preço de Venda ==

Rodrigogml: /* Fator de Conversão */

2025-11-20T13:05:55Z

Fator de Conversão

← Edição anterior		Edição das 13h05min de 20 de novembro de 2025
Linha 113:		Linha 113:

	<pre>qtyItemVO = qcFactor * qtyItemCodeVO</pre>		<pre>qtyItemVO = qcFactor * qtyItemCodeVO</pre>


			Ou sua equivalente:


			<pre>qtyItemCodeVO = qtyItemVO / qcFactor</pre>

Rodrigogml: /* Fator de Conversão */

2025-11-20T13:04:24Z

Fator de Conversão

← Edição anterior		Edição das 13h04min de 20 de novembro de 2025
Linha 113:		Linha 113:

	<pre>qtyItemVO = qcFactor * qtyItemCodeVO</pre>		<pre>qtyItemVO = qcFactor * qtyItemCodeVO</pre>



			{{nota\|Em palavras...\|Com o '''qcFactor''' na mão, temos que:

			'''''cada unidade vendida do código equivale "X" unidades vendidas do item''''',

			ou mais precisamente:

			'''''cada unidade vendida do código equivale "qcFactor" unidades vendidas do item'''''.}}

Rodrigogml: /* Exemplo */

2025-11-20T13:03:25Z

Exemplo

@@ Linha 132: / Linha 132: @@
 * '''Relações de Grandezas:''' Para cobrir seus diferentes métodos de venda o usuário estabelece a seguinte relação de Grandezas:
 :* '''1 Und = 30g''' - Define que 1 unidade de Mini Coxinha tem o tamanho de 30g.
-:* '''1 Bandeja = 1 Dúzia''' - A unidade personalizada Bandeija equivale a 1 dúzia.
+:* '''1 Bandeja = 2 Dúzia''' - A unidade personalizada Bandeija equivale a 1 dúzia.
 * '''Códigos de Vendas:'''
 :* '''1 - Venda por Kilo:''' - Neste código o usuário define o tamanho do pacote em 1, a unidade 'Kilogram' e que o códigio é divisível.
 :* '''2 - Venda por Cento:''' - Neste, define o tamanho do pacote em 1, a unidade em 'Centro' e que o código é indivisível.
 :* '''3 - Venda por Unidade:''' - Neste, define o tamanho do pacote em 1, a unidade em 'Unidade' e que o código é indivisível.
-:* '''4 - Venda por Bandeija:''' - Aqui, define o tamanho do pacote em 1, a unidade em 'Bandeija' e que o código é indivisível.
+:* '''4 - Venda por Bandeija:''' - Aqui, define o tamanho do pacote em 2, a unidade em 'Bandeija' e que o código é indivisível.
-Em relação ao código para trabalhar com essas informações vamos dividir em duas partes:
+Em relação ao código para trabalhar com essas informações vamos dividir em partes:
-'''Preparação da Régua e Definições:'''
-Montamos a MeasureRulerVO com as informações, um exemplo seria:
 == Definição do Preço de Venda ==

Rodrigogml: /* Fator de Conversão */

2025-11-20T12:12:49Z

Fator de Conversão

@@ Linha 106: / Linha 106: @@
 === Fator de Conversão ===
-Um conceito presa ser definido neste ponto: para efeitos de cálculo, criamos o '''Fator de Conversão de Quantidade''' ou '''fatorCQ'''. Esse fator indica o multiplicador necessário para transformar a quantidade de uma unidade de um código (<code>ItemCodeVO</code>) em uma unidade principal do item (<code>ItemCodeVO</code>). Esse fator é obetido a partir da seguinte equação verdade:
+Um conceito presa ser definido neste ponto: para efeitos de cálculo, criamos o '''Fator de Conversão de Quantidade''' ('''Quantity Conversion Factor''') ou '''qcFactor'''. Esse fator representa o multiplicador necessário para transformar a quantidade de um código (<code>ItemCodeVO</code>) na quantidade equivalente do item (<code>ItemCodeVO</code>), considerando suas unidades de medida e quantidade do pacote.
-Assim, o valor de '''fatorCQ''' é definido da seguinte forma:
+<pre>qtyItemVO = qcFactor * qtyItemCodeVO</pre>
 <pre>fatorCQ = </pre>
 == Definição do Preço de Venda ==

Rodrigogml: /* Fator de Conversão */

2025-11-19T23:09:43Z

Fator de Conversão

← Edição anterior		Edição das 23h09min de 19 de novembro de 2025
Linha 109:		Linha 109:


	<~~math display="block"~~>qtdeItemVO = fatorCQ ~~\times~~ qtdeItemCodeVO</~~math~~>		<pre>1 (Unidade de qtdeItemVO) = fatorCQ * 1 (unidade de qtdeItemCodeVO)</pre>

	~~<math>qtdeItemVO = fatorCQ \times qtdeItemCodeVO</math>~~

			Assim, o valor de '''fatorCQ''' é definido da seguinte forma:

			<pre>fatorCQ = </pre>
	~~qtdeItemVO~~ = ~~fatorCQ \times qtdeItemCodeVO~~


	== Definição do Preço de Venda ==		== Definição do Preço de Venda ==

Rodrigogml: /* Definição do Preço de Venda */

2025-11-19T22:58:24Z

Definição do Preço de Venda

@@ Linha 93: / Linha 93: @@
 ** '''[ve0010] Descrição do Item''' - Valida se a descrição do item é única entre os itens ativos no momento.
 ** '''[ve0011] Itens de Revenda não podem ser Descartáveis''' - Valida se o item tiver o propósito como revenda, não permite que seja do tipo descartável.
 == Definição do Preço de Venda ==