Voc\u00ea, desenvolvedor, j\u00e1 se deparou com cen\u00e1rios espec\u00edficos em que voc\u00ea precisa controlar um fluxo de informa\u00e7\u00f5es, mas, suportando diversos status, com diversos efeitos colaterais diferentes, entre cada mudan\u00e7a desses status?<\/p>\n
Criar e manter este tipo de estrutura, manualmente, \u00e9 bem complicado. Formalmente, este tipo de estrutura \u00e9 chamada de m\u00e1quina de estado finita ou finite state machines<\/strong> e para os \u00edntimos, FSM<\/strong>.<\/p>\n Inspirados em outros pacotes dispon\u00edveis para o Django, constru\u00edmos nosso pr\u00f3prio gerenciador de m\u00e1quinas de estados. Este \u00e9 mais um pacote open-source que disponibilizamos para a comunidade.<\/p>\n As aplica\u00e7\u00f5es das FSMs<\/strong> s\u00e3o diversas. Elas podem controlar como compoenentes internos de uma aplica\u00e7\u00e3o reagem a est\u00edmulos externos (usu\u00e1rio informa determinada informa\u00e7\u00e3o) ou mesmo serem editadas pelo pr\u00f3prio usu\u00e1rio. Um exemplo disso s\u00e3o os famigerados BPM<\/strong> (Bussiness Process Management**) onde os pr\u00f3prios usu\u00e1rios definem at\u00e9 certo ponto, o fluxo da informa\u00e7\u00e3o e por quais verifica\u00e7\u00f5es esta deve passar antes de permitir a troca de um estado para outro.<\/p>\n Outro exemplo interessante \u00e9 que algumas AIs s\u00e3o escritas usando os conceitos de FSM para determinar comportamentos de seus agentes, portanto, te garanto, FSMs s\u00e3o bastante flex\u00edveis.<\/p>\n Na realidade, a ideia desta aplica\u00e7\u00e3o Django surgiu para atender uma demanda, onde os usu\u00e1rios mais graduados, deveriam poder escolher como a informa\u00e7\u00e3o fluiria numa aplica\u00e7\u00e3o geogr\u00e1fica.<\/p>\n Para instalar este pacote \u00e9 bem simples e voc\u00ea pode usar o pip:<\/p>\n Agora adicione este pacote ao seu Execute suas migra\u00e7\u00f5es com Terminado isto, voc\u00ea precisa definir qual \u00e9 o modelo que voc\u00ea deseja controlar o status. Basta voc\u00ea herdar de um MixIn<\/strong> para obter a funcionalidade de m\u00e1quina de status:<\/p>\n Pronto. A configura\u00e7\u00e3o b\u00e1sica est\u00e1 pronta!<\/p>\n Depois disso, com toda a certeza, voc\u00ea deve querer editar quais status e como a informa\u00e7\u00e3o flui entre estes status. Isto \u00e9 bem f\u00e1cil.<\/p>\n N\u00f3s controlamos o fluxo de informa\u00e7\u00f5es utilizando tr\u00eas modelos:<\/p>\n Vamos construir isso em um passo a passo r\u00e1pido:<\/p>\n Agora que nossas transi\u00e7\u00f5es est\u00e3o prontas, voc\u00ea pode definir qualquer projeto, com diferentes tipos de m\u00e1quinas de estado, basta escolher a m\u00e1quina de estado apropriada, veja s\u00f3:<\/p>\n Neste momento, todas as a\u00e7\u00f5es da m\u00e1quina de estado est\u00e3o dispon\u00edveis atrav\u00e9s do mixin que voc\u00ea herdou na constru\u00e7\u00e3o do modelo Projeto.<\/p>\n Exemplo:<\/p>\n N\u00e3o \u00e9 s\u00f3 isso, existem diversos ganchos que voc\u00ea pode usar, como tarefas espec\u00edficas a serem disparadas e a\u00e7\u00f5es, nas quais voc\u00ea pode associar a um estado, para indicar que esta a\u00e7\u00e3o est\u00e1 dispon\u00edvel. Exemplo: no status em andamento do projeto, voc\u1ebd pode criar coment\u00e1rios e apenas neste estado. Portanto, voc\u00ea pode criar uma No seu c\u00f3digo, voc\u1ebd pode checar qual Dispon\u00edvel no Github: https:\/\/github.com\/sigma-geosistemas\/django-workflow<\/p>\n Este \u00e9 um pacote bem completo para gest\u00e3o de m\u00e1quinas de estado. Caso voc\u00ea tenha interesse, d\u00ea uma conferida. Estamos a disposi\u00e7\u00e3o!<\/p>\n","protected":false},"excerpt":{"rendered":" Voc\u00ea, desenvolvedor, j\u00e1 se deparou com cen\u00e1rios espec\u00edficos em que voc\u00ea precisa controlar um fluxo de informa\u00e7\u00f5es, mas, suportando diversos status, com diversos efeitos colaterais diferentes, entre cada mudan\u00e7a desses status? Criar e manter este tipo de estrutura, manualmente, \u00e9 bem complicado. Formalmente, este tipo de estrutura \u00e9 chamada de m\u00e1quina de estado finita ou … <\/p>\nAplica\u00e7\u00f5es das FSM<\/h2>\n
Instala\u00e7\u00e3o<\/h2>\n
pip install django-workflow-fsm\n<\/code><\/pre>\nINSTALLED_APPS<\/code>:<\/p>\nINSTALLED_APPS = (\n # outras apps,\n 'workflow',\n # outras apps,\n)\n<\/code><\/pre>\n.\/manage.py migrate<\/code><\/p>\nGetting Started<\/h2>\n
# models.py\nclass Projeto(StateControllerMixIn):\n nome = models.CharField(max_length=128)\n<\/code><\/pre>\n\n
# shell ou fixture ou migra\u00e7\u00e3o de dados\nstatus_aberto = State.objects.create(code='aberto')\nstatus_em_andamento = State.objects.create(code='em-andamento')\nstatus_fechado = State.objects.create(code='fechado')\n\n# nossos status est\u00e3o criados. Vamos criar nossa m\u00e1quina de estado\n\nfsm = StateMachine.objects.create(name='projetos-simples', initial_state=status_aberto)\n# na linha acima definimos nossa m\u00e1quina e o status inicial dela, aberto.\n\n# agora vamos definir as transicoes\naberto_andamento = Transition.objects.create(name='iniciando-projeto',\n machine=fsm,\n from_state=status_aberto,\n to_state=status_em_andamento)\n\nandamento_fechado = Transition.objects.create(name='finalizando-projeto',\n machine=fsm,\n from_state=status_em_andamento,\n to_state=status_fechado)\n<\/code><\/pre>\nprojeto = Projeto()\nprojeto.nome = 'projeto legal'\nprojeto.save(state_machine=fsm)\n<\/code><\/pre>\nprojeto.current_state\n# imprime \"aberto\"\nprojeto.next\n# imprime \"em andamento\"\nprojeto.change_to(state_em_andamento)\n# projeto ser\u00e1 enviado para o estado \"em andamento\"\nprojeto.next\n# imprime 'fechado'\n<\/code><\/pre>\nAction<\/code> e associ\u00e1-la ao estado em-andamento<\/code>.<\/p>\naction<\/code> est\u00e1 dispon\u00edvel e renderizar o template como voc\u00ea achar melhor.<\/p>\nOutras coisas legais:<\/h2>\n
\n
tasks<\/code> (ou tarefas) que ser\u00e3o executadas quando um estado da m\u00e1quina \u00e9 alterado. Por exemplo, quando a m\u00e1quina de estado mudar de estado, quero disparar um email para um usu\u00e1rio, informando do ocorrido. Voc\u00ea pode criar isso como uma Task<\/code> e associar esta task a transi\u00e7\u00e3o espec\u00edfica.<\/li>\nCelery<\/code>.<\/li>\ndjango-rest-framework<\/code><\/li>\n<\/ul>\nReposit\u00f3rio<\/h2>\n
Roadmap<\/h2>\n
\n