Pular para conteúdo

Diário de Bordo — Sprint 0

Identificação

Campo Informação
Sprint 0
Período 06/04/2026 a 20/04/2026
Responsável Letícia Resende

Visão Geral da Sprint

A Sprint 0 teve como foco principal a compreensão do projeto Tainacan e a preparação do ambiente para futuras contribuições. Durante esse período, busquei entender tanto o funcionamento do sistema quanto o contexto de desenvolvimento open-source no qual ele está inserido.

O Tainacan é uma ferramenta voltada para o gerenciamento de coleções digitais dentro do WordPress, e seu funcionamento envolve diferentes camadas e tecnologias. Dessa forma, a sprint foi essencial para construir uma base sólida de entendimento antes de iniciar contribuições práticas.


Objetivos da Sprint

  • Compreender o propósito do Tainacan
  • Estudar sua arquitetura em camadas
  • Identificar os principais repositórios e suas responsabilidades
  • Entender o fluxo de contribuição open-source
  • Configurar o ambiente local de desenvolvimento
  • Explorar as funcionalidades básicas do sistema

Atividades Desenvolvidas

Atividade Categoria Situação
Leitura do README do projeto Estudo Concluído
Estudo da arquitetura do Tainacan Estudo Concluído
Análise dos repositórios (plugin, interface, themes) Análise Concluído
Leitura do guia de contribuição Estudo Concluído
Configuração do ambiente local Configuração Concluído
Execução do sistema localmente Teste Concluído
Exploração das funcionalidades do sistema Teste Concluído

Tecnologias e Ferramentas Utilizadas

Ferramenta / Tecnologia Finalidade
Git / GitHub Controle de versão e contribuição
WordPress Base do sistema
PHP Backend do Tainacan
Vue.js Interface administrativa
REST API Comunicação entre frontend e backend
MkDocs Documentação do projeto

Atividades Realizadas em Detalhe

Durante a Sprint 0, iniciei pelo estudo da documentação principal do projeto, especialmente o README e os materiais sobre a arquitetura do Tainacan. A partir disso, compreendi que o sistema é estruturado em camadas, separando responsabilidades entre backend, implementado como plugin em PHP dentro do WordPress, e frontend, construído para a interface administrativa.

Também analisei a organização dos repositórios e percebi que o projeto não está concentrado em uma única base de código. Essa divisão foi importante para entender melhor a função de cada parte do ecossistema do Tainacan e como elas se relacionam durante o desenvolvimento.

Além disso, dediquei tempo à leitura do guia de contribuição, o que ajudou a entender melhor o fluxo de trabalho adotado no projeto, incluindo organização por branches, boas práticas para commits e abertura de pull requests. Esse contato inicial foi importante para visualizar como futuras contribuições deverão ser realizadas.

Na etapa prática, realizei a configuração do ambiente local, instalando as dependências necessárias para executar o WordPress e o Tainacan. Depois disso, explorei funcionalidades básicas da plataforma, como a criação de coleções, gerenciamento de itens e navegação pela interface, buscando relacionar a prática com o que havia sido estudado na documentação.


Principais Resultados

  • Compreensão inicial da arquitetura do Tainacan
  • Entendimento da separação entre backend e frontend
  • Familiarização com o fluxo de contribuição open-source
  • Ambiente local configurado e funcional
  • Conhecimento introdutório sobre a organização dos repositórios

Aprendizados e Dificuldades

Dificuldades encontradas

  • Entender a integração entre o WordPress e o plugin principal do Tainacan
  • Compreender a divisão do projeto em múltiplos repositórios
  • Lidar com ajustes iniciais na configuração do ambiente local
  • Assimilar o fluxo de contribuição adotado em um projeto open-source já estruturado

Aprendizados adquiridos

  • Compreensão inicial de uma arquitetura organizada em camadas
  • Entendimento do papel da API na comunicação entre diferentes partes do sistema
  • Maior familiaridade com projetos baseados em WordPress
  • Aprendizado sobre o fluxo de contribuição com GitHub
  • Percepção da importância da documentação para onboarding e colaboração em equipe

Próximos Passos

Para a próxima sprint, o objetivo será avançar da fase de estudo para uma atuação mais prática dentro do projeto.

Planejamento para a Sprint 1

  • Escolher uma issue viável no repositório do Tainacan
  • Estudar o trecho do sistema relacionado à issue selecionada
  • Realizar pequenas contribuições em documentação ou código
  • Aprofundar o entendimento da estrutura interna do sistema
  • Continuar registrando aprendizados, dificuldades e avanços ao longo do processo

Histórico de Versões

Versão Data Descrição Autor
1.0 22/04/2026 Criação do diário de bordo Letícia Resende