7. Governança de Arquitetura
A governança da arquitetura do sistema AcadMap segue diretrizes que garantem rastreabilidade, consistência e validação colaborativa das decisões técnicas.
7.1 Decisões Arquiteturais
Todas as decisões arquiteturais relevantes são formalizadas por meio de registros do tipo RDA (Registro de Decisão Arquitetural), numerados sequencialmente e armazenados no repositório docs/rda
.
7.2 Alterações no DAS
Qualquer alteração significativa no Documento de Arquitetura de Sistema (DAS) deve ser submetida via pull request, obrigatoriamente revisada por outro membro da equipe de Arquitetura. Essa prática assegura que as modificações sejam avaliadas quanto à sua conformidade com os princípios arquiteturais e impacto no sistema.
7.3 Sobre o Versionamento
Além disso, as versões do DAS são etiquetadas conforme os ciclos de entrega do projeto, utilizando versionamento semântico e.g. v1.0
, v1.1
e assim por diante. Isso permite o controle histórico da evolução da arquitetura e facilita a referência a versões específicas durante auditorias, revisões técnicas e fases de manutenção.
7.4 Ferramentas de Apoio à Arquitetura
A elaboração, manutenção e disseminação da arquitetura do sistema AcadMap são apoiadas por um conjunto de ferramentas que promovem automação, padronização e rastreabilidade. Essas ferramentas estão integradas ao fluxo de desenvolvimento e à governança do DAS, conforme a tabela abaixo:
ID | Ferramenta | Finalidade |
---|---|---|
001 | MkDocs | Geração da documentação navegável em Markdown |
002 | Mermaid | Criação de diagramas leves em Markdown |
003 | PlantUML | Modelagem de diagramas estruturados via texto |
004 | GitHub | Controle de versionamento e colaboração |
005 | GitHub Actions | Automação de pipelines CI/CD e publicação |
006 | GitHub Projects | Acompanhamento visual das atividades (Kanban) |