Changelog, Roadmap e Timeline

Resumo

Ferramentas de comunicação pública e interna sobre a evolução da plataforma: publicação de versões (changelog), roadmap futuro, timeline de marcos, página de investidores, mapa de integração e conectividade entre módulos, e infográfico executivo.

Para quem é (papel/role)

• super-admin - publica conteúdo global da plataforma.
• tenant-admin - pode publicar changelog/roadmap próprio (branding whitelabel).
• platform-staff - colabora na redação, com permissão adequada.

O que você pode fazer

Changelog (publicação de versões)

• Criar entrada: versão, data, tipo (feature/fix/breaking), itens.
• Editar / remover entradas.
• Publicar / despublicar.
• Sincronização com _generated/features-map.md - automática.

Roadmap

• Itens em andamento, planejados e concluídos.
• Prioridade e estimativa.
• Sincronização com _generated/modules-map.md e features-map.md.

Timeline

• Marcos históricos: eventos da empresa e da plataforma.
• Sincronização com 00-overview/STATUS-ATUAL-[data].md.

Investors

• Página de investidores: métricas, KPIs, deck, thesis.
• Sincronização com _generated/infra-map.md e STATUS-ATUAL.

Integration

• Mapa de integrações: como módulos conversam.
• Sincronização com _generated/modules-map.md e infra-map.md.

Connectivity

• Mapa de conectividade entre recursos/plugins.
• Sincronização com _generated/features-map.md e 13-connectivity/.

Infographic

• Infográfico executivo da plataforma: panorama visual para apresentações.

Visitors

• Estatísticas públicas: páginas mais vistas, origem de tráfego (quando aplicável).

Como acessar

1. /admin.
2. Settings → Changelog ou /admin/settings/changelog.
3. Abas: Changelog, Roadmap, Timeline, Investors, Integration, Connectivity, Infográfico, Visitors.

Tutoriais

Publicar uma nova versão (rc.200)

1. Acesse /admin/settings/changelog.
2. Clique em Nova entrada.
3. Versão: 2.0.0-rc.200, data: hoje.
4. Adicione itens agrupados por tipo (feature, fix, chore).
5. Publique.

Atualizar o roadmap para o próximo trimestre

1. Acesse a aba Roadmap.
2. Crie/edite itens com status Planejado e prioridade.
3. Salve. A sincronização atualiza _generated/modules-map.md.

Adicionar um marco na timeline

1. Acesse a aba Timeline.
2. Clique em Novo marco e descreva o evento com data.
3. Salve.

Integrações

• Frontend público - changelog/roadmap aparecem em páginas públicas (frontend-menu-paginas.md).
• Documentação gerada - sync com storage/project/docs/_generated/.
• Investidores - métricas vêm de receita-e-financeiro.md e observability-logs-metricas.md.

Perguntas frequentes

Posso agendar uma publicação futura? Sim, cada entrada tem campo de data de publicação.

Quem pode editar roadmap? Por padrão, super-admin e platform-staff com role apropriado.

Changelog do tenant aparece para clientes finais? Sim, na página pública do tenant com o branding whitelabel.

Posso importar changelog de outro sistema? Não há importador oficial. Entradas são criadas manualmente ou via scripts internos.

A sincronização com docs é automática? Sim, os arquivos em _generated/ são atualizados após publicação.

Posso usar markdown nas entradas? Sim, markdown básico é suportado.

Limitações, políticas e avisos

• Remover entradas publicadas afeta o histórico público; prefira marcar como despublicada.
• Página de investidores pode ter acesso restrito por token.
• Conteúdo em PT-BR com acentuação obrigatória; tradução suportada via i18n.

Relacionados

• frontend-menu-pages.md
• cms-content.md
• platform-feature-flags.md