====== DOCUMENTAÇÃO ====== //Software funcionando mais do que documentação abrangente// Manifesto Ágil Um mito surgiu juntamente com a difusão dos métodos ágeis, o mito de que não existe documentação no desenvolvimento de projetos. Este mito é falso, nossa documentação tem a cobertura necessária para que alcance e supra a necessidade de todas aquelas pessoas que precisam utilizá-la. Ou seja, só documentamos aquilo que vai ser utilizado por alguém. Essa atitude nos poupou o desperdício de utilizar força de trabalho para construir algo que não será utilizado. Com essa economia, passamos a investir em qualidade de forma que todo material produzido e pensando em quem vai utilizar e melhorando continuamente. ===== Projetos ===== ==== Demandas ==== Nossas demandas de projetos são acompanhadas através da ferramenta Pipefy, onde armazenamos dados como: * Problema a ser resolvido * Data da solicitação * Setor solicitante * Cliente (Pessoa responsável) * Estudo de impacto ==== Diagnósticos ==== Para cada cliente com um problema, temos um diagnóstico para seu problema. Tem tudo se resolve com um sistema. E quando se faz necessário um sistema deve haver um cuidado especial com a implantação. Todo esse cuidado é sintetizado no Relatório de Diagnóstico que é utilizado pela Gerência da GDEV na tomada de decisão, no momento de priorização de projeto. A transparência é um dos pilares da agilidade e nossos diagnósticos são publicados na Wiki da DETIC, que fica disponível para todo cidadão acessar. ==== Desenvolvimento ==== Se no diagnóstico for validado que para o problema informado tem como melhor solução o desenvolvimento de um software, os próximos passos a serem seguidos são: Ideação e Desenvolvimento. ==== Ideação ==== Os processos de ideação utilizado na DETIC tem o formato de workshop colaborativo, onde é indispensável a participação dos clientes e do time de desenvolvimento. Toda a atividade é feita com post-its e recursos visuais. Após o término do workshop todo material e digitalizado e disponibilizado na Wiki DETIC. Esse material vai ser insumo e fonte de consulta do P.O. e do Time de Desenvolvimento durante todo o processo de desenvolvimento. ==== Desenvolvimento ==== Utilizamos o SCRUM como framework de gestão de projeto. Os itens de backlog são construídos utilizando a técnica de user story. Cada user story responde às seguintes perguntas com relação ao funcionalidade a ser desenvolvida: * Para quem deve ser desenvolvida? * O que deve ser desenvolvida? * Porque deve ser desenvolvida? * Para que deve ser desenvolvida? * Quais os cenários em que a funcionalidade será utilizada? * Quais os critérios de aceitação? * Qual a avaliação de complexidade informada pelo time? Esta estrutura possibilita que os debates sejam mais produtivos e com um propósito. Todas as user stories são produzidas na ferramenta Pipefy. Estes dados podem ser exportados em diversos formatos. O que possibilita a utilização dos dados em dashboards para acompanhamento do próprio time. ===== Código de software ===== “Isso aí quem resolve é fulano, só ele sabe onde está”. Ditado popular Tudo em um só lugar, nossos códigos fontes são armazenados no GitLab da DETIC. Que utiliza o GIT que é um sistema de controle de versões distribuídos, onde para cada alteração realizada no código e submetida a revisão antes de aprovação. Para cada uma das alterações aprovadas e armazenado quem realizou a alteração e o motivo da alteração. Desde a primeira linha de código construída até a última é possível saber quem escreveu cada parte.