> For the complete documentation index, see [llms.txt](https://docs.yoplanning.support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yoplanning.support/pt/academia-yoplanning/yoplanning-parametrage/parametrage-produit/comment-marche-la-sauvegarde-par-transition-d-un-produit./sauvegarde-par-transition-dans-yoplanning-une-analyse-technique.md).

# Backup de transição no YoPlanning: uma análise técnica

O backup transitório no **YoPlanning** foi projetado para gerenciar de forma segura e granular as atualizações do produto e seu impacto nas sessões associadas. Este artigo se concentra nos aspectos técnicos para explicar detalhadamente como esse mecanismo funciona e por que alguns dados podem diferir entre as sessões.

***

### Arquitetura técnica: como funciona?

1. **Estado Inicial dos Dados** Quando um produto é criado, suas propriedades básicas (nome, descrição, preço, etc.) são registradas como um **estado inicial** no banco de dados. Toda sessão criada a partir desse produto herda esse estado inicial.
2. **Identificação de Sessões Dependentes** Quando um produto é modificado, o sistema identifica todas as sessões futuras associadas a esse produto. Isso inclui:
   * Sessões com dados estritamente idênticos ao estado inicial do produto.
   * As sessões foram personalizadas por meio de modificações manuais.
3. **Comparação com o estado inicial** Antes de aplicar uma alteração, o Yoplanning compara as propriedades das sessões existentes com o estado inicial do produto:
   * Se as propriedades de uma sessão ainda corresponderem ao estado inicial, ela estará **apta para atualização automática**.
   * Caso alguma propriedade tenha sido modificada manualmente (por exemplo, uma taxa ajustada ou um nome personalizado), a sessão será **excluída da atualização** para preservar essas personalizações.
4. **Atualização Condicional** As alterações são aplicadas apenas às sessões elegíveis. As demais permanecem inalteradas, garantindo que quaisquer personalizações específicas não sejam sobrescritas.
5. **Salvar por Transição** Durante a fase de atualização, o sistema utiliza um mecanismo de **buffer**:
   * As alterações são aplicadas inicialmente em uma área temporária.
   * Após a validação, os dados são transferidos para o banco de dados ativo. Esse processo garante total integridade em caso de erro ou interrupção.

***

### Por que os dados podem diferir entre as sessões?

#### Cenários comuns

1. **Sessões Personalizadas Manualmente** Se um usuário modificar uma sessão (por exemplo, alterando o preço ou o nome), essa personalização **sobrepõe-se** às alterações globais do produto. Isso pode dar a impressão de que uma sessão "não foi atualizada", quando na verdade ela foi **deliberadamente excluída** da atualização para preservar as personalizações.
2. **Dependência Parcial do Produto** Algumas sessões podem não depender de todas as propriedades do produto. Por exemplo, uma sessão pode herdar o preço, mas não a descrição. Essas dependências parciais explicam por que apenas certas propriedades são atualizadas.
3. **Inconsistências relacionadas a estados intermediários** Durante uma transição, se uma atualização for cancelada ou interrompida, algumas sessões podem permanecer em um estado intermediário. No entanto, graças à funcionalidade de salvar por transição, esses casos são raros e podem ser corrigidos ao confirmar novamente a transição.

***

### Diagnóstico e resolução para clientes

1. **Caso: Os dados parecem estar incorretos em uma sessão**
   * **Verificação de personalização:** Confirme se a sessão foi modificada manualmente pelo cliente.
   * **Comparação com o estado inicial:** Verificar se os dados atuais correspondem ao estado inicial ou se foram herdados de uma modificação anterior.
2. **Caso: A sessão não foi atualizada**
   * **Verificação dos critérios de elegibilidade:** Identificar se a sessão foi excluída devido a personalizações.
   * **Reexecutando a transição:** Proponha uma atualização manual ou automatizada para reaplicar as alterações globais.

***

### Conclusão

O backup transitório no Yoplanning é uma solução robusta e escalável para gerenciar atualizações de produtos e sessões. Ele oferece um equilíbrio entre automação e personalização, garantindo consistência e respeitando as modificações específicas de cada usuário. Um sólido conhecimento desse mecanismo é essencial para responder às perguntas dos clientes e aproveitar os modelos de IA no gerenciamento de sessões.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.yoplanning.support/pt/academia-yoplanning/yoplanning-parametrage/parametrage-produit/comment-marche-la-sauvegarde-par-transition-d-un-produit./sauvegarde-par-transition-dans-yoplanning-une-analyse-technique.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.