Skip to content

Draft da Spec06. Plataforma de Projetos

Jump to bottom
Peter edited this page Aug 5, 2020 · 6 revisions

Draft em avaliação para incluir como documento oficial.

A plataforma no Estatuto e no Regimento interno do Instituto

Conforme a cláusula 6.2 do Estatuto do Instituto:

Projetos técnicos, com maior abertura para a colaboração da comunidade, serão organizados e mantidos na internet através da Plataforma de Projetos.

  • A cada projeto serão destacados um ou mais membros efetivos, que assumirão a gestão do projeto na Plataforma de Projetos.

Além disso, na cláusula 8.1.4 é determinado que à Dir. Executiva cabe administrar o Instituto e:

Apoiar os gestores de projetos da Plataforma de Projetos, e zelar pelo bom uso dos recursos repassados aos mesmos, intervindo quando necessário.

O Regimento Interno ainda não existe, de modo que o presente documento servirá também de subsídio para a construção do Regimento.

Recursos e gestão da Plataforma

O organograma do Instituto, ilustrado abaixo, prevê o uso de recursos humanos para

  • Suporte técnico: atendimentos e serviços de apoio técnico ao uso da infraestrutura do Instituto e seus projets.
  • Preparo de dados: ver workflow na Spec02
  • Desenvolvimento de software: além de desenvolver podem apoiar a revisão de processos (Spec02) para sua posterior automação.

Os recursos humanos são utilizados, em boa parte, para manter o site e as ferramentas gerais de gestão dos associados e gestão e manutenção dos projetos, incluindo a a infraestrutura da própria Plataforma de Projetos. Conforme o Instituto amadurece e deixa de demandar o aperfeiçoamento de suas ferramentas, os recursos humanos podem também ser utilizados para ao desenvolvimento de novos projetos, ou seja, podem ser aplicados nos projetos que se encontram "plugados" na Plataforma.

Ciclo de maturidade dos projetos

Alguns projetos, tais como o Projeto AddressForAll, podem ser mantidos indefinidamente no Instituto. Os demais são apoiados para que um dia sigam sozinhos, de forma sustentável, sem dependência técnica ou jurídica do Instituto:

  1. Idealização e planejamento: ideias são constantemente debatidas, e podem em algum momento ser melhor estruturadas e formalizadas. Um requisito mínimo para esta etapa seria a documentação da ideia na forma de white paper e um cronograma de longo prazo. Sob curadoria do Conselho Consultivo ou Conselho Fiscal, essa documentação formal pode ser registrada de forma análoga às Specs.

  2. Incubação: o processo de incubação de projetos começa pela sua aprovação na Diretoria Executiva ou Assembleia Geral. O instituto fornece apenas infraestrutura, reutilizada da sua própria ou demais projetos. Investimentos específicos, em recursos humanos e financeiros, devem ser conseguidos já pelo projeto e com previsão de prestação de contas, plano de metas, etc.

  3. Sustentabilidade: o projeto demonstra capacidade de autonomia, captação de recursos, estabilidade de software e de gestão dos recursos, etc.

  4. Incorporação: o projeto adquire personalidade jurídica própria, em geral na forma de Condomínio Voluntário, mas sendo permitidos também Fundação, Associação, Cooperativa ou Sociedade Anônima. Neste processo há também o comprometimento de membros do projeto e/ou membros externos convidados, a doarem patrimônios tais como nomes de domínio, ou suprimentos tais como horas de processamento (hosting), etc.

  5. Vida independente: mesmo tendo o Instituto como co-proprietário, o antigo projeto se tornou uma entidade independente, não existem mais vínculos ou compromissos entre o Instituto e a nova entidade, exceto por eventuais compromissos definidos em contrato entre as partes.

Muitos projetos "morrem" ou simplesmente não tinham em seu planejamento uma vida duradoura. Em meio a adversidades ou falhas de planejamento os projetos podem eventualmente ser congelados. Dos poucos que sobrevivem, a meta sempre é o ciclo de vida completo.

Projetos vigentes

Em junho de 2020 o Instituto AddressForAll apresentava os seguintes projetos em sua Plataforma de Projetos:

  • Projeto AddressForAll: ativo. Principal projeto da Plataforma. Sub-projetos técnicos:

  • Projeto "SEM NOME" para a preservação digital da IDE dos municípios do Brasil: ativo. O Projeto AddressForAll e o OpenStreetMap (entidade externa) são seus principais usuários e apoiadores.

  • Projeto OSM Codes: congelado.

Além dos projetos latu senso foram incorporados à Plataforma, para fins de gestão e alocação de recursos, elementos da infraestrutura do Instituto:

TUTORIAIS DA PLATAFORMA

Cada projeto da Plataforma, acima listado, pode ter um ou mais repositórios git vinculados, de modo que o melhor local para as issues é nos respectivos repositórios. Para o caso de não haver ainda git ou simplesmente não fazer sentido o uso de um git para uma issue de tarefa geral do instituto, pode-se postar a issue em meio às issues do git AddressForAll (no futuro isso será revisto).

Quanto ao Kanban de tarefas gerenciadas pela Diretoria Executiva do Instituto, está centralizado na interface "Github projects" da raíz dos repositórios git da AddressForAll no Github, orgs/AddressForAll/projects.

Como usar as issues e o kanban de alocação de tarefas

Desde o sistema de tickets do suporte até a formalização de tarefas das diversas equipes técnicas, tudo no Instituto AddressForAll, em 2020, está sendo feito a partir da interface de issues do Github. Cada projeto tem a sua, e aqui temos as issues gerais (ex. Ouvidoria). Para listar todos os projetos navegue por git.AddressForAll.org.

Para poder postar a sua issy é preciso ter se cadastrar no Github, e estar logado. Para simplesmente ler as issues, é como uma página Web qualquer. Recomenda-se usar a interface de busca por palavras-chave quando houverem muitas ou estiver procurando por algo muito específico.

O Kanban eletrônico é como um quadro para anúncio do status das tarefas. No momento estamos usando o kanban que melhor se integra à gestão de issues que é o "project" do Github.

Repositórios de issues ativas

  • Suporte: equipe de suporte técnico, diversas frentes.

  • Specifications: normas técnicas e especificações formais, tendo o Instituto ou seus projetos como autoridade emitente do documento.

  • WS: Web Server, software embarcado no nosso servidor.

  • Digital Preservartion Brasil: preservação digital de longa duração (perspectiva de décadas)... É mais do que um simples "backup dos mapas".

Inglês ou português?

Boa pergunta, ainda estamos pensando nisso... Por hora é mais simples e barato em português, mas alguns docs e issues já nascem em inglês para não dar trabalho depois.

Outros tutoriais indicados

Clone this wiki locally