> For the complete documentation index, see [llms.txt](https://wedocs.gitbook.io/wedocs-5.2/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wedocs.gitbook.io/wedocs-5.2/infraestrutura-instalacao-e-requisitos/guias-de-atualizacao-and-manutencao.md).

# Guias de atualização & manutenção

Este módulo centraliza as políticas corporativas, diretrizes de segurança e manuais técnicos para a aplicação de novas versões no Ecossistema Weknow. Manter a plataforma atualizada garante à instituição de saúde o acesso nativo a correções de segurança, otimizações de performance em consultas analíticas e novos recursos de Business Intelligence (BI).

Por se tratar de uma intervenção na infraestrutura central do sistema, qualquer rotina de atualização ou manutenção deve seguir os critérios de governança detalhados abaixo.

### 🕒 Janela de manutenção e políticas de suporte

Para mitigar riscos de indisponibilidade nos painéis gerenciais da instituição, a Weknow estabelece critérios rígidos de atendimento e contingência:

* **Horário comercial recomendado**: É fortemente recomendado que toda operação de atualização seja executada em dias úteis, estritamente de segunda a sexta-feira, das 08:00 às 12:00 e das 13:30 às 18:00. Esta janela garante a prontidão total das equipes internas de suporte e engenharia da Weknow caso surjam imprevistos.
* **Cenário de sistema indisponível (Sistema PARADO):** Caso uma atualização concluída apresente erros críticos que interrompam totalmente a operação do Weknow, acione o suporte técnico imediatamente. Nossa equipe atuará em regime de urgência para reestabelecer a última versão estável funcional.
* **Cenário de inconsistências pontuais (bugs):** Se o ecossistema estiver operando, mas uma funcionalidade isolada apresentar comportamento inesperado, o ajuste será tratado via abertura de chamado padrão e corrigido em atividades programadas, de acordo com a priorização do problema.

### 🛡️ Diretrizes de governança de TI (restaurações e downgrade)

* Inexistência de Downgrade Automático: O Weknow não conta com uma ferramenta de "Downgrade" (retorno a versões anteriores) após uma atualização aplicada com sucesso. Novas builds alteram e injetam estruturas inéditas nos bancos de dados. Forçar o retorno de executáveis antigos geraria severas inconsistências de dados por incompatibilidade de metadados.
* Risco em Restaurações de Repositório (PostgreSQL): A Weknow não recomenda a execução de operações manuais de *restore* da base de dados PostgreSQL sem alinhamento prévio. Há um risco iminente de perda de relatórios, dashboards e fórmulas desenvolvidos pela sua própria equipe que não estejam consolidados no arquivo de backup utilizado.

### 🗺️ Roteiro de manutenção e próximos passos

Para realizar qualquer intervenção técnica com total segurança e previsibilidade, siga a ordem lógica dos manuais subordinados a esta seção:

* ➡️ [Política de Backup Preventivo](https://www.google.com/search?q=%23): O primeiro passo obrigatório. Saiba como salvaguardar os metadados do PostgreSQL e congelar os diretórios antes de iniciar qualquer atualizador.
* ➡️ [Atualização do Weknow Server](https://www.google.com/search?q=%23): Manual técnico sobre a operação do *Weknow Server Updater* para atualizar o Core, o TaskManager, o servidor Web Apache e o banco MonetDB.
* ➡️ [Atualização do Weknow Client](https://www.google.com/search?q=%23): Instruções para a homologação e distribuição de novas versões nas estações de trabalho locais dos analistas desenvolvedores de BI.