Pular para o conteúdo

CHANGELOG

Todas as mudanças relevantes são documentadas neste arquivo.

O formato segue Keep a Changelog e este projeto adota Versionamento Semântico.



Versão beta — primeira versão pública estruturada do framework, com infraestrutura de publicação, identidade visual consolidada e extensão para sistemas em sustentação.

  • Firebase Hosting configurado (sinergia-5241f, domínio docs.sinergia.dev.br)
  • Script scripts/deployDocs.ps1 para build e deploy automatizado
  • Google Analytics 4 integrado ao site (GA4 G-23HZDQ260L)
  • Sistema de identidade visual: 6 variantes de logo (icon, compact, dark, banner, clean, original)
  • 6 componentes de UI extraídos das coletâneas (ui-botoes, ui-progresso, ui-estados, ui-tags, ui-callouts, ui-formularios)
  • docs/images/README.md — catálogo completo com especificações, usos e regras de cada ativo visual
  • Páginas individuais por ponto de vista: ESP, INF, PRO, IMP, GTI, GDA, PDP com imagens contextuais
  • PV SIS — Sistemas em Sustentação: 8º ponto de vista do framework, com 7 artefatos (ASR, BRM, DIM, IRA, OBS, LKP, RUN-ext)
  • docs/modelo-sinergia-sistemas-legados.md — modelo completo (14 seções) com critérios de modernização (seção 12-A)
  • artefatos/SIS-Sustentacao/ — estrutura de pastas com READMEs dos 6 tipos de documentos
  • Logo na navbar e imagem hero da home page substituídos pelos assets reais do SinergIA
  • Sidebar “Pontos de Vista” expandido para grupo com 8 sub-itens individuais
  • Versão do framework reposicionada para esquema x.xxb (beta)

  • Site de documentação estática em docs/site/ com Astro + Starlight, tema gov.br e WCAG 2.1 AA
  • Estrutura completa de artefatos em artefatos/ — Modo Essencial: 78 pastas, 60 READMEs
    • ESP (Especificação): 11 tipos de histórias (HNI, HNE, HNU, HS, HRD, HUX, HC, HAI, HAC, HIVC, HI)
    • IMP (Implementação): TDD, API contract, TPL, DOD, CHG, REL
    • GTI (Governança de TI): ADR, RFC, RDM, DEC
    • PDP (Proteção de Dados Pessoais): ADR de privacidade, BRD de privacidade, PMT, RUN, RIPD
    • INF (Infraestrutura) — opcional: HII (6 sub-tipos) e HIS (9 sub-tipos)
    • PRO (Prototipação) — opcional: protótipos vinculados às histórias ESP (Especificação)
    • GDA (Governança de Dados) — opcional: DOM, ERD, ADR de dados
  • Script scripts/showDocs.ps1 para iniciar o servidor Starlight local
  • Skill .cursor/skills/versionamento/SKILL.md para orientar o agente no processo de versioning
  • Rule .cursor/rules/salvar-prompt.mdc para registro automático de prompts
  • Tagline oficial bilíngue: “SinergIA — Onde pessoas e IA trabalham juntas”
  • Seção “Filosofia e Identidade” com textos explicativos em PT e EN
  • Separação da página “Introdução e Princípios” em 3 páginas: Introdução, Princípios Gerais e Estrutura do Framework
  • Pastas dos pontos de vista renomeadas com nome completo (ex.: ESP-Especificacao/, GTI-GovernancaTI/)
  • Siglas expandidas em toda a documentação (ESP (Especificação) → Especificação, GTI (Governança de TI) → Governança de TI, etc.)
  • Esquema de versionamento ajustado para incrementos de 0.01 (ex.: 2.01, 2.02…)
  • Autor/responsável pela documentação definido como Elias Cotrim

  • Seção 16 — Glossário: definições de todos os termos técnicos do framework
  • Seção 17 — Modos de aplicação: Completo (alta criticidade), Essencial (média) e Ágil (baixa)
  • Seção 18 — Artefato Orquestrador: componente central de automação do framework
  • Apêndice A — Stack de referência: ferramentas compatíveis por categoria (não prescritivo)
  • KPIs quantitativos de desempenho (seção 15.1)
  • Diagramas Mermaid nos fluxos de pontos de vista (seções 3 e 13)
  • Mecanismos de autonomia escalonada (seção 8.6): Nível 1 / 2 / 3
  • Linter de Governança (seção 8.7)
  • Papéis de supervisão humana com briefings por IA (seção 8.5)
  • Critérios objetivos de divergência obrigatória (seções 4.2 e 7.1)
  • Gestão de custo e capacidade de IA (seção 8.8)
  • Política de evolução e obsolescência do framework (seção 8.9)
  • Regra específica de monitoração detalhada (seção 5.3)
  • Registro obrigatório de reunião a quente (seção 6.2)
  • Compatibilidade com iterações ágeis (seção 13)
  • Condições de exceção e retorno (seção 13.1)
  • Dimensões obrigatórias de qualidade de dados na GDA (seção 9.2)
  • Alternativa de monorepo para Modo Ágil (seção 12.1)
  • Convenção de nomenclatura com 4 dígitos NUM (seção 11.1)
  • Tipos documentais complementares: CTX, STY, EVD, CHK, DEC, IDX, REF (seção 11.5)
  • Hierarquia de headings corrigida em todo o documento (formatação Markdown)
  • Seção de CI/CD expandida e reorganizada: especificação na INF (5.2) e operacionalização na IMP (7.2)
  • Regras da PDP (Proteção de Dados Pessoais) expandidas com avaliação de vendor lock-in e camada de abstração (seção 10.2)
  • Sincronização entre repositórios detalhada com autoridade documental definida (seção 12.1)
  • Blocos de código não fechados no documento original
  • Seções sem prefixo de cabeçalho (12.3, 12.4, 12.5, 13, 14, 15)
  • Listas sem marcadores em múltiplas seções

  • Estrutura completa do framework com 7 pontos de vista: ESP (Especificação), INF (Infraestrutura), PRO (Prototipação), IMP (Implementação), GTI (Governança de TI), GDA (Governança de Dados), PDP (Proteção de Dados Pessoais)
  • 9 princípios gerais do modelo (seção 2)
  • 11 tipos de histórias da especificação (HNI a HIVC)
  • 17 tipos de histórias da infraestrutura (HII e HIS completos)
  • Convenção de nomenclatura <PV>-<TIPO>-<NUM>--<desc>.md
  • Ciclo operacional do framework (seção 13)
  • Cláusula de transparência operacional (seção 14)
  • Resultado esperado (seção 15)
  • Organização de repositórios por ponto de vista (seção 12.1)
  • Estrutura de pastas padrão por repositório (seção 12.2)
  • Regra de documentação curta (seção 12.3)
  • Versionamento obrigatório de todos os artefatos (seção 12.4)
  • Repositório Git configurado em git@bitbucket.org:eliascotrim/sinergia.git