Add documentation about how to create move and transform an animal

doc/es/farm.rst

@@ -229,24 +229,122 @@ indicaremos los productos necessarios para producir el pienso. En el apartado
 :ref:`Crear una lista de materiales<production-create-bom>` tenemos con más
 detalle de cómo debemos hacer-lo.
 
-Crear un animal
-~~~~~~~~~~~~~~~
+--------------------------------------
+Crear un animal o un grupo de animales
+--------------------------------------
 
-.. TODO
+Para crear un animal o un grupo de animals debemos accedor al menú
+*Granja / <Nombre especie> / <Tipo Animal>*. En esta opción deberemos
+introducir la |arrival_date|, el |origin| y la |initial_location|.
 
+.. view:: farm.farm_animal_form_view
+
+Opcionalmente podremos introducir un |animal_number| para identificar el animal.
+En caso de que no lo introduzcamos el sistema nos generará uno.
+
+En caso de que creemos un grupo de animales deberemos introducir la
+|group_initial_qty| de animales que componen el grupo.
+
+.. view:: farm.farm_animal_group_form_view
+
+Crear una madre con su historial
+--------------------------------
+
+Para crear una madre que ya ha tenido algún parto en nuestra granja, usaremos el
+**asistente** que encontramos en la entrada de menú *Granja / <Nombre especie>
+/ Madres / Crear madre*.
+
+.. view:: farm.farm_create_female_start_view
+   :field: lines
+
+La |arrival_date|, además de rellenar el campo correspondiente en la
+ficha de la madre, se usará para el movimiento de entrada (lo que hará que la
+madre figure en el sistema desde aquella fecha).
+
+Si elegimos como |origin| *Criado*, esta fecha también se usará como
+**fecha de nacimiento**. Si elegimos la opción *Comprado* entonces podremos
+elegir una fecha específica de nacimiento.
+
+Marcaremos la opción |last_cycle_active| si la madre se encuentra a mitad de
+un ciclo (aún no ha destetado o abortado).
+
+A continuación introduciremos los diferentes ciclos de la madre en orden.
+La |second_ins_date| y |third_ins_date| no son obligatorias. Si marcamos
+la opción |aborted| ya no podremos introducir más datos del ciclo.
+
+.. |arrival_date| field:: farm.animal/arrival_date
+.. |origin| field:: farm.animal/origin
+.. |initial_location| field:: farm.animal/initial_location
+.. |animal_number| field:: farm.animal/number
+.. |group_initial_qty| field:: farm.animal.group/initial_quantity
+.. |last_cycle_active| field:: farm.create_female.start/last_cycle_active
+.. |second_ins_date| field:: farm.create_female.line/second_insemination_date
+.. |third_ins_date| field:: farm.create_female.line/third_insemination_date
+.. |aborted| field:: farm.create_female.line/abort
+
+---------------
 Mover un animal
-~~~~~~~~~~~~~~~~
+---------------
 
-.. TODO
+Para mover un animal o un grupo de animals debemos accedor al menú
+*Granja / <Nombre especie> / <Tipo Animal> / Movimientos*.
 
+Primero deberemos seleccionar la |move_farm| origen del movimiento y la
+|move_date|. Una vez hayamos seleccionado el |move_animal| se nos rellenará
+automáticamente la |move_from_location|, con lo que sólo nos faltará indicar el
+|move_to_location|.
+
+.. view:: farm.farm_move_event_form_view
+
+En caso de que introduzcamos el |move_weight| del animal, se creará un registro
+de peso para el animal en la fecha del movimiento.
+
+Una vez introducida toda la información utilizaremos el botón *Validar* para
+confirmar el movimiento.
+
+.. |move_date| field:: farm.move.event/timestamp
+.. |move_animal| field:: farm.move.event/animal
+.. |move_farm| field:: farm.move.event/farm
+.. |move_from_location| field:: farm.move.event/from_location
+.. |move_to_location| field:: farm.move.event/to_location
+.. |move_weight| field:: farm.move.event/weight
+
+---------------------
 Transformar un animal
-~~~~~~~~~~~~~~~~~~~~~
+---------------------
 
-.. TODO
+La transformación de un animal consiste en cambiar su tipo. Las siguientes
+transformaciones son posibles:
 
+* Especificar el sexo de un individuo (transformándolo a macho o hembra).
+* Extraer un individuo de un grupo.
+* Extraer un macho o hembra de un grupo.
+* Añadir un individuo/macho/hembra a un grupo.
 
+Para realizar estas transformaciones debemos ir al menú
+*Granja / <Nombre especie> / <Tipo Animal Origen> / Transformaciones*.
+
+.. view:: farm.farm_transformation_event_form_view
+
+Desde allí debemos seleccionar la |transformation_farm| dónde se encuentra
+el animal/grupo actualmente y la |transformation_date|. Luego deberemos
+seleccionar el |transformation_to_animal|, dónde indicaremos el tipo de animal
+destino. En caso de que seleccionemos el tipo grupo, podremos especificar un
+grupo existente para añadir el animal al grupo. Si seleccionamos otro tipo,
+el sistema creará el animal una vez validada la transformación. Sólo nos queda
+especificar en |transformation_to_location| la ubicación dónde permanecerá
+el animal destino
+
+.. |transformation_date| field:: farm.transformation.event/timestamp
+.. |transformation_animal| field:: farm.transformation.event/animal
+.. |transformation_to_animal| field:: farm.transformation.event/to_animal_type
+.. |transformation_farm| field:: farm.transformation.event/farm
+.. |transformation_from_location| field:: farm.transformation.event/from_location
+.. |transformation_to_location| field:: farm.transformation.event/to_location
+
+------------------
 Órdenes de trabajo
-~~~~~~~~~~~~~~~~~~
+------------------
 
 Las órdenes de trabajo de los eventos de granja son una forma rápida de
 introducir un mismo tipo de evento para varios animales.
@@ -271,8 +369,9 @@ Una orden de trabajo tiene los mismos estados y flujo de trabajo que los
 eventos, ya que lo único que hace es realizar la misma transición de estado para
 todos sus eventos.
 
+--------------------
 Producción de pienso
-~~~~~~~~~~~~~~~~~~~~
+--------------------
 
 .. inheritref:: farm/farm:paragraph:produccion_pienso