Superintendência Estadual de Tecnologia da Informação e Comunicação

Plataforma de documentação operacional e gerencial da SETIC

Ferramentas do usuário

Ferramentas do site


start:memoria_organizacional:memoria_organizacional:cultura_gdev:documentacao_na_gdev

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.

start/memoria_organizacional/memoria_organizacional/cultura_gdev/documentacao_na_gdev.txt · Última modificação: 2022/01/25 15:26 (edição externa)