diff --git a/doc/src/documento_usuario/01-introducion.rst b/doc/src/documento_usuario/01-introducion.rst index 059555001..29b65607a 100644 --- a/doc/src/documento_usuario/01-introducion.rst +++ b/doc/src/documento_usuario/01-introducion.rst @@ -5,31 +5,56 @@ Introdución A aplicación para xestión da produción do sector auxiliar do naval pretende resolver principalmente o problema da planificación nas empresas pertencentes ó sector. Para elo desenvolvéronse unha serie de funcionalidades que dan solución a certos problemas detectados durante a análise do proxecto. -A modo de resumo, poderíamos destacar os conceptos básicos cos que traballará a aplicación - * Criterios: Os criterios son unha entidade do sistema que permitirán clasificar os recursos (tanto humanos como máquinas) e as tarefas. Os recursos satisfarán criterios e por outro lado as tarefas requiren criterios para ser realizadas. - * Calendarios: Os calendarios determinarán as horas produtivas dispoñibles dos diferentes recursos. O usuario poderá crear calendarios xerais da empresa e derivar as características para calendarios máis concretos, chegando ata a nivel de calendario por recurso ou tarefa. - * Avances: A aplicación permitirá xestionar diversos tipos de avances. Un proxecto pode ser medido en porcentaxe de avance, sen embargo, pode querer ser medido en unidades, presuposto acordado, etc. Será responsabilidade da persoa que xestiona a planificación decidir qué tipo de avance será utilizado para contrastar avances a niveis superiores de proxecto. + +.. figure:: images/company_view.png + :scale: 50 + +¿Por que me é útil "______"? +============================ + +"______" é un proxecto desenvolvido co obxectivo de dotar ó usuario dunha ferramenta de planificación que se basea nunha serie de conceptos clave, os cales forman parte das características que distinguen a aplicación e a definen como unha ferramenta diseñada tendo en conta os problemas clave do sector: + + * Vista global de empresa e multiproxecto: "______" é unha aplicación orientada específicamente a dotar de información ós usuarios dos proxectos que se levan a cabo nunha empresa, polo que a base é multiproxecto. Non se determinou que o enfoque do proxecto sexa orientado individualmente a cada proxecto. Sen embargo, tamén será posible dipoñer de varias vistas específicas, entre elas a de proxectos individuais. + * Criterios: Os criterios son unha entidade do sistema que permitirán clasificar os recursos (tanto humanos como máquinas) e as tarefas. Dende o punto de vista dos recursos, estes satisfarán criterios e, dende o punto de vista das tarefas, estas requerirán criterios a ser satisfeitos. Correspóndense con un dos aspectos máis importantes da aplicación, xa que os criterios formarán parte da base das asignacións xenéricas na aplicación, resolvendo un dos problemas máis importantes para o sector, a alta temporalidade dos recursos humanos e a dificultade para ter estimacións de carga da empresa a longo prazo. * Recursos: Serán de dous tipos diferentes: humanos e máquinas. Os recursos humanos serán os traballadores da empresa que se utilizarán para controlar a carga da empresa e de uso dos mesmos. Por outro lado, as máquinas, dependentes das persoas que as xestionan, serán outros recursos que tamén serán controlables na aplicación. + * Asignación de recursos: Unha das claves é o feito de ofrecer a posibilidade de dous tipos diferentes de asignación: asignación específica e asignación xenérica. A xenérica é unha asignación baseada nos criterios que se lle establecen a unha tarefa para ser satisfeitos polos usuarios que teñen a capacidade de realizala. + * Control de carga da empresa: Baseado nos conceptos xa comentados, a aplicación dará a posibilidade de ter un control sinxelo da carga dos recursos da empresa a medio e longo prazo xa que se poderá controlar os proxectos presentes e os potenciais proxectos a futuro, visualizando as cargas en gráficos de uso de recursos. + * Etiquetas: Serán elementos que se usarán para o etiquetado das tarefas dos proxectos. Con estas etiquetas o usuario da aplicación poderá realizar agrupacións conceptuais das tarefas para posteriormente poder consultar información das mesmas de xeito agrupado e filtrado. + * Filtrados: Dado que o sistema disporá de xeito natural de elementos que etiquetan ou caracterízan tarefas e recursos, será posible utilizar filtrado de criterios ou etiquetas, o cal dotará de unha gran potencia para poder consultar información categorizada ou extraer informes específicos en base a criterios ou etiquetas. + * Calendarios: Os calendarios determinarán as horas produtivas dispoñibles dos diferentes recursos. O usuario poderá crear calendarios xerais da empresa e derivar as características para calendarios máis concretos, chegando ata a nivel de calendario por recurso ou tarefa. * Pedido e elementos de pedido: Os traballos solicitados polos clientes terán un reflexo na aplicación en forma de pedido, que se estrutura en elementos de pedido. O pedido cos seus elementos conformarán unha estrutura xerárquina en n niveis. Esta árbore de elementos será sobre a que se traballe á hora de planificar traballos. + * Avances: A aplicación permitirá xestionar diversos tipos de avances. Un proxecto pode ser medido en porcentaxe de avance, sen embargo, pode querer ser medido en unidades, presuposto acordado, etc. Será responsabilidade da persoa que xestiona a planificación decidir qué tipo de avance será utilizado para contrastar avances a niveis superiores de proxecto. * Tarefas: As tarefas son los elementos de planificación da aplicación. Serán utilizadas para temporalizar os traballos a realizar. As características máis importantes das tarefas serán: teñen dependencias entre si e poden requerir criterios a ser satisfeitos para asignar recursos. * Partes de traballo: Son os partes dos traballadores das empresas, indicando as horas traballadas e por outro lado as tarefas asignadas ás horas que un traballador realizou. Con esta información, o sistema é capaz de calcular cantas horas foron consumidas dunha tarefa con respecto ó total de horas presupostadas, permitindo contrastar os avances respecto do consumo de horas real. - * Etiquetas: Serán elementos que se usarán para o etiquetado das tarefas dos proxectos. Con estas etiquetas o usuario da aplicación poderá realizar agrupacións conceptuais das tarefas para posteriormente poder consultar información das mesmas de xeito agrupado e filtrado. +A maiores das funcionalidades que ofrece a aplicación caben destacar outras características que o distinguen de aplicacións similares: + * Integración con ERP: A aplicación importará información directamente dos ERP das empresas para os pedidos, recursos humanos, partes de traballo e certos criterios. + * Xestión de versións: A aplicación permitirá a xestión de diversas versións de planificacións e ó mesmo tempo a posibilidade de consultar a información de cada unha delas. + * Xestión de históricos: A aplicación non borra información, solo a invalida, polo que é posible consultar mediante filtrados por datas a información antiga. + +Políticas de usabilidade +======================== + +Sección en construción... Formularios -=========== +----------- Antes de realizar unha exposición das distintas funcionalidades asociadas ós módulos máis importantes, é necesario facer unha explicación xeral da filosofía de navegación e formularios. Existen 3 tipos de formularios: + * Formularios con botón de *Back*. Estes formularios forman parte de unha navegación máis completa, e os cambios que se van realizando vanse almacenando en memoria. Os cambios só se aplican cando o usuario almacena explícitamente toda pantalla dende a que chegou a dito formulario. * Formularios con botón de *Save* e *Close*. Estes formularios permiten realizar 2 operacións. A primeira delas almacena e pecha a ventana actual e a segunda delas pecha sen almacenar os cambios. * Formularios con botón de *Save*, "Save&Close" e "Close. Permiten realizar 3 operacións. A primeira delas almacena pero continúa no formulario actual. A segunda almacena e pecha o formulario. E a terceira pecha a ventana sen almacenar os cambios. Iconas e botóns estándar -======================== +------------------------ * Edición: A edición dos rexistros da aplicación poderá ser realizada xeralmente a través dunha icona formada por un Lápiz sobre unha libreta brance. * Indentado esquerda: Xeralmente estas operacións son necesarias para elementos dunha árbore que se desexan mover cara niveis internos. Esta operación poderá ser feita coa icona formada por unha frecha cara a dereita de cor verde. * Indentado dereita: Xeralmente estas operacións son necesarias para elementos dunha árbore que se desexan mover desde niveis internoscara externos. Esta operación poderá ser feita coa icona formada por unha frecha cara a esqueda de cor verde. * Borrado: Os borrados poderán ser realizados coa icona da papeleira. - \ No newline at end of file + * Procura: A lupa é unha icona que indicará que a entrada de texto á esquerda da mesma está pensada para a procura de elementos. + + + diff --git a/doc/src/documento_usuario/02-criterios.rst b/doc/src/documento_usuario/02-criterios.rst index 5a08a466b..4daf08347 100644 --- a/doc/src/documento_usuario/02-criterios.rst +++ b/doc/src/documento_usuario/02-criterios.rst @@ -6,11 +6,13 @@ Criterios Os criterios serán os elementos que se utilizarán de xeito transversal na aplicación para categorizar os recursos e ás tarefas. Un exemplo moi sinxelo de utilización de criterios é o feito de asignar a un recurso o criterio “soldador” e requirir nas tarefas que sexa necesario cumprir o criterio “soldador” para realizar asignación de recursos. No proxecto, existen varias funcionalidades a realizar con criterios: + * Administración de criterios * Asignación de criterios a recursos. * Asignación de criterios a tarefas. + * Filtrado de entidades por criterios. Será posible filtrar tarefas e elementos de pedido por criterios para realizar operacións na aplicación. Asimesmo, os informes e gráficos de cargas de recursos serán filtrables por criterios. -Das tres funcionalidades anteriores só se explicará a primeira delas nesta sección deixando para seccións posteriores os dous tipos de asignación, a de recursos na sección `Xestión de recursos`_ e a de tarefas en `Planificación de tarefas`_. +Das tres funcionalidades anteriores só se explicará a primeira delas nesta sección deixando para seccións posteriores os dous tipos de asignación, a de recursos no capitulo "Xestión de recursos" e a de tarefas no capítulo "Planificación de tarefas". Administración de criterios @@ -33,12 +35,15 @@ Premendo no botón *Create* poderase acceder ó formulario de creación/edición No formulario de edición de criterios que se amosa na imaxe anterior poderanse realizar as seguintes operacións: + * Edición do nome do criterio * Indicar se é posible asignar varios valores simultáneamente ó mesmo elemento para o tipo de criterio seleccionado. Por exemplo, un recurso que satisfai dous criterios, soldador e torneiro. * Indicar o tipo do criterio: + * Tipo xenérico: Criterio que poderá satisfacer indistintamente unha máquina ou un traballador. * Tipo traballador: Criterio que poderá satisfacer un traballador exclusivamente. * Tipo máquina: Criterio que poderá satisfacer unha máquina exclusivamente. + * Indicar se o criterio é xerárquico ou non. Existen casos nos que os criterios deben ser tratados xerárquicamente, é dicir, que o feito de ser un criterio asignado a un elemento non folla faga que este criterio estea asignado automáticamente ós fillos. Un exemplo claro de xerarquización de criterios é o criterio localización, unha persoa que teña asignado Galicia como localización pertencerá á localización España por ser xerárquico. * Indicar se o criterio está habilitado e deshabilitado. Esta é a forma de borrar criterios. Debido a que unha vez creado un criterio e utilizado en datos históricos, estes non poden ser cambiados, o criterio debe existir no sistema. Para evitar que este criterio saia en diferentes elementos de selección, poderá ser invalidado. * Realizar unha descrición do criterio. @@ -47,4 +52,7 @@ No formulario de edición de criterios que se amosa na imaxe anterior poderanse * Desplazar verticalmente os criterios na lista dos existentes. * Eliminar un valor de criterio da lista. -O formulario de administración de criterios é un formulario que responde ás características dos formularios comentados na introducción como de 3 operacións (gardar, gardar e pechar e pechar). \ No newline at end of file +O formulario de administración de criterios é un formulario que responde ás características dos formularios comentados na introducción como de 3 operacións (gardar, gardar e pechar e pechar). + + + diff --git a/doc/src/documento_usuario/03-calendarios.rst b/doc/src/documento_usuario/03-calendarios.rst index dc80e3e2b..09f140270 100644 --- a/doc/src/documento_usuario/03-calendarios.rst +++ b/doc/src/documento_usuario/03-calendarios.rst @@ -3,81 +3,104 @@ Calendarios .. contents:: -Os calendarios sern os elementos do portal que determinen as dispoibilidades para o traballo dos distintos recursos. Un calendario na aplicacin estar formado por unha serie de das anuais, cada da dispor de unha serie de horas dispoibles para o traballo. +Os calendarios serán os elementos do portal que determinen as dispoñibilidades para o traballo dos distintos recursos. Un calendario na aplicación estará formado por unha serie de días anuais, cada día disporá de unha serie de horas dispoñibles para o traballo. -Por exemplo, un festivo ter 0 horas dispoibles e, se as horas de traballo dentro dun da laboral son 8, ser este nmero o que se asignar de dispoibilidade para ese da. +Por exemplo, un festivo terá 0 horas dispoñibles e, se as horas de traballo dentro dun día laboral son 8, será este número o que se asignará de dispoñibilidade para ese día. -Administracin de calendarios +Administración de calendarios ============================= -A administracin de calendarios actuar do seguinte xeito: - * Cada da independente entre s e cada ano ten das diferentes, dicir, se se marca o 8 de Decembro de 2009 como festivo eso non quere dicir que o ano 2010 xa tea o da 8 de Decembro como festivo. - * Os das laborais mrcanse en base a das da semana, dicir, se se determina que o normal traballar 8 horas os luns, quedarn todos os luns de todas as semanas dos diferentes anos marcados como 8 horas dispoibles. - * posible marcar excepcins, dicir, elixir un da concreto no que as horas dispoibles sexan diferentes regla xeral para dito da da semana. +A administración de calendarios actuará do seguinte xeito: -A administracin de calendarios est accesible dende as operacins de "Administracin". Desde dito punto o usuario pode realizar o seguinte - 1 Crear un novo calendario dende cero. - 1 Crear un calendario derivado de outro calendario. - 1 Crear un calendario como copia de outro calendario. - 1 Editar un calendario existente. + * Cada día é independente entre sí e cada ano ten días diferentes, é dicir, se se marca o 8 de Decembro de 2009 como festivo eso non quere dicir que o ano 2010 xa teña o día 8 de Decembro como festivo. + * Os días laborais márcanse en base a días da semana, é dicir, se se determina que o normal é traballar 8 horas os luns, quedarán todos os luns de todas as semanas dos diferentes anos marcados como 8 horas dispoñibles. + * É posible marcar excepcións, é dicir, elixir un día concreto no que as horas dispoñibles sexan diferentes á regla xeral para dito día da semana. -Creacin dun novo calendario + +A administración de calendarios está accesible dende as operacións de "Administración". Desde dito punto o usuario pode realizar o seguinte + + 1. Crear un novo calendario dende cero. + 2. Crear un calendario derivado de outro calendario. + 3. Crear un calendario como copia de outro calendario. + 4. Editar un calendario existente. + +.. figure:: images/calendar-administration.png + :scale: 70 + + + +Creación dun novo calendario ---------------------------- -Para a creacin dun novo calendario necesario premer no botn "______". O sistema amosar un formulario no que o usuario poder realizar as seguintes operacins: - * Marcar as horas dispoibles para cada da da semana (luns, martes, mrcores, xoves, venres, sbados e domingos). - * Seleccionar un da especfico do calendario. - * Asignar horas como excepcin a un da especfico do calendario. +Para a creación dun novo calendario é necesario premer no botón "______". O sistema amosará un formulario no que o usuario poderá realizar as seguintes operacións: -Con estas operacins un usuario da aplicacin ten a capacidade de personalizar os calendarios completamente s sas necesidades. Para almacenar os cambios no formulario necesario premer no botn "______". + * Marcar as horas dispoñibles para cada día da semana (luns, martes, mércores, xoves, venres, sábados e domingos). + * Seleccionar un día específico do calendario. + * Asignar horas como excepción a un día específico do calendario. + +Con estas operacións un usuario da aplicación ten a capacidade de personalizar os calendarios completamente ás súas necesidades. Para almacenar os cambios no formulario é necesario premer no botón "______". + +.. figure:: images/calendar-edition.png + :scale: 70 -Creacin dun calendario derivado + +Creación dun calendario derivado -------------------------------- -Un calendario derivado un calendario que se crea como derivacin dun existente, dicir, herda todas as caractersticas do orixinal e mesmo tempo posible modificalo para que contea as sas particularidades. +Un calendario derivado é un calendario que se crea como derivación dun existente, é dicir, herda todas as características do orixinal e ó mesmo tempo é posible modificalo para que conteña as súas particularidades. -Un exemplo de uso de calendarios derivados a existencia dun calendario xeral para Espaa e a creacin dun derivado para s incluir os 2 festivos galegos sobre o xeral. +Un exemplo de uso de calendarios derivados é a existencia dun calendario xeral para España e a creación dun derivado para só incluir os 2 festivos galegos sobre o xeral. - importante destacar que ante calquera modificacin realizada sobre o calendario orixinal o calendario derivado ser directamente afectado, sempre e cando, non se definira unha actuacin concreta sobre el mesmo. Por exemplo, no calendario de Espaa inclese un da laboral no 17 de Maio con 8 horas de traballo e no calendario galego, que se creou como derivacin, o da 17 de Maio considerado un da de 0 horas de traballo por ser festivo. Se sobre o calendario espaol se cambian os das da semana do 17 Maio para que as horas dispoibles sexan 4 diarias, no galego o que suceder que todos os das da semana do 17 de Maio tern 4 horas dispoibles excepto o mesmo da 17 que ter 0 horas, tal e como explcitamente se establecera antes. +É importante destacar que ante calquera modificación realizada sobre o calendario orixinal o calendario derivado será directamente afectado, sempre e cando, non se definira unha actuación concreta sobre el mesmo. Por exemplo, no calendario de España inclúese un día laboral no 17 de Maio con 8 horas de traballo e no calendario galego, que se creou como derivación, o día 17 de Maio é considerado un día de 0 horas de traballo por ser festivo. Se sobre o calendario español se cambian os días da semana do 17 Maio para que as horas dispoñibles sexan 4 diarias, no galego o que sucederá é que todos os días da semana do 17 de Maio terán 4 horas dispoñibles excepto o mesmo día 17 que terá 0 horas, tal e como explícitamente se establecera antes. -Para crear un calendario derivado na aplicacin, necesario facer o seguinte: - * Acceder men de *Administracin*. - * Premer na operacin de administracin de calendarios. - * Elixir un dos calendarios sobre o que se desexa realizar un derivado e premer no botn "______". - * Unha vez realizada esta operacin o sistema amosar un formulario de edicin coas mesmas caractersticas que os formularios para crear calendarios dende cero, coa diferencia de que as excepcins e as horas por da da semana se propoen en base calendario orixinal. +.. figure:: images/calendar-create-derived.png + :scale: 70 -Creacin dun calendario por copia +Para crear un calendario derivado na aplicación, é necesario facer o seguinte: + + * Acceder ó menú de *Administración*. + * Premer na operación de administración de calendarios. + * Elixir un dos calendarios sobre o que se desexa realizar un derivado e premer no botón "______". + * Unha vez realizada esta operación o sistema amosará un formulario de edición coas mesmas características que os formularios para crear calendarios dende cero, coa diferencia de que as excepcións e as horas por día da semana se propoñen en base ó calendario orixinal. + +Creación dun calendario por copia --------------------------------- -Un calendario copiado un calendario que se crea como copia exacta de outro existente, dicir, que recibe todas as caractersticas do orixinal e mesmo tempo posible modificalo para que contea as sas particularidades. +Un calendario copiado é un calendario que se crea como copia exacta de outro existente, é dicir, que recibe todas as características do orixinal e ó mesmo tempo é posible modificalo para que conteña as súas particularidades. -A diferencia entre copiar e derivar un calendario radica nos cambios no orixinal. No caso de copias, se o orixinal modificado, non afectar copia, sen embargo, cando se deriva, s afecta fillo. +A diferencia entre copiar e derivar un calendario radica nos cambios no orixinal. No caso de copias, se o orixinal é modificado, non afectará á copia, sen embargo, cando se deriva, sí afecta ó fillo. -Un exemplo de uso de calendario por copia o dispor de un calendario para Pontevedra e necesitar un calendario para A Corua onde a maiora das caractersticas son as mesmas sen embargo, non se espera que os cambios nun afecten outro. +Un exemplo de uso de calendario por copia é o dispor de un calendario para Pontevedra e necesitar un calendario para A Coruña onde a maioría das características son as mesmas sen embargo, non se espera que os cambios nun afecten ó outro. -Para crear un calendario copiado na aplicacin, necesario facer o seguinte: - * Acceder men de *Administracin*. - * Premer na operacin de administracin de calendarios. - * Elixir un dos calendarios sobre o que se desexa realizar un derivado e premer no botn "______". - * Unha vez realizada esta operacin o sistema amosar un formulario de edicin coas mesmas caractersticas que os formularios para crear calendarios dende cero, coa diferencia de que as excepcins e as horas por da da semana se propoen en base calendario orixinal. +Para crear un calendario copiado na aplicación, é necesario facer o seguinte: -Asignacin de calendario a recursos + * Acceder ó menú de *Administración*. + * Premer na operación de administración de calendarios. + * Elixir un dos calendarios sobre o que se desexa realizar un derivado e premer no botón "______". + * Unha vez realizada esta operación o sistema amosará un formulario de edición coas mesmas características que os formularios para crear calendarios dende cero, coa diferencia de que as excepcións e as horas por día da semana se propoñen en base ó calendario orixinal. + +Asignación de calendario a recursos ----------------------------------- -Un recurso poder recibir como asignacin un calendario existente ou un calendario creado especficamente para o recurso. En calquera dos casos, unha vez se asigna un calendario a un recurso, posible realizar modificacins especficas para ese recurso. +Un recurso poderá recibir como asignación un calendario existente ou un calendario creado específicamente para o recurso. En calquera dos casos, unha vez se asigna un calendario a un recurso, é posible realizar modificacións específicas para ese recurso. Os casos posibles son: - * *Creacin de un calendario para o recurso a partir de cero*. Neste caso, o calendario ser nicamente para o recurso e calqueira caracterstica que se lle desexe asignar deber ser modificada no propio calendario do recurso. - * *Creacin de un calendario para o recurso como copia de calendario existente*. O calendario recoller dende un principio as especificidades do calendario orixinal, sen embargo, unha vez asignado, deber ser modificado dende o propio recurso. - * *Creacin de un calendario para o recurso como derivado de calendario existente*. O calendario recoller dende un principio as especificidades do calendario orixinal e, mesmo tempo, se o calendario orixinal modificado para todos, o propio recurso recibir esas modificacins de xeito indirecto, tal e como se comentou na seccin de calendarios derivados. -Para asignar un calendario a un recurso necesario dar os seguintes pasos: - * Acceder edicin de recursos. + * *Creación de un calendario para o recurso a partir de cero*. Neste caso, o calendario será únicamente para o recurso e calqueira característica que se lle desexe asignar deberá ser modificada no propio calendario do recurso. + * *Creación de un calendario para o recurso como copia de calendario existente*. O calendario recollerá dende un principio as especificidades do calendario orixinal, sen embargo, unha vez asignado, deberá ser modificado dende o propio recurso. + * *Creación de un calendario para o recurso como derivado de calendario existente*. O calendario recollerá dende un principio as especificidades do calendario orixinal e, ó mesmo tempo, se o calendario orixinal é modificado para todos, o propio recurso recibirá esas modificacións de xeito indirecto, tal e como se comentou na sección de calendarios derivados. + +Para asignar un calendario a un recurso é necesario dar os seguintes pasos: + + * Acceder á edición de recursos. * Seleccionar a pestana de "______". - * A partir da pestana anterior aparecer un formulario de edicin de calendarios que permitir: - * Crear un calendario dende cero premendo no botn "______". - * Crear un calendario derivado premendo no botn "______". - * Crear un botn como copia premendo no botn "______". - * O sistema amosar un formulario de edicin de calendarios cos datos cargados en base opcin elixida no paso anterior. - * Para almacenar necsario premer en SAve???? + * A partir da pestana anterior aparecerá un formulario de edición de calendarios que permitirá: + * Crear un calendario dende cero premendo no botón "______". + * Crear un calendario derivado premendo no botón "______". + * Crear un botón como copia premendo no botón "______". + * O sistema amosará un formulario de edición de calendarios cos datos cargados en base á opción elixida no paso anterior. + * Para almacenar é necsario premer en Save. + + + diff --git a/doc/src/documento_usuario/04-avances.rst b/doc/src/documento_usuario/04-avances.rst index 79d57bdd8..47d6edec1 100644 --- a/doc/src/documento_usuario/04-avances.rst +++ b/doc/src/documento_usuario/04-avances.rst @@ -3,75 +3,89 @@ Avances .. contents:: -O avance dun proxecto marca o grao no que se est cumplindo co alcance estimado para a realizacin do mesmo, asimesmo, o avance dunha tarefa indica ese mesmo grao para o alcance estimado para dita tarefa. +O avance dun proxecto marca o grao no que se está cumplindo co alcance estimado para a realización do mesmo, asimesmo, o avance dunha tarefa indica ese mesmo grao para o alcance estimado para dita tarefa. -Xeralmente os avances non teen un modo automtico de ser medidos, e unha persoa quen en base experiencia ou realizacin de unha lista de chequeo determina o grao de complecin de unha tarefa ou un proxecto. +Xeralmente os avances non teñen un modo automático de ser medidos, e é unha persoa quen en base á experiencia ou á realización de unha lista de chequeo determina o grao de compleción de unha tarefa ou un proxecto. -Cabe destacar que hai unha diferencia importante entre a uso de horas asignadas a unha tarefa ou proxecto, co grao de avance nesa mesma tarefa ou proxecto. Mentres que o uso de horas pode estar en desvo ou non, o proxecto pode estar nun grao de avance inferior estimado para o da no que se est controlando ou superior. Prodcense, debido a estas das medidas, varias posibles situacins: - * Consumronse menos horas das estimadas para o elemento a medir e mesmo tempo o proxecto est indo mis lento do estimado, porque o avance inferior estimado para o da de control. - * Consumronse menos horas das estimadas para o elemento a medir e mesmo tempo o proxecto est indo mis rpido do estimado, porque o avance inferior estimado para o da de control. - * Consumronse mis horas das estimadas e mesmo tempo o proxecto est indo mis lento do estimado, porque o avance inferior estimado para o da de control. - * Consumronse mis horas das estimadas e mesmo tempo o proxecto est indo mis rpido do estimado, porque o avance inferior estimado para o da de control. +Cabe destacar que hai unha diferencia importante entre a uso de horas asignadas a unha tarefa ou proxecto, co grao de avance nesa mesma tarefa ou proxecto. Mentres que o uso de horas pode estar en desvío ou non, o proxecto pode estar nun grao de avance inferior ó estimado para o día no que se está controlando ou superior. Prodúcense, debido a estas dúas medidas, varias posibles situacións: -O contraste de estas posibles situacins posible realizalo dende a propia planificacin, utilizando informacin do grao de avance e por outro lado do grao de uso de horas. Neste captulo tratarase a introducin da informacin para poder levar un control do avance. + * Consumíronse menos horas das estimadas para o elemento a medir e ó mesmo tempo o proxecto está indo máis lento do estimado, porque o avance é inferior ó estimado para o día de control. + * Consumíronse menos horas das estimadas para o elemento a medir e ó mesmo tempo o proxecto está indo máis rápido do estimado, porque o avance é inferior ó estimado para o día de control. + * Consumíronse máis horas das estimadas e ó mesmo tempo o proxecto está indo máis lento do estimado, porque o avance é inferior ó estimado para o día de control. + * Consumíronse máis horas das estimadas e ó mesmo tempo o proxecto está indo máis rápido do estimado, porque o avance é inferior ó estimado para o día de control. -A filosofa implantada no proxecto para o control do avance est baseada en que o usuario divida ata o punto no que desexa o control de avances dos seus proxectos. En consecuencia, se o usuario desexa controlar a nivel de pedido, s debe introducir informacin nos elementos de nivel 1, cando se desexa poder dispoer de un control mis fino sobre as tarefas, debe introducir informacin de avances en niveis inferiores, sendo o sistema que propaga cara arriba na xerarqua todos os datos. +O contraste de estas posibles situacións é posible realizalo dende a propia planificación, utilizando información do grao de avance e por outro lado do grao de uso de horas. Neste capítulo tratarase a introdución da información para poder levar un control do avance. -Xestin de tipos de avance --------------------------- -Cada empresa pode ter unhas necesidades diferentes de control do avance dos seus proxectos, e concretamente das tarefas que os compoen, por esta razn foi necesario contemplar a existencia dunhas entidades no sistema chamadas "tipos de avance". Os tipos de avance son diferentes tipoloxas que cada usuario pode dar de alta no sistema para medir o avance dunha tarefa. Por exemplo, unha tarefa pode ser medida porcentualmente, pero mesmo tempo ese avance porcentual se traduce en un avance en *Toneladas* sobre o acordado co cliente. +A filosofía implantada no proxecto para o control do avance está baseada en que o usuario divida ata o punto no que desexa o control de avances dos seus proxectos. En consecuencia, se o usuario desexa controlar a nivel de pedido, só debe introducir información nos elementos de nivel 1, cando se desexa poder dispoñer de un control máis fino sobre as tarefas, debe introducir información de avances en niveis inferiores, sendo o sistema que propaga cara arriba na xerarquía todos os datos. -Un tipo de avance est caracterizado por un nome, un valor mximo e unha precisin: - * Nome: Ser un nome representativo que o usuario debe recordar para cando seleccione a asignacin de avances sexa capaz de entender qu tipo de avance est medindo. - * Valor mximo: o valor mximo que se lle permitir a unha tarefa ou proxecto establecer como medida total de avance. Por exemplo, traballando con *Toneladas*, se se considera que o mximo normal en toneladas de 4000 e nunca vai a haber tarefas que requiran realizar mis de 4000 toneladas de algn material, ese debera ser o valor mximo establecido. - * Precisin: o valor dos incrementos que se permitirn para o tipo de avance creado. Por exemplo, se o avance en *Toneladas* se vai a medir en valores redondeados, podera ser 1 a precisin. Dende ese momento, s se poderan introducir medidas de avance con nmeros enteiros, por exemplo, 1, 2, 300, etc. +Xestión de tipos de avance +========================== + +Cada empresa pode ter unhas necesidades diferentes de control do avance dos seus proxectos, e concretamente das tarefas que os compoñen, por esta razón foi necesario contemplar a existencia dunhas entidades no sistema chamadas "tipos de avance". Os tipos de avance son diferentes tipoloxías que cada usuario pode dar de alta no sistema para medir o avance dunha tarefa. Por exemplo, unha tarefa pode ser medida porcentualmente, pero ó mesmo tempo ese avance porcentual se traduce en un avance en *Toneladas* sobre o acordado co cliente. + +Un tipo de avance está caracterizado por un nome, un valor máximo e unha precisión: + + * Nome: Será un nome representativo que o usuario debe recordar para cando seleccione a asignación de avances sexa capaz de entender qué tipo de avance está medindo. + * Valor máximo: É o valor máximo que se lle permitirá a unha tarefa ou proxecto establecer como medida total de avance. Por exemplo, traballando con *Toneladas*, se se considera que o máximo normal en toneladas é de 4000 e nunca vai a haber tarefas que requiran realizar máis de 4000 toneladas de algún material, ese debería ser o valor máximo establecido. + * Precisión: É o valor dos incrementos que se permitirán para o tipo de avance creado. Por exemplo, se o avance en *Toneladas* se vai a medir en valores redondeados, podería ser 1 a precisión. Dende ese momento, só se poderían introducir medidas de avance con números enteiros, por exemplo, 1, 2, 300, etc. O sistema conta con dous tipos de avance creados por defecto: - * Porcentual: Tipo de avance xeral que permite medir o avance dun proxecto ou tarefa en base porcentaxe que se estima de complecin do mesmo, por exemplo, unha tarefa est 30% respecto 100% estimado nun da concreto. - * Unidades: Tipo de avance xeral que permite medir o avance en unidades sen necesidade de especificar as unidades concretas. A tarefa comprenda a creacin de 3000 unidades e o avance son 500 unidades sobre as 3000 estimadas. + + * Porcentual: Tipo de avance xeral que permite medir o avance dun proxecto ou tarefa en base ó porcentaxe que se estima de compleción do mesmo, por exemplo, unha tarefa está ó 30% respecto ó 100% estimado nun día concreto. + * Unidades: Tipo de avance xeral que permite medir o avance en unidades sen necesidade de especificar as unidades concretas. A tarefa comprendía a creación de 3000 unidades e o avance son 500 unidades sobre as 3000 estimadas. .. figure:: images/tipos-avances.png :scale: 70 -O usuario poder crear novos tipos de avance do seguinte xeito: - * O usuario accede seccin de "Administracin". - * Preme na opcin do men de segundo nivel "______". +O usuario poderá crear novos tipos de avance do seguinte xeito: + + * O usuario accede á sección de "Administración". + * Preme na opción do menú de segundo nivel "______". * O sistema amosa un listado de tipos de avance existentes. - * Con cada tipo de avance o usuario poder: + * Con cada tipo de avance o usuario poderá: + * Editar * Borrar - * A maiores, o usuario poder crear un tipo de avance novo. - * Coa edicin ou a creacin, o sistema amosar un formulario coa seguinte informacin: + + * A maiores, o usuario poderá crear un tipo de avance novo. + * Coa edición ou a creación, o sistema amosará un formulario coa seguinte información: + * Nome do tipo de avance. - * Valor mximo que acepta o tipo de avance. + * Valor máximo que acepta o tipo de avance. * Precision di tipo de avance. -Introducin de avances en base a tipo -------------------------------------- +Introdución de avances en base a tipo +===================================== -A introducin dos avances vaise realizar sobre os elementos de pedido, sen embargo, ser posible facelo con un atallo dende as tarefas de planificacin. Ser responsabilidade do usuario da aplicacin a decisin sobre qu tipos de avance desexa asociar a cada elemento de pedido. +A introdución dos avances vaise realizar sobre os elementos de pedido, sen embargo, será posible facelo con un atallo dende as tarefas de planificación. Será responsabilidade do usuario da aplicación a decisión sobre qué tipos de avance desexa asociar a cada elemento de pedido. -Ser posible introducir un tipo de avance nico e defectivo para todo un pedido. +Será posible introducir un tipo de avance único e defectivo para todo un pedido. -Antes de poder realizar medidas de avance, necesario asociar o tipo elixido pedido, por exemplo, un avance de tipo porcentaxe para medir porcentualmente os avances realizados sobre o total da tarefa ou un avance de tipo pactado por se se queren introducir a futuro medicins de avances pactadas co cliente. +Antes de poder realizar medidas de avance, é necesario asociar o tipo elixido ó pedido, por exemplo, un avance de tipo porcentaxe para medir porcentualmente os avances realizados sobre o total da tarefa ou un avance de tipo pactado por se se queren introducir a futuro medicións de avances pactadas co cliente. .. figure:: images/avance.png :scale: 70 -Para introducir medicins de avance ser necesario realizar o seguinte: +Para introducir medicións de avance será necesario realizar o seguinte: + * Seleccionar o tipo de avance para o que desexa introducir o avance. - * Se non existe ningn tipo de avance necesario engadir un tipo de avance. - * No formulario que aparece debaixo cos campos "______" e "______" introducir o valor absoluto da medida e a data que se lle desexa asignar medida tomada. - * O sistema almacenar automticamente os datos introducidos. + + * Se non existe ningún tipo de avance é necesario engadir un tipo de avance. + + * No formulario que aparece debaixo cos campos "______" e "______" introducir o valor absoluto da medida e a data que se lle desexa asignar á medida tomada. + * O sistema almacenará automáticamente os datos introducidos. Contraste de avances sobre un elemento do pedido ------------------------------------------------- +================================================ -Ser posible contrastar grficamente as evolucins dos avances dos pedidos en base s medicins realizadas. Cada tipo de avance dispn dunha columna con botns de chequeo (de ttulo "______") o cal ser marcado se amosar a grfica de evolucins de medidas realizadas sobre o elemento de pedido. +Será posible contrastar gráficamente as evolucións dos avances dos pedidos en base ás medicións realizadas. Cada tipo de avance dispón dunha columna con botóns de chequeo (de título "______") o cal ó ser marcado se amosará a gráfica de evolucións de medidas realizadas sobre o elemento de pedido. .. figure:: images/contraste-avance.png :scale: 70 + + + diff --git a/doc/src/documento_usuario/05-recursos.rst b/doc/src/documento_usuario/05-recursos.rst index 7436adf2c..f6c0225be 100644 --- a/doc/src/documento_usuario/05-recursos.rst +++ b/doc/src/documento_usuario/05-recursos.rst @@ -1,42 +1,45 @@ -Xestin de recursos +Xestión de recursos ################### .. _recursos: .. contents:: -Xestin de recursos -=================== +A aplicación xestiona dous tipos de recursos diferentes: recursos traballadores e recursos máquinas. -A aplicacin xestiona dous tipos de recursos diferentes: recursos traballadores e recursos mquinas. +Os recursos traballadores representan os traballadores das empresas. As características principais son: -Os recursos traballadores representan os traballadores das empresas. As caractersticas principais son: - * Satisfarn un ou varios criterios de tipo xenrico ou tipo traballador. - * Son asignables especficamente a unha tarefa. - * Son asignables como parte da asignacin xenrica a unha tarefa que requira un criterio que satisfai o traballador. - * Disporn de un calendario por defecto ou especfico se as o decide o usuario. + * Satisfarán un ou varios criterios de tipo xenérico ou tipo traballador. + * Son asignables específicamente a unha tarefa. + * Son asignables como parte da asignación xenérica a unha tarefa que requira un criterio que satisfai o traballador. + * Disporán de un calendario por defecto ou específico se así o decide o usuario. -Os recursos mquina representan as mquinas das empresas. As caractersticas principais son: - * Satisfarn un ou varios criterios de tipo xenrico ou tipo mquina. - * Son asignables especficamente a unha tarefa. - * Son asignables como parte da asignacin xenrica a unha tarefa que requira un criterio que satisfai a mquina. - * Disporn de un calendario por defecto ou especfico se as o decide o usuario. - * Contar un unha pantalla de configuracin na que se poder establecer un valor *alfa* que represente a relacin entre mquina e traballador. - * O *alfa* representa canto tempo dun traballador necesario para que a mquina funcione. Por exemplo, un alfa de 0.5 indica que de cada 8 horas de mquina son necesarias 4 de un traballador. - * posible asignar un *alfa* de xeito especfico a un traballador, dicir, elxese o traballador que estar ocupado esa porcentaxe do seu tempo coa mquina. - * Ou ben, posible facer unha asignacin xenrica en base a un criterio, de xeito que se asigna unha porcentaxe do uso a todos os criterios que satisfn ese criterio e teen tempo dispoible. O funcionamento da asignacin xenrica ser a mesma que a explicada para asignacins xenricas a tarefas. +Os recursos máquina representan as máquinas das empresas. As características principais son: -O usuario poder crear, editar e invalidar (nunca borrar definitivamente) traballadores da empresa dende a pestana de "Recursos". Dende dita pestana existen as seguintes operacins: - * Listado de traballadores: Os traballadores amosaranse listados e paxinados, dende onde podern xestionar os seus datos. - * Listado de mquinas: As mquinas amosaranse listados e paxinados, dende onde podern xestionar os seus datos. + * Satisfarán un ou varios criterios de tipo xenérico ou tipo máquina. + * Son asignables específicamente a unha tarefa. + * Son asignables como parte da asignación xenérica a unha tarefa que requira un criterio que satisfai a máquina. + * Disporán de un calendario por defecto ou específico se así o decide o usuario. + * Contará un unha pantalla de configuración na que se poderá establecer un valor *alfa* que represente a relación entre máquina e traballador. -Xestin de traballadores ------------------------- + * O *alfa* representa canto tempo dun traballador é necesario para que a máquina funcione. Por exemplo, un alfa de 0.5 indica que de cada 8 horas de máquina son necesarias 4 de un traballador. + * É posible asignar un *alfa* de xeito específico a un traballador, é dicir, elíxese o traballador que estará ocupado esa porcentaxe do seu tempo coa máquina. + * Ou ben, é posible facer unha asignación xenérica en base a un criterio, de xeito que se asigna unha porcentaxe do uso a todos os criterios que satisfán ese criterio e teñen tempo dispoñible. O funcionamento da asignación xenérica será a mesma que a explicada para asignacións xenéricas a tarefas. -A xestin de traballadores realizarase dende a pestana de "Recursos" e a operacin de "______". Dende a lista de recursos posible editar cada un dos traballadores premendo na icona estndar de edicin. +O usuario poderá crear, editar e invalidar (nunca borrar definitivamente) traballadores da empresa dende a pestana de "Recursos". Dende dita pestana existen as seguintes operacións: -Unha vez na edicin dun recurso, o usuario poder: + * Listado de traballadores: Os traballadores amosaranse listados e paxinados, dende onde poderán xestionar os seus datos. + * Listado de máquinas: As máquinas amosaranse listados e paxinados, dende onde poderán xestionar os seus datos. + +Xestión de traballadores +======================== + + +A xestión de traballadores realizarase dende a pestana de "Recursos" e a operación de "______". Dende a lista de recursos é posible editar cada un dos traballadores premendo na icona estándar de edición. + +Unha vez na edición dun recurso, o usuario poderá acceder ás seguintes pestanas: + +1) Pestana de datos de traballador. Esta pestana permitirá editar os datos básicos de identificación do traballador. -1) Editar os datos bsicos de identificacin do traballador. * Nome * Apelidos * DNI @@ -44,27 +47,72 @@ Unha vez na edici .. figure:: images/worker-personal-data.png :scale: 70 +2) Pestana de criterios. Dende este punto poderase configurar os criterios que un traballador satisfai. O usuario poderá asignar calquera valor de criterio de tipo traballador ou xenérico que así considere a un traballador. É importante, para que a aplicación sexa utilizada en todo o seu valor, que os traballadores satisfagan criterios. Para asignar criterios o usuario debe: -2) Configurar os criterios que un traballador satisfai. O usuario poder asignar calquera valor de criterio de tipo traballador ou xenrico que as considere a un traballador. importante, para que a aplicacin sexa utilizada en todo o seu valor, que os traballadores satisfagan criterios. Para asignar criterios o usuario debe: + i. Premer no botón "______". - i. Buscar o criterio que desexa engadir e seleccionar o que encaixe coa sa procura. + ii. Buscar o criterio que desexa engadir e seleccionar o que encaixe coa súa procura. - ii. Premer no botn de engadir. + iii. Premer no botón de engadir. - iii. Seleccionar data de inicio do criterio dende o momento que deba aplicarse. + iv. Seleccionar data de inicio do criterio dende o momento que deba aplicarse. - iv. Seleccionar a data de fin de aplicacin do criterio recurso. + v. Seleccionar a data de fin de aplicación do criterio ó recurso. Dita data non é obrigatoria indicando que o criterio é indefinido. .. figure:: images/worker-criterions.png :scale: 70 -3) Configurar un calendario especfico para o traballador. +3) Pestana de calendario. Pestana dende a que se pode configurar un calendario específico para a máquina. Cada máquina disporá de un calendario por defecto asignado, sen embargo, será posible asignar un calendario específico para cada un a partir da creación dun baleiro, copia a partir dun existente ou creación a partir dun calendario derivado. .. figure:: images/worker-calendar.png :scale: 70 +A asignación de recursos explícase na sección de asignación de recursos. -Xestin de mquinas -------------------- +Xestión de máquinas +=================== + +As máquinas son recursos a todos os efectos, polo cal, tal e como sucede cos traballadores, as máquinas serán administrables e asignables a tarefas. A asignación de recursos tratarase na sección de asignación. Neste punto explicaranse as características específicas das máquinas. + +As máquinas son administradas dende a sección de recursos. En dita sección existe unha operación chamada "Listado de máquinas" que permitirá a visualización das máquinas que dipoñen nunha empresa. A partir deste listado poderáse editar ou borrar unha máquina. + + +A edición dunha máquina o sistema maosará unha serie de pestanas dende as cales se permitirá administrar a seguinte información: +1) Pestana de datos da máquina. Pestana para a eEdición de datos identificativos das máquinas. Os datos modificables nesta pestana son: + + i Nome. + ii Código da máquina. + iii Descrición da máquina. + + +.. figure:: images/machine-data.png + :scale: 70 + + +2) Pestana de criterios. Tal e como se comentou na anterior sección de recursos traballadores, esta será a pestana na que se poden engadir criterios que satisfán as diversas máquinas do sistema. Os criterios que serán asignables ás máquinas serán aqueles que se identificaran como criterios de máquina ou xenéricos. Non se poderán asignar criterios de traballadores. Para asignar criterios o usuario deberá: + + i. Premer no botón "______". + + ii. Buscar o criterio que desexa engadir e seleccionar o que encaixe coa súa procura. + + iii. Premer no botón de engadir. + + iv. Seleccionar data de inicio do criterio dende o momento que deba aplicarse. + + v. Seleccionar a data de fin de aplicación do criterio ó recurso. Dita data non é obrigatoria indicando que o criterio é indefinido. + +.. figure:: images/machine-criterions.png + :scale: 70 + +3) Pestana de calendario. Pestana dende a que se pode configurar un calendario específico para a máquina. Cada máquina disporá de un calendario por defecto asignado, sen embargo, será posible asignar un calendario específico para cada un a partir da creación dun baleiro, copia a partir dun existente ou creación a partir dun calendario derivado. + + +.. figure:: images/machine-calendar.png + :scale: 70 + +4) Pestana de configuración de máquinas: Dende esta pestana será posible configurar a relación das máquinas cos recursos traballadores existentes. Unha máquina disporá de un alfa que indicará a relación entre a máquina e os recursos implicados, tal e como xa se comentou, un alfa de 0.5 indicará que se consumirá traballo de 0.5 persoas para cada xornada completa de máquina. O sistema, a partir dun alfa, crea automáticamente asignacións á traballadores que estean dalgún xeito relaciondao coa máquina unha vez se asigna unha máquina a unha tarefa. A forma de relacionar un traballador con unha máquina pódese facer de dous xeitos: + + i Asignando específicamente un rango de datas nas que o traballador se desexa asignar a unha máquina. Será unha asignación específica de modo que o sistema asignará automáticamente horas ó traballador cando se planifique a máquina. + ii Asignando específicamente criterios que se desexa satisfagan os traballadores que sexan asignados ás máquinas. Deste xeito farase unha asignación xenérica ós traballadores que satisfan os criterios. diff --git a/doc/src/documento_usuario/06-pedidos.rst b/doc/src/documento_usuario/06-pedidos.rst index 88b0826d8..caa8490a3 100644 --- a/doc/src/documento_usuario/06-pedidos.rst +++ b/doc/src/documento_usuario/06-pedidos.rst @@ -3,5 +3,123 @@ Pedidos e elementos de pedidos .. contents:: -Contidos... +Os pedidos son as entidades que describirán os traballos a realizar por parte dos usuarios que utilicen a aplicación. +Cada pedido corresponderase cos proxectos que as empresas van a ofrecerlles ós seus clientes. +Un pedido está formado por unha ou varias liñas de pedido. Cada liña de pedido corresponderase coa estructuración que se desexe realizar sobre os traballos dentro dese pedido. As liñas de pedido organizanse de xeito xerárquico sen limitacións de profundidade. O feito de que as liñas de pedido se organicen de xeito xerárquico marcará o funcionamento de diversas características herdables, tal como as etiquetas. + +Nas seguintes seccións describiranse as operacións que un usuario pode realizar cos pedidos e as liñas de pedidos. + +Pedido +====== + +Un pedido é un proxecto ou traballo que un cliente lle solicita a unha empresa. O pedido para o planificador identifica a entidade de proxecto dentro da empresa. A diferencia das aplicacións de xestión globais, "______" só necesita utilizar certos datos dos pedidos. Estes datos son: + + * Nome do pedido + * Código do pedido. + * Importe total do pedido + * Data de comezo estimada + * Data de finalización + * Responsable + * Cliente + * Descrición + * Outros campos ainda por decidir... + +Para editar ou crear un pedido é posible realizalo dende varios puntos da aplicación: + + * Accedendo á pestana de pedidos dentro da vista global de empresa. + * Accedendo a un pedido no diagrama de Gantt e cambiando de perpectiva á de edición de pedido. + + +Dende a edición de pedido é posible acceder a dúas pestanas: + + * Edición dos datos de pedidos. Dende dita pantalla é posible editoar os datos básicos do pedido. Actualmente: + + * Nome + * Código + * Data de comezo estimada + * Data de finalización + * Responsable + * Cliente + * Descrición + +.. figure:: images/order-edition.png + :scale: 70 + + * Listado de elementos de pedido. Dende o listado de elenentos de pedido é posible realizar varias operacións: + + * Crear novos elementos de pedido. + * Subir nun mesmo nivel da xerarquía un elemento de pedido. + * Baixar nun mesmo nivel da xerarquía un elemento de pedido. + * Indentar un elemento de pedido, ou o que é o mesmo mover cara abaixo na xerarquía, cambiando de nivel o elemento. + * Des-indentar un elemento de pedido, ou o que é o mesmo mover cara arriba na xerarquía, cambiando de nivel o elemento. + * Filtrar os elementos de pedido. + * Borrar elementos de pedido. + * Mover arrastrando e soltando un elemento de pedido na xerarquía. + +.. figure:: images/order-elements-list.png + :scale: 70 + + + +Edición de elementos de pedido +=============================== + +A edición de elementos de pedido realizarase dende a pestana de listado de elementos de pedido a partir da icona de edición. Se o usuario preme na icona de edición, o sistema amosa unha nova pantalla dende a que o usuario pode realizar o seguinte: + + * Editar a información do elemento de pedido. + * Xestionar os avances dos elementos de pedido. + * Xestionar as etiquetas do pedido. + * Visualización de horas imputadas a elemento de pedido. + +Edición da información do elemento de pedido +-------------------------------------------- + +A edición de información de elemento de pedido inclúe a edición dos seguintes datos: + + * Nome do elemento de pedido. + * Código do elemento de pedido. + * Data de inicio do elemento de pedido. + * Data estimada de fin do elemento de pedido. + * Horas totais do elemento de pedido. Estas horas poden ser calculadas a partir dos grupos de horas engadidas ou introducidas directamente neste punto que se repartiran entre os grupos de horas, creando algún novo se as porcentaxes non coinciden coas porcentaxes iniciais. + * **Grupos de horas**: É posible engadir un ou varios grupos de horas ó elemento de pedido. **O significado destes grupos de horas** é o establecemento dos requirimentos que se lle esixirán ós recursos que vaian a ser asignados para realizalas. + * Criterios: É posible engadir criterios que se deben satisfacer para poder se asignado xenéricamente para realizar dito elemento de pedido. + +.. figure:: images/order-edition.png + :scale: 70 + + +Xestión de avances dos elementos de pedido +------------------------------------------ + +A introdución de tipos de avances e xestión dos avances dos elementos de pedido foi descrita no capítulo de "Avances". + +Xestión de etiquetas do pedido +------------------------------ + +As etiquetas, tal e como se describen no capítulo adicado ás mesmas, son entidades que permiten categorizar os elementos de pedido. Deste xeito, o usuario poderá agrupar información de planificación ou pedidos en base a elas. + +Un usuario pode asignar etiquetas directamente a un elemento de pedido ou ben a un ascendente na xerarquía dese elemento de pedido. A partir do momento no que se asignar unha etiqueta dun dos dous xeitos anteriores, tanto o elemento de pedido como a tarefa de planificación asociada estarán asociadas a dita etiqueta, sendo utilizadas para posteriores filtrados. + +.. figure:: images/order-element-tags.png + :scale: 70 + +Tal e como se pode ver na imaxe, dende a pestana de **etiquetas**, o usuario poderá realizar as seguintes operacións: + + * Visualización das etiquetas que un elemento do pedido terá asociadas por herdanza dun elemento de pedido superior na xerarquía á que lle foi asignada directamente. A tarefa de planificación asociada a cada elemento de pedido terá as mesmas etiquetas asociadas. + * Visualización das etiquetas que un elemento do pedido ten asociadas directamente a través do seguinte formulario de asignación de etiquetas inferior. + * Asignar etiquetas existentes: Un usuario poderá asignar etiquetas existentes a partir da procura dunha entre as existentes no formulario inferior ó listado de etiquetas directas. Para buscar unha etiqueta chega con premer na icona coa lupa ou escribir o inicio da etiqueta na entrada de texto para que o sistema amose as opcións dispoñibles. + * Crear e asignar etiquetas novas: Un usuario poderá crear novas etiquetas asociadas a un tipo de etiquetas existente dende dito formulario. Para relizar a operación é necesario que seleccione un tipo de etiqueta á que se asociará e se introduza o valor da etiqueta para o tipo seleccionado. Premendo en "______ e ______" o sistema xa a creará automáticamente e a asigna ó elemento de pedido. + +Visualización de horas imputadas a elementos de pedido +------------------------------------------------------ + +A pestana de "Horas ______" permite visualizar os partes de traballo asociados a un elemento de pedido e ó mesmo tempo permite visualizar cantas horas das presupostadas están xa realizadas. + +.. figure:: images/order-element-hours.png + :scale: 70 + +A pantalla está dividida en dúas partes: + + * Listado de partes de traballo: O usuario verá o listado de partes de traballo que están asociados ó elemento de pedido podendo comprobar a data e hora, recurso e número de horas adicadas á tarefa. + * Uso das horas presupostadas: O sistema calcula o total de horas adicadas á tarefa e as contrasta coas que estaban presupostadas. \ No newline at end of file diff --git a/doc/src/documento_usuario/07-planificacion.rst b/doc/src/documento_usuario/07-planificacion.rst index d7fdca61e..24a9b3943 100644 --- a/doc/src/documento_usuario/07-planificacion.rst +++ b/doc/src/documento_usuario/07-planificacion.rst @@ -1,11 +1,11 @@ -Planificacin de tarefas +Planificación de tarefas ######################## .. _tarefas: .. contents:: -Planificacin de tarefas +Planificación de tarefas ======================== Contidos... diff --git a/doc/src/documento_usuario/08-asignacion.rst b/doc/src/documento_usuario/08-asignacion.rst index ede43095e..385812d34 100644 --- a/doc/src/documento_usuario/08-asignacion.rst +++ b/doc/src/documento_usuario/08-asignacion.rst @@ -1,38 +1,67 @@ -Asignacin de recursos +Asignación de recursos ###################### .. asigacion_ .. contents:: -A asignacin de recursos unha das partes mis importantes da aplicacin. A asignacin de recursos pode realizarse de dous xeitos diferentes: - * Asignacins especficas. - * Asignacins xenricas. +A asignación de recursos é unha das partes máis importantes da aplicación. A asignación de recursos pode realizarse de dous xeitos diferentes: -Cada unha das asignacins explicada nas seguintes seccins + * Asignacións específicas. + * Asignacións xenéricas. -Asignacin especfica ---------------------- +Cada unha das asignacións é explicada nas seguintes seccións -A asignacin especfica aquela asignacin de un recurso de xeito concreto e especfico unha tarefa de un proxecto, dicir, o usuario da aplicacin est decidindo qu "nome e apelidos" ou qu "mquina" concreta debe ser asignada a unha tarefa. +Asignación específica +===================== -A asignacin especfica realizable dende a pantalla que se pode ver na imaxe: +A asignación específica é aquela asignación de un recurso de xeito concreto e específico á unha tarefa de un proxecto, é dicir, o usuario da aplicación está decidindo qué "nome e apelidos" ou qué "máquina" concreta debe ser asignada a unha tarefa. + +A asignación específica é realizable dende a pantalla que se pode ver na imaxe: .. figure:: images/asignacion-especifica.png :scale: 70 -A aplicacin, cando un recurso asignado especficamente, crea asignacins diarias en relacin porcentaxe de recurso diario que o usuario elixiu para asignacin e contrastando co calendario dispoible do recurso. Exemplo: unha asignacin de 0.5 recursos para unha tarefa de 32 horas far que se asignen recurso especfico (supoendo un calendario laboral de 8 horas diarias) 4 horas diarias para realizar a tarefa. +A aplicación, cando un recurso é asignado específicamente, crea asignacións diarias en relación á porcentaxe de recurso diario que o usuario elixiu para asignación e contrastando co calendario dispoñible do recurso. Exemplo: unha asignación de 0.5 recursos para unha tarefa de 32 horas fará que se asignen ó recurso específico (supoñendo un calendario laboral de 8 horas diarias) 4 horas diarias para realizar a tarefa. -Asignacin xenrica -------------------- +Asignación específica de máquinas +--------------------------------- -A asignacin xenrica aquela asignacin onde o usuario no elixe os recursos concretamente e deixa decisin da aplicacin como reparte as cargas entre os recursos dispoibles da empresa. +A asignación específica de máquinas actuará do mesmo xeito que a de traballadores, é dicir, cando se asigna unha máquina a unha tarefa, o sistema almacena unha asignación de horas específica á máquina elixida. A diferencia principal será que no momento de asignar unha máquina, o sistema buscará o listado de traballadores ou criterios asignados á máquina: + + * Se a máquina tiña un listado de traballadores asignados, elixirá entre o número deles que requira a máquina para o calendario asignado. Por exemplo, se o calendario da máquina é de 16 horas diarias e dos recursos de 8, asignará dous recursos da lista de recursos dispoñibles. + * Se a máquina tiña un criterio ou varios asignados, realizará asignacións xenéricas entre os recursos que satisfán os criterios asignados á máquina. + +Asignación xenérica +=================== + +A asignación xenérica é aquela asignación onde o usuario no elixe os recursos concretamente e deixa á decisión da aplicación como reparte as cargas entre os recursos dispoñibles da empresa. .. figure:: images/asignacion-xenerica.png :scale: 70 -O sistema de asignacin utiliza como base os seguintes supostos: - * As tarefas contarn con criterios a ser requeridos s recursos. - * Os recursos estarn configurados para que satisfagan os criterios. +O sistema de asignación utiliza como base os seguintes supostos: -Sen embargo, o sistema non fallar naqueles casos nos que non se asignen criterios senn que non discernir entre diferencias de criterios. \ No newline at end of file + * As tarefas contarán con criterios a ser requeridos ós recursos. + * Os recursos estarán configurados para que satisfagan os criterios. + +Sen embargo, o sistema non fallará naqueles casos nos que non se asignen criterios senón que non discernirá entre diferencias de criterios. + +O algoritmo de asignación xenérica actuará do seguinte xeito: + + * Cada recurso e día será tratado como un contedor onde caben asignacións diarias de horas, baseándose a capacidade máxima de asignación no calendario da tarefa. + * O sistema busca os recursos que satisfán o criterio. + * O sistema analiza qué asignacións teñen actualmente os diferentes recursos que cumpren os criterios. + * De entre os que satisfán os criterios escóllense os recursos que teñen dispoñibilidade suficiente. + * Se os recursos máis libres van sendo ocupados, seguirase realizando asignacións nos recursos que tiñan menor dispoñibilidade. + * Só cando todos os recursos que satisfán os criterios correspondentes están asignados ó 100% se comeza coa sobreasignación de recursos ata completar o total necesario para realizar a tarefa. + +Asignación xenérica de máquinas +------------------------------- + +A asignación xenérica de máquinas actuará do mesmo xeito que a de traballadores, é dicir, cando se asigna unha máquina a unha tarefa, o sistema almacena unha asignación de horas xenérica a cada unha das máquinas que satisfán os criterios, tal e como se describíu xenéricamente para os recursos en xeral. Sen embargo, tratándose de máquinas o sistema realiza a seguinte operación am maiores: + + * Para cada máquina elixida para a asignación xenérica: + * Recolle a información de configuración da máquina, é dicir, alfa, traballadores e criterios asignados. + * Se a máquina tiña un listado de traballadores asignados, elixirá entre o número deles que requira a máquina dependendo do calendario asignado. Por exemplo, se o calendario da máquina é de 16 horas diarias e dos recursos de 8, asignará dous recursos da lista de recursos dispoñibles. + * Se a máquina tiña un criterio ou varios asignados, realizará asignacións xenéricas entre os recursos que satisfán os criterios asignados á máquina. diff --git a/doc/src/documento_usuario/10-etiquetas.rst b/doc/src/documento_usuario/10-etiquetas.rst index ff0444f0e..81652e19a 100644 --- a/doc/src/documento_usuario/10-etiquetas.rst +++ b/doc/src/documento_usuario/10-etiquetas.rst @@ -1,7 +1,53 @@ -Etiquetas +Etiquetas ######### .. contents:: -Contidos... +As etiquetas son entidades que se utilizan na aplicación para a organización conceptualmente de tarefas ou elementos de pedido. +As etiquetas categorizanse segundo os tipos de etiquetas. Unha etiqueta só pertencerá a un tipo de etiqueta, sen embargo, nada impide crear tantas etiquetas similares que pertenzan a tipos de etiquetas diferentes. + +Tipos de etiquetas +================== + +Os tipos de etiquetas utilizanse para agrupar tipoloxías de etiquetas que os usuarios desexen xestionar na aplicación. Exemplos de tipos de etiquetas posibles: + + i. Cliente: O usuario podería estar interesado en etiquetar as tarefas, pedidos ou elementos de pedido en base ó cliente que os solicitou. + ii. Zona: O usuario podería estar intersado en etiquetar as tarefas, pedidos ou elementos de pedido en base á zona na que se realizan. + +A administración de tipos de etiquetas xesiontarase dende a opción de menú de "Administración". Será dende esta opción, dende a que o usuario poderá editar tipos de etiqueta, crear novos tipos de etiqueta ou engadir etiquetas a tipos de etiquetas. Dende dita operación poderá accederse ó listado de etiquetas. + +.. figure:: images/tag-types-list.png + :scale: 50 + +Dendo o listado de tipos de etiquetas será posible: + + i. Crear novo tipo de etiquetas. + ii. Editar un tipo de etiquetas existente. + iii. Borrar un tipo de etiquetas con todas as súas etiquetas. + +Tanto a edición como a creación de etiquetas comparten formulario. Dende dito formulario o usuario poderá, asignar un nome ó tipo de etiquetas, crear ou borrar etiquetas e almacenar os cambios. Para realizar esto: + + i. O usuario debería seleccionar unha etiqueta a editar ou premer no botón de creación de unha nova. + ii. O sistema amosará un formulario con unha entrada de texto para o nome e un listado de entradas de texto coas etiquetas existentes e asignadas. + iii. Se o usuario desexa engadir unha nova etiqueta debe premer no botón "______". + iv. O sistema amosará unha nova fila ó listado con unha entrada de texto baleira que o usuario debe editar. + v. O usuario introduce un nome para a etiqueta. + vi. O sistema engade o nome ó listado. + vii. O usuario preme en "______" para gardar e saír ou "______ e ______" para gardar e continuar editando o formulario. + + + +.. figure:: images/tag-types-edition.png + :scale: 50 + +Etiquetas +========= + +As etiquetas son entidades que pertencen a un tipo de etiqueta. Estas entidades poden ser asignadas a elementos de pedido. O feito de asignar unha etiqueta a un elemento de pedido fará que todos os elementos descendentes dese elemento herden a etiqueta á que pertencen. O feito de contar con unha etiqueta asignada permitirá que eses elementos saian filtrados nos puntos nos que se ofrecerá a posibilidade de procura: + + i. Procura de tarefas no diagrama de Gantt. + ii. Procura de elementos de pedido no listado de elementos de pedido. + iii. Filtrados para informes. + +A asignación de etiquetas a elementos de pedido será cuberta no capítulo de pedidos. \ No newline at end of file diff --git a/doc/src/documento_usuario/docinfo b/doc/src/documento_usuario/docinfo index 660033775..0afe53a0e 100644 --- a/doc/src/documento_usuario/docinfo +++ b/doc/src/documento_usuario/docinfo @@ -1,6 +1,6 @@ -############## -Document Title -############## +############################################################################################# +Documento de usuario para a aplicación de xestión da produción do sector do auxiliar do naval +############################################################################################# :Version: !!git log -1 --format=%H :Date: !!git log -1 --format=%ad